I've been writing a small guide that explains how we handle texlive, how to migrate to it etc. Now that I've found the time to add the last section (aka common errors), I think it's worth making it an official guide. However, I have no clue where to put it :/ I'll gladly accept any suggestion. Reviewing it will also not hurt, be it due to my poor english or that I dont know well guidexml. It should be ok wrt doc team policy, but I might have missed a few rules; if that's the case, please point me them. Also I'm not an experienced doc writer, so comments are welcome on the organisation of the document & cie.
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
http://www.gentoo.org/proj/en/tex/texlive-migration-guide.xml