to the Global Module Index for a set of documents. This is used to include
a reference to the global index from the per-document module indexes, so
that it is just a little easier to find.
(Someone suggested this, but I do not remember who. Please let me know if
it was you -- thanks!)
scope to be " (in module <name>)" instead of
" (in <name>)" to be consistent with \withsubitem
usage throughout the documentation. This achieves
consistency in indexing throughout the documentation.
whatever is being documented, not necessarily Python. (These tools are
also used for the How-To documents, etc.)
get_version_text(): New function. Returns HTML fragment describing the
software version and documentation date.
bot_navigation_panel(): Include the result of get_version_text() at the
end, so the information is available on every page.
definition provided by previously loaded configuration code, and
testing whether it's defined isn't needed since the default was
false anyway.
get_link_icon(): Add support for $OFF_SITE_LINK_ICON_HEIGHT and
$OFF_SITE_LINK_ICON_WIDTH, giving the dimensions of the icon
being used. This can make for faster page display. Both are
optional.
make_my_titlegraphic(): Fix insertion of the off-site icon link.
do_env_funcdesc(): Remove debugging print.
handle_rfclike_reference(): Remove trailing colon from first line; it
doesn't really make sense and looks bad if we add an icon to
mark off-site links.
into a usable filename using $ICONSERVER and
$IMAGE_TYPE as needed.
get_link_icon(): Function to examine a URL and return the string to use
to insert an icon if the link points off-site, if needed
and $OFF_SITE_LINK_ICON is set.
Adjusted appropriate places to use these new functions.
use_italics(): Remove both functions, inlining use_italics() at its
only call site.
init_myformat(): Uncomment line so that some internal markup does not
get generated, since it is not properly removed later.
(Fix on aspect of SourceForge bug #114749.)
Modified call to process_commands_wrap_deferred(), removing \code from
the list since it had a bad interaction with other changes in some contexts.
do_cmd_setshortversion(): Implementation for new markup.
convert_args(): New helper function.
do_cmd_optional(): Modified to understand when it is called from within
a convert_args() invocation.
do_env_funcdesc(),
do_env_funcdescni(),
do_cmd_funcline(),
do_cmd_funclineni(),
handle_classlike_descriptor(),
do_env_methoddesc(),
do_end_methoddescni(),
do_cmd_methodline(),
do_cmd_methodlineni(): Modified to use helper convert_args().
The convert_args() helper and related changes fix the generation of HTML
for the \optional markup, so that bogus </var>...<var> is not generated.
This closes SourceForge bug #113800.
Update processing of module synopsis tables (found at the beginning of
most chapters of the library reference) to reflect changes in the
processing pattern of recent versions LaTeX2HMTL. Requires most
recent change to SynopsisTable.pm.
This does not fix the module index problem.
generated markup.
Don't be careless with the navigation icons! We should use the blank
icon where there is not anyplace to go for a particular position in the
navigation bar.
do_cmd_unspecified(): New functions to reflect previously unused markup.
do_cmd_file(): Simplified generated markup to only make use of the
existing stylesheet.
do_cmd_makevar(): Make the markup more stylesheet-friendly.
get_rfc_url(): New function; returns the URL for a numbered IETF RFC.
do_cmd_rfc(): Use get_rfc_url() instead of hard-coding in the HTML
formatting.
do_cmd_seerfc(): New function.
do_env_definitions(): Small change to avoid "local".
do_cmd_citetitle(): New function. Extracts one optional and one
required parameter. If the optional one is
provided, it is used a URL (or relative URL) and
the text of the required parameter is turned into
a hyperlink.
supplemental l2h initialization file it creates and still get all the
right behavior. In particular, it can change the image type and icon
location and not get inconsistent results.
Some code to help suppress various navigational pages; this might be
interesting when generating HTML to create HTML Help documents, since
the navigation support creates confusing hits in the full text
search. HTML Help also provides a lot of the navigational
infrastructure, so duplicating it makes it more tedious to use.
l2hinit.perl version of the function (which
overrode a version in latex2html), but
do_cmd_index() was overridden. Since
do_cmd_index() was the only caller, we can trash
this.
define_indexing_macro(): New function used during setup to support
more dynamic dispatch for indexing.
process_index_macros(): New function; implement dynamic dispatching
of indexing support functions, allowing many
targets used in indexing to be shared by
multiple index entries. I.e., something like
\index{foo}\bifuncindex{bar} can now share a
single target anchor.
These indexing changes reduce the amount of clutter in the generated
HTML files. In the reference manual, this cuts the number of targets
by 44%. Targets are less affected when generated by environments
rather than macros.
Fred Drake