[Python-checkins] r51988 - python/branches/release25-maint/Doc/whatsnew/whatsnew25.tex

[Neal Norwitz]

On 9/23/06, A.M. Kuchling <amk at amk.ca> wrote:
> On Sat, Sep 23, 2006 at 08:10:13PM +0200, neal.norwitz wrote:
> > -Because \keyword{yield} will often be returning \constant{None}, you
> >  should always check for this case.  Don't just use its value in
>
> > +\keyword{yield} will usually return \constant{None}, you
> >  should always check for this case.  Don't just use its value in
>
> I don't think this change makes sense: the original sentence was
> 'Because <something>, you should always <something>'.  Your change
> takes out 'Because', which I think breaks the sentence (it's now a
> run-on sentence).

If you take out the markup it is:

  yield will usually return None, you should always check for this case.

The phrase before the comma can be a sentance on its own.  As can the
phrase after the comma.  Perhaps the comma should be a semi-colon (or
even a period).  I don't really remember the definition of a run-on
sentance, so it could be. :-)  I was  just trying to simplify the
language.  Also many people dislike beginning a sentance with
'because.'

If you want to change it to something that's not a run-on, that's fine with me.

n