Re: [docs] Standardize documentation whitespace, formatting (issue 23921)

http://bugs.python.org/review/23921/diff/14579/Doc/faq/programming.rst File Doc/faq/programming.rst (right): http://bugs.python.org/review/23921/diff/14579/Doc/faq/programming.rst#newco... Doc/faq/programming.rst:668: >>> print(b) On 2016/01/07 02:41:26, vadmium wrote:
Why not add prompts to the lines above as well?
Yes, link this it's a bit inconsistent. http://bugs.python.org/review/23921/diff/14579/Doc/howto/logging-cookbook.rs... File Doc/howto/logging-cookbook.rst (right): http://bugs.python.org/review/23921/diff/14579/Doc/howto/logging-cookbook.rs... Doc/howto/logging-cookbook.rst:742: root.setLevel(logging.DEBUG) # send all messages, for demo; no other level or filter logic applied. this is probably too long a line (e.g. for PDF output), better move the comment above the code http://bugs.python.org/review/23921/diff/14579/Doc/howto/urllib2.rst File Doc/howto/urllib2.rst (right): http://bugs.python.org/review/23921/diff/14579/Doc/howto/urllib2.rst#newcode... Doc/howto/urllib2.rst:178: values = {'name' : 'Michael Foord', could also remove the spaces before ':' as well. http://bugs.python.org/review/23921/diff/14579/Doc/library/locale.rst File Doc/library/locale.rst (right): http://bugs.python.org/review/23921/diff/14579/Doc/library/locale.rst#newcod... Doc/library/locale.rst:473: >>> locale.strcoll('f\xe4n', 'foo') # compare a string containing an umlaut keep only 2 spaces, the line is already long http://bugs.python.org/review/23921/diff/14579/Doc/library/multiprocessing.r... File Doc/library/multiprocessing.rst (right): http://bugs.python.org/review/23921/diff/14579/Doc/library/multiprocessing.r... Doc/library/multiprocessing.rst:2071: print(result.get(timeout=1)) # prints "100" unless your computer is *very* slow these lines are also too long. http://bugs.python.org/review/23921/diff/14579/Doc/library/optparse.rst File Doc/library/optparse.rst (right): http://bugs.python.org/review/23921/diff/14579/Doc/library/optparse.rst#newc... Doc/library/optparse.rst:1827: [...] replace by a single ellipsis, I don't think we're using that style anywhere else http://bugs.python.org/review/23921/diff/14579/Doc/library/tokenize.rst File Doc/library/tokenize.rst (right): http://bugs.python.org/review/23921/diff/14579/Doc/library/tokenize.rst#newc... Doc/library/tokenize.rst:216: if toknum == NUMBER and '.' in tokval: # replace NUMBER tokens no, keep shorter line http://bugs.python.org/review/23921/diff/14579/Doc/library/urllib.request.rs... File Doc/library/urllib.request.rst (right): http://bugs.python.org/review/23921/diff/14579/Doc/library/urllib.request.rs... Doc/library/urllib.request.rst:1105: ... data=b'This data is passed to stdin of the CGI') this is also a case where the longer line may hurt http://bugs.python.org/review/23921/diff/14579/Doc/whatsnew/3.2.rst File Doc/whatsnew/3.2.rst (right): http://bugs.python.org/review/23921/diff/14579/Doc/whatsnew/3.2.rst#newcode1... Doc/whatsnew/3.2.rst:1540: >>> os.chdir('mydata') # change to the source directory again, too long lines here. http://bugs.python.org/review/23921/
participants (1)
-
georg@python.org