This is the mail archive of the java-patches@gcc.gnu.org mailing list for the Java project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: [patch] generate man pages for classpath tools


Tom Tromey writes:
> >>>>> "Matthias" == Matthias Klose <doko@cs.tu-berlin.de> writes:
> 
> Matthias> The GCC tools generate man pages for all commands, this
> Matthias> patch does the same for the tools installed by classpath.
> 
> Matthias> The patch is for classpath HEAD.
> 
> Please check this in.  This is excellent.
> 
> I think we ought to rename the Classpath .texi and .info files to be
> more Classpath-specific.  The /usr/share/info "namespace" is flat
> after all.  So instead of "tools.info" I would suggest
> "cp-tools.info".

done, same for the other files

> Matthias> * doc/gappletviewer.1, doc/gjar.1, doc/gjarsigner.1, doc/gjavah.1,
> Matthias> doc/gkeytool.1, doc/gnative2ascii.1, doc/gorbd.1, doc/grmid.1,
> Matthias> doc/grmiregistry.1, doc/gserialver.1, doc/gtnameserv.1: Generate.
> 
> I saw these in the patch.  Classpath generally does not check in
> generated files (with the occasionally troublesome exception of the
> JNI headers).  So, don't put them in the Classpath tree.  For GCC, do
> whatever the rest of GCC does.

done.

The man pages are currently not yet generated; sending this as a
followup patch.

  Matthias

ChangeLog

2007-02-20  Matthias Klose  <doko@ubuntu.com>

        * doc/Makefile.am: Add rules to build and install man pages
        from texinfo docs.
        * doc/hacking.texinfo doc/tools.texinfo, doc/vmintegration.texinfo:
        Rename, prefix files with "cp-".
        * doc/cp-tools.texinfo: Add markup for man page generation,
        add documentation for command line options for gjar, gjavah,
        gnative2ascii, gorbd, grmid, grmiregistry, gserialver, gtnameserv.
        doc/texi2pod.pl: New, taken from the GCC sources.

ChangeLog.gcj

2007-02-20  Matthias Klose  <doko@ubuntu.com>

        * Merge doc update from classpath HEAD.
        * doc/texi2pod.pl: Not imported.
        * doc/Makefile.am: Use GCC's texi2pod.pl
        * doc/Makefile.in: Regenerate.


Attachment: cp-tools.diff.gz
Description: Binary data


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]