Move some \index entries around so we can avoid using empty comments;

empty comments trigger a bug in LaTeX2HTML.

Problem reported by Gerry Wiener <gerry@ucar.edu>.
This commit is contained in:
Fred Drake 1999-05-26 16:15:17 +00:00
parent 82f355a36a
commit abc8cc63ce
1 changed files with 25 additions and 31 deletions

View File

@ -16,23 +16,22 @@ An explanation of some terminology and conventions is in order.
The \dfn{epoch}\index{epoch} is the point where the time starts. On The \dfn{epoch}\index{epoch} is the point where the time starts. On
January 1st of that year, at 0 hours, the ``time since the epoch'' is January 1st of that year, at 0 hours, the ``time since the epoch'' is
zero. For \UNIX{}, the epoch is 1970. To find out what the epoch is, zero. For \UNIX{}, the epoch is 1970. To find out what the epoch is,
look at \code{gmtime(0)}.% look at \code{gmtime(0)}.
\index{epoch}
\item \item
The functions in this module do not handle dates and times before the The functions in this module do not handle dates and times before the
epoch or far in the future. The cut-off point in the future is epoch or far in the future. The cut-off point in the future is
determined by the \C{} library; for \UNIX{}, it is typically in 2038.% determined by the C library; for \UNIX{}, it is typically in
\index{Year 2038} 2038\index{Year 2038}.
\item \item
\strong{Year 2000 (Y2K) issues}: Python depends on the platform's \C{} \strong{Year 2000 (Y2K) issues}:\index{Year 2000}\index{Y2K} Python
library, which generally doesn't have year 2000 issues, since all depends on the platform's C library, which generally doesn't have year
dates and times are represented internally as seconds since the 2000 issues, since all dates and times are represented internally as
epoch. Functions accepting a time tuple (see below) generally require seconds since the epoch. Functions accepting a time tuple (see below)
a 4-digit year. For backward compatibility, 2-digit years are generally require a 4-digit year. For backward compatibility, 2-digit
supported if the module variable \code{accept2dyear} is a non-zero years are supported if the module variable \code{accept2dyear} is a
integer; this variable is initialized to \code{1} unless the non-zero integer; this variable is initialized to \code{1} unless the
environment variable \envvar{PYTHONY2K} is set to a non-empty string, environment variable \envvar{PYTHONY2K} is set to a non-empty string,
in which case it is initialized to \code{0}. Thus, you can set in which case it is initialized to \code{0}. Thus, you can set
\envvar{PYTHONY2K} to a non-empty string in the environment to require 4-digit \envvar{PYTHONY2K} to a non-empty string in the environment to require 4-digit
@ -41,26 +40,21 @@ converted according to the \POSIX{} or X/Open standard: values 69-99
are mapped to 1969-1999, and values 0--68 are mapped to 2000--2068. are mapped to 1969-1999, and values 0--68 are mapped to 2000--2068.
Values 100--1899 are always illegal. Note that this is new as of Values 100--1899 are always illegal. Note that this is new as of
Python 1.5.2(a2); earlier versions, up to Python 1.5.1 and 1.5.2a1, Python 1.5.2(a2); earlier versions, up to Python 1.5.1 and 1.5.2a1,
would add 1900 to year values below 1900.% would add 1900 to year values below 1900.
\index{Year 2000}%
\index{Y2K}
\item \item
UTC is Coordinated Universal Time (formerly known as Greenwich Mean UTC\index{UTC} is Coordinated Universal Time\index{Coordinated
Time, or GMT). The acronym UTC is not a mistake but a compromise Universal Time} (formerly known as Greenwich Mean
between English and French.% Time,\index{Greenwich Mean Time} or GMT). The acronym UTC is not a
\index{UTC}% mistake but a compromise between English and French.
\index{Coordinated Universal Time}%
\index{Greenwich Mean Time}
\item \item
DST is Daylight Saving Time, an adjustment of the timezone by DST is Daylight Saving Time,\index{Daylight Saving Time} an adjustment
(usually) one hour during part of the year. DST rules are magic of the timezone by (usually) one hour during part of the year. DST
(determined by local law) and can change from year to year. The \C{} rules are magic (determined by local law) and can change from year to
library has a table containing the local rules (often it is read from year. The C library has a table containing the local rules (often it
a system file for flexibility) and is the only source of True Wisdom is read from a system file for flexibility) and is the only source of
in this respect.% True Wisdom in this respect.
\index{Daylight Saving Time}
\item \item
The precision of the various real-time functions may be less than The precision of the various real-time functions may be less than
@ -84,7 +78,7 @@ The time tuple as returned by \function{gmtime()},
is a tuple of 9 integers: year (e.g.\ 1993), month (1--12), day is a tuple of 9 integers: year (e.g.\ 1993), month (1--12), day
(1--31), hour (0--23), minute (0--59), second (0--59), weekday (0--6, (1--31), hour (0--23), minute (0--59), second (0--59), weekday (0--6,
monday is 0), Julian day (1--366) and daylight savings flag (-1, 0 or monday is 0), Julian day (1--366) and daylight savings flag (-1, 0 or
1). Note that unlike the \C{} structure, the month value is a range 1). Note that unlike the C structure, the month value is a range
of 1-12, not 0-11. A year value will be handled as descibed under of 1-12, not 0-11. A year value will be handled as descibed under
``Year 2000 (Y2K) issues'' above. A \code{-1} argument as daylight ``Year 2000 (Y2K) issues'' above. A \code{-1} argument as daylight
savings flag, passed to \function{mktime()} will usually result in the savings flag, passed to \function{mktime()} will usually result in the
@ -112,14 +106,14 @@ Only use this if \code{daylight} is nonzero.
\begin{funcdesc}{asctime}{tuple} \begin{funcdesc}{asctime}{tuple}
Convert a tuple representing a time as returned by \function{gmtime()} Convert a tuple representing a time as returned by \function{gmtime()}
or \function{localtime()} to a 24-character string of the following form: or \function{localtime()} to a 24-character string of the following form:
\code{'Sun Jun 20 23:21:05 1993'}. Note: unlike the \C{} function of \code{'Sun Jun 20 23:21:05 1993'}. Note: unlike the C function of
the same name, there is no trailing newline. the same name, there is no trailing newline.
\end{funcdesc} \end{funcdesc}
\begin{funcdesc}{clock}{} \begin{funcdesc}{clock}{}
Return the current CPU time as a floating point number expressed in Return the current CPU time as a floating point number expressed in
seconds. The precision, and in fact the very definiton of the meaning seconds. The precision, and in fact the very definiton of the meaning
of ``CPU time''\index{CPU time}, depends on that of the \C{} function of ``CPU time''\index{CPU time}, depends on that of the C function
of the same name, but in any case, this is the function to use for of the same name, but in any case, this is the function to use for
benchmarking\index{benchmarking} Python or timing algorithms. benchmarking\index{benchmarking} Python or timing algorithms.
\end{funcdesc} \end{funcdesc}
@ -199,7 +193,7 @@ specification, and are replaced by the indicated characters in the
\end{tableii} \end{tableii}
Additional directives may be supported on certain platforms, but Additional directives may be supported on certain platforms, but
only the ones listed here have a meaning standardized by ANSI \C{}. only the ones listed here have a meaning standardized by ANSI C.
On some platforms, an optional field width and precision On some platforms, an optional field width and precision
specification can immediately follow the initial \character{\%} of a specification can immediately follow the initial \character{\%} of a