[petsc-dev] make documentation

[Jakub Kruzik]

Works fine. Thanks for such a quick fix :)

Jakub


On 16.1.2017 17:26, Satish Balay wrote:
> Thanks for the report! I think the following might be the fix - will check and push.
>
> Satish
>
> --------
>
> $ git diff |cat
> diff --git a/lib/petsc/conf/rules b/lib/petsc/conf/rules
> index 7cd30a5..eebcfe7 100644
> --- a/lib/petsc/conf/rules
> +++ b/lib/petsc/conf/rules
> @@ -585,29 +585,29 @@ chk_mansec:
>           fi
>   
>   chk_manualpage_dir:
> -	@if [ "${SUBMANSEC}" == "" ] ; then SUBMANSEC=${MANSEC}; else SUBMANSEC=${SUBMANSEC}; fi; \
> -         if [ ! -d "${LOC}/docs/manualpages/${SUBMANSEC}" ]; then \
> -	  echo Making directory ${LOC}/docs/manualpages/$${SUBMANSEC} for library; ${MKDIR} ${LOC}/docs/manualpages/$${SUBMANSEC}; fi
> +	@if [ "${SUBMANSEC}" = "" ] ; then LMANSEC=${MANSEC}; else LMANSEC=${SUBMANSEC}; fi; \
> +         if [ ! -d "${LOC}/docs/manualpages/$${LMANSEC}" ]; then \
> +	  echo Making directory ${LOC}/docs/manualpages/$${LMANSEC} for library; ${MKDIR} ${LOC}/docs/manualpages/$${LMANSEC}; fi
>   
>   manualpages_buildcite: chk_manualpage_dir
>   	@-if [ "${MANSEC}" != "" ] ; then \
> -          if [ "${SUBMANSEC}" == "" ] ; then SUBMANSEC=${MANSEC}; else SUBMANSEC=${SUBMANSEC}; fi; \
> +          if [ "${SUBMANSEC}" = "" ] ; then LMANSEC=${MANSEC}; else LMANSEC=${SUBMANSEC}; fi; \
>             DOCTEXT_PATH=${PETSC_DIR}/src/docs/tex/doctext; export DOCTEXT_PATH; \
>   	  TEXTFILTER_PATH=${PETSC_DIR}/src/docs/tex/doctext; export TEXTFILTER_PATH; \
> -          ${DOCTEXT} -html -indexdir ../$${SUBMANSEC} \
> +          ${DOCTEXT} -html -indexdir ../$${LMANSEC} \
>   		-index ${LOC}/docs/manualpages/manualpages.cit \
> -		-mpath ${LOC}/docs/manualpages/$${SUBMANSEC} ${SOURCED};  fi
> +		-mpath ${LOC}/docs/manualpages/$${LMANSEC} ${SOURCED};  fi
>   #
>   #
>   manualpages:
>   	- at if [ "${MANSEC}" != "" ] ; then \
> -          if [ "${SUBMANSEC}" == "" ] ; then SUBMANSEC=${MANSEC}; else SUBMANSEC=${SUBMANSEC}; fi; \
> +          if [ "${SUBMANSEC}" = "" ] ; then LMANSEC=${MANSEC}; else LMANSEC=${SUBMANSEC}; fi; \
>             DOCTEXT_PATH=${PETSC_DIR}/src/docs/tex/doctext; export DOCTEXT_PATH; \
>   	  ${DOCTEXT} -html \
> -		-mpath ${LOC}/docs/manualpages/$${SUBMANSEC} -heading PETSc \
> +		-mpath ${LOC}/docs/manualpages/$${LMANSEC} -heading PETSc \
>   		-defn ${PETSC_DIR}/src/docs/tex/doctext/html.def \
>   		-locdir ${LOCDIR} -mapref ${LOC}/docs/manualpages/manualpages.cit ${SOURCED};\
> -		chmod -f g+w ${LOC}/docs/manualpages/$${SUBMANSEC}/* ; fi
> +		chmod -f g+w ${LOC}/docs/manualpages/$${LMANSEC}/* ; fi
>   #
>   #   Example usage for manual pages; adds each example that uses a function to that functions
>   # manual page up to a limit of 10 examples.
>
>
> On Mon, 16 Jan 2017, Jakub Kruzik wrote:
>
>> Dear all,
>>
>> I have a problem with the documentation on the updated master branch.
>>
>> The problem is in chk_manualpage_dir makefile rule (called by make alldoc1).
>> It fails to create $LOC/docs/manualpages/${SUBMANSEC} directories for some
>> sections.
>>
>> Even some manual sections for pestc-dev branch are missing e.g.
>> http://www.mcs.anl.gov/petsc/petsc-dev/docs/manualpages/Vec/index.html
>>
>>
>> I believe the problem is in 1b266c9 (
>> https://bitbucket.org/petsc/petsc/commits/1b266c996c0ee2177e49587321b28ae9c622ce9a#chg-lib/petsc/conf/rules
>> ), the parent ( 3b494cf ) works OK.
>>
>>
>> Best,
>>
>> Jakub
>>
>>
>> Part of the error output:
>>
>> --------
>>
>> manualpages_buildcite in: /opt/petsc/petsc/src/vec/vec/utils
>> if [ "" == "" ] ; then SUBMANSEC=Vec; else SUBMANSEC=; fi; \
>>           if [ ! -d "/opt/petsc/petsc/docs/manualpages/" ]; then \
>>    echo Making directory /opt/petsc/petsc/docs/manualpages/${SUBMANSEC} for
>> library; /usr/bin/mkdir -p /opt/petsc/petsc/docs/manualpages/${SUBMANSEC}; fi
>> if [ "Vec" != "" ] ; then \
>>            if [ "" == "" ] ; then SUBMANSEC=Vec; else SUBMANSEC=; fi; \
>>            DOCTEXT_PATH=/opt/petsc/petsc/src/docs/tex/doctext; export
>> DOCTEXT_PATH; \
>>    TEXTFILTER_PATH=/opt/petsc/petsc/src/docs/tex/doctext; export
>> TEXTFILTER_PATH; \
>>            /opt/petsc/petsc/llvm-debug/bin/doctext -html -indexdir
>> ../${SUBMANSEC} \
>>          -index /opt/petsc/petsc/docs/manualpages/manualpages.cit \
>>          -mpath /opt/petsc/petsc/docs/manualpages/${SUBMANSEC} vinv.c
>> vscat.c vpscat.c vecio.c comb.c vecstash.c vecmpitoseq.c vecs.c vsection.c
>> projection.c  vpscat.h;  fi
>> Could not open output file
>> /opt/petsc/petsc/docs/manualpages/Vec/VecStrideSet.html
>> Reason: No such file or directory
>>
>> --------
>>
>> ls /opt/petsc/petsc/docs/manualpages/Vec
>> ls: cannot access '/opt/petsc/petsc/docs/manualpages/Vec': No such file or
>> directory
>>
>>
>>