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: Put a reference to print in the Library Reference, please.
Type: enhancement Stage:
Components: Documentation Versions:
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: fdrake Nosy List: fdrake, lcreighton, logistix
Priority: high Keywords:

Created on 2003-04-17 13:41 by lcreighton, last changed 2022-04-10 16:08 by admin. This issue is now closed.

Messages (5)
msg15482 - (view) Author: Laura Creighton (lcreighton) * Date: 2003-04-17 13:41
Often the first question a Newbie has is 'how do I
print stuff?'.
They come to the Library Reference, looking for a print
function.   They are unaware that print is an
expression, and
that they need to be looking in the Language Reference
Manual.
One line, early on telling them where to look will save
aggrevation
for them.  Thanks very much,
Laura Creighton
msg15483 - (view) Author: Fred Drake (fdrake) (Python committer) Date: 2003-04-17 14:49
Logged In: YES 
user_id=3066

Guido wants this fixed, so bumped priority and assigned it
to me.
msg15484 - (view) Author: Grant Olson (logistix) Date: 2003-04-18 22:04
Logged In: YES 
user_id=699438

Perhaps this could be a "builtin statements" subsection of 
section 2 that lists all statements and crossreferences the 
Language Reference.  It took me a year before it finally stuck 
that I needed to go to the Language Reference to look at try... 
syntax, etc.

It's probably my biggest usability gripe with the manuals.
msg15485 - (view) Author: Laura Creighton (lcreighton) * Date: 2003-04-19 08:55
Logged In: YES 
user_id=376262

This is probably the best time to add a reference to the %
operator and 
what it is good for.  
msg15486 - (view) Author: Fred Drake (fdrake) (Python committer) Date: 2003-04-30 16:45
Logged In: YES 
user_id=3066

The Library Reference contains an index entry for "print
statement", which points to a minor reference at the
beginning of the "Built-in Types" chapter.  I've expanded
the reference to include:

- a specific link to the "print" reference documentation in
the language reference;

- a link to the contents page for the language reference,
advising the reader that all language statements are
documented there; and

- a link to the contents page for the tutorial, 'cause it's
useful for newbies.

I don't know that this exactly matches you're looking for.

I'll note that the % operator for string formatting is
indexed in the library already.

If these changes are not sufficient, please explain in more
detail where you were looking for the information and failed
to find it.

Changes committed as Doc/lib/libstdtypes.tex 1.123 and
1.80.6.22.
History
Date User Action Args
2022-04-10 16:08:11adminsetgithub: 38317
2003-04-17 13:41:29lcreightoncreate