This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: String formatting operator % badly documented
Type: Stage:
Components: Documentation Versions: Python 2.4
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: fdrake Nosy List: fdrake, georg.brandl, mcherm, siemer
Priority: normal Keywords:

Created on 2003-11-10 22:11 by siemer, last changed 2022-04-11 14:56 by admin. This issue is now closed.

Files
File name Uploaded Description Edit
patch2.patch mcherm, 2004-03-20 18:58 Patch to apply to dist/src/Doc/ref/ref5.tex
Messages (4)
msg18966 - (view) Author: Robert Siemer (siemer) Date: 2003-11-10 22:11
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
msg18967 - (view) Author: Michael Chermside (mcherm) (Python triager) Date: 2004-03-20 18:52
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?
msg18968 - (view) Author: Michael Chermside (mcherm) (Python triager) Date: 2004-03-20 19:00
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.
msg18969 - (view) Author: Georg Brandl (georg.brandl) * (Python committer) Date: 2005-12-26 23:16
Logged In: YES 
user_id=1188172

Applied corrected patch in rev. 41820/41821.
History
Date User Action Args
2022-04-11 14:56:01adminsetgithub: 39533
2003-11-10 22:11:23siemercreate