Contributing new programs to Madagascar - Revision history

Fomels: /* Static code checks */ links

2024-11-26T03:32:27Z

Static code checks: links

← Older revision		Revision as of 03:32, 26 November 2024
Line 28:		Line 28:

	==Static code checks==		==Static code checks==
	Madagascar contains the beginning of an implementation of static code checks for security vulnerabilities and coding mistakes with [http://www.splint.org/ Splint]. This is visible in the code through the presence of comments like <tt>/@out@/</tt> and <tt>/@null@/</tt>, which instruct Splint about the intent of different variables and function return values. Plans include dynamic checking by [http://valgrind.org/ Valgrind] or IBM's [http://www-306.ibm.com/software/awdtools/purify/ Rational Purify]. Madagascar code metrics are [~~http~~://~~www.ohloh~~.net/p/m8r~~/analyses/latest~~ assessed periodically by ~~Ohloh~~].		Madagascar contains the beginning of an implementation of static code checks for security vulnerabilities and coding mistakes with [http://www.splint.org/ Splint]. This is visible in the code through the presence of comments like <tt>/@out@/</tt> and <tt>/@null@/</tt>, which instruct Splint about the intent of different variables and function return values. Plans include dynamic checking by [http://valgrind.org/ Valgrind] or IBM's [http://www-306.ibm.com/software/awdtools/purify/ Rational Purify]. Madagascar code metrics are [https://openhub.net/p/m8r assessed periodically by Open Hub].

	==Maintaining the maintenance tools==		==Maintaining the maintenance tools==

Fomels: /* Repository procedure suggestions */

2024-11-26T03:30:19Z

Repository procedure suggestions

← Older revision		Revision as of 03:30, 26 November 2024
Line 10:		Line 10:

	==Repository procedure suggestions==		==Repository procedure suggestions==
	~~Please try to:~~
	* Do [http://en.wikipedia.org/wiki/Atomic_commit atomic commits].
	* If you use Subversion, run <pre>svn commit -m "your message here"</pre> to let others know what changed.
	** Alternatively, set the <tt>EDITOR</tt> or <tt>SVN_EDITOR</tt> environmental variables to your favorite editor and edit your message there.

	For coding style suggestions, please see [[Adding_new_programs_to_Madagascar#Style_guide \| the "Adding new programs" section]].		Please try to do [http://en.wikipedia.org/wiki/Atomic_commit atomic commits]. For coding style suggestions, please see [[Adding_new_programs_to_Madagascar#Style_guide \| the "Adding new programs" section]].

	==Backward compatibility features==		==Backward compatibility features==

Fomels: typos

2024-11-26T03:29:32Z

typos

← Older revision		Revision as of 03:29, 26 November 2024
Line 1:		Line 1:
	If you want to share your code with other Madagascar users:		If you want to share your code with other Madagascar users:
	# Follow the guide on [[Adding new programs to Madagascar]].		# Follow the guide on [[Adding new programs to Madagascar]].
	# If your employer holds the copyright for your software, obtain a permission to distribute under a [http://www.gnu.org/copyleft/gpl.html GPL license] and place a copyright and GPL license notice in each file with code.		# If your employer holds the copyright for your software, obtain permission to distribute under a [http://www.gnu.org/copyleft/gpl.html GPL license] and place a copyright and GPL license notice in each file with code.
	# [https://github.com/ Sign up at GitHub].		# [https://github.com/ Sign up at GitHub].
	# Upload your directory to the [https://github.com/ahay/src Github repository] by making a pull request.		# Upload your directory to the [https://github.com/ahay/src Github repository] by making a pull request.
	# Announce your changes in the release notes for the upcoming stable version ([https://github.com/ahay/src/blob/master/NEWS.txt $RSFSRC/NEWS.txt])		# Announce your changes in the release notes for the upcoming stable version ([https://github.com/ahay/src/blob/master/NEWS.txt $RSFSRC/NEWS.txt])
	# Make sure to add reproducible examples of using your program under the <tt>$RSFSRC/book</tt> tree. Create new directories if necessary and commit them to the repository. As a rule, programs without examples ~~are not included in the release version~~.		# Make sure to add reproducible examples of using your program under the <tt>$RSFSRC/book</tt> tree. Create new directories if necessary and commit them to the repository. As a rule, the release version does not include programs without examples.

	Some additional ~~useful~~ information is included below.		Some additional helpful information is included below.

	==Repository procedure suggestions==		==Repository procedure suggestions==
Line 18:		Line 18:

	==Backward compatibility features==		==Backward compatibility features==
	If you introduce or notice a feature that is used solely for ~~backwards~~ compatibility with an old version of a dependency, please document it here, so that the feature can be eliminated when the Madagascar community stops supporting that version of that dependency<ref>This could be more elegantly done by using a special string to flag a ~~backwards~~ compatibility comment in the code, then have the documentation builder build this list automatically. This would make it more likely for this page to be kept in ~~synch~~ with the codebase.</ref>.		If you introduce or notice a feature that is used solely for backward compatibility with an old version of a dependency, please document it here so that the feature can be eliminated when the Madagascar community stops supporting that version of that dependency<ref>This could be more elegantly done by using a special string to flag a backward compatibility comment in the code, then have the documentation builder build this list automatically. This would make it more likely for this page to be kept in sync with the codebase.</ref>.

	~~===Python 2.2 and older===~~
	* In <tt>framework/rsfdoc.py</tt>: Everything in the <tt>have_datetime_module=False</tt> branches

	~~===Python 2.3 and older===~~
	* In <tt>configure.py</tt>: Everything in the <tt>have_subprocess=False</tt> branches
	* In <tt>configure.py</tt>: See code after comment "For Py 2.4 and up this can be done more elegantly..."
	* In <tt>user/ivlad/ivlad.py</tt>: Everything in the <tt>have_subprocess=False</tt> branches
	* The entire <tt>api/python/rsfbak.py</tt> (also needed on systems which do not have recent versions of numpy ''and'' SWIG)
	~~===Python 2.4 and older===~~
	* try (try...except)... finally construct instead of try... except... finally in <tt>framework/rsfdoc.py</tt>

	==Mitigating missing dependencies==		==Mitigating missing dependencies==
Line 35:		Line 24:
	==Reasons for the existence of certain features==		==Reasons for the existence of certain features==
	===Why pyc files are generated during the install step===		===Why pyc files are generated during the install step===
	Python bytecode files, with the pyc extensions, are created during the <tt>scons install</tt> ~~in order~~ to:		Python bytecode files, with the pyc extensions, are created during the <tt>scons install</tt> to:
	* Register them in SCons' dependency tree, so that ~~they are removed by~~ <tt>scons -c install</tt>		* Register them in SCons' dependency tree so that <tt> scons remove them -c install</tt>
	* Avoid a situation ~~in which~~ a user tries to execute a Madagascar Python program, but ~~creating~~ the pyc file during a module import fails because of lack of write access to <tt>$RSFROOT/lib</tt>.		* Avoid a situation where a user tries to execute a Madagascar Python program but creates the pyc file during a module import fails because of lack of write access to <tt>$RSFROOT/lib</tt>.

	==cfortran.h==		==cfortran.h==
	This source code file provides a machine-independent interface between C procedures, Fortran procedures and global data (more details [http://www-zeus.desy.de/~burow/cfortran/ on the website of its initial author]). It is a dependency of the F77 and F90 APIs, as well as of vplot. It is included in m8r in <tt>api/f90</tt> with a link in <tt>api/f77</tt>. Version 4.3 (2002) is still distributed through ~~the website of~~ the original author. Another version (fork?) is [http://root.cern.ch/viewvc/trunk/montecarlo/eg/inc/cfortran.h?view=log maintained at CERN] and distributed in the include directory of the interface to event generators in the Monte Carlo libraries in the [http://cernlib.web.cern.ch/cernlib/ CERN Program Library] (CERNlib). Debian distributes the Free Software part of this package as <tt>cernlib</tt>. Under Fedora, <tt>cfortran.h</tt> is included in <tt>cernlib-g77-devel</tt> and <tt>cernlib-devel</tt>, which happily overwrite each other's files and create copies of <tt>cfortran.h</tt> in two different locations deeply nested under <tt>/usr/include</tt>. CERNlib's Debian maintainer states that [http://people.debian.org/~kmccarty/cernlib/index.html "CERNlib is an ancient mass of mostly Fortran code"] and that [http://people.debian.org/~kmccarty/physics-software-rant.html "Most components of CERNLIB are completely broken on modern 64-bit architectures"], so m8r developers should be aware that CERNlib will probably be superseded ~~at some point~~ in the future by [http://en.wikipedia.org/wiki/ROOT ROOT], with upstream <tt>cfortran.h</tt> maintenance possibly continuing this way.		This source code file provides a machine-independent interface between C procedures, Fortran procedures, and global data (more details [http://www-zeus.desy.de/~burow/cfortran/ on the website of its initial author]). It is a dependency of the F77 and F90 APIs, as well as of vplot. It is included in m8r in <tt>api/f90</tt> with a link in <tt>api/f77</tt>. Version 4.3 (2002) is still distributed through the original author's website. Another version (fork?) is [http://root.cern.ch/viewvc/trunk/montecarlo/eg/inc/cfortran.h?view=log maintained at CERN] and distributed in the include directory of the interface to event generators in the Monte Carlo libraries in the [http://cernlib.web.cern.ch/cernlib/ CERN Program Library] (CERNlib). Debian distributes the Free Software part of this package as <tt>cernlib</tt>. Under Fedora, <tt>cfortran.h</tt> is included in <tt>cernlib-g77-devel</tt> and <tt>cernlib-devel</tt>, which happily overwrite each other's files and create copies of <tt>cfortran.h</tt> in two different locations deeply nested under <tt>/usr/include</tt>. CERNlib's Debian maintainer states that [http://people.debian.org/~kmccarty/cernlib/index.html "CERNlib is an ancient mass of mostly Fortran code"] and that [http://people.debian.org/~kmccarty/physics-software-rant.html "Most components of CERNLIB are completely broken on modern 64-bit architectures"], so m8r developers should be aware that CERNlib will probably be superseded in the future by [http://en.wikipedia.org/wiki/ROOT ROOT], with upstream <tt>cfortran.h</tt> maintenance possibly continuing this way.

	==Static code checks==		==Static code checks==
	Madagascar contains the beginning of an implementation of static code checks for security vulnerabilities and coding mistakes with [http://www.splint.org/ Splint]. This is visible in the code through the presence of comments like <tt>/@out@/</tt> and <tt>/@null@/</tt>, which instruct Splint about the intent of different variables and function return values. ~~Future plans~~ include ~~using also~~ dynamic checking by [http://valgrind.org/ Valgrind] or IBM's [http://www-306.ibm.com/software/awdtools/purify/ Rational Purify]. Madagascar code metrics are [http://www.ohloh.net/p/m8r/analyses/latest assessed periodically by Ohloh].		Madagascar contains the beginning of an implementation of static code checks for security vulnerabilities and coding mistakes with [http://www.splint.org/ Splint]. This is visible in the code through the presence of comments like <tt>/@out@/</tt> and <tt>/@null@/</tt>, which instruct Splint about the intent of different variables and function return values. Plans include dynamic checking by [http://valgrind.org/ Valgrind] or IBM's [http://www-306.ibm.com/software/awdtools/purify/ Rational Purify]. Madagascar code metrics are [http://www.ohloh.net/p/m8r/analyses/latest assessed periodically by Ohloh].

	==Maintaining the maintenance tools==		==Maintaining the maintenance tools==
	Please document scripts ~~used to~~ maintain the Madagascar codebase, and save them in <tt>$RSFSRC/admin</tt>. Cleanup procedures may need to be repeated in the future, as authors are human and can make the same mistakes again.		Please document scripts that maintain the Madagascar codebase and save them in <tt>$RSFSRC/admin</tt>. Cleanup procedures may need to be repeated in the future, as authors are human and can make the same mistakes again.

	==Information flow map==		==Information flow map==
Line 53:		Line 42:
	<references/>		<references/>
	==Dual licensing Madagascar code==		==Dual licensing Madagascar code==
	~~When in~~ a contractual work relationship, you may find it handy to reuse some of your ~~own~~ existing public code for which you own the copyright. This may also apply if you are doing contract work for a client on behalf of your employer, who owns the copyright.		In a contractual work relationship, you may find it handy to reuse some of your existing public code for which you own the copyright. This may also apply if you are doing contract work for a client on behalf of your employer, who owns the copyright.

	If your code does not have any GPL-ed dependencies, and the copyright owner agrees to ~~releasing~~ the code under a different license than the GPL, then you are free to go ahead and do it. However, make sure that in every file you state:		If your code does not have any GPL-ed dependencies, and the copyright owner agrees to release the code under a different license than the GPL, then you are free to go ahead and do it. However, make sure that in every file you state the following:
	* who is the copyright owner,		* who is the copyright owner,
	* what are the terms of the proprietary license that it is being released under,		* what are the terms of the proprietary license that it is being released under,
	* that the code has already been licensed to the public under the GNU GPL ~~prior to~~ this as part of the Madagascar package		* that the code has already been licensed to the public under the GNU GPL before this as part of the Madagascar package
	It is important to specify all these items, lest years later, someone in your client's company finds the code, realizes that similar code is part of Madagascar, and wrongly believes that the copyright belonged to his company, and that you infringed it by releasing the code under the GPL.		It is important to specify all these items, lest years later, someone in your client's company finds the code, realizes that similar code is part of Madagascar, and wrongly believes that the copyright belonged to his company and that you infringed it by releasing the code under the GPL.

	~~Make sure~~ that proper copyright and licensing statements are in place in case of dual licensing, even if you are on ~~very good~~ terms with your client, and are ~~certain that~~ they will not falsely accuse you of wrongdoing. Companies get acquired, employees and even owners leave companies, policies and business strategies change, and old contracts, licenses and legal documents get discarded or lost in a mass of old junk. Each source code file should contain all the relevant copyright and licensing information.		Ensure that proper copyright and licensing statements are in place in case of dual licensing, even if you are on excellent terms with your client and are confident they will not falsely accuse you of wrongdoing. Companies get acquired, employees and even owners leave companies, policies and business strategies change, and old contracts, licenses, and legal documents get discarded or lost in a mass of old junk. Each source code file should contain all the relevant copyright and licensing information.

Sfomel at 15:40, 30 August 2016

2016-08-30T15:40:47Z

← Older revision		Revision as of 15:40, 30 August 2016
Line 2:		Line 2:
	# Follow the guide on [[Adding new programs to Madagascar]].		# Follow the guide on [[Adding new programs to Madagascar]].
	# If your employer holds the copyright for your software, obtain a permission to distribute under a [http://www.gnu.org/copyleft/gpl.html GPL license] and place a copyright and GPL license notice in each file with code.		# If your employer holds the copyright for your software, obtain a permission to distribute under a [http://www.gnu.org/copyleft/gpl.html GPL license] and place a copyright and GPL license notice in each file with code.
	# [~~http~~://~~sourceforge~~.~~net/account/registration~~/ ~~Register~~ at ~~SourceForge].~~		# [https://github.com/ Sign up at GitHub].
	~~# Find out who the project administrators are (Look for "Project Admins" on [http://sourceforge.net/projects/rsf/ this page~~]~~) and pass your SourceForge user name to one of them~~.		# Upload your directory to the [https://github.com/ahay/src Github repository] by making a pull request.
	# Upload your directory to the ~~repository using <tt>[http://svnbook.red-bean.com/en/1.0/re01.html svn add]</tt> and <tt>~~[~~http~~://~~svnbook.red-bean~~.com/en/~~1.1/re06.html svn commit~~]~~</tt>~~.		# Announce your changes in the release notes for the upcoming stable version ([https://github.com/ahay/src/blob/master/NEWS.txt $RSFSRC/NEWS.txt])
	# Announce your changes in the release notes for the upcoming stable version ([~~http~~://~~sourceforge~~.~~net/p/rsf~~/~~code~~/~~HEAD~~/~~tree~~/~~trunk~~/NEWS.txt $RSFSRC/NEWS.txt])
	# Make sure to add reproducible examples of using your program under the <tt>$RSFSRC/book</tt> tree. Create new directories if necessary and commit them to the repository. As a rule, programs without examples are not included in the release version.		# Make sure to add reproducible examples of using your program under the <tt>$RSFSRC/book</tt> tree. Create new directories if necessary and commit them to the repository. As a rule, programs without examples are not included in the release version.

Sfomel: /* Repository procedure suggestions */

2015-07-27T23:55:40Z

Repository procedure suggestions

← Older revision		Revision as of 23:55, 27 July 2015
Line 13:		Line 13:
	Please try to:		Please try to:
	* Do [http://en.wikipedia.org/wiki/Atomic_commit atomic commits].		* Do [http://en.wikipedia.org/wiki/Atomic_commit atomic commits].
	* ~~Use~~ <tt>svn commit -m "your message here"</tt> to let others know what changed.		* If you use Subversion, run <pre>svn commit -m "your message here"</pre> to let others know what changed.
	** Alternatively, set the <tt>EDITOR</tt> or <tt>SVN_EDITOR</tt> environmental variables to your favorite editor and edit your message there.		** Alternatively, set the <tt>EDITOR</tt> or <tt>SVN_EDITOR</tt> environmental variables to your favorite editor and edit your message there.
	* If you plan to do large-scale substantive changes, create a Subversion [http://en.wikipedia.org/wiki/Branching_(software) branch] by running
	~~<pre>~~		For coding style suggestions, please see [[Adding_new_programs_to_Madagascar#Style_guide \| the "Adding new programs" section]].
	~~svn copy https://svn.code.sf.net/p/rsf/code/trunk https://svn.code.sf.net/p/rsf/code/yourbranchname~~
	~~svn co https://svn.code.sf.net/p/rsf/code/yourbranchname~~
	~~</pre>~~
	For coding style suggestions, please see [[Adding_new_programs_to_Madagascar#Style_guide \| the "Adding new programs" section]].

	==Backward compatibility features==		==Backward compatibility features==

Sfomel at 03:49, 13 September 2013

2013-09-13T03:49:53Z

← Older revision		Revision as of 03:49, 13 September 2013
Line 6:		Line 6:
	# Upload your directory to the repository using <tt>[http://svnbook.red-bean.com/en/1.0/re01.html svn add]</tt> and <tt>[http://svnbook.red-bean.com/en/1.1/re06.html svn commit]</tt>.		# Upload your directory to the repository using <tt>[http://svnbook.red-bean.com/en/1.0/re01.html svn add]</tt> and <tt>[http://svnbook.red-bean.com/en/1.1/re06.html svn commit]</tt>.
	# Announce your changes in the release notes for the upcoming stable version ([http://sourceforge.net/p/rsf/code/HEAD/tree/trunk/NEWS.txt $RSFSRC/NEWS.txt])		# Announce your changes in the release notes for the upcoming stable version ([http://sourceforge.net/p/rsf/code/HEAD/tree/trunk/NEWS.txt $RSFSRC/NEWS.txt])
	# Make sure to add reproducible examples of using your program under the <tt>RSFSRC/book</tt> tree. Create new directories if necessary and commit them to the repository. As a rule, programs without examples are not included in the release version.		# Make sure to add reproducible examples of using your program under the <tt>$RSFSRC/book</tt> tree. Create new directories if necessary and commit them to the repository. As a rule, programs without examples are not included in the release version.

	Some additional useful information is included below.		Some additional useful information is included below.
Line 51:		Line 51:

	==Maintaining the maintenance tools==		==Maintaining the maintenance tools==
	Please document scripts used to maintain the Madagascar codebase, and save them in <tt>RSFSRC/admin</tt>. Cleanup procedures may need to be repeated in the future, as authors are human and can make the same mistakes again.		Please document scripts used to maintain the Madagascar codebase, and save them in <tt>$RSFSRC/admin</tt>. Cleanup procedures may need to be repeated in the future, as authors are human and can make the same mistakes again.

	==Information flow map==		==Information flow map==

Sfomel at 19:43, 14 October 2012

2012-10-14T19:43:32Z

← Older revision		Revision as of 19:43, 14 October 2012
Line 5:		Line 5:
	# Find out who the project administrators are (Look for "Project Admins" on [http://sourceforge.net/projects/rsf/ this page]) and pass your SourceForge user name to one of them.		# Find out who the project administrators are (Look for "Project Admins" on [http://sourceforge.net/projects/rsf/ this page]) and pass your SourceForge user name to one of them.
	# Upload your directory to the repository using <tt>[http://svnbook.red-bean.com/en/1.0/re01.html svn add]</tt> and <tt>[http://svnbook.red-bean.com/en/1.1/re06.html svn commit]</tt>.		# Upload your directory to the repository using <tt>[http://svnbook.red-bean.com/en/1.0/re01.html svn add]</tt> and <tt>[http://svnbook.red-bean.com/en/1.1/re06.html svn commit]</tt>.
	# Announce your changes in the release notes for the upcoming stable version ([http://~~rsf.svn.~~sourceforge.net/~~viewvc~~/rsf/trunk/NEWS.txt~~?view=markup~~ $RSFSRC/NEWS.txt])		# Announce your changes in the release notes for the upcoming stable version ([http://sourceforge.net/p/rsf/code/HEAD/tree/trunk/NEWS.txt $RSFSRC/NEWS.txt])
	# Make sure to add reproducible examples of using your program under the <tt>RSFSRC/book</tt> tree. Create new directories if necessary and commit them to the repository. As a rule, programs without examples are not included in the release version.		# Make sure to add reproducible examples of using your program under the <tt>RSFSRC/book</tt> tree. Create new directories if necessary and commit them to the repository. As a rule, programs without examples are not included in the release version.

Line 17:		Line 17:
	* If you plan to do large-scale substantive changes, create a Subversion [http://en.wikipedia.org/wiki/Branching_(software) branch] by running		* If you plan to do large-scale substantive changes, create a Subversion [http://en.wikipedia.org/wiki/Branching_(software) branch] by running
	<pre>		<pre>
	svn copy https://~~rsf~~.~~svn~~.~~sourceforge~~.net/~~svnroot~~/rsf/trunk https://~~rsf~~.~~svn~~.~~sourceforge~~.net/~~svnroot~~/rsf/yourbranchname		svn copy https://svn.code.sf.net/p/rsf/code/trunk https://svn.code.sf.net/p/rsf/code/yourbranchname
	svn co https://~~rsf~~.~~svn~~.~~sourceforge~~.net/~~svnroot~~/rsf/yourbranchname		svn co https://svn.code.sf.net/p/rsf/code/yourbranchname
	</pre>		</pre>
	For coding style suggestions, please see [[Adding_new_programs_to_Madagascar#Style_guide \| the "Adding new programs" section]].		For coding style suggestions, please see [[Adding_new_programs_to_Madagascar#Style_guide \| the "Adding new programs" section]].

Sfomel: /* SWIG or numpy */

2012-06-30T13:15:10Z

SWIG or numpy

@@ Line 38: / Line 38: @@
 ==Mitigating missing dependencies==
 The main idea is to attempt to provide [http://en.wikipedia.org/wiki/Graceful_degradation graceful degradation] when facing a missing dependency. Quoting the Wikipedia page on fault-tolerant systems, this "enables a system to continue operating properly in the event of the failure of (or one or more faults within) some of its components. If its operating quality decreases at all, the decrease is proportional to the severity of the failure, as compared to a naively-designed system in which even a small failure can cause total breakdown."
 ==Reasons for the existence of certain features==
 ===Why pyc files are generated during the install step===

Nick: suggestion to add info to NEWS.txt

2011-08-18T03:34:15Z

suggestion to add info to NEWS.txt

← Older revision		Revision as of 03:34, 18 August 2011
Line 5:		Line 5:
	# Find out who the project administrators are (Look for "Project Admins" on [http://sourceforge.net/projects/rsf/ this page]) and pass your SourceForge user name to one of them.		# Find out who the project administrators are (Look for "Project Admins" on [http://sourceforge.net/projects/rsf/ this page]) and pass your SourceForge user name to one of them.
	# Upload your directory to the repository using <tt>[http://svnbook.red-bean.com/en/1.0/re01.html svn add]</tt> and <tt>[http://svnbook.red-bean.com/en/1.1/re06.html svn commit]</tt>.		# Upload your directory to the repository using <tt>[http://svnbook.red-bean.com/en/1.0/re01.html svn add]</tt> and <tt>[http://svnbook.red-bean.com/en/1.1/re06.html svn commit]</tt>.
			# Announce your changes in the release notes for the upcoming stable version ([http://rsf.svn.sourceforge.net/viewvc/rsf/trunk/NEWS.txt?view=markup $RSFSRC/NEWS.txt])
	# Make sure to add reproducible examples of using your program under the <tt>RSFSRC/book</tt> tree. Create new directories if necessary and commit them to the repository. As a rule, programs without examples are not included in the release version.		# Make sure to add reproducible examples of using your program under the <tt>RSFSRC/book</tt> tree. Create new directories if necessary and commit them to the repository. As a rule, programs without examples are not included in the release version.

Nick: Dual licensing

2011-08-13T01:14:43Z

Dual licensing

← Older revision		Revision as of 01:14, 13 August 2011
Line 66:		Line 66:
	[[Image:M8rmap.png]]		[[Image:M8rmap.png]]
	<references/>		<references/>
			==Dual licensing Madagascar code==
			When in a contractual work relationship, you may find it handy to reuse some of your own existing public code for which you own the copyright. This may also apply if you are doing contract work for a client on behalf of your employer, who owns the copyright.

			If your code does not have any GPL-ed dependencies, and the copyright owner agrees to releasing the code under a different license than the GPL, then you are free to go ahead and do it. However, make sure that in every file you state:
			* who is the copyright owner,
			* what are the terms of the proprietary license that it is being released under,
			* that the code has already been licensed to the public under the GNU GPL prior to this as part of the Madagascar package
			It is important to specify all these items, lest years later, someone in your client's company finds the code, realizes that similar code is part of Madagascar, and wrongly believes that the copyright belonged to his company, and that you infringed it by releasing the code under the GPL.

			Make sure that proper copyright and licensing statements are in place in case of dual licensing, even if you are on very good terms with your client, and are certain that they will not falsely accuse you of wrongdoing. Companies get acquired, employees and even owners leave companies, policies and business strategies change, and old contracts, licenses and legal documents get discarded or lost in a mass of old junk. Each source code file should contain all the relevant copyright and licensing information.