summaryrefslogtreecommitdiffstats
path: root/Doc/perl/python.perl
Commit message (Collapse)AuthorAgeFilesLines
* Separate out a \cfuncline macro from the cfuncdesc environment.Fred Drake2002-04-151-8/+21
| | | | | This matches many other of the *desc environments, and is useful when multiple functions share a description.
* Generate the right annotations in the index entries.Fred Drake2002-04-151-2/+2
| | | | Thanks to Thomas Heller for the sharp eye.
* Clean up the application of style to verbatim text.Fred Drake2002-04-151-5/+5
| | | | | | | 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).
* Add support for \cmemberline and the cmemberdesc environment.Fred Drake2002-04-151-0/+24
|
* Update the PEP URL format to point to python.org.Fred Drake2002-04-031-1/+1
|
* Revise the markup related to the grammar productions to increase theFred Drake2002-03-151-0/+13
| | | | | | level of predictability. This is not really "good" markup, but is arguably better than we had before. This closes SF bug #523117.
* Change the way \textasciitilde is implemented so it works more consistentlyFred Drake2002-03-131-1/+1
| | | | | (dropping tildes into data that still goes through LaTeX-like processing is a bad idea).
* Add implementations for \textgreater and \textless, defined in (relatively)Fred Drake2002-03-051-0/+2
| | | | recent versions of LaTeX2e but not support in LaTeX2HTML.
* Add a new environment for whole-paragraph (or longer) notes & warnings.Fred Drake2001-12-141-2/+21
|
* The valign attribute to control the vertical alignment of a table cell shouldFred Drake2001-12-141-3/+3
| | | | | be on the <tr> element, not the <table> element. Partially fixes SF bug #493243.
* Remove crufty whitespace in a block of index entries.Fred Drake2001-12-111-0/+1
| | | | | Minor, but generates slightly smaller HTML & makes it easier to see what's happening when debugging the HTML.
* Add a new environment in the Python docs markup: seealso*. This is similarFred Drake2001-11-301-0/+6
| | | | | | | | 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.
* Add yet more markup that let's a stylesheet pick out a small bit of theFred Drake2001-10-261-3/+11
| | | | | presentation. This is acceptable since it only occurs in the formatted output and does not affect the document markup.
* New markup: \note{...} and \warning{...}Fred Drake2001-10-091-0/+10
|
* Move the styling for the HTML version of \mailheader into the CSS file.Fred Drake2001-09-261-1/+1
| | | | | | 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.
* New \grammartoken markup, similar to \token but allowed everywhere.Fred Drake2001-08-201-0/+4
|
* fix_font(): Instead of using a long if/elsif cluster, use a bloodyFred Drake2001-08-161-23/+16
| | | | | dictionary. Added some entries to the dictionary to fix part of SF bug #451556.
* Define the \mailheader macro and document conventions for using it.Fred Drake2001-08-031-0/+2
|
* Define new markup for 5-column tables.Fred Drake2001-07-171-7/+72
|
* Add support for \ulink and hyperlink grammars.Fred Drake2001-07-061-2/+151
| | | | | | | 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.
* Added support for our new \infinity and \plusminus macros, and theFred Drake2001-06-231-1/+4
| | | | | | standard \textbar macro (not supported in many versions of LaTeX2HTML). Added newline to error message.
* Added support for new \setreleaseinfo macro.Fred Drake2001-06-201-65/+76
| | | | | | | 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.
* Implement the \verbatiminput LaTeX macro; this contains more magic thanFred Drake2001-06-151-0/+46
| | | | it should, but only enough that LaTeX2HTML doesn't bite us.
* Define a new environment, classdesc*, which can be used to document aFred Drake2001-05-111-0/+11
| | | | | | 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.
* The (fairly recent) \textasciicircum is not supported by LaTeX2HTML; addFred Drake2001-04-211-0/+1
| | | | support for it here.
* Added support for optional explanation parameter to the \versionaddedFred Drake2001-04-181-13/+14
| | | | | | | | 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.
* When forming the <A> tag for a \seepep or \seerfc, make sure we stripFred Drake2001-04-121-1/+10
| | | | | | 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.
* Add corresponding support for the alltt environment to the HTML generator.Fred Drake2001-04-101-0/+46
|
* Remove the spurious space of uncertain origin from the output for function,Fred Drake2001-03-291-10/+10
| | | | | method and constructor signatures. Suggested by Peter Funk on the Doc-SIG mailing list.
* Label classes and exceptions explicitly in the documentation (for theirFred Drake2001-03-021-2/+4
| | | | *desc environments).
* Fix \seepep handling -- correct URL to the online PEP repository on SF isFred Drake2001-01-221-27/+39
| | | | | | | | | | | | now generated. (SF bug #129692.) Patch from Anthon van der Neut <anthon@mnt.org>: Work around the removal of content-less paired tags used for name anchors in some places. (SF bug #116008.) Move some class attributes from an artificial SPAN element to otherwise "useful" elements that are being generated anyway. Added the class "versionnote", used for \deprecated, \versionadded, \versionchanged.
* For the title page, insert the package version number before the date.Fred Drake2000-12-141-3/+3
| | | | | This makes the title area more like the title are of the top-level index, and puts the information more people are interested in first.
* A few small refinements to the table building code.Fred Drake2000-11-301-7/+10
|
* define_module(): Change the "index sub-item" for definitions at moduleFred Drake2000-10-301-1/+1
| | | | | | | 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.
* Normalize the HTML generated for table headers.Fred Drake2000-10-261-7/+10
|
* Rename $PYTHON_VERSION to $PACKAGE_VERSION; this is the version number forFred Drake2000-10-251-5/+8
| | | | | whatever is being documented, not necessarily Python. (These tools are also used for the How-To documents, etc.)
* $OFF_SITE_LINK_ICON: Don't define here; simply defining it overrides aFred Drake2000-10-031-7/+11
| | | | | | | | | | | | | | | | | | | 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.
* make_icon_filename(): Convenience function to turn a partial filenameFred Drake2000-10-021-20/+45
| | | | | | | | | | | 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_sans_serif(),Fred Drake2000-09-221-10/+7
| | | | | | | | | | | | 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.
* Add new environments: longtableii, longtableiii, and longtableiv, toFred Drake2000-09-211-0/+12
| | | | | support long tables which might break across page boundaries. Otherwise identical to tableii, tableiii, and tableiv.
* do_cmd_shortversion(),Fred Drake2000-09-141-11/+32
| | | | | | | | | | | | | | | | | | | | | | | 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.
* \seetitle: New macro for building reference list content.Fred Drake2000-09-121-0/+19
|
* Add support for new \pep, \seepep, excclassdesc markup.Fred Drake2000-09-091-9/+68
| | | | | | | | | 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.
* Push some table header formatting to the style sheet; this also helpsFred Drake2000-08-311-15/+97
| | | | | | separate some of the ties between l2hinit.perl and python.perl. Revamp the "title page" construction to allow more flexibility.
* do_env_cfuncdesc(): Push as much of the generated HTML into one placeFred Drake2000-08-111-8/+8
| | | | as possible for better readability. Revise a comment.
* fix_font(): Handle one more case for the magical first column of tables.Fred Drake2000-08-091-0/+3
|
* do_cmd_moreargs(),Fred Drake2000-08-031-4/+8
| | | | | | | | | 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.
* Support constant as a font name for the first column of a table using theFred Drake2000-06-281-0/+3
| | | | tableii & friends markup family.
* do_cmd_textasciitilde(): New function.Fred Drake2000-06-151-0/+5
|
* do_cmd_seeurl(): New function.Fred Drake2000-05-091-0/+11
|