This is the mail archive of the java-patches@sources.redhat.com 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]

Re: Patch: generate texinfo documentation


>>>>> "Bryce" == Bryce McKinlay <bryce@albatross.co.nz> writes:

Bryce> Do we really want these in gcj? Arn't they just bulking up the
Bryce> distribution with duplicated information? If people do find
Bryce> them useful, wouldn't it be better to set up a server side
Bryce> script to periodically regenerate them against the cvs sources,
Bryce> and put them in a separate archive (libgcj-docs-xxyyzz.tar.gz
Bryce> or something?). It might also be good to generate html versions
Bryce> and have them accessible online.

We should definitely have them online.

One problem with including them in the distribution is that according
to the GNU standards we should also include .info files.  That would
add even more bulk.

Bryce> On a related note, I'm quite keen to write a real .texi manual
Bryce> for gcj that incorporates a lot of the information thats
Bryce> currently scattered around the website, etc (but then I've been
Bryce> saying this for a while ;-). IIRC you were working on something
Bryce> like this a while ago... was there ever any progress? We should
Bryce> get this done before the 3.0 release.

I agree, this is very important.  I have time to work on gcj projects
right now.  Anthony, could you send me what you have?  I think this is
the most important thing to do right now.  I'll work on it.

Tom

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