summaryrefslogtreecommitdiffstats
path: root/Doc/tut
Commit message (Collapse)AuthorAgeFilesLines
* Fix up some examples in the tutorial so we don't contradict our ownFred Drake2001-12-201-2/+2
| | | | | advice on docstrings. This fixes SF bug #495601.
* Include a warning that scripts should not have the same name as standardFred Drake2001-12-041-13/+37
| | | | | | | modules, or the module cannot be properly imported. (Based on a suggestion sent to python-docs.) Update the displayed dir() of the sys and __builtin__ module with Python 2.2.
* Talk about str() in the discussion of string representations of values, andFred Drake2001-12-041-3/+26
| | | | | give examples for which str() and repr() yield different results. This closes SF bug #485446.
* Update lambda description to reflect nested scopes. This was noted byFred Drake2001-12-031-4/+2
| | | | Andrew Koenig.
* Add a scalar product to the example list comprehensions based on a suggestionFred Drake2001-12-031-0/+2
| | | | sent to python-docs.
* Clean up some markup cruft. A number of the macros that take noFred Drake2001-11-281-6/+6
| | | | | | | | parameters (like \UNIX) are commonly entered using an empty group to separate the markup from a following inter-word space; this is not needed when the next character is punctuation, or the markup is the last thing in the enclosing group. These cases were marked inconsistently; the empty group is now *only* used when needed.
* Fix thinko in a comment about seeking with a file object.Fred Drake2001-10-161-1/+1
| | | | Reported by Francesco Trentini.
* Exceptions in interactive examlpes did not always include the indication ofFred Drake2001-09-211-19/+85
| | | | | | | | | the source file using "in ?". Added a description of the bare "raise" statement. Added more description and examples for user-defined exceptions; this is part of a response to SF bug #443559.
* Clarified the interaction between string literals and continuation lines.Fred Drake2001-09-061-5/+28
| | | | Fixes bug reported as SF bug #453728.
* Make the examples for "Default Argument Values" more presentable andFred Drake2001-09-061-9/+13
| | | | | less hostile to newbie use at the interactive prompt. This is in response to SF bug #458654.
* Clarify the prompt in an example.Fred Drake2001-08-141-1/+1
| | | | This closes SF bug #450633.
* Minor re-wording in the exaplantion of sequence comparisons.Fred Drake2001-08-011-3/+4
| | | | This closes SF bug #445749.
* Add a more substantial example startup file for the interactive shell;Fred Drake2001-07-181-7/+44
| | | | | | | | sample startup script provided by Itamar Shtull-Trauring. This closes SF patch #410890. Add some logical markup where it was missing.
* Minor changes to match the style guide.Fred Drake2001-07-141-4/+4
|
* Fix up a few style nits -- avoid "e.g." and "i.e." -- these makeFred Drake2001-07-061-58/+62
| | | | | translation more difficult, as well as reading the English more difficult for non-native speakers.
* Use the more conventional "self" as the name of the self parameter in anFred Drake2001-06-291-1/+1
| | | | example. It actually confused a reader.
* Update to include the license information in a less annoying place.Fred Drake2001-06-201-0/+3
|
* Clarification in the fp appendix suggested on c.l.py by Michael Chermside.Tim Peters2001-06-171-2/+3
| | | | | Also replaced a *star* style emphasis in the Representation Error section with an \emph{} thingie.
* Fix the attributions for the new floating point text.Fred Drake2001-06-081-2/+1
|
* Added credits in the right places.Fred Drake2001-06-081-0/+2
|
* Text from Tim & Guido discussing floating point arithmetic and what usersFred Drake2001-06-081-0/+265
| | | | | | | | need to understand about the binary & decimal fp, so that representation weirdness is documented somewhere. This makes it easier to repond to "bug" reports caused by user confusion & ignorance of the issues. This closes SF patch #426208.
* Changed all the examples with ugly platform-dependent float output to useTim Peters2001-05-221-16/+20
| | | | | | | | numbers that display nicely after repr(). From much doctest experience with the same trick, I believe people find examples with simple fractions easier to understand too: they can usually check the results in their head, and so feel confident about what they're seeing. Not even I get a warm feeling from a result that looks like 70330.345024097141 ...
* Update output to reflect additional precision produced by the repr() ofFred Drake2001-05-211-2/+3
| | | | | | | | | | floating point numbers in an interactive example. Added comment to help explain control flow in the example code showing how to check if a number is prime. This closes SF bugs 419434 and 424552.
* Correct two floating-point representations printed by the interpreter inFred Drake2001-04-251-2/+2
| | | | interactive examples. Error noted by Dinu Gherman.
* Update to reflect the new string repr -- \n instead of \012. This is theFred Drake2001-04-121-5/+5
| | | | only documentation file that appears to be affected by the change!
* Based on a comment by Konrad Hinsen on python-list:Fred Drake2001-04-111-4/+4
| | | | | | | | Change "EOF" to "end-of-file", on the premise that it is easier for new programmers to understand (at least a little). This does not attempt to explain "file or device attached to standard input."
* Make reference to the Library Reference in the "What Now?" chapter aFred Drake2001-04-031-5/+7
| | | | | | | | hyperlink. Fix two English usage errors caught by Jan Wells: Changed "subsequence" to "sub-sequence" in two places, and avoid improper use of "hopefully" in the first paragraph of the "What Now?" chapter.
* Add some LaTeX magic so that Latin-1 characters do not get so badlyFred Drake2001-03-131-0/+1
| | | | trashed.
* Correct typos in Ping's email address.Fred Drake2001-03-061-4/+4
| | | | | | Remove premature use of negative indexes in string operation examples; negative indexes have not been explained at that point, and the use of negative indexes are not necessary for the examples.
* Reflect change in traceback format:Fred Drake2001-02-141-12/+12
| | | | "innermost last" --> "most recent call last"
* Update to properly explain that the default Unicode encoding is ASCII, &c.Ka-Ping Yee2001-02-131-22/+40
|
* Show '\011', '\012', and '\015' as '\t', '\n', '\r' in strings.Ka-Ping Yee2001-01-241-14/+6
| | | | Switch from octal escapes to hex escapes for other nonprintable characters.
* Clarify comments about returning None using a return without an expression;Fred Drake2001-01-191-3/+2
| | | | | | this is not hard to explain! Closes SF bug #129345.
* Fix up an awkward sentence, pointed out by Chris Ryland <cpr@emsoftware.com>.Fred Drake2001-01-011-1/+1
|
* Fix broken backslashes in Unicode strings section.Fred Drake2000-11-291-2/+2
| | | | This closes bug #123730.
* Partial fix for SF bug 123730: extra backslash in tutorial.Tim Peters2000-11-291-1/+1
|
* SF non-bug 123520: fleshed out the tutorial's lambda example a little more.Tim Peters2000-11-271-2/+9
|
* Updates to reflect pending changes to the XML conversion process.Fred Drake2000-11-221-1/+1
|
* Typo: shorted --> shorterFred Drake2000-10-251-1/+1
| | | | This closes bug #117706.
* Update the display of some floating point values at the interactive promptFred Drake2000-10-201-6/+6
| | | | | | | | | to reflect current behavior. This closes SourceForge bug #117305. Made a reference to the library reference a hyperlink. Fixed some minor markup nits.
* Spelling: internalization --> internationalizationFred Drake2000-09-291-56/+48
| | | | | | | | | | | | | | | | | | | | | Fixed displays of the interactive prompt in running text. These close SourceForge bug #115658. Also: Updated discussion of tuple unpacking to reflect the general ability to unpack any sequence type. Explained that it is possible to create tuples which contain mutable values, and noted in the dictionary section that such tuples cannot be used as keys. Noted that .pyc and .pyo files can be run directly when provided as the script parameter to the interpreter, and slightly clarified comments about using modules with only the byte compiled code. Removed some XXX comments that are no longer relevant. Removed commented-out paragraph about __private names being experimental. Adjusted markup for consistency in some places.
* Correct some bitrot; some things have become inaccurate in the tutorial.Fred Drake2000-09-221-5/+9
| | | | | | | | | | <file>.readlines() does not call <file>.readline() internally anymore, and the sizehint parameter should be mentioned briefly. Some displays of floating point numbers needed to be updated due to the change in the repr() of floats (from 1.6). Both issues were noted by Aahz <aahz@panix.com>.
* When referring to namespaces, always say "namespaces" instead ofFred Drake2000-09-121-49/+50
| | | | | | "name spaces". Inconsistency noted by Keith Briggs <keith.briggs@bt.com>.
* require list comprehensions to start with a for clauseSkip Montanaro2000-08-221-4/+20
|
* Ka-Ping Yee <ping@lfw.org>:Fred Drake2000-08-161-6/+10
| | | | Further examples of list comprehensions.
* Fix some markup errors that prevented formatting, and one that didn't.Fred Drake2000-08-121-4/+5
|
* list comprehensions. seeSkip Montanaro2000-08-121-0/+21
| | | | | | http://sourceforge.net/patch/?func=detailpatch&patch_id=100654&group_id=5470 for details.
* Rip out the information about the PSA, since the fate of that is notFred Drake2000-07-271-13/+9
| | | | | | | | | | certain. Update the information about the mailing list, using the python.org address instead of cwi.nl, and point to the pipermail archives. Also update the daily average message count (at the risk of scaring people off), using the mail archive at http://www.egroups.com/group/python-list for the first half of 2000 for statistical information.
* More of Rob W. W. Hooft's spelling fixes. The only ones left now are theThomas Wouters2000-07-161-4/+4
| | | | | | | | | | | distutils patches, which I'll leave to the distutils maintainers. Tip: review the patch like this: grep "^[\!+-] " <patchfile> To get a quick and easy way to review the actual changes. Most of the changes are single-line ones, anyway.
* Markup improvements in sections relating to interactive behavior.Fred Drake2000-07-081-45/+51
| | | | Clarify some of the details of readline-related configuration.