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 <ni...@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)
_______________________________________________
pkg-java-commits mailing list
pkg-java-comm...@lists.alioth.debian.org
http://lists.alioth.debian.org/mailman/listinfo/pkg-java-commits
