We forgot to describe what some of the optional keyword args do, so
update the docs for that. Also some clean of the description of the
return values to mention that these are lists.
Finally, in the first example, load hompack, so the user knows how to
get hompack_polsys.
Add -F option to force makeinfo to build the html docs
build_html.sh now supports -F to force building the html docs even if
errors are encountered by makeinfo.
This should only be used for debugging; do not enable this by default
in the Makefile. We want at least the English docs to build without
errors at all times.
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.