Explain comments at the start of chapter 3. This is needed since they

appear in the examples without any further explanation, and the
tutorial doesn't have this information explicit anywhere else.
Omission reported by Jon Black <jblack@Ridgeway-Sys.com>.
This commit is contained in:
Fred Drake 1999-04-29 13:20:25 +00:00
parent 0e1de8bd6b
commit bdadf0f7f3
1 changed files with 21 additions and 2 deletions

View File

@ -285,7 +285,9 @@ executable, like shell scripts, by putting the line
(assuming that the interpreter is on the user's \envvar{PATH}) at the
beginning of the script and giving the file an executable mode. The
\samp{\#!} must be the first two characters of the file.
\samp{\#!} must be the first two characters of the file. Note that
the hash, or pound, character, \character{\#}, is used to start a
comment in Python.
\subsection{The Interactive Startup File \label{startup}}
@ -328,7 +330,7 @@ In the following examples, input and output are distinguished by the
presence or absence of prompts (\samp{>>> } and \samp{... }): to repeat
the example, you must type everything after the prompt, when the
prompt appears; lines that do not begin with a prompt are output from
the interpreter.%
the interpreter. %
%\footnote{
% I'd prefer to use different fonts to distinguish input
% from output, but the amount of LaTeX hacking that would require
@ -337,6 +339,23 @@ the interpreter.%
Note that a secondary prompt on a line by itself in an example means
you must type a blank line; this is used to end a multi-line command.
Many of the examples in this manual, even those entered at the
interactive prompt, include comments. Comments in Python start with
the hash character, \character{\#}, and extend to the end of the
physical line. A comment may appear at the start of a line or
following whitespace or code, but not within a string literal. A hash
character within a string literal is just a hash character.
Some examples:
\begin{verbatim}
# this is the first comment
SPAM = 1 # and this is the second comment
# ... and now a third!
STRING = "# This is not a comment."
\end{verbatim}
\section{Using Python as a Calculator \label{calculator}}
Let's try some simple Python commands. Start the interpreter and wait