[Bug other/11146] New: Bad characters in cpp.1, gcc.1 man pages

[Bug other/11146] New: Bad characters in cpp.1, gcc.1 man pages

[drk@sgi.com]

PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=11146

           Summary: Bad characters in cpp.1, gcc.1 man pages
           Product: gcc
           Version: 3.3
            Status: UNCONFIRMED
          Severity: normal
          Priority: P2
         Component: other
        AssignedTo: unassigned@gcc.gnu.org
        ReportedBy: drk@sgi.com
                CC: gcc-bugs@gcc.gnu.org

The gcc/3.3 tarball has corrupted cpp.1 and gcc.1 man
pages.  If you check, there are a couple NULL characters
(and some other garbage) where the __GNUC_MINOR__ macro
should be.

[Bug other/11146] Bad characters in cpp.1, gcc.1 man pages

[drk@sgi.com]

PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=11146



------- Additional Comments From drk@sgi.com  2003-06-11 03:11 -------
Created an attachment (id=4197)
 --> (http://gcc.gnu.org/bugzilla/attachment.cgi?id=4197&action=view)
Proposed fix

Note that patch doesn't actually process files containing
NULLs properly; you'll have to apply this by hand.

[Bug other/11146] Bad characters in cpp.1, gcc.1 man pages

[jsm28@cam.ac.uk]

PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=11146



------- Additional Comments From jsm28@cam.ac.uk  2003-06-11 08:57 -------
Subject: Re:  Bad characters in cpp.1, gcc.1 man pages

On Wed, 11 Jun 2003, drk@sgi.com wrote:

> Created an attachment (id=4197)
 --> (http://gcc.gnu.org/bugzilla/attachment.cgi?id=4197&action=view)
>  --> (http://gcc.gnu.org/bugzilla/attachment.cgi?id=4197&action=view)
> Proposed fix
> 
> Note that patch doesn't actually process files containing
> NULLs properly; you'll have to apply this by hand.

Patching generated files is not a suitable fix.  Someone (Zack is the most
expert in this area) will need to determine which generation stage
(texi2pod.pl or pod2man) is introducing these characters and either fix
texi2pod.pl or fix pod2man and adjust the version requirements on it.

Problems with what patch handles are only relevant insofar as this might
cause problems for people applying the 3.3.1 diff if the problem is fixed
for 3.3.1, if patch 2.5.4 (the version we recommend, because some earlier
versions are known to have problems with binary diffs) won't handle these
characters properly.

[Bug other/11146] [3.3 regression] Bad characters in cpp.1, gcc.1 man pages

[jsm28 at gcc dot gnu dot org]

PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=11146


jsm28 at gcc dot gnu dot org changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |jsm28 at gcc dot gnu dot org
             Status|UNCONFIRMED                 |NEW
     Ever Confirmed|                            |1
   Last reconfirmed|0000-00-00 00:00:00         |2003-06-24 09:34:39
               date|                            |
            Summary|Bad characters in cpp.1,    |[3.3 regression] Bad
                   |gcc.1 man pages             |characters in cpp.1, gcc.1
                   |                            |man pages
   Target Milestone|3.4                         |3.3.1


------- Additional Comments From jsm28 at gcc dot gnu dot org  2003-06-24 09:34 -------
This is a regression in the 3.3 release tarball relative to 3.2.3.

[Bug other/11146] [3.3 regression] Bad characters in cpp.1, gcc.1 man pages

[mmitchel at gcc dot gnu dot org]

PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=11146


mmitchel at gcc dot gnu dot org changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
   Target Milestone|3.3.1                       |3.3.2


------- Additional Comments From mmitchel at gcc dot gnu dot org  2003-07-17 19:55 -------
Postponed until GCC 3.3.2.

[Bug other/11146] [3.3 regression] Bad characters in cpp.1, gcc.1 man pages

[mmitchel at gcc dot gnu dot org]

PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=11146


mmitchel at gcc dot gnu dot org changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
   Target Milestone|3.3.2                       |3.3.3


------- Additional Comments From mmitchel at gcc dot gnu dot org  2003-10-16 09:39 -------
Postponed until GCC 3.3.3.

[Bug other/11146] [3.3 regression] Bad characters in cpp.1, gcc.1 man pages

[jsm at polyomino dot org dot uk]

PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=11146



------- Additional Comments From jsm at polyomino dot org dot uk  2003-10-17 01:06 -------
Subject: Re:  [3.3 regression] Bad characters in cpp.1,
 gcc.1 man pages

On Thu, 16 Oct 2003, mmitchel at gcc dot gnu dot org wrote:

> Postponed until GCC 3.3.3.

Actually this bug got fixed in the 3.3.1 release - the relevant paragraph
of cppopts.texi was removed as part of a backport of manual cleanups from
the mainline (revision 1.15.8.3).  So though the problem could reoccur
elsewhere as the underlying cause isn't known - arguably this PR should
stay open to document the existence of such a bug somewhere in the
texi2pod/pod2man combination, to be fixed either in texi2pod.pl or in
stricter version requirements on pod2man - this particular instance of it
is no longer present in releases - so this can no longer count as a
regression.

[Bug other/11146] Bad characters can happen in cpp.1, gcc.1 man pages

[pinskia at gcc dot gnu dot org]

PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=11146


pinskia at gcc dot gnu dot org changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
            Summary|[3.3 regression] Bad        |Bad characters can happen in
                   |characters in cpp.1, gcc.1  |cpp.1, gcc.1 man pages
                   |man pages                   |
   Target Milestone|3.3.3                       |---


------- Additional Comments From pinskia at gcc dot gnu dot org  2003-10-26 21:48 -------
Since this is no longer a regression moving changing the target milestone.