[petsc-dev] build of manual

[Barry Smith]

   The text processing tools automatically add hyperlinks for PETSc objects. Thus one should never put them inside something like \trl or \textbf  Just write TSAdapt and the text processing will add the hyperlink automatically 

   Barry

> On Sep 12, 2016, at 10:15 AM, Hong Zhang <hongzhang at anl.gov> wrote:
> 
> The problem is in line 5216 
> 
> \noindent\textbf{\trl{TSAdapt} basic.}
> 
> If you change the word TSAdapt (e.g. add a random character), the error would disappear. Probably it is conflicting with something else. 
> 
> Hong 
> 
>> On Sep 12, 2016, at 10:01 AM, Barry Smith <bsmith at mcs.anl.gov> wrote:
>> 
>> 
>> Run 
>> 
>> make manual.pdf LOC=${PETSC_DIR} GONULL="" 
>> 
>> and it should print the process to the screen so you see what is breaking the latex.
>> 
>>  Barry
>> 
>> 
>>> On Sep 12, 2016, at 9:54 AM, Mark Adams <mfadams at lbl.gov> wrote:
>>> 
>>> Anyone have any idea what the problem is here?
>>> 
>>> 10:51 mark/gamg-docs * ~/Codes/petsc/src/docs/tex/manual$ make manual.pdf LOC=${PETSC_DIR}
>>> /Library/TeX/texbin/pdflatex -halt-on-error manual1  > /dev/null 2>&1
>>> make: *** [manual.pdf] Error 1
>>> 
>>> I've made alldoc in PETSC_DIR. 
>>> 
>>> 
>>> On Tue, Nov 4, 2014 at 4:20 PM, Barry Smith <bsmith at mcs.anl.gov> wrote:
>>> 
>>> You need to be in the correct directory to run the make. and likely you also need the LOC=${PETSC_DIR}
>>> 
>>>> On Nov 4, 2014, at 3:15 PM, Mark Adams <mfadams at lbl.gov> wrote:
>>>> 
>>>> Thanks Barry, it does not seem to pick changes in part2.tex:
>>>> 
>>>> 16:14 mark/gamgdoc ~/Codes/petsc/docs$ make manual.pdf
>>>> make: Nothing to be done for `manual.pdf'.
>>>> 
>>>> 
>>>> On Tue, Nov 4, 2014 at 4:03 PM, Barry Smith <bsmith at mcs.anl.gov> wrote:
>>>> 
>>>>> On Nov 4, 2014, at 2:41 PM, Mark Adams <mfadams at lbl.gov> wrote:
>>>>> 
>>>>> Thanks Satish,  and I do see this in the web page:
>>>>> make alldoc LOC=${PETSC_DIR}
>>>>> 
>>>>> This takes a long time.
>>>> 
>>>>  Yes a very long time
>>>> 
>>>>> Is the workflow edit part2.tex; make alldoc … ?
>>>> 
>>>> No, once you have done the make alldoc once you can simply run make manual.pdf in the manual directory as you edit the users manual.
>>>> 
>>>>  Barry
>>>> 
>>>>> 
>>>>> 
>>>>> 
>>>>> 
>>>>> 
>>>>> 
>>>>> 
>>>>> 
>>>>> On Tue, Nov 4, 2014 at 2:52 PM, Satish Balay <balay at mcs.anl.gov> wrote:
>>>>> You'll have to do 'make alldoc1' from PETSC_DIR - or atleast
>>>>> part of it..
>>>>> 
>>>>> 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}
>>>>> 
>>>>> Satish
>>>>> 
>>>>> 
>>>>> On Tue, 4 Nov 2014, Mark Adams wrote:
>>>>> 
>>>>>> I get this error when I try to make the manual:
>>>>>> 
>>>>>> 14:47 mark/gamgdoc ~/Codes/petsc/src/docs/tex/manual$ latex manual.tex
>>>>>> This is pdfTeX, Version 3.14159265-2.6-1.40.15 (TeX Live 2014) (preloaded
>>>>>> format=latex)
>>>>>> restricted \write18 enabled.
>>>>>> entering extended mode
>>>>>> (./manual.tex
>>>>>> LaTeX2e <2014/05/01>
>>>>>> Babel <3.9k> and hyphenation patterns for 78 languages loaded.
>>>>>> 
>>>>>> [snip]
>>>>>> 
>>>>>> (/usr/local/texlive/2014/texmf-dist/tex/generic/pgf/frontendlayer/tikz/librarie
>>>>>> s/tikzlibrarytopaths.code.tex))) (../sty/verbatim.sty
>>>>>> Style-Option: `verbatim' v1.4d <91/04/24> (RmS)
>>>>>> English Documentation          <91/04/24> (RmS)
>>>>>> ) (../sty/tpage.sty) (../sty/here.sty) (../sty/anlhelper.sty)
>>>>>> (../sty/trl.sty
>>>>>> 
>>>>>> LaTeX Warning: You have requested package `../sty/trl',
>>>>>>              but the package provides `trl'.
>>>>>> 
>>>>>> )
>>>>>> 
>>>>>> ! LaTeX Error: Missing \begin{document}.
>>>>>> 
>>>>>> See the LaTeX manual or LaTeX Companion for explanation.
>>>>>> Type  H <return>  for immediate help.
>>>>>> ...
>>>>>> 
>>>>>> l.38 h
>>>>>>     yperbaseurl
>>>>>> ?
>>>>>> 
>>>>>> On Tue, Nov 4, 2014 at 2:38 PM, Barry Smith <bsmith at mcs.anl.gov> wrote:
>>>>>> 
>>>>>>> 
>>>>>>> This is not enough information to help debug your problem.
>>>>>>> 
>>>>>>>> On Nov 4, 2014, at 1:26 PM, Mark Adams <mfadams at lbl.gov> wrote:
>>>>>>>> 
>>>>>>>> I am getting errors building the manual and had to comment this out:
>>>>>>>> 
>>>>>>>> %hyperbaseurl
>>>>>>>> 
>>>>>>>> And I now get this error:
>>>>>>>> 
>>>>>>>> ! LaTeX Error: File `part1tmp.tex' not found.
>>>>>>>> 
>>>>>>>> Mark
>>>>>>> 
>>>>>>> 
>>>>>> 
>>>>> 
>>>>> 
>>>> 
>>>> 
>>> 
>>> 
>> 
>