mirror of
https://github.com/python/cpython.git
synced 2024-11-25 10:54:51 +08:00
Branch merge
This commit is contained in:
commit
d4ae04fdb8
@ -135,7 +135,7 @@ Good example (establishing confident knowledge in the effective use of the langu
|
||||
Economy of Expression
|
||||
---------------------
|
||||
|
||||
More documentation is not necessarily better documentation. Error on the side
|
||||
More documentation is not necessarily better documentation. Err on the side
|
||||
of being succinct.
|
||||
|
||||
It is an unfortunate fact that making documentation longer can be an impediment
|
||||
@ -197,7 +197,7 @@ Audience
|
||||
The tone of the tutorial (and all the docs) needs to be respectful of the
|
||||
reader's intelligence. Don't presume that the readers are stupid. Lay out the
|
||||
relevant information, show motivating use cases, provide glossary links, and do
|
||||
our best to connect-the-dots, but don't talk down to them or waste their time.
|
||||
your best to connect-the-dots, but don't talk down to them or waste their time.
|
||||
|
||||
The tutorial is meant for newcomers, many of whom will be using the tutorial to
|
||||
evaluate the language as a whole. The experience needs to be positive and not
|
||||
|
@ -124,7 +124,7 @@ class HTMLParser(_markupbase.ParserBase):
|
||||
_markupbase.ParserBase.reset(self)
|
||||
|
||||
def feed(self, data):
|
||||
"""Feed data to the parser.
|
||||
r"""Feed data to the parser.
|
||||
|
||||
Call this as often as you want, with as little or as much text
|
||||
as you want (may include '\n').
|
||||
|
@ -8,7 +8,7 @@ from types import ModuleType
|
||||
|
||||
__all__ = [
|
||||
'get_importer', 'iter_importers', 'get_loader', 'find_loader',
|
||||
'walk_packages', 'iter_modules',
|
||||
'walk_packages', 'iter_modules', 'get_data',
|
||||
'ImpImporter', 'ImpLoader', 'read_code', 'extend_path',
|
||||
]
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user