Squashed commit of the following:
commit f8567caf8e42d9aaa108e9aadaa49a0d48b1da08
Merge: 4e0d6b21c 3e3b80508
Author: Raymond Toy <email address hidden>
Date: Tue Sep 20 16:52:28 2022 -0700
Merge branch 'master' into rtoy-html-docs-for-langs
commit 4e0d6b21c297a5e1f66c159586d37e5b209b38e2
Merge: 1840d1315 dfbf5c2fd
Author: Raymond Toy <email address hidden>
Date: Mon Sep 19 15:50:00 2022 -0700
Merge branch 'master' into rtoy-html-docs-for-langs
commit 1840d13151b0931c05eb1fa6861bf047ed62d9b6
Author: Raymond Toy <email address hidden>
Date: Mon Sep 19 14:13:10 2022 -0700
Use @GREP@ to get the configured grep
Also add -q to silence any output.
commit 3cdf7d48d75dea16b74add2a39945fda5d924742
Author: Raymond Toy <email address hidden>
Date: Mon Sep 19 11:58:54 2022 -0700
Undefine category macros for Russian manual.
Currently the Russian manual includes parts of the English manual
which uses the category macros. But categories aren't currently working for
the Russian manual (many missing @refs). To work around this, replace
the category macros with macros that do nothing.
We also need build_html.sh to add the --force option to makeinfo so
that the docs will be made despite the errors. This is better than
nothing until we get this all sorted out.
commit 0d51fdfdeb6d9ad51618b61f76e5483ebbbc34be
Author: Raymond Toy <email address hidden>
Date: Mon Sep 19 11:55:40 2022 -0700
Add marker to indicate doc categories section is included.
Add the line
@c Include documenation categories
to the maxima.texi files where documentation categories are
supported. Currently this is just the English and German manuals.
Update build_html.sh.in to look for this marker which then allows the
script to insert commands to include all the category files.
commit e01a9ebf460719216ccd4afa040db9cf19a0e6ad
Author: Raymond Toy <email address hidden>
Date: Mon Sep 19 11:52:47 2022 -0700
Remove documentation categories section if lang has none
These translations of the manual have no documentation categories
implemented, so don't include the (empty) section for the
documentation categories.
commit 5c42ca5af36d5472aa9ee4b002aff21075926d9a
Author: Raymond Toy <email address hidden>
Date: Sun Sep 18 15:11:32 2022 -0700
Actually exit with the exit code from makeinfo if it fails.
We were correctly detecting that makeinfo failed, but were exiting
with a code of 0 (no error) instead. Save the exit code from makeinfo
and use that for the exit code.
commit 54ad7340aeb622cd3b321edb3fbfc5a6f4b2c586
Author: Raymond Toy <email address hidden>
Date: Sun Sep 18 15:08:41 2022 -0700
Need to include dlmf-ref-macros.texi
These files need acces to the DLMF and A&S cross-reference macros.
commit 5e638a38c78ffae6956ad61fbd9ac923bf513328
Author: Raymond Toy <email address hidden>
Date: Sun Sep 18 15:07:54 2022 -0700
Clean up old stuff and add some comments
Remove the "DEBUG=yes" that was added for debugging.
Add some comments on what we're trying to do with the automatic
documentation categories stuff, modifing maxima.texi.
commit 736cfe906bb10a0e811f3a72ca1fe6cb870ccfad
Author: Raymond Toy <email address hidden>
Date: Sun Sep 18 15:06:36 2022 -0700
Add new file dlmf-ref-macros.texi
This file contains the macros for cross-referencing DLMF and A&S. It
needs to be included in include-maxima.texi.in to define the macros.
Currently, only the English and Russian docs need this; the other
languages don't currently have cross-references to DLMF and A&S.
commit c704fda45b1add8bd3ea77abedc0d19680f74297
Author: Raymond Toy <email address hidden>
Date: Sun Sep 18 13:50:24 2022 -0700
Define the documentation category and index nodes for English
commit 7b100986d1c851c54ec0c787ecec4c7847cc94c4
Author: Raymond Toy <email address hidden>
Date: Sun Sep 18 13:49:52 2022 -0700
Define the documentation category and index nodes for Russian
commit 44c33036b44f8ebd6196fb36f98e2ed7b7899d9a
Author: Raymond Toy <email address hidden>
Date: Sun Sep 18 13:49:46 2022 -0700
Define the documentation category and index nodes for Brazilian Portuguese
commit da9881591625641a9525e6f8f68cabb5f797da99
Author: Raymond Toy <email address hidden>
Date: Sun Sep 18 13:49:34 2022 -0700
Define the documentation category and index nodes for Portuguese
commit b8d1a038e148fc555b75ff6be435fcfc851e3085
Author: Raymond Toy <email address hidden>
Date: Sun Sep 18 13:47:46 2022 -0700
Define the documentation category and index nodes for Japanese
commit 11f8f8b1d67083356d11677db628adb0e75bb272
Author: Raymond Toy <email address hidden>
Date: Sun Sep 18 13:47:36 2022 -0700
Define the documentation category and index nodes for Spanish.
commit ceecb95e84a6e097a2e0729fb540f982eab79db0
Author: Raymond Toy <email address hidden>
Date: Sun Sep 18 13:47:27 2022 -0700
Define the documentation category and index nodes for German.
commit 15bd3067a7396d07b27b0186ad6aed933262cf17
Author: Raymond Toy <email address hidden>
Date: Sun Sep 18 13:46:44 2022 -0700
If makeinfo fails, exit build_html.sh
If makeinfo fails to build in build_html.sh, exit the script with an
error code from makeinfo so that make will stop building the docs.
This will make it obvious that something needs to be fixed so that we
can build the html docs.
Previously, the build didn't stop and it was hard to notice something
bad happened.
Also, we were inserting a section for the documentation categories,
assuming the previous node was named "Function and Variable Index".
Of course, this is incorrect for most other languages. This will be
done in the <lang>/maxima.texi file with the correct language-specific
node name.