Change order of arguments for dh in debian/rules.

[debian/jabref.git] / debian / README.source

diff --git a/debian/README.source b/debian/README.source
index 952a9547f7091ea96e86530eeb4ffae85545871b..64f049668e2d016b5c73307c8ac7d7b3a2e6feae 100644 (file)
--- a/debian/README.source
+++ b/debian/README.source
@@ -1,4 +1,19 @@
-This package uses quilt to manage patches against the upstream source code.
+This package uses quilt to manage all modifications to the upstream
+source.  Changes are stored in the source package as diffs in
+debian/patches and applied during the build.
 
-If you want to work on the package and are not familiar with quilt,
-please take a look at /usr/share/doc/quilt/README.source.
+See /usr/share/doc/quilt/README.source for a detailed explanation.
+
+The files ./src/java/net/sf/jabref/bst/BstLexer.java and
+./src/java/net/sf/jabref/bst/BstParser.java are generated with
+the command (also note that the Bst.g file is included in the patch
+debian/patches/05_antlrv32.patch):
+
+       antlr3 Bst.g
+
+After generation, they are hand-edited to contain the proper
+Java package name and to correct an issue with the _channel
+member field.  The maintainers are working with upstream to 
+either include the generation as part of the build process
+or to ship the upstream tarball with versions of the parser
+and lexer that operate with antlr 3.2.