Issue 723136: Put a reference to print in the Library Reference, please. (original) (raw)

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)	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)	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.