Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity
10,559 Commits 6 Branches 592 Tags 2.4 GiB
Commit Graph

233 Commits

Author SHA1 Message Date
Fred Drake 6038f54b74 Adjust so that we are no longer using special entities for well-known 
names.  These are too much of a pain for occaissional authors.
 1999-01-14 21:44:56 +00:00
Fred Drake 3effeedad3 Shorten the name of the <rfc> "number" attribute to "num". 1999-01-14 21:18:52 +00:00
Fred Drake d24167baf2 Make <rfc> no longer an empty element but a container. The text 
currently generated by the LaTeX and LaTeX2HTML processes is generated
here as well, making it more flexible in the SGML version.

Reduce the <args> element so that <optional> goes away; just use
square brackets to indicate what's optional.  This makes it easier to
read than the LaTeX, and the processor can do any checking it needs to
in order to make sure it's legit.  Possible shortcoming: DSSSL
processors may need more explicit markup.  Can probably hack around it
for this case, but we'll see.
 1999-01-14 21:18:03 +00:00
Fred Drake f8ebb5521d Several new functions to re-write tables to be at least partly 
conformant with the OASIS Exchange model.  There's a little more
massage left to do, but not much.
 1999-01-14 19:45:38 +00:00
Fred Drake a50a1df588 Added clean and clobber targets. 1999-01-14 18:26:23 +00:00
Fred Drake 54bad44f25 Update to the latest version of Michael Ernst's script. 1999-01-14 18:17:07 +00:00
Fred Drake 3a7a3d745d "Driver" makefile to convert all documents to SGML or XML at once. 1999-01-14 18:13:59 +00:00
Fred Drake 7727416686 Add usage of the "driver" Makefile. 1999-01-14 18:12:33 +00:00
Fred Drake 9d1c3b565f Elaborate a comment on the format of the table that drives the 
conversion.
 1999-01-14 18:10:09 +00:00
Fred Drake d7acf02290 Adjustments to allow elements with subelements as parameters. This is 
used to deal with the table headings and entries.

An additional flag in the element table is used to indicate elements
which have no "general" content, but which do have subelement
content.  These must be flagged distinctly from empty elements.
Currently used for \lineii, \lineiii, and \lineiv.
 1999-01-14 17:38:12 +00:00
Fred Drake 79ad1f19dc Escape special characters on output. 1999-01-14 17:06:09 +00:00
Fred Drake 701f10fbea Simplify command that extracts the number of pages from a PostScript 
file; use "grep -c" instead of "grep | wc -l | cut ... | tr ...".
 1999-01-12 19:28:41 +00:00
Fred Drake 8e2c9457a2 output_body(): For <address> elements, just skip, since they're 
always part of the page trailer.
 1999-01-11 22:30:34 +00:00
Fred Drake ed94dde4b9 No longer useful. 1999-01-08 15:48:47 +00:00
Fred Drake dd21c32169 It's finally gone! 1999-01-08 15:40:16 +00:00
Fred Drake c4e9263010 Add a few comments. 1999-01-08 15:32:27 +00:00
Fred Drake c58f346374 New support scripts for HTML->info conversion that use Michael Ernst's new 
conversion tools.
 1999-01-08 15:27:17 +00:00
Fred Drake 3fe1d32693 New conversion tools for HTML->info from Michael Ernst 
<mernst@cs.washington.edu>.

Thanks!
 1999-01-08 15:25:29 +00:00
Fred Drake 637ad47e61 convert(): Make sure no line has trailing whitespace. (docfixer.py 
checks for \n\n as a paragraph separator, LaTeX allows white
	space between the newlines.)
 1999-01-07 18:47:07 +00:00
Fred Drake fcc5910090 Preliminary code to mark paragraphs. Seems to work, but very slow. 1999-01-06 22:50:52 +00:00
Fred Drake 26f0f65653 Remove obsolete comment. 1999-01-05 20:53:43 +00:00
Fred Drake 3b07480a17 trim_ignored_letters(): Simplify a little. 1999-01-04 22:00:56 +00:00
Fred Drake 03a0235793 Print a line to the console reporting the number of index nodes 
processed.  This can be interesting to see.
 1998-12-28 20:46:53 +00:00
Fred Drake aaed9710e9 create_module_info(): New function: Modify a <section> to create a 
<moduleinfo> element based on various meta information, and
	strip some cruftiness.  This is more usable for information
	extraction, and organizes the information more clearly.

cleanup_synopses():  Rewrite to use create_module_info(), so this
	will work with multi-rooted "documents".
 1998-12-10 20:25:30 +00:00
Fred Drake 4abcffb233 Don't pass around a list of known empty elements, since the ESIS 
contains "e" events for them.  This wasn't used anyway.
 1998-12-10 18:31:37 +00:00
Fred Drake fba0ba2a6f Added a transform to start cleaning up the modulesynopsis stuff a 
little; more thinking is needed about what we really want.
 1998-12-10 05:07:09 +00:00
Fred Drake c166331cd3 Handle SGML variant as well as XML variant. SGML is *much* more 
likely to be used.
 1998-12-10 04:56:00 +00:00
Fred Drake 86bc7b01b5 General comments on what's here and how to try it out. Note 
dependence on the XML package.
 1998-12-02 17:21:35 +00:00
Fred Drake 3695b1212c Support conversions to both SGML and XML; SGML is the "default". 
Add dependency on esistools.py for the ESIS intermediate files.
 1998-12-01 19:05:56 +00:00
Fred Drake aeea9810cd Use esistools. 
Lots of changes to the conversion table.
 1998-12-01 19:04:12 +00:00
Fred Drake 4db5b4636c Use esistools. 
Generate ESIS data instead of XML.
Misc. changes to some transforms.
 1998-12-01 19:03:01 +00:00
Fred Drake f077b9d61f Use esistools, getopt. 1998-12-01 19:01:53 +00:00
Fred Drake 3843bae969 Utility functions and misc. classes used in handling ESIS data. 1998-12-01 19:00:58 +00:00
Fred Drake f954b6516e Remove $(CUTCRUFT) garbage; now in fixgenents.sh. 
Separate ESIS generation from XML generation.  This will evolve a bit
more in a couple of days.
 1998-11-30 22:31:45 +00:00
Fred Drake 3d5e2c032d Move nasty cruft from make.rules' $(CUTCRUFT) here, mostly to clean up 
make.rules.
 1998-11-30 22:30:29 +00:00
Fred Drake ca6d6355d7 l2hoption: Do the "right thing" to quote the right-hand-side of Perl 
assignments.  This allows '"', '$', and '@' to be included in
	the values passed to parameters like --address.
 1998-11-30 20:30:26 +00:00
Fred Drake 7777e36c21 Add a -address parameter to the LaTeX2HTML command line to direct 
documentation comments appropriately.  In response to comment from
Martijn Faassen <faassen@vet.uu.nl>.
 1998-11-30 20:27:31 +00:00
Fred Drake 42f5298ab5 Several small adjustments. 1998-11-30 14:45:24 +00:00
Fred Drake 87dfd3cfbf Handle output of \geq and \leq. 1998-11-30 14:36:26 +00:00
Fred Drake 4c5e533693 Do the right stuff to convert what was originally \e, \ldots, and --- 
in the LaTeX sources.
 1998-11-25 19:28:02 +00:00
Fred Drake d8faf85d40 Supplemental rules to convert a .tex file to a .xml file. Both XML and 
SGML will be supported soon, probably using an ESIS representation saved
in a temp file.
 1998-11-24 17:40:33 +00:00
Fred Drake 6942e57f87 Script to convert things like <C/> and <Cpp/> to &C; and &Cpp;. This is 
something that con't be done with the DOM as far as I can tell.
 1998-11-24 17:38:49 +00:00
Fred Drake 1cb330c383 The & character is also escaped using \. 1998-11-23 23:11:12 +00:00
Fred Drake 1ff6db484f Add some additional cleanup transformations. 1998-11-23 23:10:35 +00:00
Fred Drake 5701482ea7 Fix comment regex so we don't screw up structured comments with 
different internal indentation levels.
 1998-11-23 18:21:54 +00:00
Fred Drake 0320473a29 Script to squirrel around with the DOM tree of document fragments from the 
LaTeX-based ESIS streams to be a little better structured, and generally
perform clean-up.

Preliminary.
 1998-11-23 17:02:03 +00:00
Fred Drake 30a68c7a2b Moved into tools/sgmlconv/. 1998-11-23 16:59:39 +00:00
Fred Drake 63de8f6d55 Moving to sgmlconv/ subdir. 1998-11-23 16:58:48 +00:00
Fred Drake bbd7509dbe Fix up the extraction of optional parameters a little. 
Be more informative in an exception message.
 1998-11-23 16:30:18 +00:00
Fred Drake c16149b17b Some cleanup. 
Don't duplicate the information on what's empty; rely on the input
data for that.  (This means that the DOM may need more work.)
 1998-11-23 15:14:18 +00:00
Fred Drake 96b07a9453 Fix some minor problems. 
Make the table of attribute information contain only one kind of
entry.  Simplifies some stuff in subconvert().
 1998-11-23 15:12:00 +00:00
Fred Drake 99ff8c4361 First cut at a script to generate SGML/XML from an ESIS event stream, 
probably only usable for the Python docs.  But also probably more
useful than latex2esis.py.
 1998-11-18 23:28:24 +00:00
Fred Drake 95f4f92b47 First cut at a script to generate ESIS events from LaTeX source, 
probably only usable for the Python docs.
 1998-11-18 23:27:24 +00:00
Fred Drake 566b6d5b59 Support the use of bibtex. This is transparent to the user. 
Switch from bash to ksh, in the hope that more systems support it (one
report of a site without an available bash).
 1998-10-27 21:59:03 +00:00
Fred Drake d29cf379b9 Added --tools option, to package only the framework (no documents). 1998-10-21 14:26:26 +00:00
Fred Drake fbddddee49 Reflect new name of index style file. 1998-10-19 21:48:05 +00:00
Fred Drake 9dcc9f7764 No longer needed since we have nice, contributed navigation buttons. 1998-10-19 21:40:45 +00:00
Fred Drake a5de730d2d If building HTML and the icons should be served from the same 
directory as the HTML (--iconserver .), copy the icons into place.

Clarify that lynx is needed for --text in the usage message.

Fix a typo in a comment.
 1998-10-19 19:14:42 +00:00
Fred Drake b521095952 In build_html(), strip off leading "./" from filename, added by 
kpsewhich.  This caused a problem with the latest latex2html beta.
 1998-10-16 17:34:34 +00:00
Fred Drake 437ff8600a Change the default split level to not split on marked \paragraph and 
\subparagraph sections.  Indicate the default in the --help message.
 1998-10-07 16:46:54 +00:00
Fred Drake b0b1900198 If --debug was used, don't delete the temporary .perl file used to 
pass options to latex2html.
 1998-10-07 16:41:40 +00:00
Fred Drake 8c1e114d1a Don't attempt to add paragraph and subparagraph sections to the PDF 
outline.

Work around font-long bogosity caused by ' in docstring.
 1998-10-07 14:12:20 +00:00
Fred Drake 47f69067d5 Script to generate page counts of the PostScript files. 1998-08-28 21:16:28 +00:00
Fred Drake e1feb8f2dc Support long options that take arguments of the form --option=value as well 
as --option value.

Minor nits cleaned up.
 1998-08-28 20:21:04 +00:00
Fred Drake 9f6f0da084 Improved some error messages for command line processing. 
Added --all to produce all formats at once.
 1998-08-12 18:07:51 +00:00
Fred Drake 78b8c3d0d6 Oops, the --text option wasn't documented! 1998-08-12 17:52:16 +00:00
Fred Drake c794c38187 Added a comment about not using a symbolic link to access the script. 1998-08-12 17:50:07 +00:00
Fred Drake 15c417eb77 Helper script used in creating navigation buttons. 1998-08-11 19:35:03 +00:00
Fred Drake af06a0b4ee Use Perl's rename() function instead of system(); there's no need for two 
additional processes for each name change!
 1998-08-11 18:17:47 +00:00
Fred Drake f6b6bbceb6 Add a comment explaining that this script is probably not useful outside the 
standard Python documentation, since the mkhowto.sh script is.  Let there be
no doubts....
 1998-08-11 14:10:40 +00:00
Fred Drake 077fffa874 The letter headings must be requested explicitly with --letters. 1998-08-07 20:49:54 +00:00
Fred Drake 7cbf462acf Allow multi-column indexes to be produced. 1998-08-07 19:50:13 +00:00
Fred Drake 9940bd717c Variant of AMK's patch to produce text versions of HOWTO documents. 
This ensures that the text version uses latex2html's -split 1 option, without
affecting HTML produced in the same run, and also minimizes the number of
l2h runs needed if --split 1 was used for an HTML run.
 1998-08-06 20:15:20 +00:00
Fred Drake 11300cc71e build_html(): Simplify, so there's only one version of the latex2html 
command line.

l2hoption():  Convenience function, to write out an option to the aux. init.
	file only if set.

Added --iconserver option to set the $ICONSERVER variable in latex2html; this
requires the use of an auxillary init. file since this can't be initialized
using a standard latex2html command-line option.  So the aux. init. file is
used for just about all the special options since it has to be written anyway
when $ICONSERVER needs to be set.
 1998-08-05 04:48:18 +00:00
Fred Drake 8cab549c0a use_latex(): Hack to pass .syn files though uniq, so that the last module 
in a HOWTO document isn't listed in the synopsis table twice.  This
	will do until the real bug is found (low priority!).
 1998-07-23 19:13:52 +00:00
Fred Drake e87ab1fbf2 Fix definition of release_version (global). 1998-05-19 19:37:55 +00:00
Fred Drake a4565b0796 Update to use latex2html 98.1p5. 1998-05-15 17:14:17 +00:00
Fred Drake 8dbf46a79e Update to use latex2html 98.1p5. 
Cleanup temporary files produced by latex2html in the output directory.
 1998-05-15 17:13:08 +00:00
Fred Drake 8d1b3384c3 Remove debugging echo. 1998-05-15 13:38:21 +00:00
Fred Drake df825a10fc Fix the fix to allow the .tex document sources not live in ".". 1998-05-14 20:36:49 +00:00
Fred Drake 25d4e2873c Mostly spurious change to ensure that everyone's version of this picks up the 
execute bit.... problem discovered by Guido.
 1998-05-14 20:07:10 +00:00
Fred Drake f4fc476885 Don't run tools/toc2bkm.py unless we're building PDF. 
Change the way TEXINPUTS gets defined to ensure that the directory containing
the main document file comes before any other dir, to allow documents to have
files that "override" like-named files elsewhere on the search path.  Guido
discovered we needed this.
 1998-05-14 20:03:14 +00:00
Fred Drake 72dd58d90e Use .tgz instead of .tar.gz for the output file name. 1998-05-11 21:08:39 +00:00
Fred Drake d5d473fd5c Add --letter option, similar to --a4. This is a no-op, but can be used from 
a Makefile:  mkhowto.sh --$(PAPER).
 1998-05-11 20:40:24 +00:00
Fred Drake 58ff112e7f Don't be so ugly as to use "set -x" to get the executed commands printed. 1998-05-11 19:06:26 +00:00
Fred Drake 1a3541c29c Oops, better add it to the usage message! 1998-05-11 19:04:56 +00:00
Fred Drake 3504952781 Add easy-to-use support for A4 paper. 1998-05-11 19:04:06 +00:00
Fred Drake f2fa1e2afe Accept the release number on the command line instead of hardcoding it. 1998-05-11 18:52:24 +00:00
Fred Drake 323dc70de5 Don't be so ugly as to use "set -x" to get the executed commands printed. 1998-05-11 18:41:16 +00:00
Fred Drake 8ffa21c7aa Adjust to new file layout. 1998-05-08 15:37:13 +00:00
Fred Drake f4166a478a Some versions of latex2html don't automatically append the .tex extension to 
the name of the main .tex source file if it's not in the current directory.
 1998-05-08 04:00:56 +00:00
Fred Drake 4a9129c7e8 /bin/sed works on both Solaris and RedHat Linux; /usr/bin/sed does not. 1998-05-08 03:42:23 +00:00
Fred Drake 19c7c84db8 Be a little more robust handling filenames. 1998-05-07 21:20:39 +00:00
Fred Drake bf332696a1 Add support for a --pdf option to cause a PDF file to be created instead; 
most of the processing is the same and has to be done anyway.
 1998-05-07 17:28:42 +00:00
Fred Drake 8920156d04 New script to drive HTML generation. 1998-05-07 14:53:55 +00:00
Fred Drake 5360879740 New helper script to build the .dvi for a Python manual; usable for the 
api, ext, ref, and tut manuals.  The Library Reference requires too much
special index processing to make it beneficial to extend this to support
it.
 1998-05-07 01:38:16 +00:00
Fred Drake c9b8a57040 cleanup(): Remove *all* the temp files related to index generation! 1998-04-29 21:28:25 +00:00
Fred Drake 8805354bbc Simplify how some options get propogated. 1998-04-24 21:57:12 +00:00
Barry Warsaw dc1c970b0f This script appears to no longer be in the toolchain for Python 
documentation, so it has been moved to ../../Tools/scripts

Fred, please verify.
 1998-04-23 22:57:16 +00:00
Fred Drake 476412a918 cleanup(): Get rid of module index turds. 1998-04-17 20:25:55 +00:00