Mailman 3 October 2018 - docs

[issue14911] generator.throw() documentation inaccurate
by Kristján Valur Jónsson 17 Oct '18

17 Oct '18

New submission from Kristján Valur Jónsson <kristjan(a)ccpgames.com>: the documentation for generator.throw() does not mention the fact that it has the same semantics for the three arguments as a "raise" expression has. The first two arguments can be: throw(exc_type, None) throw(exc_type, value) throw(exc_type, exc_instance) throw(exc_instance, None) ---------- assignee: docs@python components: Documentation messages: 161565 nosy: docs@python, kristjan.jonsson priority: normal severity: normal status: open title: generator.throw() documentation inaccurate versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue14911> _______________________________________

5 12

404 link to doc
by Serhii Polishchuk 17 Oct '18

17 Oct '18

https://docs.python.org/3.6/download.html epub link return 404. Same for 3.7 -- --- Regards Serhii Polishchuk +380 93 418 75 75

1 0

Hello Documentation download link give 404
by Sebastián Aberastury 16 Oct '18

16 Oct '18

Hello, I'm trying to download the documentation from https<https://docs.python.org/3.6/download.html>://<https://docs.python.org/3.6/download.html>docs.python.org<https://docs.python.org/3.6/download.html>/3.6/<https://docs.python.org/3.6/download.html>download.html<https://docs.python.org/3.6/download.html> but a 404 error appears. Thank you! Get Outlook for Android<https://aka.ms/ghei36>

1 0

[issue34590] "Logging HOWTO" should share an example of best practices for using logging in a library
by Nathaniel Manista 16 Oct '18

16 Oct '18

New submission from Nathaniel Manista <nathaniel(a)google.com>: https://docs.python.org/3.8/howto/logging.html#configuring-logging-for-a-li… is a bit too short and doesn't answer some questions that I have as a library author about the best ways to use logging in a library. Should I make use of a single logger object in my library, multiple loggers in a tree, or multiple unrelated loggers? Since I have just one public module, I'm tempted to say that I should just use one logger object. Should I present as part of my public API the name of the logger object(s) used? Probably - the documentation starts with "When developing a library which uses logging, you should take care to document how the library uses logging - for example, the names of loggers used.". But should I also include the logger objects in my API? If an application wants to reach my logger, why should they use "logging.getLogger(<name that I shared with them>)" rather than "my_library.LOGGER"? Should I use my library's fully-qualified name as the name of its logger? This seems like a great idea because it's unlikely to bring up any new conflicts. Is it a best practice? Is there any better practice? The "Configuring Logging for a Library" text could answer these questions, and maybe it should, but... I really think a toy library example that library authors could follow would also help a great deal. ---------- assignee: docs@python components: Documentation messages: 324652 nosy: Nathaniel Manista, docs@python priority: normal severity: normal status: open title: "Logging HOWTO" should share an example of best practices for using logging in a library type: enhancement versions: Python 2.7, Python 3.4, Python 3.5, Python 3.6, Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue34590> _______________________________________

5 7

Download Python 3.7.1rc2 Documentation
by Steve Turpin 16 Oct '18

16 Oct '18

Only the html files exist. Steve

1 0

Download Docs Links
by Daniel Donovan 16 Oct '18

16 Oct '18

Hi The download links for the documents are raising 404s. Specifically the PDF download links. Thanks Daniel Donovan

1 0

Download PDF docs for Python 3.6
by Gabriele Sardoni 16 Oct '18

16 Oct '18

Hello, I try to download PDF docs for Python 3.6 but it seem does not exists. At https://docs.python.org/3.6/download.html all document are linked but in https://docs.python.org/3.6/archives/ there are html and text only. Can you help me? Thanks Gabriele Sardoni (Italy)

1 0

Documentation Download option not Working [HTTP 404]
by Ranajit 16 Oct '18

16 Oct '18

Dear Developers, As a user, we need full documentation sometime in offline mode. But download link is not working right now... Please solve this error for us... Thanking You R.Nath

1 0

[issue34967] Sphinx is deprecating add_description_unit
by Julien Palard 16 Oct '18

16 Oct '18

New submission from Julien Palard <julien+python(a)palard.fr>: When running `make -C Doc/ autobuild-dev-html` with a recent Sphinx, I'm getting: /.../site-packages/sphinx/application.py:927: RemovedInSphinx20Warning: app.add_description_unit() is now deprecated. Use app.add_object_type() instead. Looks easy to fix. ---------- assignee: docs@python components: Documentation keywords: easy messages: 327600 nosy: docs@python, mdk priority: normal severity: normal status: open title: Sphinx is deprecating add_description_unit versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue34967> _______________________________________

3 9

EPub documentation is missing
by Ryan Johnson 15 Oct '18

15 Oct '18

Wanted to download EPub, but the link is dead. Checked the directory where the text and pdfs are stored and the file does not exist. Would appreciate it being added back.

1 0