Mailman 3 June 2010 - docs

Question mark in grammar notation
by Thomas Oliveira 27 Jun '10

27 Jun '10

Dear Admin, In http://docs.python.org/py3k/library/string.html#format-string-syntax a question mark is used at the definition of the grammar for a replacement field: arg_name ::= (identifier | integer)? However, it is not defined in http://docs.python.org/py3k/reference/introduction.html#notation Would it be the same as arg_name ::= [identifier | integer] ? Thank you for your attention, Thomas Oliveira

2 1

Confusing sentence at http://docs.python.org/tutorial/introduction.html#strings
by dave000 27 Jun '10

27 Jun '10

http://docs.python.org/tutorial/introduction.html#strings The statement "Note that newlines still need to be embedded in the string using \n; the newline following the trailing backslash is discarded. This example would print the following:" is confusing with the semicolon in that sentence. I was looking for a semicolon in the code fragment and thought there was a typo at first. Perhaps the following would be clearer? ""Note that newlines still need to be embedded in the string using \n ; the newline following the trailing backslash is discarded. This example would print the following:" The gray color on the command-line would then have enough white space to differentiate it from the semicolon. Or maybe i just need to buy a better monitor! :D

2 1

Fwd: Printed docs legitimate?
by Georg Brandl 27 Jun '10

27 Jun '10

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Forwarding to PSF board -- printing and selling *is* allowed, however I don't know if the $1 donation claim is correct. Georg - -------- Original-Nachricht -------- Betreff: [docs] Printed docs legitimate? Datum: Tue, 22 Jun 2010 23:53:38 -0500 Von: John Bokma <contact(a)johnbokma.com> Organisation: Castle Amber An: docs(a)python.org Hi, I participate in a Usenet discussion (comp.lang.python) regarding if: http://www.amazon.com/Python-Reference-Manual-Documentation-Part/dp/1441412… is allowed? I think yes. On top of that, do you know if Python Software Foundation does receive 1USD donations per sold book per "For each copy sold $1 will be donated to the Python Software Foundation by the publisher." I have been considering to buy those manuals but if this is not in agreement with python.org / PSF, let me know. Thanks for your time, John _______________________________________________ docs mailing list docs(a)python.org http://mail.python.org/mailman/listinfo/docs -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.15 (GNU/Linux) iEYEARECAAYFAkwnK1gACgkQN9GcIYhpnLC+TgCgnoAjz3T9A/vyj4cxeYGXoOGt He8An3Q5Hfyz9Xfp4folCs9dXKWFtp2p =1sqf -----END PGP SIGNATURE-----

1 0

[issue9078] Fix C API documentation of unicode
by STINNER Victor 27 Jun '10

27 Jun '10

New submission from STINNER Victor <victor.stinner(a)haypocalc.com>: Attached patch fixes minor bugs in the C API documentation of unicode. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9078> _______________________________________

2 2

[issue9024] PyDateTime_IMPORT macro incorrectly marked up
by Alexander Belopolsky 26 Jun '10

26 Jun '10

Alexander Belopolsky <belopolsky(a)users.sourceforge.net> added the comment: Committed in r82251. Thanks for the patch, Tim. ---------- status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9024> _______________________________________

1 0

[issue9024] PyDateTime_IMPORT macro incorrectly marked up
by Alexander Belopolsky 26 Jun '10

26 Jun '10

Alexander Belopolsky <belopolsky(a)users.sourceforge.net> added the comment: Should also add :cvar: tag to PyDateTimeAPI. http://docs.python.org/documenting/markup.html#information-units Thanks, Ezio. ---------- assignee: docs@python -> belopolsky status: closed -> open _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9024> _______________________________________

1 0

[issue9024] PyDateTime_IMPORT macro incorrectly marked up
by Alexander Belopolsky 26 Jun '10

26 Jun '10

Alexander Belopolsky <belopolsky(a)users.sourceforge.net> added the comment: Committed in r82236 - r82239. ---------- nosy: +belopolsky resolution: -> accepted stage: patch review -> committed/rejected status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9024> _______________________________________

1 0

[issue5212] Incorrect note about md5 in hmac module documentation
by Terry J. Reedy 26 Jun '10

26 Jun '10

Terry J. Reedy <tjreedy(a)udel.edu> added the comment: Are you proposing that the note be removed entirely (and ignore the results it is based on) or just reworded? If it were removed, I could imagine complaints. If reword, specifically how? ---------- assignee: georg.brandl -> docs@python nosy: +docs@python, tjreedy _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue5212> _______________________________________

1 0

[issue9076] Add C-API documentation for PyUnicode_AsDecodedObject/Unicode and PyUnicode_AsEncodedObject/Unicode
by Marc-Andre Lemburg 25 Jun '10

25 Jun '10

Changes by Marc-Andre Lemburg <mal(a)egenix.com>: ---------- title: Remove PyUnicode_AsDecodedObject/Unicode and PyUnicode_AsEncodedObject/Unicode? -> Add C-API documentation for PyUnicode_AsDecodedObject/Unicode and PyUnicode_AsEncodedObject/Unicode _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9076> _______________________________________

1 0

[issue9076] Remove PyUnicode_AsDecodedObject/Unicode and PyUnicode_AsEncodedObject/Unicode?
by Marc-Andre Lemburg 25 Jun '10

25 Jun '10

Changes by Marc-Andre Lemburg <mal(a)egenix.com>: ---------- assignee: -> docs@python components: +Documentation -Unicode nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9076> _______________________________________

1 0