[petsc-dev] manual pages

[Mark F. Adams]

On Apr 13, 2013, at 2:13 PM, Satish Balay <balay at mcs.anl.gov> wrote:

> alldoc1 should be invoked in PETSC_DIR
> 
> cd ~/Codes/petsc
> make alldoc1  LOC=$PETSC_DIR
> 

This seemed to have worked once, or maybe the manual.pdf was already there, but I'm not getting a manual.pdf now.  It does take a long time and does not seem to have errors.

> Satish
> 
> On Sat, 13 Apr 2013, Mark F. Adams wrote:
> 
>> I tried making alldoc1 but got these errors. I tried removing these targets w/o rules.  The tried to rung the old make command (not sure what I was supposed to do).
>> 
>> 14:06 2 madams/manual-gamg ~/Codes/petsc/src/docs/tex/manual$ make alldoc1 LOC=$PETSC_DIR
>> make: *** No rule to make target `deletemanualpages', needed by `alldoc1'.  Stop.
>> 
>> 14:07 2 madams/manual-gamg ~/Codes/petsc/src/docs/tex/manual$ make alldoc1 LOC=$PETSC_DIR
>> make: *** No rule to make target `chk_concepts_dir', needed by `alldoc1'.  Stop.
>> 
>> 14:07 2 madams/manual-gamg ~/Codes/petsc/src/docs/tex/manual$ make alldoc1 LOC=$PETSC_DIR
>> /usr/bin/python bin/maint/countpetsccits.py
>> /usr/bin/python: can't open file 'bin/maint/countpetsccits.py': [Errno 2] No such file or directory
>> make: [alldoc1] Error 2 (ignored)
>> /usr/bin/make  --no-print-directory ACTION=manualpages_buildcite tree_basic LOC=/Users/markadams/Codes/petsc
>> cd src/docs/tex/manual; /usr/bin/make  --no-print-directory manual.pdf LOC=/Users/markadams/Codes/petsc
>> make[1]: *** No rule to make target `manual.pdf'.  Stop.
>> make: [alldoc1] Error 2 (ignored)
>> cd src/docs/tex/manual; /usr/bin/make  --no-print-directory developers.pdf LOC=/Users/markadams/Codes/petsc
>> make[1]: *** No rule to make target `developers.pdf'.  Stop.
>> make: [alldoc1] Error 2 (ignored)
>> 
>> 14:08 1 madams/manual-gamg ~/Codes/petsc/src/docs/tex/manual$ make manual.pdf LOC=$PETSC_DIR
>> /opt/local/bin/pdflatex -halt-on-error manual1  > /dev/null 2>&1
>> 
>> make: *** [manual.pdf] Error 1
>> 14:09 2 madams/manual-gamg ~/Codes/petsc/src/docs/tex/manual$ 
>> 
>> 
>> On Apr 13, 2013, at 1:39 PM, Satish Balay <balay at mcs.anl.gov> wrote:
>> 
>>> set LOC to PETSC_DIR
>>> 
>>> Also - due to the depencencies withn the doc generation - you might
>>> have to do the 'alldoc1' stuff - atleast to the manualpage generation
>>> step [atleast once]
>>> 
>>> alldoc1: chk_loc deletemanualpages chk_concepts_dir
>>>       -${PYTHON} bin/maint/countpetsccits.py
>>>       -${OMAKE} ACTION=manualpages_buildcite tree_basic LOC=${LOC}
>>>       - at sed -e s%man+../%man+manualpages/% ${LOC}/docs/manualpages/manualpages.cit > ${LOC}/docs/manualpages/htmlmap
>>>       - at cat ${PETSC_DIR}/src/docs/mpi.www.index >> ${LOC}/docs/manualpages/htmlmap
>>>       -cd src/docs/tex/manual; ${OMAKE} manual.pdf LOC=${LOC}
>>>       -cd src/docs/tex/manual; ${OMAKE} developers.pdf LOC=${LOC}
>>> 
>>> Satish
>>> 
>>> On Sat, 13 Apr 2013, Mark F. Adams wrote:
>>> 
>>>> I'm trying to add a GAMG section to the manual and am having problems building it:
>>>> 
>>>> 13:15 2 madams/manual-gamg ~/Codes/petsc/src/docs/tex/manual$ make manual.pdf LOC=/var/tmp            
>>>> 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: /var/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: /var/tmp/docs/manualpages/htmlmap
>>>> 
>>>> make: [manual.pdf] Error 1 (ignored)
>>>> /opt/local/bin/pdflatex -halt-on-error manual1  > /dev/null 2>&1
>>>> 
>>>> bibtex manual1 > /dev/null 2>&1
>>>> make: [manual.pdf] Error 2 (ignored)
>>>> /opt/local/bin/pdflatex -halt-on-error manual1  > /dev/null 2>&1
>>>> 
>>>> /opt/local/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
>>>> 
>>>> 
>>>> Clearly I'm not using LOC correctly ….
>>>> 
>> 
>>