libudev devhelp is incomplete

Bug #519670 reported by Karl Hegbloom
16
This bug affects 3 people
Affects Status Importance Assigned to Milestone
udev (Ubuntu)
Fix Released
Medium
Martin Pitt

Bug Description

Binary package hint: udev

When I open devhelp to read the API documentation for libudev, the documentation is mostly blank, and does not fully document libudev the way the online version does at http://www.kernel.org/pub/linux/utils/kernel/hotplug/libudev/
It is either incomplete in this version of libudev, or not being generated correctly by the package build.

ProblemType: Bug
Architecture: amd64
Date: Wed Feb 10 00:17:30 2010
DistroRelease: Ubuntu 10.04
Package: libudev-dev 149-5
ProcEnviron:
 PATH=(custom, user)
 LANG=en_US.UTF-8
 SHELL=/bin/zsh
ProcVersionSignature: Ubuntu 2.6.32-12.17-generic
SourcePackage: udev
Uname: Linux 2.6.32-12-generic x86_64

Revision history for this message
Karl Hegbloom (karl.hegbloom) wrote :
Revision history for this message
Karl Hegbloom (karl.hegbloom) wrote :

As far as I can tell, the gtkdocize tool generates a makefile that doesn't work right from a build directory. The way it's all set up, if you run the configure in the source directory, then cd into libudev/docs and run make there, you'll get correct documentation files... but only if you don't modify the gtk-doc.make with the sed statement in the debian/rules 'prep' target. After that, a make distclean will actually leave those generated documents where they are. For what it's worth, I'd add an extra step to the build to have it do that just to get them right. I'll see if I can write a patch for it.

Martin Pitt (pitti)
Changed in udev (Ubuntu):
status: New → Triaged
importance: Undecided → Medium
Revision history for this message
Martin Pitt (pitti) wrote :

Fixed in packaging bzr.

Changed in udev (Ubuntu):
assignee: nobody → Martin Pitt (pitti)
status: Triaged → Fix Committed
Revision history for this message
Launchpad Janitor (janitor) wrote :

This bug was fixed in the package udev - 161+git20100827-1

---------------
udev (161+git20100827-1) maverick; urgency=low

  * Merge fixes from trunk:
    - keymap: Fix Acer TravelMate 4720 (LP: #569815)
    - gudev: fix crash if netlink is not available (LP: #581527)
    - udev(7) manpage: Fix description of $attr (LP: #348513)
  * debian/changelog: Fix bug reference in previous upload.
  * debian/udev.{pre,post}inst: Remove pre-lucid upgrade code.
  * debian/udev.postinst: Drop obsolete /lib/udev/devices/sndstat symlink, OSS
    has gone from our kernels ages ago. (LP: #605443)
  * debian/udev.postinst, create_devices(): Drop devices which are handled by
    static_dev_create_links().
  * debian/udev.postinst, create_devices(): Drop devices which are handled by
    devtmpfs.
  * debian/rules: Work around gtk-doc not being able to work in a separate
    build tree; debian/rules prep already fixes $srcdir→$builddir, so copy
    the relevant source files into the build tree so that gtk-doc has
    something to scan for. (LP: #519670)
  * Add debian/local/hotplug.functions: Provides some helper functions which
    udev callouts can use. This is being used by usb-modeswitch, alsa, and
    other Debian packages. Copied from current udev sid package. (LP: #625110)
 -- Martin Pitt <email address hidden> Mon, 30 Aug 2010 11:21:43 +0200

Changed in udev (Ubuntu):
status: Fix Committed → Fix Released
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Duplicates of this bug

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.