Summary: | texlive 2007 documentation | ||
---|---|---|---|
Product: | [OLD] Docs on www.gentoo.org | Reporter: | Alexis Ballier <aballier> |
Component: | New Documentation | Assignee: | TeX project <tex> |
Status: | RESOLVED FIXED | ||
Severity: | enhancement | CC: | Martin.vGagern |
Priority: | High | ||
Version: | unspecified | ||
Hardware: | All | ||
OS: | Linux | ||
Whiteboard: | |||
Package list: | Runtime testing required: | --- | |
Attachments: |
guidexml file
update before I forget |
Description
Alexis Ballier
2007-11-04 16:11:08 UTC
Created attachment 135158 [details]
guidexml file
Looks nice to me. A few suggestions: . drop link="/doc/en/guide.xml", not required, and it's not going to be called guide.xml anyway :) . file/dir path names go inside <path>, not <c> . drop the colour coding in <pre>, just use <i> for what the user types, leave the rest as plain text Destination: if it can't go somewhere under /proj/en/ it'll go under /doc/en/ but we'll need your help to maintain it and you'll need our help to commit it :) Created attachment 135180 [details]
update before I forget
I cant find any suitable place in proj/en for this, tex doesnt have a project page neither does the old text-markup afaik...
(In reply to comment #3) > I cant find any suitable place in proj/en for this, tex doesnt have a project > page neither does the old text-markup afaik... *shrug* so create a project? you can do that, you know. you could ask the X/desktop guys if you wanted it to be a subproject of their stuff. your call. this is definitely project-specific information, so it should have a home somewhere in /proj/ (In reply to comment #4) > (In reply to comment #3) > > I cant find any suitable place in proj/en for this, tex doesnt have a project > > page neither does the old text-markup afaik... > > *shrug* so create a project? well... the split happened before my time, and I was too lazy to do the "administrative" stuff of gathering information of who is in, who is not, announcing it, etc to create a project. However, this is probably the best idea. > you could ask the > X/desktop guys if you wanted it to be a subproject of their stuff. your call. it could arguably be put under desktop project also, but I see it at the same level as other languages (python/perl/php/java/etc) > this is definitely project-specific information, so it should have a home > somewhere in /proj/ agreed nevertheless, this does not remove the need of this to be reviewed and proof checked ;) proof checking has been done by several people as far as I know, but english might not be perfect for example. I had a dead symlink /usr/share/texmf/doc which wasn't mentioned in the manual. Maybe you want to include that as well. (In reply to comment #6) > I had a dead symlink /usr/share/texmf/doc which wasn't mentioned in the manual. > Maybe you want to include that as well. > Do you know what had created it ? what was it pointing to ? (In reply to comment #7) > Do you know what had created it ? what was it pointing to ? I'm not 100% sure, but I believe it was pointing to ../tetex-${PV} or some subdirectory of this. So I'd say it would have to be some tetex ebuild. Probably due to line 218 of tetex.eclass which says "ln -s ../doc/${PF} doc" (In reply to comment #8) > (In reply to comment #7) > > Do you know what had created it ? what was it pointing to ? > > I'm not 100% sure, but I believe it was pointing to ../tetex-${PV} or some > subdirectory of this. So I'd say it would have to be some tetex ebuild. > Probably due to line 218 of tetex.eclass which says "ln -s ../doc/${PF} doc" > well this is done in src_install so I suppose portage should have removed it when unmerging tetex |