| Commit message (Collapse) | Author | Age | Files | Lines |
| |
|
|
|
|
| |
change the installed version on either of the machines I use to format the
docs. Instead, use a compatibility hack to support both versions. This is
also better for external users of the Python styles.
|
| |
|
|
|
|
| |
level of predictability. This is not really "good" markup, but is arguably
better than we had before.
This closes SF bug #523117.
|
| | |
|
| |
|
|
| |
will be replaced shortly. See the comments for more details.
|
| |
|
|
|
|
|
|
| |
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.
|
| |
|
|
| |
generate PostScript).
|
| |
|
|
|
| |
right, but the tests for whether we are generating PDF are a bit more
readable, and some unnecessary indirection has been removed.
|
| | |
|
| |
|
|
|
|
| |
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.
|
| | |
|
| | |
|
| | |
|
| | |
|
| |
|
|
| |
\plusminus: New macros to allow us to avoid math mode for these symbols.
|
| |
|
|
| |
is not pretty, but does what is needed.
|
| |
|
|
|
|
| |
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 versioning information, similar to \versionchanged.
|
| |
|
|
|
| |
the way we handle verbatim, so that it picks up the same indentation and
minipage behavior.
|
| |
|
|
| |
*desc environments).
|
| |
|
|
|
| |
too Unix-specific, and not really needed. (Already fixed the HTML
formatting, but forgot to mention it in the checkin for python.perl 1.94.)
|
| |
|
|
|
|
|
|
|
| |
the content body is the \ttindex macro, which seems to match actual usage.
Adjust \funcline to restore the "index sub-item" for functions to be
" (in module <name>)" instead of " (in <name>)". This is need to match
uses of \withsubitem throughout the documentation. (Not ideal, but
gets achieves consistency.)
|
| |
|
|
|
|
| |
to be very robust. Using \index directly fixes a lot of entries in the
index that had to be specifically read to determine that they had the
wrong parenthesized description.
|
| |
|
|
| |
distracting.
|
| |
|
|
|
| |
support long tables which might break across page boundaries. Otherwise
identical to tableii, tableiii, and tableiv.
|
| |
|
|
|
|
| |
\setshortversion: New markup to help deal with Python having a "real"
version number and an abbreviated version number
used to create pathnames to the library installation.
|
| | |
|
| |
|
|
|
|
|
|
| |
exceptions which have interesting constructor signatures.
\pep, \seepep: New macros. Equivalent to \rfc and \seerfc, but
referring to the PEP series instead of the Internet RFC
series of documents.
|
| | |
|
| |
|
|
|
| |
does everything needed, and discard the older stuff that is not
being used.
|
| |
|
|
| |
Change a 1.6 version number used in a an example in a comment to 2.0.
|
| | |
|
| | |
|
| | |
|
| | |
|
| |
|
|
|
| |
When processing the optional parameter, don't append any text;
let the pre-processor supply all of it.
|
| | |
|
| |
|
|
|
|
|
|
|
| |
text. Looks like \program.
\citetitle: New macro, used to mark titles of cited works (like the
names of the Python manuals). Accepts & discards an
optional parameter that is only used by the HTML
formatter. Looks like \emph.
|
| |
|
|
|
|
|
| |
for the manual class go one deeper than it previously did (\subsection
entries will now be numbered); no change for howto documents.
This makes it easier to refer precisely to smaller sections using \ref.
|
| | |
|
| |
|
|
|
|
|
|
|
|
|
|
| |
entry based on the module type if the type is known.
Otherwise, spit out a warning the the module type
parameter was bad and generate a "plain" index entry.
Without this, the bad module type was emitted as
text.
Problem noticed by processing Michael Hudson's docs for
bytecodehacks.
|
| | |
|
| |
|
|
| |
in tables.
|
| |
|
|
| |
This is in response to a comment from Wes Rishel <wes@rishel.com>.
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
| |
typical published manuals, so people can more easily see what they're
really asking for. ;-)
Revise the verbatim environment: simple implementation, but more
compatible if a document also add \usepackage{verbatim} at the
beginning.
Declare \modindex, \bimodindex, \exmodindex, and \stmodindex
obsolete. These still work just fine, but \declaremodule should be
used instead. The obsolete macros will print a warning on standard
out.
|
| | |
|
| |
|
|
| |
nor a separate paragraph.
|
| |
|
|
|
|
|
|
| |
hyperlinking in the PDF version. This also allows many of the
macros that do this stuff to be a good bit more readable.
Takes the target name and link content as parameters.
Use \py@linkToName for all internal links.
|
| |
|
|
|
| |
that used in the "normal" index. No visual difference, but
more easily processed by helper scripts.
|
| |
|
|
|
|
|
|
|
| |
so they don't get run together when there's no blank line
between them in the source. The HTML conversion already did
the right thing.
\refmodule: Refer to a module, using a hyperlink in the PDF version.
Visually the same as \module.
|
| | |
|