[Bug web/54124] New: Web-based GCC 4.7.1 manual seems to have a section corrupted

2012-07-29 Thread kscott at eznet dot net
http://gcc.gnu.org/bugzilla/show_bug.cgi?id=54124

 Bug #: 54124
   Summary: Web-based GCC 4.7.1 manual seems to have a section
corrupted
Classification: Unclassified
   Product: gcc
   Version: unknown
Status: UNCONFIRMED
  Severity: normal
  Priority: P3
 Component: web
AssignedTo: unassig...@gcc.gnu.org
ReportedBy: ksc...@eznet.net


I was looking for a description of the -dM option.  Currently, I'm able to find
it using "info" on the old version of gcc that's installed at my workplace; the
problem is that the current online HTML manual for v4.7.1 appears as if part of
section 3.11 (options controlling the preprocessor) has been overwritten with
other text about options that control warnings.  As a result, the -dM option,
which belongs in that section, seems to be missing from the HTML manual.


[Bug web/54124] Web-based GCC 4.7.1 manual seems to have a section corrupted

2012-07-29 Thread kscott at eznet dot net
http://gcc.gnu.org/bugzilla/show_bug.cgi?id=54124

--- Comment #2 from Kevin Scott  2012-07-30 02:40:29 
UTC ---
Now that you mention it, I looked again, and it in fact is there, in the gcc
manual.  The problem was that, on my prior readings, I instinctively ignored
the entire '-dCHARS' section, as it didn't seem like the thing I was looking
for.  So it might be a little clearer to include the '-d' with each of the five
suboptions.


[Bug web/54124] Web-based GCC 4.7.1 manual seems to have a section corrupted

2012-07-29 Thread kscott at eznet dot net
http://gcc.gnu.org/bugzilla/show_bug.cgi?id=54124

Kevin Scott  changed:

   What|Removed |Added

URL||http://gcc.gnu.org/onlinedo
   ||cs/gcc-4.7.1/gcc/Preprocess
   ||or-Options.html#Preprocesso
   ||r-Options
Version|unknown |4.7.1
   Severity|normal  |enhancement

--- Comment #4 from Kevin Scott  2012-07-30 03:12:19 
UTC ---
I've changed the category to "enhancement" since it only concerns the
readability of the -dCHARS section(s) of the manual(s).  Feel free to either
edit the manual(s) or defer or close, as you see fit.


[Bug web/54124] GCC 4.7.1 manual: -dM and similar options hard to find

2012-07-31 Thread kscott at eznet dot net
http://gcc.gnu.org/bugzilla/show_bug.cgi?id=54124

Kevin Scott  changed:

   What|Removed |Added

Summary|Web-based GCC 4.7.1 manual: |GCC 4.7.1 manual:  -dM and
   | -dM and similar options|similar options hard to
   |hard to find|find

--- Comment #6 from Kevin Scott  2012-08-01 03:05:10 
UTC ---
The old info that I was comparing to was from gcc 2.95.3.  Here is what the
section looked like in that version:

`-dM'
 Tell the preprocessor to output only a list of the macro
 definitions that are in effect at the end of preprocessing.  Used
 with the `-E' option.

`-dD'
 Tell the preprocessing to pass all macro definitions into the
 output, in their proper sequence in the rest of the output.

`-dN'
 Like `-dD' except that the macro arguments and contents are
 omitted.  Only `#define NAME' is included in the output.

`-dI'
 Output `#include' directives in addition to the result of
 preprocessing.

Having the "-d" with each option makes it more immediately apparent what they
are, and thus easier to find visually.

I don't doubt that the HTML and current info are the same.  I've adjusted the
title to describe the issue better.