Commit Graph

213 Commits

Author SHA1 Message Date
Fred Drake b02f0dfbe9 - Committing the modified signature lines I've been using for a long
time in http://www.python.org/dev/doc/.  There have been no bug
  reports on these for a long time now.
- Remove local "use" statement that duplicates a top-level "use".
2002-11-13 19:16:37 +00:00
Fred Drake 4400509aaa Add \funcline, \funclineni, and \methodlineni to the list of functions
that are processed before their arguments.
Closes SF bug #637807.
2002-11-13 17:55:17 +00:00
Fred Drake 2394900a55 Still more magical <link> elements. 2002-10-30 21:51:18 +00:00
Fred Drake dbb2b9d77e Hackish way to generate an up-<link> for the title page if we have
one.

Added misc. comments.
2002-10-30 21:38:32 +00:00
Fred Drake 0e2e687ba0 Minor rearranging. 2002-10-30 19:55:23 +00:00
Fred Drake dd3d6a03c0 Add support for using a "favicon".
make_head_and_body():  Re-arranged to do (slightly) less work for each page.
2002-10-30 17:00:58 +00:00
Fred Drake 73c5b6602d Clean up some really minor Perl warnings. 2002-10-24 16:36:05 +00:00
Fred Drake 15a159c231 Change the default path to icons so that "mkhowto" does the "right thing" by
default when used for 3rd-party docs.  This requires the standard Python docs
to specify a location, but they are a bit of a special case in sharing one set
of icons among several documents.
2002-10-01 15:20:20 +00:00
Fred Drake 4837fa3a54 \productioncont: Replace leading spaces with &nbsp; so that it's
possible to control the indentation of continuation lines.

cfuncline_helper():  Only mark the argument names are <var>, not the
    whole argument list.  This leaves the argument types in the same
    font as the return type.  Based on a casual suggestion from
    Guido.
2002-06-18 18:30:28 +00:00
Fred Drake f6e902717e Refactor the generation of signature lines for funcdesc, methoddesc,
and friends.  This was part of the changes to the presentation of
signature lines, but does not include any of the aspects that people
questioned.
2002-06-18 18:24:16 +00:00
Fred Drake 6fc22f6c3d Ensure \verbatiminput always uses a unique filename for each input file in
the "Download as text" link.  Previously, it could map multiple source files
to a single name since all files end up with the same extension.
This closes SF bug #558279.
2002-06-17 15:01:05 +00:00
Fred Drake f547863c63 Use Perl function prototypes to help avoid definition/usage mismatches
while modifying these files.
Minor style changes to make the use of "my" with arrays more consistent.
2002-05-23 17:59:16 +00:00
Fred Drake 34adb8a8ec Separate out a \cfuncline macro from the cfuncdesc environment.
This matches many other of the *desc environments, and is useful when
multiple functions share a description.
2002-04-15 20:48:40 +00:00
Fred Drake 0157276cf8 Generate the right annotations in the index entries.
Thanks to Thomas Heller for the sharp eye.
2002-04-15 19:35:29 +00:00
Fred Drake 8a5e6790d9 Clean up the application of style to verbatim text.
This moves styling to the stylesheet; the use of <dl> structures to control
style sometimes produced improper indentation of subsequent text in many
browsers when the text was already part of the <dl> structure (as in a
function or class description).
2002-04-15 18:41:31 +00:00
Fred Drake eeb5ec42e0 Add support for \cmemberline and the cmemberdesc environment. 2002-04-15 17:46:00 +00:00
Fred Drake e03e1fe5cc Add support for the "Aesop Meta Tag". Not widely used, but not a bad idea,
either.
2002-04-05 17:34:50 +00:00
Fred Drake dbfe768f66 Update the PEP URL format to point to python.org. 2002-04-03 02:47:14 +00:00
Fred Drake 69f0a8e42f The <link> to the stylesheet should include the type attribute. 2002-03-26 19:57:52 +00:00
Fred Drake cf43004b83 Fix broken HTML in the head; this was reported by a user as causing Opera 6.01
to crash.  The user has reported the problem to Opera, but we still should
generate something that passes for HTML.
2002-03-22 17:22:38 +00:00
Fred Drake 5381588073 Revise the markup related to the grammar productions to increase the
level of predictability.  This is not really "good" markup, but is arguably
better than we had before.
This closes SF bug #523117.
2002-03-15 23:21:37 +00:00
Fred Drake f171ad9d99 Change the way \textasciitilde is implemented so it works more consistently
(dropping tildes into data that still goes through LaTeX-like processing is
a bad idea).
2002-03-13 02:44:50 +00:00
Fred Drake 58fb237948 Add implementations for \textgreater and \textless, defined in (relatively)
recent versions of LaTeX2e but not support in LaTeX2HTML.
2002-03-05 04:04:06 +00:00
Fred Drake 6ca33771f8 Add a new environment for whole-paragraph (or longer) notes & warnings. 2001-12-14 22:50:06 +00:00
Fred Drake e27f86820a The valign attribute to control the vertical alignment of a table cell should
be on the <tr> element, not the <table> element.
Partially fixes SF bug #493243.
2001-12-14 16:54:53 +00:00
Fred Drake be6dd3083c Remove crufty whitespace in a block of index entries.
Minor, but generates slightly smaller HTML & makes it easier to see what's
happening when debugging the HTML.
2001-12-11 20:49:23 +00:00
Fred Drake bb7775a6ae Fix SF bug #479967: Appearantly I broke something that made the index
insertion work.  This fix makes things at least somewhat more explicit, and
adds a little sanity checking (and verbosity!) to
add_bbl_and_idx_dummy_commands().
2001-12-04 17:03:54 +00:00
Fred Drake 5ed35fd149 Add a new environment in the Python docs markup: seealso*. This is similar
to seealso, but does not add the "See also:" header or put the content in a
box in the HTML version.

Updated the description of \seeurl to better indicate when it should be used;
the old description was written before we had \seetitle.
2001-11-30 18:09:54 +00:00
Fred Drake fb6499fd9c Clean up the tables of child links generated by stock LaTeX2HTML so we get
consistent (lack of) vertical space between sections, and remove some of the
unnecessary cruft that was added in (finally we get to *remove* something
that got generated!).
2001-10-26 14:16:23 +00:00
Fred Drake af07b2c34f Add yet more markup that let's a stylesheet pick out a small bit of the
presentation.  This is acceptable since it only occurs in the formatted
output and does not affect the document markup.
2001-10-26 03:09:27 +00:00
Fred Drake a219b411af Add better support for Mozilla's use of <link> elements. 2001-10-22 16:57:49 +00:00
Fred Drake cc2e306592 Support for the iSilo conversion. 2001-10-19 21:08:36 +00:00
Fred Drake 92350b3a1f New markup: \note{...} and \warning{...} 2001-10-09 18:01:23 +00:00
Fred Drake 479384e1ff Move the styling for the HTML version of \mailheader into the CSS file.
In both the HTML and typeset versions of the documentation, add a colon
after the name of a mail header so that it is more easily distinguished
from other text.
2001-09-26 18:46:36 +00:00
Fred Drake 16bb41934c New \grammartoken markup, similar to \token but allowed everywhere. 2001-08-20 21:36:38 +00:00
Fred Drake 2dc07946bf Make sure that ampersand escaping is still performed on the contents of
local module tables (the lists of modules documented within a chapter,
inserted at the beginning of the chapter).  If this is not done here,
the text is not part of the resulting documents when latex2html does the
processing normally.

This fixes a little bit more of SF bug #451556.
2001-08-17 17:20:44 +00:00
Fred Drake cb19976f1a fix_font(): Instead of using a long if/elsif cluster, use a bloody
dictionary.  Added some entries to the dictionary to fix part of
    SF bug #451556.
2001-08-16 21:56:24 +00:00
Fred Drake 9443dc31c1 Remove the use of the "cat" program. This improves portability to non-Unix
platforms.

This is part the response to SF patch #429611.
2001-08-10 20:12:09 +00:00
Fred Drake 7eac0cb04c Define the \mailheader macro and document conventions for using it. 2001-08-03 18:36:17 +00:00
Fred Drake f269e59232 Define new markup for 5-column tables. 2001-07-17 23:05:57 +00:00
Fred Drake 77602f2e32 Add support for \ulink and hyperlink grammars.
do_cmd_verbatiminput():  Write out a text file containing the content of the
    input file with a .txt extension, and add a link to it at the bottom of
    the presentation.  This easier retrieval of example source code for
    copy & paste use.
2001-07-06 22:43:02 +00:00
Fred Drake 6fe4660f61 Added support for our new \infinity and \plusminus macros, and the
standard \textbar macro (not supported in many versions of LaTeX2HTML).

Added newline to error message.
2001-06-23 03:13:30 +00:00
Fred Drake dce975c820 Update to use the newly separated values $PACKAGE_VERSION and $RELEASE_INFO.
Normalize all HTML attributes to be written as name="value" instead of
name='value'.
2001-06-20 21:31:36 +00:00
Fred Drake f1927a6d80 Added support for new \setreleaseinfo macro.
Normalize all generated HTML so that attribute names come out as
name="value" instead of name='value'.
Changed the target of RFC links to point to the hypertext RFCs at
www.faqs.org instead of the plain text RFCs at www.ietf.org.
2001-06-20 21:29:30 +00:00
Fred Drake 57e52ef076 Implement the \verbatiminput LaTeX macro; this contains more magic than
it should, but only enough that LaTeX2HTML doesn't bite us.
2001-06-15 21:31:57 +00:00
Fred Drake 06a01e84b9 Define a new environment, classdesc*, which can be used to document a
class without providing any information about the constructor.  This
should be used for classes which only exist to act as containers rather
than as factories for instances.
2001-05-11 01:00:30 +00:00
Fred Drake caa79a9ee4 Minor adjustments to HTML for the module synopsis tables. 2001-05-09 15:32:14 +00:00
Fred Drake 056a71da76 The (fairly recent) \textasciicircum is not supported by LaTeX2HTML; add
support for it here.
2001-04-21 05:48:07 +00:00
Fred Drake c2b29d0fee Added support for optional explanation parameter to the \versionadded
macro.

Refactored do_cmd_versionadded() and do_cmd_versionchanged() to do most
of the work in a helper function, with the do_cmd_*() wrappers just supplying
a portion of the replacement text.
2001-04-18 03:11:04 +00:00
Fred Drake e0197bfaeb When forming the <A> tag for a \seepep or \seerfc, make sure we strip
HTML markup from the string used as the title in the TITLE attribute.

This fixes formatting in the "What's New in Python 2.1" document.
2001-04-12 04:03:22 +00:00