Python 3 Doc not show in Devhelp

[Hồng Quân]

Binary package hint: python3.2-doc

The Python 3.2 Doc does not show in Devhelp.

ProblemType: Bug
DistroRelease: Ubuntu 11.04
Package: python3.2-doc 3.2-1ubuntu1
ProcVersionSignature: Ubuntu 2.6.38-8.42-generic 2.6.38.2
Uname: Linux 2.6.38-8-generic i686
NonfreeKernelModules: nvidia
Architecture: i386
Date: Mon May 23 21:52:19 2011
Dependencies: libjs-jquery 1.5-2ubuntu1
InstallationMedia: Ubuntu 11.04 "Natty Narwhal" - Release i386 (20110427.1)
PackageArchitecture: all
ProcEnviron:
 LANGUAGE=en_US:en
 LANG=en_US.UTF-8
 SHELL=/bin/bash
SourcePackage: python3.2
UpgradeStatus: No upgrade log present (probably fresh install)

[Matthias Klose (doko)]

seems to be an issue with devhelp. if both python2.7-doc and python3.2-doc are installed, then only one of them is shown in devhelp.

[Vadim Rutkovsky (roignac)]

Can't reproduce using these versions:
devhelp:
  Installed: 3.3.3-1ubuntu1
  Candidate: 3.3.3-1ubuntu1
  Version table:
 *** 3.3.3-1ubuntu1 0
        500 http://archive.ubuntu.com/ubuntu/ precise/main amd64 Packages
        100 /var/lib/dpkg/status
python2.7-doc:
  Installed: 2.7.2-13ubuntu5
  Candidate: 2.7.2-13ubuntu5
  Version table:
 *** 2.7.2-13ubuntu5 0
        500 http://archive.ubuntu.com/ubuntu/ precise/main amd64 Packages
        100 /var/lib/dpkg/status
python:
  Installed: 2.7.2-9ubuntu2
  Candidate: 2.7.2-9ubuntu2
  Version table:
 *** 2.7.2-9ubuntu2 0
        500 http://archive.ubuntu.com/ubuntu/ precise/main amd64 Packages
        100 /var/lib/dpkg/status
python3.2-doc:
  Installed: 3.2.2-4ubuntu1
  Candidate: 3.2.2-4ubuntu1
  Version table:
 *** 3.2.2-4ubuntu1 0
        500 http://archive.ubuntu.com/ubuntu/ precise/main amd64 Packages
        100 /var/lib/dpkg/status

Python 3.2 doc appears. Python 2.7 doc appears only if python3.2 package is removed.

Is this issue still reproducible? Which versions are you using?

[Hồng Quân (ng-hong-quan)]

I'm using DevHelp 3.2.0 under Ubuntu 11.10 (Ocelot). Maybe the newer version solves this issue?

[Vadim Rutkovsky (roignac)]

Yes, please try checking this in Precise Pangolin

[Launchpad Janitor (janitor)]

[Expired for devhelp (Ubuntu) because there has been no activity for 60 days.]

[Hồng Quân (ng-hong-quan)]

This bug still exists in Ubuntu 12.04 (Pangolin). Please check.
$ devhelp --version
Devhelp 3.4.1

$ apt-cache show python3-doc
Package: python3-doc
Priority: optional
Section: doc
Installed-Size: 63
Maintainer: Ubuntu Developers <email address hidden>
Original-Maintainer: Matthias Klose <email address hidden>
Architecture: all
Source: python3-defaults
Version: 3.2.3-0ubuntu1
Depends: python3.2-doc (>= 3.2.3)
Suggests: python3 (>= 3.2.3-0ubuntu1), python3-examples
Filename: pool/main/p/python3-defaults/python3-doc_3.2.3-0ubuntu1_all.deb
Size: 12036
MD5sum: 2d8951258d316462225456a25004c881
SHA1: a0563d3cf354680df7e8c9851b11fd790f6c598e
SHA256: 6c5e9cd1ef4a4ad67fe230280cfa3500bd0c13931caf073fe75198e0ba94de35
Description-en: documentation for the high-level object-oriented language Python 3
 This is the official set of documentation for the interactive high-level
 object-oriented language Python 3 (v3.2). All documents are provided
 in HTML format, some in info format. The package consists of nine documents:
 .
   * Tutorial
   * Python Library Reference
   * Macintosh Module Reference
   * Python Language Reference
   * Extending and Embedding Python
   * Python/C API Reference
   * Installing Python Modules
   * Documenting Python
   * Distributing Python Modules
 .
 This package is a dependency package, which depends on Debian's default
 Python 3 version (currently v3.2).
Homepage: http://www.python.org/
Description-md5: c9501c8e73abc0b80e37053fc252c402
Bugs: https://bugs.launchpad.net/ubuntu/+filebug
Origin: Ubuntu
Supported: 5y

[Launchpad Janitor (janitor)]

[Expired for devhelp (Ubuntu) because there has been no activity for 60 days.]

[Joel Peláez Jorge (joelpelaez)]

The problem is in tag "name" in python3.2.devhelp.gz and python2.7.devhelp.gz, this is the same: "Python"; and DevHelp use the major version (this case python3-doc).
A solution is change the tag "name" to: "Python2" and "Python3" respectively.

[Joel Peláez Jorge (joelpelaez)]

This problem is in python3.2-dev and python2.7-doc DevHelp Book File (.devhelp.gz)

[Scott Kitterman (kitterman)]

Python2.7 is python. Changing it would be wrong.

[Joel Peláez Jorge (joelpelaez)]

But it works for me, I have installed python3.2-doc and python2.7-doc packages, changed the tag name in their DevHelp Book Description solve the problem.
A example: the gtkmm documentation packages (2.4 and 3.0) difference the DevHelp Book Description using "gtkmm-2.4" and "gtkmm-3.0" in attribute "name" in the tag <book>. The python documentation packages must do the same. Is possible use "Python2.7" and "Python3.2", this can help if has installed more than one the same major version: 2.* or 3.* versions.

[Launchpad Janitor (janitor)]

Status changed to 'Confirmed' because the bug affects multiple users.

[Sam Bull (dreamsorcerer)]

I can also confirm that just changing the name attribute in /usr/share/doc/python3.2/html/python3.2.devhelp.gz fixes this problem. Just changing it from "Python" to "Python3" is enough, which I've done in the above patch.

[Ubuntu Foundations Team Bug Bot (crichton)]

The attachment "Adds 3 to name attribute." of this bug report has been identified as being a patch. The ubuntu-reviewers team has been subscribed to the bug report so that they can review the patch. In the event that this is in fact not a patch you can resolve this situation by removing the tag 'patch' from the bug report and editing the attachment so that it is not flagged as a patch. Additionally, if you are member of the ubuntu-reviewers team please also unsubscribe the team from this bug report.

[This is an automated message performed by a Launchpad user owned by Brian Murray. Please contact him regarding any issues with the action taken in this bug report.]

[Launchpad Janitor (janitor)]

This bug was fixed in the package python3.2 - 3.2.3-6ubuntu1

---------------
python3.2 (3.2.3-6ubuntu1) quantal; urgency=low

  * Update to 20120910 from the 3.2 branch. Linux relevant fixes:
    - Issue #13992: The trashcan mechanism is now thread-safe. This eliminates
      sporadic crashes in multi-thread programs when several long deallocator
      chains ran concurrently and involved subclasses of built-in container
      types.
    - Issue #15846: Fix SystemError which happened when using ast.parse in an
      exception handler on code with syntax errors.
    - Issue #15801: Make sure mappings passed to '%' formatting are actually
      subscriptable.
    - Issue #15881: Fixed atexit hook in multiprocessing.
    - Issue #15340: Fix importing the random module when /dev/urandom cannot
      be opened. This was a regression caused by the hash randomization patch.
    - Issue #15841: The readable(), writable() and seekable() methods of BytesIO
      and StringIO objects now raise ValueError when the object has been closed.
    - Issue #15509: webbrowser.UnixBrowser no longer passes empty arguments to
      Popen when %action substitutions produce empty strings.
    - Issue #12776,#11839: call argparse type function (specified by
      add_argument) only once.
    - Issue #15676: Now "mmap" check for empty files before doing the
      offset check.
    - Issue #15802: Fix test logic in TestMaildir.test_create_tmp.
    - Issue #15819: Make sure we can build Python out-of-tree from a readonly
      source directory.
    - Issue #15822: Ensure 2to3 grammar pickles are properly installed.
    - Issue #11964: Document a change in v3.2 to the behavior of the indent
      parameter of json encoding operations.

python3.2 (3.2.3-6) unstable; urgency=low

  * Don't run the testsuite on the Hurd and kfreebsd (as already done
    for python2.7).
  * Encode the version in the devhelp documentation name. LP: #787039.

python3.2 (3.2.3-5) unstable; urgency=low

  * Hint on installing the python-gdbm package on failing _gdbm import.
    LP: #995616.
  * Enable verbose build for the sharedmods target.
  * libpython3.2: Fix libpython3.2.so symlink. Closes: #686374.
  * Fix issue #15847: allow args to be a tuple in parse_args.
  * Fix issue #15340: Fix importing the random module when /dev/urandom cannot
    be opened. Regression caused by the hash randomization patch.
  * Don't use `-n' anymore to start idle in the desktop/menu files, not
    needed anymore for multiseat installations.
 -- Matthias Klose <email address hidden> Mon, 10 Sep 2012 12:32:17 +0200

[Matthias Klose (doko)]

nothing to change in python2.7

[Balthazar Rouberol (rouberol-b)]

I confirm Sam Bull's technique works: changing the "name" tag of the Python3.X (I'm experiencing the problem with the Python3.3.2 doc built from source with Sphinx) from "Python" to "Python3" solves this issue.