← Back to team overview

kernel-packages team mailing list archive

[Bug 1223920] [NEW] Documentation build error

 

Public bug reported:

Building documentation results in the following error:

    Error(/build/buildd/linux-3.5.0//include/linux/wait.h:621): cannot
understand prototype:'wait_event_interruptible_lock_irq_timeout(wq,
condition, lock,     \ '

It looks like prototypes are expected to be defined in a single line.

The following commit should fix this issue:

commit 654784284430bf2739985914b65e09c7c35a7273
Author: Daniel Santos <daniel.santos@xxxxxxxxx>
Date:   Thu Oct 4 17:15:05 2012 -0700

    kernel-doc: bugfix - multi-line macros
    
    Prior to this patch the following code breaks:
    
    /**
     * multiline_example - this breaks kernel-doc
     */
     #define multiline_example( \
    myparam)
    
    Producing this error:
    
    Error(somefile.h:983): cannot understand prototype: 'multiline_example( \ '
    
    This patch fixes the issue by appending all lines ending in a blackslash
    (optionally followed by whitespace), removing the backslash and any
    whitespace after it prior to appending (just like the C pre-processor
    would).
    
    This fixes a break in kerel-doc introduced by the additions to rbtree.h.

ProblemType: Bug
DistroRelease: Ubuntu 12.10
Package: linux-image-3.5.0-34-generic 3.5.0-34.55
ProcVersionSignature: Ubuntu 3.5.0-34.55-generic 3.5.7.13
Uname: Linux 3.5.0-34-generic x86_64
ApportVersion: 2.6.1-0ubuntu12
Architecture: amd64
AudioDevicesInUse:
 USER        PID ACCESS COMMAND
 /dev/snd/controlC2:  ubuntu     1681 F.... pulseaudio
 /dev/snd/controlC1:  ubuntu     1681 F.... pulseaudio
 /dev/snd/controlC0:  ubuntu     1681 F.... pulseaudio
CRDA: Error: command ['iw', 'reg', 'get'] failed with exit code 1: nl80211 not found.
CurrentDmesg:
 [   15.377267] show_signal_msg: 57 callbacks suppressed
 [   15.377272] colord-sane[1462]: segfault at 0 ip 00007f0904e1d5d4 sp 00007fffef3c7950 error 4 in libc-2.15.so[7f0904d62000+1b5000]
 [   15.628049] end_request: I/O error, dev fd0, sector 0
 [   15.648073] end_request: I/O error, dev fd0, sector 0
 [   64.737929] gdbus[1675]: segfault at 200000006 ip 00007f9690b527d3 sp 00007f96871cad80 error 4 in libglib-2.0.so.0.3400.1[7f9690b0b000+f5000]
Date: Wed Sep 11 15:54:49 2013
HibernationDevice: RESUME=UUID=38974120-e8e1-4057-a8ba-999df156bb26
InstallationDate: Installed on 2012-12-19 (266 days ago)
InstallationMedia: Ubuntu 12.10 "Quantal Quetzal" - Release amd64 (20121017.5)
IwConfig:
 eth0      no wireless extensions.
 
 lo        no wireless extensions.
Lsusb: Error: command ['lsusb'] failed with exit code 1: unable to initialize libusb: -99
MachineType: Bochs Bochs
MarkForUpload: True
ProcEnviron:
 TERM=xterm
 PATH=(custom, no user)
 XDG_RUNTIME_DIR=<set>
 LANG=en_US.UTF-8
 SHELL=/bin/bash
ProcFB: 0 EFI VGA
ProcKernelCmdLine: BOOT_IMAGE=/boot/vmlinuz-3.5.0-34-generic root=UUID=89a7e0f5-d420-4ddd-8958-c23dafbc8746 ro console=ttyS0
RelatedPackageVersions:
 linux-restricted-modules-3.5.0-34-generic N/A
 linux-backports-modules-3.5.0-34-generic  N/A
 linux-firmware                            1.95.1
RfKill:
 
SourcePackage: linux
UpgradeStatus: No upgrade log present (probably fresh install)
dmi.bios.date: 01/01/2011
dmi.bios.vendor: Bochs
dmi.bios.version: Bochs
dmi.chassis.type: 1
dmi.chassis.vendor: Bochs
dmi.modalias: dmi:bvnBochs:bvrBochs:bd01/01/2011:svnBochs:pnBochs:pvr:cvnBochs:ct1:cvr:
dmi.product.name: Bochs
dmi.sys.vendor: Bochs

** Affects: linux (Ubuntu)
     Importance: Undecided
     Assignee: Luis Henriques (henrix)
         Status: Triaged


** Tags: amd64 apport-bug quantal running-unity

** Changed in: linux (Ubuntu)
       Status: New => Triaged

-- 
You received this bug notification because you are a member of Kernel
Packages, which is subscribed to linux in Ubuntu.
https://bugs.launchpad.net/bugs/1223920

Title:
  Documentation build error

Status in “linux” package in Ubuntu:
  Triaged

Bug description:
  Building documentation results in the following error:

      Error(/build/buildd/linux-3.5.0//include/linux/wait.h:621): cannot
  understand prototype:'wait_event_interruptible_lock_irq_timeout(wq,
  condition, lock,     \ '

  It looks like prototypes are expected to be defined in a single line.

  The following commit should fix this issue:

  commit 654784284430bf2739985914b65e09c7c35a7273
  Author: Daniel Santos <daniel.santos@xxxxxxxxx>
  Date:   Thu Oct 4 17:15:05 2012 -0700

      kernel-doc: bugfix - multi-line macros
      
      Prior to this patch the following code breaks:
      
      /**
       * multiline_example - this breaks kernel-doc
       */
       #define multiline_example( \
      myparam)
      
      Producing this error:
      
      Error(somefile.h:983): cannot understand prototype: 'multiline_example( \ '
      
      This patch fixes the issue by appending all lines ending in a blackslash
      (optionally followed by whitespace), removing the backslash and any
      whitespace after it prior to appending (just like the C pre-processor
      would).
      
      This fixes a break in kerel-doc introduced by the additions to rbtree.h.

  ProblemType: Bug
  DistroRelease: Ubuntu 12.10
  Package: linux-image-3.5.0-34-generic 3.5.0-34.55
  ProcVersionSignature: Ubuntu 3.5.0-34.55-generic 3.5.7.13
  Uname: Linux 3.5.0-34-generic x86_64
  ApportVersion: 2.6.1-0ubuntu12
  Architecture: amd64
  AudioDevicesInUse:
   USER        PID ACCESS COMMAND
   /dev/snd/controlC2:  ubuntu     1681 F.... pulseaudio
   /dev/snd/controlC1:  ubuntu     1681 F.... pulseaudio
   /dev/snd/controlC0:  ubuntu     1681 F.... pulseaudio
  CRDA: Error: command ['iw', 'reg', 'get'] failed with exit code 1: nl80211 not found.
  CurrentDmesg:
   [   15.377267] show_signal_msg: 57 callbacks suppressed
   [   15.377272] colord-sane[1462]: segfault at 0 ip 00007f0904e1d5d4 sp 00007fffef3c7950 error 4 in libc-2.15.so[7f0904d62000+1b5000]
   [   15.628049] end_request: I/O error, dev fd0, sector 0
   [   15.648073] end_request: I/O error, dev fd0, sector 0
   [   64.737929] gdbus[1675]: segfault at 200000006 ip 00007f9690b527d3 sp 00007f96871cad80 error 4 in libglib-2.0.so.0.3400.1[7f9690b0b000+f5000]
  Date: Wed Sep 11 15:54:49 2013
  HibernationDevice: RESUME=UUID=38974120-e8e1-4057-a8ba-999df156bb26
  InstallationDate: Installed on 2012-12-19 (266 days ago)
  InstallationMedia: Ubuntu 12.10 "Quantal Quetzal" - Release amd64 (20121017.5)
  IwConfig:
   eth0      no wireless extensions.
   
   lo        no wireless extensions.
  Lsusb: Error: command ['lsusb'] failed with exit code 1: unable to initialize libusb: -99
  MachineType: Bochs Bochs
  MarkForUpload: True
  ProcEnviron:
   TERM=xterm
   PATH=(custom, no user)
   XDG_RUNTIME_DIR=<set>
   LANG=en_US.UTF-8
   SHELL=/bin/bash
  ProcFB: 0 EFI VGA
  ProcKernelCmdLine: BOOT_IMAGE=/boot/vmlinuz-3.5.0-34-generic root=UUID=89a7e0f5-d420-4ddd-8958-c23dafbc8746 ro console=ttyS0
  RelatedPackageVersions:
   linux-restricted-modules-3.5.0-34-generic N/A
   linux-backports-modules-3.5.0-34-generic  N/A
   linux-firmware                            1.95.1
  RfKill:
   
  SourcePackage: linux
  UpgradeStatus: No upgrade log present (probably fresh install)
  dmi.bios.date: 01/01/2011
  dmi.bios.vendor: Bochs
  dmi.bios.version: Bochs
  dmi.chassis.type: 1
  dmi.chassis.vendor: Bochs
  dmi.modalias: dmi:bvnBochs:bvrBochs:bd01/01/2011:svnBochs:pnBochs:pvr:cvnBochs:ct1:cvr:
  dmi.product.name: Bochs
  dmi.sys.vendor: Bochs

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/linux/+bug/1223920/+subscriptions


Follow ups

References