All the more reason to build the docs from the code directly with doxygen or 
whatever. I'm pretty sure nobody writes code with the intent it doesn't get 
used, from a coder standpoint having documentation helps feature acceptance.

This feature probably is documented but since I can't find that documentation 
quickly (i.e. just could find it in under 5 minutes) it might as well not 
exist to the majority of devs. We s'port too many hidden feats.

Anyway we've got lots of docs but were lacking a good taxonomy for them, do we 
have any librarians helping the docs team? (cc'ing doc to get a reply about 
this)

So let me rephrase that portage docs need to be complete and up to date at all 
times (at least an english version, devs should know enough english). Linking 
the documentation to the code is the only way I can see this happen.

 Bart.

On Monday 29 December 2003 00:02, Daniel Robbins wrote:
>
> This results in the current USE settings. I do think that not too many
> people know about auto-USE, so it is somewhat under-utilized.


--
[email protected] mailing list



Reply via email to