[petsc-dev] make documentation

[Satish Balay]

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