[issue18384] Add devhelp build instructions to the documentation makefile
New submission from Balthazar Rouberol: The documentation makefile is missing support for Devhelp. The supplied patch fixes this for the Python 3 branch. It also edits the ouput of the sphinx build to change the name of the devhelp project. This is needed to be able to have both versions of documentation (py2 & py3) displayed in Devhelp. This is useful if developers need to access documentation for both versions, such as both maintaining a Python2 project and starting a new project in Python3. This has been patched in some distributions downstream, but would be nice to have patched upstream. See: https://bugs.launchpad.net/ubuntu/+source/devhelp/+bug/787039 ---------- assignee: docs@python components: Documentation files: devhelp-build-py3.patch keywords: patch messages: 192457 nosy: brouberol, docs@python priority: normal severity: normal status: open title: Add devhelp build instructions to the documentation makefile type: enhancement versions: Python 3.5 Added file: http://bugs.python.org/file30823/devhelp-build-py3.patch _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue18384> _______________________________________
Changes by Ezio Melotti <ezio.melotti@gmail.com>: ---------- nosy: +georg.brandl stage: -> patch review versions: +Python 3.4 -Python 3.5 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue18384> _______________________________________
Changes by Balthazar Rouberol <brouberol@imap.cc>: Removed file: http://bugs.python.org/file30823/devhelp-build-py3.patch _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue18384> _______________________________________
Changes by Balthazar Rouberol <brouberol@imap.cc>: Added file: http://bugs.python.org/file30824/devhelp-build-py3.patch _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue18384> _______________________________________
Changes by Balthazar Rouberol <brouberol@imap.cc>: ---------- title: Add devhelp build instructions to the documentation makefile -> Add devhelp build instructions to the documentation makefile (Python3) _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue18384> _______________________________________
Changes by Balthazar Rouberol <brouberol@imap.cc>: ---------- title: Add devhelp build instructions to the documentation makefile (Python3) -> Add devhelp build instructions to the documentation makefile versions: +Python 2.7 Added file: http://bugs.python.org/file30826/devhelp-build-py2.patch _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue18384> _______________________________________
R. David Murray added the comment: I'm not sure that this belongs in core, but I'll certainly defer to Georg on that :). If it does go in, the help string should explain what 'devhelp' does, since it isn't obvious from the name (for a non-GNOME user...I had to google it). ---------- nosy: +r.david.murray _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue18384> _______________________________________
Berker Peksag added the comment: I think we should avoid adding distro specific tools into CPython repository (and the another reason to reject this is that the other distros will probably want to add their tools). ---------- nosy: +berker.peksag resolution: -> rejected stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue18384> _______________________________________
participants (4)
-
Balthazar Rouberol
-
Berker Peksag
-
Ezio Melotti
-
R. David Murray