Docs: Generate MyST (.md) files instead of .html for man pages

Use a new version of Sowing doctext that accepts the -myst flag.

We use a mostly-duplicated local myst.def here.

Split the copying of

Docs: Generate MyST (.md) files instead of .html for man pages

Use a new version of Sowing doctext that accepts the -myst flag.

We use a mostly-duplicated local myst.def here.

Split the copying of the classic docs into a "pre" and "post" stage,
now accepting a destination argument, so that .md manualpage files
may be copied at the start of the Sphinx build.

Change -html to -myst in the manualpages target.

Remove the manualpages_buildcite target entirely, as we
remove the -mapref argument from the manualpages target.
Now the .cit file is generated during a single run of doctext and
converted to htmlmap, which is used to create man pages links with the
custom Sphinx extension.

Remove the add_version_header.py script, which leaves a few classic
HTML pages without a version, but this feature was mainly for the man
pages, which now have the same version information at the bottom as
all the Sphinx-generated pages.

This commit does not address further required changes:
- index.html pages auto-generated in the docs/manualpages/ tree have not been converted to .md
- Man page postprocessing stages have not been updated to operate on .md instead of .html and will thus fail

show more ...

Merge branch 'barry/2022-04-15/add-manpages-hseti-etc' into 'main'

Automatically create manual pages for hash table objects created with PETSC_HASH_SET()

See merge request petsc/petsc!5129

Automatically create manual pages for hash table objects created with PETSC_HASH_SET()

Previous documention was not intuitive since it did not match the names in the source code usage

Identical cha

Automatically create manual pages for hash table objects created with PETSC_HASH_SET()

Previous documention was not intuitive since it did not match the names in the source code usage

Identical changes for documentation for PETSC_HASH_MAP objects must be made. I will do it once this MR is accepted so that the process will be quick and easy.

Commit-type: documentation, usability
/spend 2.5h

show more ...

Merge branch 'barry/2022-04-01/fix-petsc-options-begin-end/release' into 'main'

Remove bogus error returns from Begin/End() macros

See merge request petsc/petsc!5069

Remove contrib directory to remove PETSc fun3d

Just not worth the hassle to maintain

/spend 5m

Merge remote-tracking branch 'origin/release'

Merge branch 'psanan/docs-remove-concepts' into 'release'

Docs: remove Concepts

See merge request petsc/petsc!5065

Docs: remove concepts

Merge branch 'balay/doc-fixes' into 'main'

doc fixes

See merge request petsc/petsc!5028

doc fixes

CI get 'manualpages.err' on stdout

sed: -e expression #1, char 34: Invalid range end
Error! No level info in file:
Could not open raja.c

Merge branch 'balay/fix-doc' into 'main'

CI: update target 'manualpages' to abort on error - and fix all doc issues

See merge request petsc/petsc!4979

docs build: update target 'manualpages' to abort on error

Merge branch 'balay/fix-error.log' into 'main'

build: switch from looking for 'error' string to identify build failure to checking errorcode

See merge request petsc/petsc!4926

build: switch from looking for 'error' string to identify build failure to checking errorcode

This fixes false positive string match with ' error ' string in warnings

/opt/rocm-5.0.0/rocthrust/incl

build: switch from looking for 'error' string to identify build failure to checking errorcode

This fixes false positive string match with ' error ' string in warnings

/opt/rocm-5.0.0/rocthrust/include/thrust/system/hip/memory_resource.h:59:17: warning: ignoring return value of function declared with 'nodiscard' attribute [-Wunused-result]
hipGetLastError(); // Clear the HIP global error state.

show more ...

Merge remote-tracking branch 'origin/release'

Merge branch 'barry/2021-06-09/petsc-test-options' into 'release'

Organized the PETSC_OPTIONS used in .gitlab-ci.yml to be provided by the appropriate package

See merge request petsc/petsc!4075

fix 'make check'

Merge remote-tracking branch 'origin/release'

Merge branch 'psanan/docs-remove-deleted-script-call' into 'release'

Docs: remove calls to deleted update-docs.py script

See merge request petsc/petsc!4488

Docs: remove calls to and mentions of deleted update-docs.py script

Merge remote-tracking branch 'origin/release'

Merge branch 'psanan/docs-migrate-classic-to-doc-tree' into 'release'

Migrate data for classic build from src/docs to doc/classic

See merge request petsc/petsc!4434

Merge branch 'psanan/docs-remove-top-level-makefile-sphinx-targets' into 'release'

Docs: remove "alldoc" and all Sphinx-related targets from top-level makefile

See merge request petsc/petsc!4468

Docs: migrate data for classic build from src/docs to doc/classic

Docs: remove "alldoc" and all Sphinx-related targets from top-level makefile

These targets are not used by the CI, the website deployment, or the
instructions for building the local docs, so remove

Docs: remove "alldoc" and all Sphinx-related targets from top-level makefile

These targets are not used by the CI, the website deployment, or the
instructions for building the local docs, so remove them to reduce
maintenance burden and overall complexity.

show more ...