[petsc-dev] manual pages

[Satish Balay]

alldoc1 should be invoked in PETSC_DIR

cd ~/Codes/petsc
make alldoc1  LOC=$PETSC_DIR

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 ….
> >> 
> 
>