[pkg-java] r12952 - in trunk/japitools/debian: . source

Thu Sep 2 07:50:16 UTC 2010

Author: nthykier-guest
Date: 2010-09-02 07:50:07 +0000 (Thu, 02 Sep 2010)
New Revision: 12952

Added:
   trunk/japitools/debian/source/
   trunk/japitools/debian/source/format
Modified:
   trunk/japitools/debian/changelog
   trunk/japitools/debian/japicompat.1
   trunk/japitools/debian/japize.1
   trunk/japitools/debian/rules
Log:
  * Removed unused simple-patch system.
  * Fixed some hyphens that should have been minus signs in the
    manpages.
  * Converted source format to 3.0 (quilt).



Modified: trunk/japitools/debian/changelog
===================================================================

--- trunk/japitools/debian/changelog	2010-09-02 07:23:54 UTC (rev 12951)
+++ trunk/japitools/debian/changelog	2010-09-02 07:50:07 UTC (rev 12952)
@@ -6,6 +6,10 @@
     - Bumped Standards-Versions to 3.9.1 - no changes required.
     (Closes: #590910)
   * Added Homepage and Vcs-* fields.
+  * Removed unused simple-patch system.
+  * Fixed some hyphens that should have been minus signs in the
+    manpages.
+  * Converted source format to 3.0 (quilt).
 
  -- Niels Thykier <niels at thykier.net>  Tue, 03 Aug 2010 12:29:19 +0200
 

Modified: trunk/japitools/debian/japicompat.1
===================================================================
--- trunk/japitools/debian/japicompat.1	2010-09-02 07:23:54 UTC (rev 12951)
+++ trunk/japitools/debian/japicompat.1	2010-09-02 07:50:07 UTC (rev 12952)
@@ -42,7 +42,7 @@
 
 .TP
 \fB\-j\fP
-generates output in raw machine readable form. The format produced is called "japio" format, and by convention should be saved with a ".japio" file extension. The standalone japiotext and japiohtml utilities can be used to convert this format into html or text (actually, japicompat calls japiotext or japiohtml internally if the -h or -t flags are used). Japio files can also be used with the -i flag to support ignoring errors caused by incompatibilities between JDK versions.
+generates output in raw machine readable form. The format produced is called "japio" format, and by convention should be saved with a ".japio" file extension. The standalone japiotext and japiohtml utilities can be used to convert this format into html or text (actually, japicompat calls japiotext or japiohtml internally if the \-h or \-t flags are used). Japio files can also be used with the \-i flag to support ignoring errors caused by incompatibilities between JDK versions.
 
 .TP
 \fB\-w\fP
@@ -54,7 +54,7 @@
 
 .TP
 \fB\-o\fR <outfile\fR>\fP
-Send the output to <outfile> instead of stdout. The format of this file depends on the -h, -t and -j flags.
+Send the output to <outfile> instead of stdout. The format of this file depends on the \-h, \-t and \-j flags.
 
 .TP
 \fB\-i\fR <ignorefiles\fR>\fP
@@ -62,15 +62,15 @@
 
 Unfortunately Sun has not followed their own binary compatibility rules between JDK releases, let alone the expanded rules that japicompat tests for. So when you run a comparison between JDK 1.1 and your implementation, you will get spurious error reports when you're compatible with 1.4 but not 1.1.
 
-Obviously what you really want is to ignore errors like this, and japicompat provides a way to do so. First, run a comparison between 1.1 and 1.4 using the -j switch. Then run the comparison between 1.1 and your implementation, passing the "-i" option with the output of the previous run. For example:
+Obviously what you really want is to ignore errors like this, and japicompat provides a way to do so. First, run a comparison between 1.1 and 1.4 using the \-j switch. Then run the comparison between 1.1 and your implementation, passing the "\-i" option with the output of the previous run. For example:
 
-$ japicompat -jo ignore-11-14.japio jdk11.japi.gz jdk14.japi.gz
+$ japicompat \-jo ignore-11-14.japio jdk11.japi.gz jdk14.japi.gz
 .br
-$ japicompat -ho jdk11-myimpl.html -i ignore-11-14.japio jdk11.japi.gz myimpl.japi.gz
+$ japicompat \-ho jdk11-myimpl.html \-i ignore-11-14.japio jdk11.japi.gz myimpl.japi.gz
 
 You can also get the same effect by running:
 
-$ japicompat -ho jdk11-myimpl.html -i jdk14.japi.gz jdk11.japi.gz myimpl.japi.gz
+$ japicompat \-ho jdk11-myimpl.html \-i jdk14.japi.gz jdk11.japi.gz myimpl.japi.gz
 
 This is obviously simpler and quicker to type, but requires the comparison between jdk11 and jdk14 to be run every single time. Making the japio file manually allows for it to be saved and used again the next time, which lets japicompat run about twice as fast.
 
@@ -85,7 +85,7 @@
 .br
 $ japicompat myimpl.japi.gz jdk12.japi.gz
 
-It is probably impossible to make an implementation that passes both these tests, since Sun's own JDK1.2 produces numerous errors when tested against JDK1.1. See the discussion of the -i option above for a way to cope with this situation.
+It is probably impossible to make an implementation that passes both these tests, since Sun's own JDK1.2 produces numerous errors when tested against JDK1.1. See the discussion of the \-i option above for a way to cope with this situation.
 
 Either compressed (.japi.gz) or uncompressed (.japi) files can be passed to japicompat: The file extension is used to determine whether or not to pipe input through gzip or not.
 

Modified: trunk/japitools/debian/japize.1
===================================================================
--- trunk/japitools/debian/japize.1	2010-09-02 07:23:54 UTC (rev 12951)
+++ trunk/japitools/debian/japize.1	2010-09-02 07:50:07 UTC (rev 12952)
@@ -60,7 +60,7 @@
 
 .TP
 \fB+\fP|\fB-\fR<pkgpath\fR>\fP
-To specify which classes are included, use +pkgpath to add pkgpaths to be scanned and -pkgpath to exclude sub-pkgpaths of these. You MUST specify at least one +pkgpath option to specify which pkgpath to include, otherwise Japize could happily scan through all the zipfiles and directories but not actually process any of the classes. Since that would be a useless thing to do, japize gives an error instead.
+To specify which classes are included, use +pkgpath to add pkgpaths to be scanned and \-pkgpath to exclude sub-pkgpaths of these. You MUST specify at least one +pkgpath option to specify which pkgpath to include, otherwise Japize could happily scan through all the zipfiles and directories but not actually process any of the classes. Since that would be a useless thing to do, japize gives an error instead.
 
 A "pkgpath" refers to either a package (which includes, by implication, all sub-packages of it) or a single class. A pkgpath for a package looks like "com.foo.pkg.sub," and a pkgpath for a class looks like "com.foo.pkg,Cls". The existence and placement of the comma indicates unambiguously which type of path is intended.
 
@@ -70,15 +70,15 @@
 
 Sun's JDK 1.1 includes classes in java.awt.peer and in java.text.resources that are not part of the public API, even though they are public classes; however, every other class in the java.* package hierarchy is part of the public API. The syntax to construct a useful jdk11.japi.gz would therefore be:
 
-$ japize as jdk11 apis classes.zip +java -java.awt.peer -java.text.resources
+$ japize as jdk11 apis classes.zip +java \-java.awt.peer \-java.text.resources
 
 Note that since all pkgpath arguments here are packages, you could save a small amount of processing by doing this instead:
 
-$ japize as jdk11 packages classes.zip +java -java.awt.peer -java.text.resources
+$ japize as jdk11 packages classes.zip +java \-java.awt.peer \-java.text.resources
 
 or even this:
 
-$ japize as jdk11 explicitly classes.zip +java, -java.awt.peer, -java.text.resources,
+$ japize as jdk11 explicitly classes.zip +java, \-java.awt.peer, \-java.text.resources,
 
 .SH SEE ALSO
 .BR japicompat (1) 

Modified: trunk/japitools/debian/rules
===================================================================
--- trunk/japitools/debian/rules	2010-09-02 07:23:54 UTC (rev 12951)
+++ trunk/japitools/debian/rules	2010-09-02 07:50:07 UTC (rev 12952)
@@ -3,7 +3,6 @@
 
 include /usr/share/cdbs/1/rules/debhelper.mk
 include /usr/share/cdbs/1/class/ant.mk
-include /usr/share/cdbs/1/rules/simple-patchsys.mk
 
 export UPSTREAM_VERSION = $(shell head -1 debian/changelog | cut -f2 -d\( | cut -f1 -d\) | cut -f1 -d\-)
 

Added: trunk/japitools/debian/source/format
===================================================================
--- trunk/japitools/debian/source/format	                        (rev 0)
+++ trunk/japitools/debian/source/format	2010-09-02 07:50:07 UTC (rev 12952)
@@ -0,0 +1 @@
+3.0 (quilt)


