[ python-Bugs-839585 ] String formatting operator % badly documented

[SourceForge.net]

Bugs item #839585, was opened at 2003-11-10 17:11
Message generated for change (Comment added) made by mcherm
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=839585&group_id=5470

Category: Documentation
Group: Python 2.4
Status: Open
Resolution: None
Priority: 5
Submitted By: Robert Siemer (siemer)
>Assigned to: Nobody/Anonymous (nobody)
Summary: String formatting operator % badly documented

Initial Comment:
Hello everyone!

The % operator works with strings, but this is hard to
find in the documentation (Library Reference 2.2.6.2).

Really bad is, that an operator should be documented in
the Language Reference, where it isn't.

Lang-Ref "5.6 Binary arithmetic operations" is labeled
wrong, as it also describes the non-arithmetic
operations of + and * but seems to know nothing about %
under that aspect...
It is actually indirectly saying that there is no
further non-arithmetic operation - but there is: %.


Rob

----------------------------------------------------------------------

>Comment By: Michael Chermside (mcherm)
Date: 2004-03-20 14:00

Message:
Logged In: YES 
user_id=99874

Two thoughts I had after attaching that patch.
(1) If there's a way to create inter-document links, that
would be a good idea. I don't know of one.
(2) If the format of this patch is a pain, let me know. All
I'm doing is adding one paragraph.

----------------------------------------------------------------------

Comment By: Michael Chermside (mcherm)
Date: 2004-03-20 13:52

Message:
Logged In: YES 
user_id=99874

Good point, this has long bothered me too.

I'm attaching a patch. Fred, can you review (make sure I
didn't introduce broken tex syntax) and check in?

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=839585&group_id=5470