🚀 go-pugleaf

RetroBBS NetNews Server

Inspired by RockSolid Light RIP Retro Guy

Article View: borland.public.jbuilder.documentation
Article #29

Re: JavaDoc packaging

#29
From: Gillmer J. Derge [TeamB]
Date: Tue, 12 Oct 2004 15:25
20 lines
2061 bytes
Brian Ray wrote:
> I would think that if I include project
> documentation in my jars that the documentation should work automatically
> when I include the jar in my library.  Otherwise there is no sense in
> including the documentation in the jar file.  Is something that should put
> in an RFE for?

If you think it should be done, then enter it in QualityCentral: 
http://qc.borland.com.  My feeling, however, is that it shouldn't and 
can't be implemented.

How is JBuilder supposed to know whether you put the documentation in 
doc, docs, doc/api, docs/api, doc/javadoc, doc/javadocs, docs/javadoc, 
docs/javadocs, ... ?  I guess you could make a list of all the places 
you think are "right," but there's always going to be someone who puts 
them somewhere else and insists that's the "right" place.  IMHO 
JBuilder's solution of letting you specify where they are is perfect.

-- 
Gillmer J. Derge [TeamB]
Technical Details
Message-ID: <416bf77f@newsgroups.borland.com>
Path: arc1-ca.pugleaf.net!g2news1.google.com!news1.google.com!sn-xit-04!sn-xit-05!sn-xit-14!supernews.com!news.maxwell.syr.edu!news.tele.dk!news.tele.dk!small.news.tele.dk!npeer.de.kpn-eurorings.net!feed.news.schlund.de!schlund.de!newsfeed01.sul.t-online.de!t-online.de!newsgroups.borland.com!not-for-mail
References: <416add31$1@newsgroups.borland.com> <u655gh0ib.fsf@broadpark.no> <416bed3c@newsgroups.borland.com>

Show Full Headers
Complete Article Headers
X-Google-Thread: 10b82f,1b0b52097939a8ec
X-Google-Attributes: gid10b82f,public
X-Google-Language: ENGLISH,ASCII-7-bit
Date: Tue, 12 Oct 2004 11:25:51 -0400
From: "Gillmer J. Derge [TeamB]" <spam@gillmerderge.com>
User-Agent: Mozilla Thunderbird 0.8 (Windows/20040913)
X-Accept-Language: en-us, en
MIME-Version: 1.0
Newsgroups: borland.public.jbuilder.documentation
Subject: Re: JavaDoc packaging
References: <416add31$1@newsgroups.borland.com> <u655gh0ib.fsf@broadpark.no> <416bed3c@newsgroups.borland.com>
In-Reply-To: <416bed3c@newsgroups.borland.com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
NNTP-Posting-Host: 64.185.133.65
Message-ID: <416bf77f@newsgroups.borland.com>
X-Trace: newsgroups.borland.com 1097594751 64.185.133.65 (12 Oct 2004 08:25:51 -0700)
Lines: 20
Path: arc1-ca.pugleaf.net!g2news1.google.com!news1.google.com!sn-xit-04!sn-xit-05!sn-xit-14!supernews.com!news.maxwell.syr.edu!news.tele.dk!news.tele.dk!small.news.tele.dk!npeer.de.kpn-eurorings.net!feed.news.schlund.de!schlund.de!newsfeed01.sul.t-online.de!t-online.de!newsgroups.borland.com!not-for-mail