[petsc-dev] htmlmapfile error when building the manual

[Satish Balay]

Its best to grab the autogenerated manual from our website

i.e check https://www.mcs.anl.gov/petsc/developers/index.html
https://www.mcs.anl.gov/petsc/petsc-dev/docs/index.html

The document generation is a pretty complex process with lots of
dependencies. The best way to do this is to do 'make alldoc' at
the toplevel - which generates all the PETSc documentation in
the correct order.

[and this requires a bunch of linux doc tools and even matlab :(]

Satish

On Wed, 17 Oct 2012, Milad Fatenejad wrote:

> Hello:
> 
> My name is Milad Fatenejad, I am working with PETSc as part of the Plasma
> Surface Interaction (PSI) SciDAC project. I was encouraged to begin by
> using PETSc from the mercurial repository. I have cloned the repository and
> everything has been working fine. However, I have been unable to build the
> latex documentation and was hoping to get some help. So far, I entered the
> src/docs/tex/manual and tried "make manual.pdf LOC=/tmp" and got an error
> about not being able to open the htmlmap-file (see below). Am I doing
> something wrong? Does the LOC option have to be set to some specific
> location?
> 
> Thanks for your help!
> Milad
> 
> >>> make manual.pdf LOC=/tmp
> make[1]: Entering directory
> `/home/milad/petsc/petsc-dev/src/docs/tex/manual'
> make[1]: Leaving directory `/home/milad/petsc/petsc-dev/src/docs/tex/manual'
> Traceback (most recent call last):
>   File "../../../../bin/maint/mapnameslatex.py", line 204, in <module>
>     raise RuntimeError('Unable to open htmlmap-file: '+htmlmapfile+'\n')
> RuntimeError: Unable to open htmlmap-file: /tmp/docs/manualpages/htmlmap
> 
> make: [manual.pdf] Error 1 (ignored)
> Traceback (most recent call last):
>   File "../../../../bin/maint/mapnameslatex.py", line 204, in <module>
>     raise RuntimeError('Unable to open htmlmap-file: '+htmlmapfile+'\n')
> RuntimeError: Unable to open htmlmap-file: /tmp/docs/manualpages/htmlmap
> 
> make: [manual.pdf] Error 1 (ignored)
> /usr/bin/pdflatex -halt-on-error manual1  > /dev/null 2>&1
> bibtex manual1 > /dev/null 2>&1
> make: [manual.pdf] Error 2 (ignored)
> /usr/bin/pdflatex -halt-on-error manual1  > /dev/null 2>&1
> /usr/bin/pdflatex -halt-on-error manual1  > /dev/null 2>&1
> makeindex manual1  > /dev/null 2>&1
> /bin/mv part2tmp.tex tmp
> grep -v "end{theindex}" tmp > part2tmp.tex
> make: *** [manual.pdf] Error 1
>