]> git.sesse.net Git - mlt/blobdiff - docs/policies.txt
Remove files that no longer belong.
[mlt] / docs / policies.txt
index 4da3b605a99831cc3ef48669ea35a07e44502c03..f2fb0336c8ff69183561bcad23fd62c121ec5613 100644 (file)
@@ -4,28 +4,38 @@ by Dan Dennedy
 Policies
 --------
 
-Any contribution to the "core" module assign copyright to Ushodaya Enterprises
-Limited because they need license control over that module.
-
-Comments in the framework and valerie header files must be C-style, not C++.
+Any contribution to the "core" module must assign copyright to Ushodaya
+Enterprises Limited because they need license control over that module.
 
 The framework and valerie client libraries are covered under LGPL. Miracle,
 inigo, albino, and humperdink applications are covered under GPL. Modules
 should strive to be LGPL to make them available through the framework as LGPL.
 
+Comments in the framework and valerie header files must be C-style, not C++.
+
 Coding Style:
 There are not a lot of rules, but we prefer brackets on their own line,
 indents using tabs, liberal usage of spaces in statements and expressions, and
 no hard line length. The code in src/framework serves as a good example.
 
+Commit messages must be prefaced with the name of the changed files. This makes
+the Subversion log more useful as a ChangeLog. For example,
+    docs/policies.txt: added policy about commit message
+
+Increment the version number in ./configure AND mlt.h on the first commit after
+a release as well as just prior to a new release. This way we can track if
+someone is using an unreleased version from the source code repository.
+
+Do not write messages to stdout. stdout is reserved for writing streams that
+can be redirected: e.g. raw DV in consumer_libdv. I recommended to use the
+mlt_log API. For something quick and dirty, use stderr.
+
+
 Procedures
 ----------
 
 Update services.txt when you add or update a service.
 
-Until we convert to Subversion, which can provide a nice, comprehensive log
-please update ChangeLog with every commit.
-
 Setting Copyright on Appropriated Code:
 You do not want to be accused of copying someone's code and changing copyright
 or license without permission. The license is straightforward: you must retain
@@ -45,4 +55,3 @@ First preference is to use the SourceForge tracker:
 http://sourceforge.net/tracker/?group_id=96039&atid=613414
 Second preference is in the mailing list:
 mlt-devel@lists.sourceforge.net
-