Re: [Python-Dev] String literal concatenation & docstrings

2004-11-28 Thread Guido van Rossum
> > Right.  Over-clarification results in docs that read like the
> > instructions for the holy hand grenade ;-)
> 
> Well said.

Except that now I can't find the adjacent string literals in the
grammar any more!

I'm looking al http://www.python.org/dev/doc/devel/ref/grammar.txt

The path goes from primary to atom to literal to stringliteral (and
from there on into lexical detail) and nowhere does the grammar show
that multiple string literals are allowed. Adding a single + after
stringliteral in the expansion for literal would fix this. Once that
is fixed, we could probably reduce the text of the offending section
somewhat to use the phrase "where allowed by the grammar" and skip the
mentioning of different quoting conventions or intervening whitespace.

-- 
--Guido van Rossum (home page: http://www.python.org/~guido/)
___
Python-Dev mailing list
[EMAIL PROTECTED]
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com


[Python-Dev] Re: [Python-checkins] python/dist/src/Lib/email __init__.py, 1.34, 1.35

2004-11-28 Thread Anthony Baxter
On Monday 29 November 2004 12:10, [EMAIL PROTECTED] wrote:
> Update of /cvsroot/python/python/dist/src/Lib/email
> In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv19040
>
> Modified Files:
>  __init__.py
> Log Message:
> There's likely nothing more to do to the email package before Python 2.4 is
> final, so I'm marking email's version number as "3.0" (e.g. final).


Are there any other packages that have their own version numbers that
should be updated?

___
Python-Dev mailing list
[EMAIL PROTECTED]
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com


[Python-Dev] TRUNK FREEZE for 2.4 final from 2100 UTC, 29-11-2004

2004-11-28 Thread Anthony Baxter
Ok, we're about ready for the 2.4 final release. Please hold off any checkins
post 21:00 UTC (so in about 19-20 hours from now). 

Thanks,
Anthony
___
Python-Dev mailing list
[EMAIL PROTECTED]
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com


Re: [Python-Dev] String literal concatenation & docstrings

2004-11-28 Thread Brett C.
Guido van Rossum wrote:
Right.  Over-clarification results in docs that read like the
instructions for the holy hand grenade ;-)
Well said.

Except that now I can't find the adjacent string literals in the
grammar any more!
I'm looking al http://www.python.org/dev/doc/devel/ref/grammar.txt
The path goes from primary to atom to literal to stringliteral (and
from there on into lexical detail) and nowhere does the grammar show
that multiple string literals are allowed. Adding a single + after
stringliteral in the expansion for literal would fix this
[SNIP]
But if you look at Grammar/Grammar you will notice that atom goes to STRING+ 
which should cover this.  Is that grammar.txt file generated from 
Grammar/Grammar or is it done by hand?

-Brett
___
Python-Dev mailing list
[EMAIL PROTECTED]
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com


Re: [Python-Dev] String literal concatenation & docstrings

2004-11-28 Thread Guido van Rossum
> But if you look at Grammar/Grammar you will notice that atom goes to STRING+
> which should cover this.

Of course, otherwise it wouldn't work! :-)

> Is that grammar.txt file generated from
> Grammar/Grammar or is it done by hand?

By hand. The reference manual has more detail (Grammar/Grammar doesn't
say anything about what a STRING is, or other literals) and presents
some rules in a more readable form which wouldn't work for
Grammar/Grammar given the LL1 constraints of pgen. It also chooses
more readable names. But the translation process is fallible.


-- 
--Guido van Rossum (home page: http://www.python.org/~guido/)
___
Python-Dev mailing list
[EMAIL PROTECTED]
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com


Re: [Python-Dev] server modules class diagram

2004-11-28 Thread Aahz
On Sat, Nov 27, 2004, aurora wrote:
>
> Hi I don't know if I'm sending this to the right mailing list. Anyway
> I have gone through the Python server module code so many times. I
> actually come up with a class diagram to help me navigate it. I wonder
> if this would be useful in offical documentation. Please let me know
> if this is not the right mailing list for documentations. (The class
> diagram show be viewed with monospace fonts.)

If you look at the Python docs, the bottom of every page says, "See
About the Python Documentation for information on suggesting changes".
-- 
Aahz ([EMAIL PROTECTED])   <*> http://www.pythoncraft.com/

WiFi is the SCSI of the 21st Century -- there are fundamental technical
reasons for sacrificing a goat.  (with no apologies to John Woods)
___
Python-Dev mailing list
[EMAIL PROTECTED]
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com