Re: [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:
        -@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