mirror of https://github.com/python/cpython
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:
parent
0e1de8bd6b
commit
bdadf0f7f3
|
@ -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
|
||||
|
|
Loading…
Reference in New Issue