Erm, this should have gone to the list..

-- 
Mike Gratton <[EMAIL PROTECTED]>
   Leader in leachate production and transmission since 1976.
   <http://web.vee.net/>
--- Begin Message ---


Guillaume Rousse wrote:

> We propose instead to install it under a distinct subdirectory under a new 
> /usr/share/apidoc top-level directory. Advantages:
> - distinction with standard documentation


Erm, but isn't that the whole point of the standard? So that everything 
is always in the same place, regardless of what platform, OS, etc.

Someone new to Java, but who knows UNIX will think to look in 
/usr/[share/]doc/[packagename] for any docs, but no one will think to 
look in /usr/share/apidoc.

> - would allow to link generated javadoc versus already-installed one


Surely something like:

/usr/share/doc/[packagename]/javadoc
/usr/share/doc/[packagename]/javadoc-generated

would do.

> - name 'apidoc' is not specificaly related to java, could also be used by 
> other languages


Again, it is bad because it is counter-intuitative.


I don't think it is agood idea.

Mike.

-- 
Mike Gratton <[EMAIL PROTECTED]>
"Every motive escalate."
  Blatant self-promotion: <http://web.vee.net/>

--- End Message ---

Reply via email to