On Tue, 2013-12-03 at 11:43 +0100, Alexander Berntsen wrote: > On 03/12/13 11:21, Sebastian Luther wrote: > > The problem with all these variables is that we don't maintain > > them. If they disappear, change meaning or new ones are added we > > constantly have to fix our documentation. > I don't think this is a problem. I could fix any documentation bugs > related to this. > > > The python team's documentation [1] is just fine imo. Maybe this > > one needs to be more user visible? Maybe by linking it into the > > handbook (if it isn't already)? > It could be linked in the man page of make.conf as well. > > > Ultimately my stance is that it should be in the man page. I can add > them myself. However, I will leave it out if more people agree with > Sebastian than me.
I think a good compromise is to use python_targets as an example under a general use expand heading, explaining how use expand works. Add the link to the python doc, yes Then simply mention to look for the relevant docs for details of any of the other use expand variables. And a pointer to the gentoo docs index. I think python_targets is too central to a gentoo system to be completely ignored in the man pages.
signature.asc
Description: This is a digitally signed message part
