[Bug 792056] [NEW] gcc(1) manpage formatting error on "-print-multi-lib"

[Adam Buchbinder]

Public bug reported:

The manpage for gcc(1) contains the following:

       -print-multi-lib
           Print the mapping from multilib directory names to compiler
           switches that enable them.  The directory name is separated from
           the switches by ;, and each switch starts with an @} instead of
           the @samp{-, without spaces between multiple switches.  This is
           supposed to ease shell-processing.

I noted this in the Cygwin documentation some years ago:

http://www.cygwin.com/ml/cygwin/2005-12/msg00636.html

It seems that gcc's manpages are generated by a particular toolchain,
and some escape sequences aren't being properly escaped. I'm unsure of
exactly how to proceed, but if I come up with a patch, I'll attach it
here.

http://gcc.gnu.org/onlinedocs/gccint/Man-Page-Generation.html

ProblemType: Bug
DistroRelease: Ubuntu 10.10
Package: gcc 4:4.4.4-1ubuntu2
ProcVersionSignature: Ubuntu 2.6.35-28.50-generic 2.6.35.11
Uname: Linux 2.6.35-28-generic x86_64
Architecture: amd64
CheckboxSubmission: e8aeaf9845af0062f5473c26a064d5c6
CheckboxSystem: 2a6f54df59af338184485e85cbcf0d32
Date: Thu Jun  2 16:24:47 2011
InstallationMedia: Ubuntu 10.10 "Maverick Meerkat" - Release amd64 (20101007)
ProcEnviron:
 PATH=(custom, user)
 LANG=en_US.utf8
 SHELL=/bin/bash
SourcePackage: gcc-defaults

** Affects: gcc-defaults (Ubuntu)
     Importance: Undecided
         Status: New


** Tags: amd64 apport-bug maverick

-- 
You received this bug notification because you are a member of Ubuntu
Foundations Bugs, which is subscribed to gcc-defaults in Ubuntu.
https://bugs.launchpad.net/bugs/792056

Title:
  gcc(1) manpage formatting error on "-print-multi-lib"

Status in “gcc-defaults” package in Ubuntu:
  New

Bug description:
  The manpage for gcc(1) contains the following:

         -print-multi-lib
             Print the mapping from multilib directory names to compiler
             switches that enable them.  The directory name is separated from
             the switches by ;, and each switch starts with an @} instead of
             the @samp{-, without spaces between multiple switches.  This is
             supposed to ease shell-processing.

  I noted this in the Cygwin documentation some years ago:

  http://www.cygwin.com/ml/cygwin/2005-12/msg00636.html

  It seems that gcc's manpages are generated by a particular toolchain,
  and some escape sequences aren't being properly escaped. I'm unsure of
  exactly how to proceed, but if I come up with a patch, I'll attach it
  here.

  http://gcc.gnu.org/onlinedocs/gccint/Man-Page-Generation.html

  ProblemType: Bug
  DistroRelease: Ubuntu 10.10
  Package: gcc 4:4.4.4-1ubuntu2
  ProcVersionSignature: Ubuntu 2.6.35-28.50-generic 2.6.35.11
  Uname: Linux 2.6.35-28-generic x86_64
  Architecture: amd64
  CheckboxSubmission: e8aeaf9845af0062f5473c26a064d5c6
  CheckboxSystem: 2a6f54df59af338184485e85cbcf0d32
  Date: Thu Jun  2 16:24:47 2011
  InstallationMedia: Ubuntu 10.10 "Maverick Meerkat" - Release amd64 (20101007)
  ProcEnviron:
   PATH=(custom, user)
   LANG=en_US.utf8
   SHELL=/bin/bash
  SourcePackage: gcc-defaults