Manual Building issues

[BdN3504]

I can build the manual using svn and miktex/texnic (a windows latex environment) but the index is missing and the references don't work ('??' is shown instead of pagenumbers). i've never been able to get it working with svn but miktex gave me good results until one or two days ago. i was told to download some odd colours.sty file i think and since then i can't get the manual to build on either platform. to be more precise: the file i am asked to install is xcolor.sty. what is this?

[Llorean]

Why aren't you building the manual the way it's supposed to be built?

If you're looking for help for some third party tool, why aren't you asking the providers of it?

[BdN3504]

erm, since when is using the svn (../tools/configure;M) third party?
anyhow, i got it to build with my vm. i forgot to execute 'texhash' after the installation. so if you run into some kind of '*.sty file not found' error just search for that file on the web, put it in the latex folder (the exact locations are mostly always mentioned in the read me files for the corresponding packages) and simply type 'texhash'.

[AlexP]

xcolor is a package that we are now using to auto-colour the rows in tables.  It is a latex package, and nothing to do with the manual sources or configuring the build in SVN.

[GodEater]

..and building with "miktex/texnic (a windows latex environment)" is what Llorean meant by "third party tool". It's not what the manuals which are made available for download are built in.

That being said, if you *do* have an alternative way to build the manual on windows, why not document it and put it in the wiki? I'm sure it'd prove useful to some folks who are scared by linux and cygwin

[BdN3504]

it's somewhat complicated and doesn't work without linux  i first build a manual using "make manual". this gives me the output files which lack references etc. i then take the "rockbox-build.tex" file, open it with texnic, compile it et voilà i got the manual with references.
i got myself miktex after reading the manualhowto wiki Windows native.

[AlexP]

it's somewhat complicated and doesn't work without linux  i first build a manual using "make manual". this gives me the output files which lack references etc. i then take the "rockbox-build.tex" file, open it with texnic, compile it et voilà i got the manual with references.

I'm confused - if you have got as far as make manual under linux then you have the manual - it is all done, you have the pdf.  Why are you then building it again in a complicated way in Windows?

[BdN3504]

I can build the manual using svn but the index is missing and the references don't work ('??' is shown instead of pagenumbers).

[AlexP]

I can build the manual using svn

Using SVN means nothing here - you are not building anything using SVN.  You are using the sources held in SVN.  SVN is a version control system, not a way of constructing pdfs from a tex source.  Therefore this statement is useless.  Did you mean that you were building the manual using tetex or texlive in linux?

If so, then the real answer would be to find out why this doesn't work for you but does for everyone else, not to introduce another load of tools into the equation.  Given your complete misuse of the terms, I think it is not unsurprising I am a little confused about what you have done.

[BdN3504]

let me break it down:
i am using the debian vmwware image. i choose manual in the ../tools/configure dialogue. i get a make file. i "make manual". i get a pdf file, and several .tex files in the build folder. when i open the pdf file in that folder, i can read the manual but the page/section references all show up as ??. so i tried to go a different route and downloaded miktex and texniccenter, which were mentioned in the wiki. i then opened the rockbox-build.tex which i got by the "make manual" command and compile it in texniccenter. then i get a pdf file that is working (i.e. has working references).

[AlexP]

Thank you, that is finally clear.

The question now should be what is the image missing that means the manual doesn't build properly.  Which image did you download?  This one?:

http://forums.rockbox.org/index.php?topic=21010.0

I see you were active in this thread, and the only person that replied having tried manual builds had no issues.

[BdN3504]

i am using the "old" image. you think it'll work with the one in that thread?

[AlexP]

I haven't tried it personally, but the one person in that thread that tried it said it worked.

I wouldn't be surprised if the old one has some missing/outdated packages - did you try updating it?

[BdN3504]

no, i did not directly update it with "apt-get update" or "apt-get upgrade" but i installed utf-8 suppport and mingw. i'll try manual building with the new image in a few moments, will report back if it's not working.

[bluebrother]

i get a pdf file, and several .tex files in the build folder.

Then building the manual itself is working.

when i open the pdf file in that folder, i can read the manual but the page/section references all show up as ??.

This simply means that the sources haven't been LaTeX'ed often enough to resolve the references. That's somewhat strange as the Makefile takes care about this. You should check if the LaTeX run that is actually running is the only one -- probably some error occurs which makes the make run stop after the first invocation.

And copying a file around and building with a differen LaTeX version is neither a good idea nor a solution. Posting a complete log to some pastebin site might help.