[Python-Dev] python/dist/src/Doc/tut tut.tex,1.276,1.277

Phillip J. Eby pje at telecommunity.com
Tue Aug 23 19:57:27 CEST 2005

At 07:23 PM 8/23/2005 +0200, Reinhold Birkenfeld wrote:
>rhettinger at users.sourceforge.net wrote:
>I'm not a native speaker, but...
> > @@ -114,7 +114,7 @@
> >  programs, or to test functions during bottom-up program development.
> >  It is also a handy desk calculator.
> >
> > -Python allows writing very compact and readable programs.  Programs
> > +Python enables programs to written compactly and readably.  Programs
> >  written in Python are typically much shorter than equivalent C or
> >  \Cpp{} programs, for several reasons:
> >  \begin{itemize}
>...shouldn't it be "programs to be written compactly"?

It looks to me like the original text here should stand; Python doesn't 
"enable programs to be written"; it enables people to write them.  That is, 
the passive voice should be avoided if possible.  ;-)

> > @@ -1985,7 +1987,9 @@
> >  \section{The \keyword{del} statement \label{del}}
> >
> >  There is a way to remove an item from a list given its index instead
> > -of its value: the \keyword{del} statement.  This can also be used to
> > +of its value: the \keyword{del} statement.  Unlike the \method{pop()})
> > +method which returns a value, the \keyword{del} keyword is a statement
> > +and can also be used to
> >  remove slices from a list (which we did earlier by assignment of an
> >  empty list to the slice).  For example:
>The del keyword is a statement?

The keyword certainly isn't.  This section also looks like it should stand 
the way it was, or else say that "unlike the pop() method, the del 
statement can also be used to remove slices...".

More information about the Python-Dev mailing list