Man page.

[David Walker]

Hiya.
I am an OpenBSD user.
I was looking at the online man page for GCC(1) and notice the "Author"
section seems to contain a uri that does not work.
Quote:
AUTHOR
   See the Info entry for gcc, or <http://gcc.gnu.org/online-
   docs/gcc/Contributors.html>, for contributors to GCC.

http://www.openbsd.org/cgi-bin/man.cgi?query=gcc&sektion=1

As hyphens in uri's are not uncommon I assumed the page had been moved and
went to your site. It seems, however, that the uri has suffered in the
formatting process.
I had a look at the FreeBSD online man pages and notice a similar thing:
AUTHOR
   See the Info entry for gcc, or <http://gcc.gnu.org/onlinedocs/gcc/Con-
   tributors.html>, for contributors to GCC.

http://www.freebsd.org/cgi/man.cgi?query=gcc&apropos=0&sektion=0&manpath=FreeBSD+6.2-RELEASE&format=html

>From memory, the man pages do not have hyperlinks so users might spot the
hyphen as not part of the address. To avoid confusion, perhaps the uri
could begin on a new line.

Apparently this is the intended page:
http://gcc.gnu.org/onlinedocs/gcc/Contributors.html

Best wishes,
David Walker

Bug in g77 man page

[Leslie E. Ballentine]

As far as I can see, neither 
   man g77
nor
   info g77
tell you the meaning of the options "-o" and "-c".

man gcc does contain that information, but how many Fortran
programmers would think to look there?
Please correct the man page.

Leslie Ballentine

[Bug bootstrap/7817] [3.3/3.4 regression] Link to gcc man page in g++ man page incorrect

[gdr at gcc dot gnu dot org]

--- Additional Comments From gdr at gcc dot gnu dot org  2003-12-21 18:12 ---
I don't think, anyone is going to fix this for 3.3.x

-- 
   What|Removed |Added

 Status|NEW |RESOLVED
 Resolution||WONTFIX


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

[Bug other/38768] man page: -fschedule-insns documentation

[tim at klingt dot org]

--- Comment #1 from tim at klingt dot org  2009-01-08 17:44 ---
Created an attachment (id=17057)
 --> (http://gcc.gnu.org/bugzilla/attachment.cgi?id=17057&action=view)
proposed patch


-- 


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

[Bug other/38768] man page: -fschedule-insns documentation

[pinskia at gmail dot com]

--- Comment #2 from pinskia at gmail dot com  2009-01-08 18:27 ---
Subject: Re:  man page: -fschedule-insns documentation



On Jan 8, 2009, at 9:44 AM, "tim at klingt dot org"  wrote:

>
>
> --- Comment #1 from tim at klingt dot org  2009-01-08 17:44  
> ---
> Created an attachment (id=17057)
 --> (http://gcc.gnu.org/bugzilla/attachment.cgi?id=17057&action=view)
> --> (http://gcc.gnu.org/bugzilla/attachment.cgi?id=17057&action=view)
> proposed patch


This patch is incorrect as -fschedule-insns is enabled at -O2 and  
above for most targets except for x86.

>
>
>
> -- 
>
>
> http://gcc.gnu.org/bugzilla/show_bug.cgi?id=38768
>


-- 


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

[Bug other/38768] man page: -fschedule-insns documentation

[tim at klingt dot org]

--- Comment #3 from tim at klingt dot org  2009-01-08 18:30 ---
> This patch is incorrect as -fschedule-insns is enabled at -O2 and  
> above for most targets except for x86.

and x86_64 ... the only platforms i can use for testing ...


-- 


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

[Bug other/24131] Error in log2 man page

[pinskia at gcc dot gnu dot org]

--- Additional Comments From pinskia at gcc dot gnu dot org  2005-09-29 
22:50 ---
log2 man page is not maintained by GCC, in fact almost none of the standard C 
library is part of GCC 
but part of glibc.  the man pages are maintained by a different project though.

-- 
   What|Removed |Added

 Status|UNCONFIRMED |RESOLVED
 Resolution||INVALID


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

[Bug gcov-profile/80081] gcov-dump needs man page

[vries at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=80081

--- Comment #1 from Tom de Vries  ---
Options needing documentation:
...
$ gcov-dump --help
Usage: gcov-dump [OPTION] ... gcovfiles
Print coverage file contents
  -h, --help   Print this help
  -v, --versionPrint version number
  -l, --long   Dump record contents too
  -p, --positions  Dump record positions
  -w, --working-sets   Dump working set computed from summary

For bug reporting instructions, please see:
.
...

[Bug gcov-profile/80081] gcov-dump needs man page

[rguenth at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=80081

Richard Biener  changed:

   What|Removed |Added

 Status|UNCONFIRMED |NEW
   Last reconfirmed||2017-03-17
 Ever confirmed|0   |1

--- Comment #2 from Richard Biener  ---
Confirmed.

[Bug gcov-profile/80081] gcov-dump needs man page

[marxin at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=80081

Martin Liška  changed:

   What|Removed |Added

 CC||marxin at gcc dot gnu.org
   Assignee|unassigned at gcc dot gnu.org  |marxin at gcc dot 
gnu.org

--- Comment #3 from Martin Liška  ---
Good point, I'll do that.

[Bug gcov-profile/80081] gcov-dump needs man page

[marxin at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=80081

--- Comment #4 from Martin Liška  ---
Author: marxin
Date: Tue Mar 21 14:41:11 2017
New Revision: 246321

URL: https://gcc.gnu.org/viewcvs?rev=246321&root=gcc&view=rev
Log:
Document gcov-dump and fix installation of gcov-tool (PR gcov-profile/80081).

2017-03-21  Martin Liska  

PR gcov-profile/80081
* Makefile.in: Add gcov-dump and fix installation of gcov-tool.
* doc/gcc.texi: Include gcov-dump stuff.
* doc/gcov-dump.texi: New file.

Added:
trunk/gcc/doc/gcov-dump.texi
Modified:
trunk/gcc/ChangeLog
trunk/gcc/Makefile.in
trunk/gcc/doc/gcc.texi

[Bug gcov-profile/80081] gcov-dump needs man page

[marxin at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=80081

Martin Liška  changed:

   What|Removed |Added

  Known to work||7.0

--- Comment #5 from Martin Liška  ---
Fixed on trunk so far.

[Bug gcov-profile/80081] gcov-dump needs man page

[marxin at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=80081

--- Comment #6 from Martin Liška  ---
Author: marxin
Date: Wed Mar 22 10:49:24 2017
New Revision: 246363

URL: https://gcc.gnu.org/viewcvs?rev=246363&root=gcc&view=rev
Log:
Backport r246321

2017-03-22  Martin Liska  

Backport from mainline
2017-03-21  Martin Liska  

PR gcov-profile/80081
* Makefile.in: Add gcov-dump and fix installation of gcov-tool.
* doc/gcc.texi: Include gcov-dump stuff.
* doc/gcov-dump.texi: New file.

Added:
branches/gcc-6-branch/gcc/doc/gcov-dump.texi
Modified:
branches/gcc-6-branch/gcc/ChangeLog
branches/gcc-6-branch/gcc/Makefile.in
branches/gcc-6-branch/gcc/doc/gcc.texi

[Bug gcov-profile/80081] gcov-dump needs man page

[marxin at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=80081

--- Comment #7 from Martin Liška  ---
Author: marxin
Date: Wed Mar 22 12:32:56 2017
New Revision: 246379

URL: https://gcc.gnu.org/viewcvs?rev=246379&root=gcc&view=rev
Log:
Backport r246321

2017-03-22  Martin Liska  

Backport from mainline
2017-03-21  Martin Liska  

PR gcov-profile/80081
* Makefile.in: Add gcov-dump and fix installation of gcov-tool.
* doc/gcc.texi: Include gcov-dump stuff.
* doc/gcov-dump.texi: New file.

Added:
branches/gcc-5-branch/gcc/doc/gcov-dump.texi
Modified:
branches/gcc-5-branch/gcc/ChangeLog
branches/gcc-5-branch/gcc/Makefile.in
branches/gcc-5-branch/gcc/doc/gcc.texi

[Bug gcov-profile/80081] gcov-dump needs man page

[marxin at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=80081

Martin Liška  changed:

   What|Removed |Added

 Status|NEW |RESOLVED
 Resolution|--- |FIXED

--- Comment #8 from Martin Liška  ---
Fixed on all active branches.

[Bug other/38768] New: man page: -fschedule-insns documentation

[tim at klingt dot org]

according to the manpage, -fschedule-insns is enabled at the optimization
levels -O2, -O3 and -Os. according to g++ -c -Q --help=optimizers, this is not
the case, though.


-- 
   Summary: man page: -fschedule-insns documentation
   Product: gcc
   Version: 4.4.0
Status: UNCONFIRMED
  Severity: normal
  Priority: P3
 Component: other
AssignedTo: unassigned at gcc dot gnu dot org
ReportedBy: tim at klingt dot org


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

Re: [Bug other/38768] man page: -fschedule-insns documentation

[Andrew Thomas Pinski]

On Jan 8, 2009, at 9:44 AM, "tim at klingt dot org" > wrote:





--- Comment #1 from tim at klingt dot org  2009-01-08 17:44  
---

Created an attachment (id=17057)
--> (http://gcc.gnu.org/bugzilla/attachment.cgi?id=17057&action=view)
proposed patch



This patch is incorrect as -fschedule-insns is enabled at -O2 and  
above for most targets except for x86.






--


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

[Bug other/24131] New: Error in log2 man page

[PTrenholme at 4DV dot net]

The manual page states that log2 returns the natural log, not the base two log.

Note: The documentation problem was first seen on a RH9 system, and I saw it on
my FC4 system. Both are RH distros (sort of), so it may not be a general
problem. Fairly minor, in any case.

-- 
   Summary: Error in log2 man page
   Product: gcc
   Version: 4.0.1
Status: UNCONFIRMED
  Severity: minor
  Priority: P2
 Component: other
AssignedTo: unassigned at gcc dot gnu dot org
ReportedBy: PTrenholme at 4DV dot net
CC: gcc-bugs at gcc dot gnu dot org


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

[Bug gcov-profile/80081] New: gcov-dump needs man page

[vries at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=80081

Bug ID: 80081
   Summary: gcov-dump needs man page
   Product: gcc
   Version: 7.0
Status: UNCONFIRMED
  Severity: trivial
  Priority: P3
 Component: gcov-profile
  Assignee: unassigned at gcc dot gnu.org
  Reporter: vries at gcc dot gnu.org
  Target Milestone: ---

https://gcc.gnu.org/ml/gcc-patches/2017-03/msg00925.html :
...
Bonus point if you also write the missing gcov-dump.texi (so we get a
manpage as well).
...

[Bug treelang/24771] treelang does not have a man page

[tromey at gcc dot gnu dot org]

--- Comment #2 from tromey at gcc dot gnu dot org  2008-05-22 19:51 ---
Treelang has been removed.


-- 

tromey at gcc dot gnu dot org changed:

   What|Removed |Added

 CC||tromey at gcc dot gnu dot
   ||org
 Status|NEW |RESOLVED
 Resolution||FIXED
   Target Milestone|--- |4.4.0


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

[Bug preprocessor/91025] cpp man page incorrectly describes -MD option

[redi at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=91025

--- Comment #1 from Jonathan Wakely  ---
(In reply to Stephen Kell from comment #0)
> I'm happy in principle to produce a patch... but haven't quite got my head
> around how the man pages are generated (from the texinfo?).

Yes, via .pod files. See the %.pod and doc/%.1 targets in gcc/Makefile.in

[Bug preprocessor/91025] cpp man page incorrectly describes -MD option

[srk31 at srcf dot ucam.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=91025

--- Comment #2 from Stephen Kell  ---
Created attachment 47405
  --> https://gcc.gnu.org/bugzilla/attachment.cgi?id=47405&action=edit
Patch to cpp manual page's description of -MD

It took me long enough, but I'm fairly sure this patch results in a less-wrong
cpp man page than the current one.

[Bug preprocessor/91025] cpp man page incorrectly describes -MD option

[redi at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=91025

Jonathan Wakely  changed:

   What|Removed |Added

 Status|UNCONFIRMED |NEW
   Last reconfirmed||2019-12-03
 Ever confirmed|0   |1

[Bug preprocessor/91025] cpp man page incorrectly describes -MD option

[redi at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=91025

--- Comment #3 from Jonathan Wakely  ---
Thanks! As per https://gcc.gnu.org/contribute.html#patches patches should be
sent to the mailing list for review. They get missed/ignored when attached to
bugzilla. If this is your first patch for GCC it's probably small enough to not
need a copyright assignment, although you might want to complete one anyway,
see https://gcc.gnu.org/contribute.html#legal 

Thanks again.

[Bug treelang/24771] treelang does not have a man page

[pinskia at gcc dot gnu dot org]

--- Comment #1 from pinskia at gcc dot gnu dot org  2005-11-10 14:45 ---
Confirmed.


-- 

pinskia at gcc dot gnu dot org changed:

   What|Removed |Added

 Status|UNCONFIRMED |NEW
 Ever Confirmed|0   |1
   Last reconfirmed|-00-00 00:00:00 |2005-11-10 14:45:15
   date||


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[debian-gcc at lists dot debian dot org]

--- Comment #1 from debian-gcc at lists dot debian dot org  2009-12-22 
11:40 ---
Created an attachment (id=19368)
 --> (http://gcc.gnu.org/bugzilla/attachment.cgi?id=19368&action=view)
man pages with errors


-- 


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[debian-gcc at lists dot debian dot org]

--- Comment #2 from debian-gcc at lists dot debian dot org  2009-12-22 
11:42 ---
Created an attachment (id=19369)
 --> (http://gcc.gnu.org/bugzilla/attachment.cgi?id=19369&action=view)
patch fixing two typos


-- 


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[paolo dot carlini at oracle dot com]

--- Comment #3 from paolo dot carlini at oracle dot com  2009-12-30 01:21 
---
Matthias, please apply your doc patchlet, thanks.


-- 


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[paolo dot carlini at oracle dot com]

--- Comment #4 from paolo dot carlini at oracle dot com  2009-12-30 02:01 
---
Matthias, sorry, please apply only the first hunk, I'm applying momentarily the
patch from Ed fixing the second issue.


-- 


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[paolo dot carlini at oracle dot com]

--- Comment #5 from paolo dot carlini at oracle dot com  2010-01-06 11:41 
---
Done both.


-- 


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[debian-gcc at lists dot debian dot org]

--- Comment #6 from debian-gcc at lists dot debian dot org  2010-01-06 
12:18 ---
The "Invalid or incomplete multibyte or wide character" messages were generated
due to an incorrect setup of the checking tool (lintian).


-- 


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[paolo dot carlini at oracle dot com]

--- Comment #7 from paolo dot carlini at oracle dot com  2010-01-06 16:39 
---
Ok, thanks. Can you summarize the present status, then? Outstanding issues,
maybe more patchlets... ;)


-- 


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[bkoz at gcc dot gnu dot org]

--- Comment #8 from bkoz at gcc dot gnu dot org  2010-01-07 18:37 ---
Created an attachment (id=19502)
 --> (http://gcc.gnu.org/bugzilla/attachment.cgi?id=19502&action=view)
log of man page creation


-- 


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[bkoz at gcc dot gnu dot org]

--- Comment #9 from bkoz at gcc dot gnu dot org  2010-01-07 18:40 ---

The rest of these look bogus to me. 

__gnu_cxx::enc_filebuf.3cxx 805: warning: macro `If' not defined
__gnu_cxx::stdio_sync_filebuf.3cxx 699: warning: macro `If' not defined
std::basic_filebuf.3cxx 905: warning: macro `If' not defined
std::basic_ios.3cxx 1123: warning: macro `Minimum' not defined
std::basic_istream.3cxx 988: warning: macro `)).' not defined
std::basic_istringstream.3cxx 1011: warning: macro `)).' not defined
std::basic_stringbuf.3cxx 723: warning: macro `If' not defined

These look fine, and the generated file seems normal, ie this error looks like

.PP
If no file is currently open, this function immediately fails.
.PP

in the __gnu_cxx::enc_filebuf.3 file.

So it looks like this can be closed to me but I'll wait for confirmation.


-- 

bkoz at gcc dot gnu dot org changed:

   What|Removed |Added

 Status|UNCONFIRMED |NEW
 Ever Confirmed|0   |1
   Last reconfirmed|-00-00 00:00:00 |2010-01-07 18:40:02
   date||


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[paolo dot carlini at oracle dot com]

--- Comment #10 from paolo dot carlini at oracle dot com  2010-01-20 13:12 
---
Ok, let's close this one as fixed...


-- 

paolo dot carlini at oracle dot com changed:

   What|Removed |Added

 Status|NEW |RESOLVED
 Resolution||FIXED
   Target Milestone|--- |4.5.0


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[doko at ubuntu dot com]

--- Comment #11 from doko at ubuntu dot com  2010-01-20 13:58 ---
the man pages still have problems with escape codes used (prefix backslashes);
I didn't build and run the check tool yet again.

  Matthias


-- 


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[paolo dot carlini at oracle dot com]

--- Comment #12 from paolo dot carlini at oracle dot com  2010-01-20 14:00 
---
Ok, let's re-open to be safe: please provide as soon as possible to Benjamin
the information he needs...


-- 

paolo dot carlini at oracle dot com changed:

   What|Removed |Added

 Status|RESOLVED|REOPENED
 Resolution|FIXED   |


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[doko at ubuntu dot com]

--- Comment #13 from doko at ubuntu dot com  2010-01-21 14:30 ---
std::basic_ios.3, std::basic_ofstream.3, std::basic_ostream.3,
std::basic_ostringstream.3, std::ios_base.3:

.PP
Definition at line 657 of file ios_base.h.
.SS "\fBstreamsize\fP std::ios_base::width () const\fC [inline, inherited]\fP"
.PP
Flags access. \fBReturns:\fP
.RS 4
The minimum field width to generate on output operations.
.RE
.PP
'Minimum field width' refers to the number of characters. 
.PP

The ' should be escaped as \', or else the paragraph is just discarded; unsure
how this should be formatted (quoting as \" for doxygen?). other places are
quotations from the standard, like:

src/libstdc++-v3/include/std/streambuf

   *  'If it returns a positive value, then successive calls to
   *  @c underflow() will not return @c traits::eof() until at least that
   *  number of characters have been supplied.  If @c showmanyc()
   *  returns -1, then calls to @c underflow() or @c uflow() will fail.'
   *  [27.5.2.4.3]/1

Extraction into another streambuf. \fBParameters:\fP
.RS 4
\fIsb\fP A streambuf in which to store data. 
.RE
.PP
\fBReturns:\fP
.RS 4
*this
.RE
.PP
Returns \fCget\fP(sb,widen('
.br
')). 
.PP
Definition at line 365 of file istream.

libstdc++-v3/include/std/istream

   *  Returns @c get(sb,widen('\n')).

unqoted quote and unqoted backslash, so make this "\\\"\? There are other
places.


std::linear_congruential_engine.3
A random number generator that produces pseudorandom numbers using the linear
function $x_{i+1}\leftarrow(ax_{i} + c) \bmod m $.

std::exponential_distribution.3
The formula for the exponential probability density function is $ p(x|\lambda)
= \lambda e^{-\lambda x} $.

Tex is used instead of eqn. Didn't see a directive to not include this not for
the manpages.

So far, no bad checks from the checker, these all look like real problems.


-- 


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[bkoz at gcc dot gnu dot org]

--- Comment #14 from bkoz at gcc dot gnu dot org  2010-02-03 23:07 ---

Got it Matthias, fixing, thanks for explaining what's up.

How do you get these errors and validate the generated man pages? If it's a
script can you attach it? Are you re-configuring doxygen? Or is this
post-generation of the 'doc-man-doxygen' rule?


-- 


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[bkoz at gcc dot gnu dot org]

--- Comment #15 from bkoz at gcc dot gnu dot org  2010-02-04 00:16 ---

markup options

/**
 *  @brief  Flags access.
 *  @return  The minimum field width to generate on output operations.
 *
 *  "Minimum field width" refers to the number of characters.
 *
 *  "
 *  Minimum field width
 *  "
 *  refers to the number of characters.
 *
 *  
 *  Minimum field width
 *  
 *  refers to the number of characters.
 *
 *  @a Minimum field width
 *  refers to the number of characters.
*/



-- 


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[bkoz at gcc dot gnu dot org]

--- Comment #16 from bkoz at gcc dot gnu dot org  2010-02-04 18:20 ---
Subject: Bug 42460

Author: bkoz
Date: Thu Feb  4 18:20:34 2010
New Revision: 156502

URL: http://gcc.gnu.org/viewcvs?root=gcc&view=rev&rev=156502
Log:
2010-02-04  Benjamin Kosnik  

PR libstdc++/42460
* doc/doxygen/user.cfg.in: Update file list.
* include/debug/safe_sequence.h: Doxygen markup fixes for '' and "".
* include/debug/safe_base.h: Same.
* include/debug/macros.h: Same.
* include/tr1_impl/regex: Same.
* include/std/iostream: Same.
* include/std/streambuf: Same.
* include/std/bitset: Same.
* include/std/iosfwd: Same.
* include/std/limits: Same.
* include/std/fstream: Same.
* include/std/istream: Same.
* include/std/ostream: Same.
* include/std/sstream: Same.
* include/parallel/multiway_merge.h: Same.
* include/parallel/for_each.h: Same.
* include/parallel/workstealing.h: Same.
* include/parallel/omp_loop_static.h: Same.
* include/parallel/omp_loop.h: Same.
* include/c_std/csignal: Same.
* include/c_std/cstdlib: Same.
* include/c_std/cstdio: Same.
* include/c_std/cstdarg: Same.
* include/c_std/cctype: Same.
* include/c_std/cerrno: Same.
* include/c_std/cmath: Same.
* include/c_std/ciso646: Same.
* include/c_std/ctime: Same.
* include/c_std/clocale: Same.
* include/c_std/climits: Same.
* include/c_std/cassert: Same.
* include/c_std/csetjmp: Same.
* include/c_std/cwchar: Same.
* include/c_std/cfloat: Same.
* include/c_std/cstring: Same.
* include/c_std/cstddef: Same.
* include/c_std/cwctype: Same.
* include/profile/iterator_tracker.h: Same.
* include/profile/impl/profiler_trace.h: Same.
* include/ext/vstring.h: Same.
* include/ext/algorithm: Same.
* include/ext/pb_ds/detail/pat_trie_/pat_trie_.h.pp: Same.
* include/ext/pb_ds/detail/bin_search_tree_/bin_search_tree_.h.pp:
Same.
* include/ext/pb_ds/detail/type_utils.hpp: Same.
* include/ext/pb_ds/detail/splay_tree_/splay_tree_.hpp: Same
* include/ext/pb_ds/detail/rb_tree_map_/rb_tree_.hpp: Same.
* include/ext/rc_string_base.h: Same.
* include/ext/stdio_sync_filebuf.h: Same.
* include/ext/functional: Same.
* include/ext/mt_allocator.h: Same.
* include/bits/basic_ios.h: Same.
* include/bits/stl_map.h: Same.
* include/bits/stl_algobase.h: Same.
* include/bits/stl_queue.h: Same.
* include/bits/locale_classes.h: Same.
* include/bits/stl_set.h: Same.
* include/bits/locale_facets.h: Same.
* include/bits/stl_stack.h: Same.
* include/bits/stl_iterator_base_types.h: Same.
* include/bits/basic_string.h: Same.
* include/bits/stl_multimap.h: Same.
* include/bits/ios_base.h: Same.
* include/bits/stl_deque.h: Same.
* include/bits/stl_multiset.h: Same.
* include/bits/stl_iterator_base_funcs.h: Same.
* include/bits/char_traits.h: Same.
* include/bits/stl_algo.h: Same.
* include/bits/stl_iterator.h: Same.
* include/bits/stl_tempbuf.h: Same.
* include/bits/random.tcc: Same.
* include/bits/stl_function.h: Same.
* include/bits/cpp_type_traits.h: Same.
* include/bits/random.h: Same.
* include/bits/allocator.h: Same.
* include/bits/locale_facets_nonio.h: Same.
* include/c_global/csignal: Same.
* include/c_global/cstdlib: Same.
* include/c_global/cstdio: Same.
* include/c_global/cstdarg: Same.
* include/c_global/cctype: Same.
* include/c_global/cerrno: Same.
* include/c_global/cmath: Same.
* include/c_global/ciso646: Same.
* include/c_global/ctime: Same.
* include/c_global/clocale: Same.
* include/c_global/climits: Same.
* include/c_global/cassert: Same.
* include/c_global/csetjmp: Same.
* include/c_global/cwchar: Same.
* include/c_global/cfloat: Same.
* include/c_global/cstring: Same.
* include/c_global/cstddef: Same.
* include/c_global/cwctype: Same.
* include/tr1/hypergeometric.tcc: Same.
* include/tr1/random.tcc: Same.
* include/tr1/functional: Same.
* include/tr1/random.h: Same.
* include/backward/auto_ptr.h: Same.
* include/backward/binders.h: Same.
* testsuite/23_containers/deque/requirements/dr438/assign_neg.cc:
Adjust line numbers.
* testsuite/23_containers/deque/requirements/dr438/insert_neg.cc: Same.
*
testsuite/23_containers/deque/requirements/dr438/constructor_1_neg.cc:
Same.
*
testsuite/23_containers/deque/requirements/dr438/constructor_2_neg.cc:

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[bkoz at gcc dot gnu dot org]

--- Comment #17 from bkoz at gcc dot gnu dot org  2010-02-04 18:27 ---

Hey. Can you re-check trunk now? I should have most of the quoting issues
fixed.

I've uploaded man pages with the new markup here:
ftp://gcc.gnu.org/pub/libstdc++/doxygen/libstdc++-man.20100204.tar.bz2

Can you check these (or equivalent from trunk) please?


-- 


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[bkoz at gcc dot gnu dot org]

-- 

bkoz at gcc dot gnu dot org changed:

   What|Removed |Added

 AssignedTo|unassigned at gcc dot gnu   |bkoz at gcc dot gnu dot org
   |dot org |
 Status|REOPENED|ASSIGNED
   Last reconfirmed|2010-01-07 18:40:02 |2010-02-04 18:28:04
   date||


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[debian-gcc at lists dot debian dot org]

--- Comment #18 from debian-gcc at lists dot debian dot org  2010-02-04 
18:39 ---
this is a check run by the lintian tool to check .deb packages after they are
built. for this check, lintian calls 'man --warnings -E UTF-8 -l ' for
every generated manpage. Afaik Debian/Ubuntu do use another man implementation
than Fedora, so I don't know if this option is available there as well.


-- 


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[debian-gcc at lists dot debian dot org]

--- Comment #19 from debian-gcc at lists dot debian dot org  2010-02-04 
21:00 ---
std::basic_fstream.3cxx.gz 1213: warning: macro `)).' not defined
std::basic_ifstream.3cxx.gz 1037: warning: macro `)).' not defined
std::basic_iostream.3cxx.gz 1172: warning: macro `)).' not defined
std::basic_istream.3cxx.gz 1002: warning: macro `)).' not defined
std::basic_istringstream.3cxx.gz 1025: warning: macro `)).' not defined
std::basic_stringstream.3cxx.gz 1202: warning: macro `)).' not defined
std::exponential_distribution.3cxx.gz 66: warning: numeric expression expected
(got `m')
std::gamma_distribution.3cxx.gz 79: normal or special character expected (got a
space)
std::linear_congruential_engine.3cxx.gz 82: warning: numeric expression
expected (got `f')
std::lognormal_distribution.3cxx.gz 79: warning: numeric expression expected
(got `r')
std::normal_distribution.3cxx.gz 79: warning: numeric expression expected (got
`g')
std::regex_constants.3cxx.gz 200: warning: macro `,' not defined
std::student_t_distribution.3cxx.gz 76: warning: numeric expression expected
(got `r')
std::weibull_distribution.3cxx.gz 69: normal or special character expected (got
a space)

The one class of quoting problems seems to be fixed. 

remaining:

include/std/istream:403: Returns @c getline(s,n,widen('\n'))
include/std/istream:363: Returns @c getline(s,n,widen('\n'))
include/std/istream:330: Returns @c get(s,n,widen('\n'))

which translates to:

.PP
Returns \fCget\fP(sb,widen('
.br
')). 
.PP

quoting the backslash, I get this output (man not complaining anymore)
   template __istream_type&
std::basic_istream< _CharT, _Traits >::get
   (char_type * __s, streamsize __n) [inline, inherited]
   Simple multiple-character extraction. Parameters:
   s Pointer to an array.
   n Maximum number of characters to store in s.

   Returns:
   *this

   Returns get(s,n,widen('\n')).

   Definition at line 333 of file istream.

the other errors in the *distribution man pages are from using latex macros.

  Matthias


-- 


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[debian-gcc at lists dot debian dot org]

--- Comment #20 from debian-gcc at lists dot debian dot org  2010-02-04 
21:02 ---
Created an attachment (id=19806)
 --> (http://gcc.gnu.org/bugzilla/attachment.cgi?id=19806&action=view)
fix \n quoting

fixes the manual page, didn't check the html output


-- 


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[bkoz at gcc dot gnu dot org]

--- Comment #21 from bkoz at gcc dot gnu dot org  2010-02-09 04:50 ---
Subject: Bug 42460

Author: bkoz
Date: Tue Feb  9 04:49:49 2010
New Revision: 156617

URL: http://gcc.gnu.org/viewcvs?root=gcc&view=rev&rev=156617
Log:
2010-02-08  Benjamin Kosnik  

PR libstdc++/42460
* include/tr1_impl/regex: Fix quoting issues in doxygen markup.
* include/bits/random.h: Fix multi-line doxygen function markup.

2010-02-08  Matthias Klose  

PR libstdc++/42460
* include/std/istream: Fix '\' quoting in doxygen markup.


Modified:
trunk/libstdc++-v3/ChangeLog
trunk/libstdc++-v3/include/bits/random.h
trunk/libstdc++-v3/include/std/istream
trunk/libstdc++-v3/include/tr1_impl/regex


-- 


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[paolo dot carlini at oracle dot com]

--- Comment #22 from paolo dot carlini at oracle dot com  2010-02-17 09:36 
---
So... shall we close this as fixed?


-- 


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[bkoz at redhat dot com]

--- Comment #23 from bkoz at redhat dot com  2010-02-18 19:09 ---
Subject: Re:  man page errors for generated libstdc++
 man pages


> 2010-02-17 09:36 --- So... shall we close this as fixed?

Remaining item is doxygen function markup is not working for man pages.
But this is an upstream (doxygen) doxygen, and this
closed. I do not see any other thing to do from a libstdc++ POV.

Original reporter calls?

-benjamin


-- 


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[debian-gcc at lists dot debian dot org]

--- Comment #24 from debian-gcc at lists dot debian dot org  2010-02-23 
01:37 ---
thanks for the fixes. I don't care that much about the function markups.

  Matthias


-- 


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[rguenth at gcc dot gnu dot org]

--- Comment #25 from rguenth at gcc dot gnu dot org  2010-04-06 11:20 
---
GCC 4.5.0 is being released.  Deferring to 4.5.1.


-- 

rguenth at gcc dot gnu dot org changed:

   What|Removed |Added

   Target Milestone|4.5.0   |4.5.1


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

[Bug libstdc++/42460] man page errors for generated libstdc++ man pages

[paolo dot carlini at oracle dot com]

--- Comment #26 from paolo dot carlini at oracle dot com  2010-04-06 11:22 
---
Let's just close it as fixed.


-- 

paolo dot carlini at oracle dot com changed:

   What|Removed |Added

 Status|ASSIGNED|RESOLVED
 Resolution||FIXED
   Target Milestone|4.5.1   |4.5.0


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

[Bug preprocessor/91025] New: cpp man page incorrectly describes -MD option

[srk31 at srcf dot ucam.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=91025

Bug ID: 91025
   Summary: cpp man page incorrectly describes -MD option
   Product: gcc
   Version: 7.4.0
Status: UNCONFIRMED
  Severity: normal
  Priority: P3
 Component: preprocessor
  Assignee: unassigned at gcc dot gnu.org
  Reporter: srk31 at srcf dot ucam.org
  Target Milestone: ---

The cpp manual page's description of the -MD option is incorrect. It would be
correct as a description of gcc's -MD option... indeed it is phrased in terms
of "if -MD is used in conjunction with -E" and "the driver", neither of which
makes sense when running cpp directly.

As far as I can tell, when running "cpp" the "without -E" semantics always
apply: if -o is given then its filename is used but with a ".d" suffix
substituted; otherwise, the same substitution is done but on the input
filename. In other words, "-o" never directly specifies the dependency output
file, whether or not "-E" is on the command line (unlike when running gcc).

I'm happy in principle to produce a patch... but haven't quite got my head
around how the man pages are generated (from the texinfo?).

[Bug treelang/24771] New: treelang does not have a man page

[debian-gcc at lists dot debian dot org]

treelang does not have a man page. The man page should reference the gcc(1) man
page for options common to the gcc driver and list treelang specific options

  Matthias


-- 
   Summary: treelang does not have a man page
   Product: gcc
   Version: 4.1.0
Status: UNCONFIRMED
  Severity: enhancement
  Priority: P3
 Component: treelang
AssignedTo: unassigned at gcc dot gnu dot org
ReportedBy: debian-gcc at lists dot debian dot org


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

[Bug libstdc++/42460] New: man page errors for generated libstdc++ man pages

[debian-gcc at lists dot debian dot org]

the following errors are seen, when generating the man pages on a Debian
system, two of them fixed in the attached patch.

  Matthias

C++Intro.3cxx  around line 32: table wider than line width

__gnu_cxx::enc_filebuf.3cxx 805: warning: macro `If' not defined
__gnu_cxx::stdio_sync_filebuf.3cxx 699: warning: macro `If' not defined
std::basic_filebuf.3cxx 905: warning: macro `If' not defined
std::basic_ios.3cxx 1123: warning: macro `Minimum' not defined
std::basic_istream.3cxx 988: warning: macro `)).' not defined
std::basic_istringstream.3cxx 1011: warning: macro `)).' not defined
std::basic_stringbuf.3cxx 723: warning: macro `If' not defined
std::exponential_distribution.3cxx 66: warning: numeric expression expected
(got `m')
std::gamma_distribution.3cxx 79: normal or special character expected (got a
space)
std::ios_base.3cxx 636: warning: macro `Minimum' not defined
std::linear_congruential_engine.3cxx 82: warning: numeric expression expected
(got `f')
std::lognormal_distribution.3cxx 79: warning: numeric expression expected (got
`r')
std::normal_distribution.3cxx 79: warning: numeric expression expected (got
`g')
std::regex_constants.3cxx 200: warning: macro `,' not defined
std::regex_token_iterator.3cxx  Invalid or incomplete multibyte or wide
character
std::regex_traits.3cxx  Invalid or incomplete multibyte or wide character
std::student_t_distribution.3cxx 76: warning: numeric expression expected (got
`r')
std::weibull_distribution.3cxx 69: normal or special character expected (got a
space)

SGIextensions.3cxx  Invalid or incomplete multibyte or wide character
__gnu_cxx.3cxx  Invalid or incomplete multibyte or wide character
__gnu_cxx::debug_allocator.3cxx  Invalid or incomplete multibyte or wide
character
__gnu_cxx::malloc_allocator.3cxx  Invalid or incomplete multibyte or wide
character
__gnu_cxx::new_allocator.3cxx  Invalid or incomplete multibyte or wide
character
__gnu_cxx::stdio_filebuf.3cxx  Invalid or incomplete multibyte or wide
character
__gnu_parallel.3cxx  Invalid or incomplete multibyte or wide character
std::basic_fstream.3cxx  Invalid or incomplete multibyte or wide character
std::basic_ifstream.3cxx  Invalid or incomplete multibyte or wide character
std::basic_iostream.3cxx  Invalid or incomplete multibyte or wide character
std::basic_ofstream.3cxx  Invalid or incomplete multibyte or wide character
std::basic_ostream.3cxx  Invalid or incomplete multibyte or wide character
std::basic_ostringstream.3cxx  Invalid or incomplete multibyte or wide
character
std::basic_streambuf.3cxx  Invalid or incomplete multibyte or wide character
std::basic_stringstream.3cxx  Invalid or incomplete multibyte or wide character
std::deque.3cxx  Invalid or incomplete multibyte or wide character


-- 
   Summary: man page errors for generated libstdc++ man pages
   Product: gcc
   Version: 4.5.0
Status: UNCONFIRMED
  Severity: normal
  Priority: P3
 Component: libstdc++
AssignedTo: unassigned at gcc dot gnu dot org
ReportedBy: debian-gcc at lists dot debian dot org


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

[Bug other/51679] spurious parenthesis for -fassociative-math in manual and man page

[rguenth at gcc dot gnu.org]

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

--- Comment #1 from Richard Guenther  2012-01-02 
10:46:04 UTC ---
Author: rguenth
Date: Mon Jan  2 10:46:01 2012
New Revision: 182785

URL: http://gcc.gnu.org/viewcvs?root=gcc&view=rev&rev=182785
Log:
2012-01-02  Richard Guenther  

PR other/51679
* invoke.texi (fassociative-math): Remove spurious paranthesis.

Modified:
trunk/gcc/ChangeLog
trunk/gcc/doc/invoke.texi

[Bug other/51679] spurious parenthesis for -fassociative-math in manual and man page

[rguenth at gcc dot gnu.org]

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

Richard Guenther  changed:

   What|Removed |Added

 Status|UNCONFIRMED |RESOLVED
 Resolution||FIXED

--- Comment #2 from Richard Guenther  2012-01-02 
10:46:25 UTC ---
Fixed.

[Bug other/90375] Environment variables not listed in ENVIRONMENT section of man page

[redi at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=90375

--- Comment #2 from Jonathan Wakely  ---
(In reply to Eric Gallager from comment #1)
> I thought the CHKP/MPX stuff had been removed...

It has, I was looking at the man page for gcc-8, sorry.

[Bug other/90375] Environment variables not listed in ENVIRONMENT section of man page

[egallager at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=90375

Eric Gallager  changed:

   What|Removed |Added

 CC||egallager at gcc dot gnu.org

--- Comment #1 from Eric Gallager  ---
(In reply to Jonathan Wakely from comment #0)
> The following env vars are documented as affecting GCC's behaviour, but are
> not listed in the ENVIRONMENT section of the gcc(1) man page:
> 
> GCC_COLORS (for -fdiagnostics-color)
> COLUMNS (for -fno-diagnostics-show-caret)
> MAKE (for -flto=n)
> ASAN_OPTIONS
> TSAN_OPTIONS
> LSAN_OPTIONS
> VTV_LOGS_DIR (for -fvtv-debug)
> PATH (for finding subprograms when -Bprefix and the standard locations don't
> have them)

Bug 80271 would have CLICOLOR_FORCE added to that list as well.

> 
> -M mentions "or use an environment variable like DEPENDENCIES_OUTPUT" which
> isn't very clear if that actually gets used by GCC or is just an example. I
> suggest saying "or use one of the environment variables DEPENDENCIES_OUTPUT
> or SUNPRO_DEPENDENCIES" instead.
> 
> There's also "The runtime library  behavior can be influenced using various
> CHKP_RT_* environment variables.  See
> <https://gcc.gnu.org/wiki/Intel%20MPX%20support%20in%20the%20GCC%20compiler>
> for more details."

I thought the CHKP/MPX stuff had been removed...

[Bug c/59693] New: man page says "extern" declarations are unaffected by -fvisibility

[jed at 59A2 dot org]

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

Bug ID: 59693
   Summary: man page says "extern" declarations are unaffected by
-fvisibility
   Product: gcc
   Version: 4.8.2
Status: UNCONFIRMED
  Severity: normal
  Priority: P3
 Component: c
  Assignee: unassigned at gcc dot gnu.org
  Reporter: jed at 59A2 dot org

The gcc man page says the following:

extern declarations are not affected by -fvisibility, so a lot of
code can be recompiled with -fvisibility=hidden with no
modifications.  However, this means that calls to "extern" functions
with no explicit visibility use the PLT, so it is more effective to
use "__attribute ((visibility))" and/or "#pragma GCC visibility" to
tell the compiler which "extern" declarations should be treated as
hidden.

I read this to mean that functions and data declared "extern" will have default
visibility when compiled with -fvisibility=hidden, but that is not the case:

$ cat externvis.c
EXTERN int foo_func(void);
EXTERN int foo_data;

int foo_func(void) {
  return 0;
}
int foo_data;

$ gcc -c externvis.c -DEXTERN=extern -fvisibility=hidden && objdump -t
externvis.o | grep foo  
 g F .text  000b .hidden foo_func
0004   O *COM*  0004 .hidden foo_data
$ gcc -c externvis.c -DEXTERN='__attribute((visibility("default")))'
-fvisibility=hidden && objdump -t externvis.o | grep foo
0004   O *COM*  0004 foo_data
 g F .text  000b foo_func
$ gcc -c externvis.c -DEXTERN=extern && objdump -t externvis.o | grep foo
 g F .text  000b foo_func
0004   O *COM*  0004 foo_data

It seems to me that either gcc's behavior should be changed to match the
documentation or this paragraph should be removed/modified.  Note that clang's
behavior matches gcc (not the man page).

[Bug other/14708] description of -ffloat-store in gcc man page incorrect/inaccurate

[pinskia at gcc dot gnu dot org]

--- Additional Comments From pinskia at gcc dot gnu dot org  2004-11-29 
14:24 ---
Confirmed.

-- 
   What|Removed |Added

 Status|UNCONFIRMED |NEW
 Ever Confirmed||1
   Last reconfirmed|-00-00 00:00:00 |2004-11-29 14:24:22
   date||


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

[Bug other/14708] description of -ffloat-store in gcc man page incorrect/inaccurate

[vincent at vinc17 dot org]

--- Additional Comments From vincent at vinc17 dot org  2004-11-29 15:35 
---
In Comment 5, I wrote:
> The real problem is that intermediate results in extended precision are not
converted back to double after a cast or an assignment; this is required by the
C standard, whether __STDC_IEC_559__ is defined or not.

This problem has been fixed in gcc 3.4. So, now I think that the -ffloat-store
option should no longer be used: if the user wants the result to be converted
into double precision, he could add a cast to double, which is more portable
than relying on --ffloat-store. Also, note that neither the cast nor the
-ffloat-store option solves the problem of "double rounding" as described here:

  http://www.vinc17.org/research/extended.en.html

IMHO the manual should discourage the use of -ffloat-store.

-- 


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

[Bug other/14708] description of -ffloat-store in gcc man page incorrect/inaccurate

[vincent at vinc17 dot org]

--- Additional Comments From vincent at vinc17 dot org  2004-12-08 15:13 
---
I'm wrong. gcc 3.4 (from Debian) still has this problem. So, -ffloat-store is
still needed for C compliance.

-- 


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

[Bug other/51679] New: spurious parenthesis for -fassociative-math in manual and man page

[vincent-gcc at vinc17 dot net]

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

 Bug #: 51679
   Summary: spurious parenthesis for -fassociative-math in manual
and man page
Classification: Unclassified
   Product: gcc
   Version: 4.6.2
Status: UNCONFIRMED
  Severity: minor
  Priority: P3
 Component: other
AssignedTo: unassig...@gcc.gnu.org
ReportedBy: vincent-...@vinc17.net


In the -fassociative-math description in the manual and man page:

  (x + 2**52) - 2**52)

The second closing parenthesis should be removed.

[Bug middle-end/14708] description of -ffloat-store in gcc man page incorrect/inaccurate

[vincent-gcc at vinc17 dot net via Gcc-bugs]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=14708

--- Comment #9 from Vincent Lefèvre  ---
An update after all these years: As Joseph S. Myers said in the gcc-help list
in February 2005, "even -ffloat-store only deals with assignment, not casts":
https://gcc.gnu.org/pipermail/gcc-help/2005-February/051031.html

So, -ffloat-store did not really help to solve the issue, though those aware of
it could replace casts by intermediate variables to ensure a conversion to the
target precision with -ffloat-store. Rather ugly.

Since then, the -fexcess-precision option has been added[*] for GCC 4.5 and
should probably be recommended as a replacement for -ffloat-store. Or is there
still any reason to use -ffloat-store?

[*] PR323 comment 123 by Joseph S. Myers (November 2008).

[Bug web/65231] Dead link in man page to the status of C99 features

[gerald at pfeifer dot com]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=65231

Gerald Pfeifer  changed:

   What|Removed |Added

 Status|NEW |SUSPENDED
 CC||gerald at pfeifer dot com

[Bug web/65231] Dead link in man page to the status of C99 features

[gerald at pfeifer dot com]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=65231

Gerald Pfeifer  changed:

   What|Removed |Added

 Status|SUSPENDED   |RESOLVED
 Resolution|--- |WORKSFORME

--- Comment #3 from Gerald Pfeifer  ---
So, this appears to be an issue with the Debian package, not coming
from the GCC side of things.

Closing this report.

Sorry we could not be of further help, Roman.

[Bug other/90375] New: Environment variables not listed in ENVIRONMENT section of man page

[redi at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=90375

Bug ID: 90375
   Summary: Environment variables not listed in ENVIRONMENT
section of man page
   Product: gcc
   Version: 10.0
Status: UNCONFIRMED
  Keywords: documentation
  Severity: minor
  Priority: P3
 Component: other
  Assignee: unassigned at gcc dot gnu.org
  Reporter: redi at gcc dot gnu.org
  Target Milestone: ---

The following env vars are documented as affecting GCC's behaviour, but are not
listed in the ENVIRONMENT section of the gcc(1) man page:

GCC_COLORS (for -fdiagnostics-color)
COLUMNS (for -fno-diagnostics-show-caret)
MAKE (for -flto=n)
ASAN_OPTIONS
TSAN_OPTIONS
LSAN_OPTIONS
VTV_LOGS_DIR (for -fvtv-debug)
PATH (for finding subprograms when -Bprefix and the standard locations don't
have them)

-M mentions "or use an environment variable like DEPENDENCIES_OUTPUT" which
isn't very clear if that actually gets used by GCC or is just an example. I
suggest saying "or use one of the environment variables DEPENDENCIES_OUTPUT or
SUNPRO_DEPENDENCIES" instead.

There's also "The runtime library  behavior can be influenced using various
CHKP_RT_* environment variables.  See
<https://gcc.gnu.org/wiki/Intel%20MPX%20support%20in%20the%20GCC%20compiler>
for more details."

[Bug c/65231] Dead link in man page to the status of C99 features

[humbug at deeptown dot org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=65231

Roman Proskuryakov  changed:

   What|Removed |Added

   Keywords||documentation
   Severity|normal  |trivial

[Bug web/65231] Dead link in man page to the status of C99 features

[pinskia at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=65231

Andrew Pinski  changed:

   What|Removed |Added

 Status|UNCONFIRMED |NEW
   Last reconfirmed||2015-02-27
  Component|c   |web
 Ever confirmed|0   |1

--- Comment #1 from Andrew Pinski  ---
Someone needs to add the redirect from
http://gcc.gnu.org/gcc-4.8/c99status.html to http://gcc.gnu.org/c99status.html
.
Most likely http://gcc.gnu.org/gcc-4.9/c99status.html might need one too.

[Bug web/65231] Dead link in man page to the status of C99 features

[joseph at codesourcery dot com]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=65231

--- Comment #2 from joseph at codesourcery dot com  ---
On Fri, 27 Feb 2015, pinskia at gcc dot gnu.org wrote:

> Someone needs to add the redirect from
> http://gcc.gnu.org/gcc-4.8/c99status.html to http://gcc.gnu.org/c99status.html
> .
> Most likely http://gcc.gnu.org/gcc-4.9/c99status.html might need one too.

No, they are not needed.  The 4.8 branch manual does not contain a 
reference to gcc-4.8/c99status.html, which never existed; the redirects 
are only relevant where the release branch in question has/had such a 
reference before the c99status.html pages were unified.  I don't know 
where the incorrect reference in the manpage referred to came from.

[Bug libstdc++/70788] LaTeX formulae in doxygen comments should be suppressed in man-page output

[redi at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=70788

Jonathan Wakely  changed:

   What|Removed |Added

 Status|UNCONFIRMED |NEW
   Last reconfirmed||2016-04-25
 Ever confirmed|0   |1

--- Comment #1 from Jonathan Wakely  ---
Errors from the Debian package include several due to this issue:


usr/share/man/man3/__gnu_cxx.3cxx.gz 1319: a space character is not allowed
in an escape name
usr/share/man/man3/__gnu_debug::_Safe_unordered_container_base.3cxx.gz 111:
warning [p 2, 2.2i]: can't break line
usr/share/man/man3/__gnu_parallel.3cxx.gz 2415: warning: numeric expression
expected (got `r')
   
usr/share/man/man3/__gnu_pbds::detail::left_child_next_sibling_heap_const_iterator_.3cxx.gz
11: warning [p 1, 1.8i]: can't break line
   
usr/share/man/man3/__gnu_pbds::detail::left_child_next_sibling_heap_node_point_const_iterator_.3cxx.gz
5: warning [p 1, 0.8i]: can't break line
usr/share/man/man3/std::_Hashtable.3cxx.gz 211: warning [p 2, 7.2i]: can't
break line
usr/share/man/man3/std::__debug::map.3cxx.gz 200: warning [p 2, 4.8i]:
can't break line
usr/share/man/man3/std::__debug::multimap.3cxx.gz 200: warning [p 2, 5.0i]:
can't break line
usr/share/man/man3/std::__debug::unordered_map.3cxx.gz 209: warning [p 2,
6.3i]: can't break line
usr/share/man/man3/std::__debug::unordered_multimap.3cxx.gz 209: warning [p
2, 6.7i]: can't break line
usr/share/man/man3/std::__profile::map.3cxx.gz 182: warning [p 2, 4.0i]:
can't break line
usr/share/man/man3/std::__profile::multimap.3cxx.gz 176: warning [p 2,
3.7i]: can't break line
usr/share/man/man3/std::__profile::unordered_map.3cxx.gz 119: warning [p 2,
0.0i]: can't break line
usr/share/man/man3/std::__profile::unordered_multimap.3cxx.gz 116: warning
[p 2, 0.0i]: can't break line
usr/share/man/man3/std::error_condition.3cxx.gz 17: warning [p 1, 2.0i]:
can't break line
usr/share/man/man3/std::exponential_distribution.3cxx.gz 30: warning:
numeric expression expected (got `m')
usr/share/man/man3/std::extreme_value_distribution.3cxx.gz 94: a space
character is not allowed in an escape name
usr/share/man/man3/std::fisher_f_distribution.3cxx.gz 103: a space
character is not allowed in an escape name
usr/share/man/man3/std::gamma_distribution.3cxx.gz 30: normal or special
character expected (got `\&')
usr/share/man/man3/std::linear_congruential_engine.3cxx.gz 97: a space
character is not allowed in an escape name
usr/share/man/man3/std::lognormal_distribution.3cxx.gz 99: a space
character is not allowed in an escape name
usr/share/man/man3/std::map.3cxx.gz 179: warning [p 2, 4.7i]: can't break
line
usr/share/man/man3/std::multimap.3cxx.gz 172: warning [p 2, 4.2i]: can't
break line
usr/share/man/man3/std::normal_distribution.3cxx.gz 102: a space character
is not allowed in an escape name
usr/share/man/man3/std::queue.3cxx.gz 197: warning: macro `c'' not defined
usr/share/man/man3/std::regex_iterator.3cxx.gz 42: warning [p 1, 4.0i]:
can't break line
usr/share/man/man3/std::regex_token_iterator.3cxx.gz 51: warning [p 1,
5.8i]: can't break line
usr/share/man/man3/std::student_t_distribution.3cxx.gz 100: a space
character is not allowed in an escape name
usr/share/man/man3/std::subtract_with_carry_engine.3cxx.gz 99: a space
character is not allowed in an escape name
usr/share/man/man3/std::unordered_map.3cxx.gz 306: warning [p 3, 6.0i]:
can't break line
usr/share/man/man3/std::unordered_multimap.3cxx.gz 306: warning [p 3,
6.8i]: can't break line
usr/share/man/man3/std::weibull_distribution.3cxx.gz 94: a space character
is not allowed in an escape name

[Bug other/87353] gcc man page formatting issue due to leading spaces in .texi contents

[vincent-gcc at vinc17 dot net]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=87353

--- Comment #1 from Vincent Lefèvre  ---
The bug may be in contrib/texi2pod.pl as the following pod text is generated:

Therefore, the G++ and driver automatically adds B<-shared-libgcc>
 whenever you build a shared library or a main executable, because C++
 programs typically use exceptions, so this is the right thing to do.

and the pod specification says: "A verbatim paragraph is distinguished by
having its first character be a space or a tab."

[Bug other/87353] gcc man page formatting issue due to leading spaces in .texi contents

[redi at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=87353

Jonathan Wakely  changed:

   What|Removed |Added

   Keywords||documentation
 Status|UNCONFIRMED |NEW
   Last reconfirmed||2018-09-18
 Ever confirmed|0   |1

[Bug other/87353] gcc man page formatting issue due to leading spaces in .texi contents

[redi at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=87353

--- Comment #2 from Jonathan Wakely  ---
Also, "Therefore, the G++ and driver" is nonsense.

[Bug other/87353] gcc man page formatting issue due to leading spaces in .texi contents

[redi at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=87353

--- Comment #3 from Jonathan Wakely  ---
This was introduced by r242433 

https://gcc.gnu.org/viewcvs/gcc/trunk/gcc/doc/invoke.texi?limit_changes=0&r1=242433&r2=242432&pathrev=242433

[Bug other/87353] gcc man page formatting issue due to leading spaces in .texi contents

[redi at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=87353

Jonathan Wakely  changed:

   What|Removed |Added

 Status|NEW |ASSIGNED
   Assignee|unassigned at gcc dot gnu.org  |redi at gcc dot gnu.org

--- Comment #4 from Jonathan Wakely  ---
Fixed on trunk so far, branches to follow.

[Bug other/87353] gcc man page formatting issue due to leading spaces in .texi contents

[redi at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=87353

--- Comment #5 from Jonathan Wakely  ---
Author: redi
Date: Tue Sep 18 14:19:55 2018
New Revision: 264395

URL: https://gcc.gnu.org/viewcvs?rev=264395&root=gcc&view=rev
Log:
PR other/87353 fix formatting and grammar in manual

The changes to invoke.texi in r242433 left some unwanted spaces that
texi2pod.pl interprets as verbatim formatting. There are also some
grammatical errors due to the removal of references to GCJ, where the
G++ driver is referred to in the plural.

PR other/87353
* doc/invoke.texi (Link Options): Fix formatting and grammar.

Modified:
trunk/gcc/ChangeLog
trunk/gcc/doc/invoke.texi

[Bug other/87353] gcc man page formatting issue due to leading spaces in .texi contents

[redi at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=87353

--- Comment #7 from Jonathan Wakely  ---
Author: redi
Date: Wed Oct  3 10:58:49 2018
New Revision: 264810

URL: https://gcc.gnu.org/viewcvs?rev=264810&root=gcc&view=rev
Log:
PR other/87353 fix formatting and grammar in manual

The changes to invoke.texi in r242433 left some unwanted spaces that
texi2pod.pl interprets as verbatim formatting. There are also some
grammatical errors due to the removal of references to GCJ, where the
G++ driver is referred to in the plural.

PR other/87353
* doc/invoke.texi (Link Options): Fix formatting and grammar.

Modified:
branches/gcc-7-branch/gcc/ChangeLog
branches/gcc-7-branch/gcc/doc/invoke.texi

[Bug other/87353] gcc man page formatting issue due to leading spaces in .texi contents

[redi at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=87353

--- Comment #6 from Jonathan Wakely  ---
Author: redi
Date: Wed Oct  3 10:58:43 2018
New Revision: 264809

URL: https://gcc.gnu.org/viewcvs?rev=264809&root=gcc&view=rev
Log:
PR other/87353 fix formatting and grammar in manual

The changes to invoke.texi in r242433 left some unwanted spaces that
texi2pod.pl interprets as verbatim formatting. There are also some
grammatical errors due to the removal of references to GCJ, where the
G++ driver is referred to in the plural.

PR other/87353
* doc/invoke.texi (Link Options): Fix formatting and grammar.

Modified:
branches/gcc-8-branch/gcc/ChangeLog
branches/gcc-8-branch/gcc/doc/invoke.texi

[Bug other/87353] gcc man page formatting issue due to leading spaces in .texi contents

[redi at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=87353

Jonathan Wakely  changed:

   What|Removed |Added

 Status|ASSIGNED|RESOLVED
 Resolution|--- |FIXED

--- Comment #8 from Jonathan Wakely  ---
Done

[Bug c/65231] New: Dead link in man page to the status of C99 features

[humbug at deeptown dot org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=65231

Bug ID: 65231
   Summary: Dead link in man page to the status of C99 features
   Product: gcc
   Version: 4.8.2
Status: UNCONFIRMED
  Severity: normal
  Priority: P3
 Component: c
  Assignee: unassigned at gcc dot gnu.org
  Reporter: humbug at deeptown dot org

In man page c99-gcc.1.gz there is a dead link to
http://gcc.gnu.org/gcc-4.8/c99status.html


$ zgrep c99status /usr/share/man/man1/c99-gcc.1.gz
.I http://gcc.gnu.org/gcc-4.8/c99status.html

$ curl --fail http://gcc.gnu.org/gcc-4.8/c99status.html
curl: (22) The requested URL returned error: 404 Not Found


Script to check for other dead links:

$ find /usr/share/man -name "*g[+c][+c]*" -exec zgrep -Ho "http://.*.html"; "{}"
\; | xargs -P4 -I{} bash -c 'IFS=":" read file url <<< "{}"; request=`curl -m3 
-LfgsS --head "$url" 2>&1` || echo url: "\"$url\"" in: "\"$file\"" error:
"\"$request\"" '


Version info:

$ dpkg -S c99-gcc.1.gz
gcc: /usr/share/man/man1/c99-gcc.1.gz

$ aptitude show gcc
Version: 4:4.8.2-1ubuntu6

$ c99 -v
Using built-in specs.
COLLECT_GCC=gcc
COLLECT_LTO_WRAPPER=/usr/lib/gcc/x86_64-linux-gnu/4.8/lto-wrapper
Target: x86_64-linux-gnu
Configured with: ../src/configure -v --with-pkgversion='Ubuntu 4.8.2-19ubuntu1'
--with-bugurl=file:///usr/share/doc/gcc-4.8/README.Bugs
--enable-languages=c,c++,java,go,d,fortran,objc,obj-c++ --prefix=/usr
--program-suffix=-4.8 --enable-shared --enable-linker-build-id
--libexecdir=/usr/lib --without-included-gettext --enable-threads=posix
--with-gxx-include-dir=/usr/include/c++/4.8 --libdir=/usr/lib --enable-nls
--with-sysroot=/ --enable-clocale=gnu --enable-libstdcxx-debug
--enable-libstdcxx-time=yes --enable-gnu-unique-object --disable-libmudflap
--enable-plugin --with-system-zlib --disable-browser-plugin
--enable-java-awt=gtk --enable-gtk-cairo
--with-java-home=/usr/lib/jvm/java-1.5.0-gcj-4.8-amd64/jre --enable-java-home
--with-jvm-root-dir=/usr/lib/jvm/java-1.5.0-gcj-4.8-amd64
--with-jvm-jar-dir=/usr/lib/jvm-exports/java-1.5.0-gcj-4.8-amd64
--with-arch-directory=amd64 --with-ecj-jar=/usr/share/java/eclipse-ecj.jar
--enable-objc-gc --enable-multiarch --disable-werror --with-arch-32=i686
--with-abi=m64 --with-multilib-list=m32,m64,mx32 --with-tune=generic
--enable-checking=release --build=x86_64-linux-gnu --host=x86_64-linux-gnu
--target=x86_64-linux-gnu
Thread model: posix
gcc version 4.8.2 (Ubuntu 4.8.2-19ubuntu1)

[Bug web/59634] Documentation (info/man page): lack of information for cache size parameters (--param)

[pinskia at gcc dot gnu.org]

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

--- Comment #1 from Andrew Pinski  ---
http://gcc.gnu.org/onlinedocs/gcc-4.8.2/gcc/Optimize-Options.html#index-param-935

l1-cache-line-size
The size of cache line in L1 cache, in bytes. 
l1-cache-size
The size of L1 cache, in kilobytes. 
l2-cache-size
The size of L2 cache, in kilobytes. 

This is talking about data cache size.

[Bug web/59634] Documentation (info/man page): lack of information for cache size parameters (--param)

[ytrezq at myopera dot com]

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

--- Comment #2 from ytrezq at myopera dot com ---
Ok. So, does it worth to make a change to the documentation?

An another possibility it to rename the parameter in this way:

l1-cache-size-->l1-data-cache-size
l2-cache-size-->l2-data-cache-size

[Bug libffi/52223] New: [4.5,4.6,4.7 regression] libffi's man page install breaks with multilibs and overridden mandir

[mikpe at it dot uu.se]

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

 Bug #: 52223
   Summary: [4.5,4.6,4.7 regression] libffi's man page install
breaks with multilibs and overridden mandir
Classification: Unclassified
   Product: gcc
   Version: 4.7.0
Status: UNCONFIRMED
  Severity: normal
  Priority: P3
 Component: libffi
AssignedTo: unassig...@gcc.gnu.org
ReportedBy: mi...@it.uu.se


libffi installs three man pages during 'make install'.  If
a) the target has multilibs enabled, and
b) the configure-time --mandir= is overridden by make install with mandir=,
then libffi's man page install step in its multilib subdirs will ignore the
overridden mandir and use the configure-time mandir instead, which may clobber
an unexpected destination, or may cause the entire install to fail if that
destination isn't currently writable by the user.

The problem reproduces easily on x86_64-linux:
/path/to/gcc-4.7/configure --prefix=/usr --mandir=/usr/share/man
--enable-languages=c,c++,java --enable-multilib
make
# the following must be done as a regular user with no write access to
# /usr/share/man
make prefix=/tmp/buildroot/usr mandir=/tmp/buildroot/usr/share/man install
...
Making install in man
make[5]: Entering directory
`/tmp/objdir/x86_64-unknown-linux-gnu/32/libffi/man'
make[6]: Entering directory
`/tmp/objdir/x86_64-unknown-linux-gnu/32/libffi/man'
make[6]: Nothing to be done for `install-exec-am'.
test -z "/usr/share/man/man3" || /bin/mkdir -p "/usr/share/man/man3"
 /usr/bin/install -c -m 644 /tmp/gcc-4.7-20120211/libffi/man/ffi.3
/tmp/gcc-4.7-20120211/libffi/man/ffi_call.3
/tmp/gcc-4.7-20120211/libffi/man/ffi_prep_cif.3 '/usr/share/man/man3'
/usr/bin/install: cannot create regular file `/usr/share/man/man3/ffi.3':
Permission denied
/usr/bin/install: cannot create regular file `/usr/share/man/man3/ffi_call.3':
Permission denied
/usr/bin/install: cannot create regular file
`/usr/share/man/man3/ffi_prep_cif.3': Permission denied
make[6]: *** [install-man3] Error 1
make[6]: Leaving directory `/tmp/objdir/x86_64-unknown-linux-gnu/32/libffi/man'
make[5]: *** [install-am] Error 2
make[5]: Leaving directory `/tmp/objdir/x86_64-unknown-linux-gnu/32/libffi/man'
make[4]: *** [install-recursive] Error 1
make[4]: Leaving directory `/tmp/objdir/x86_64-unknown-linux-gnu/32/libffi'
make[3]: *** [multi-do] Error 1
make[3]: Leaving directory `/tmp/objdir/x86_64-unknown-linux-gnu/libffi'
make[2]: *** [install-multi] Error 2
make[2]: Leaving directory `/tmp/objdir/x86_64-unknown-linux-gnu/libffi'
make[1]: *** [install-target-libffi] Error 2
make[1]: Leaving directory `/tmp/objdir'
make: *** [install] Error 2

If multilibs are disabled then the man-page install step does use the
overridden mandir=, but that clearly isn't a solution when multilibs are
essential.  I currently work around it by patching libffi's makefiles to delete
"man" from "SUBDIRS".

The problem is present in 4.5, 4.6, and 4.7, for (at least) x86_64-linux and
m68k-linux.  4.4 did not have those man pages or this problem.

The build procedure (configure with --prefix= and --mandir= pointing to system
directories, but make install with prefix= and mandir= pointing to a local
staging area) is taken verbatim from Fedora's gcc src rpm, so I'm assuming it's
something that should work.

[Bug libffi/52223] [4.5/4.6 Regression] libffi's man page install breaks with multilibs and overridden mandir

[jakub at gcc dot gnu.org]

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

Jakub Jelinek  changed:

   What|Removed |Added

Summary|[4.5/4.6/4.7 Regression]|[4.5/4.6 Regression]
   |libffi's man page install   |libffi's man page install
   |breaks with multilibs and   |breaks with multilibs and
   |overridden mandir   |overridden mandir

--- Comment #9 from Jakub Jelinek  2012-02-27 
10:05:58 UTC ---
Fixed on the trunk so far.

[Bug libffi/52223] [4.5/4.6 Regression] libffi's man page install breaks with multilibs and overridden mandir

[rguenth at gcc dot gnu.org]

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

--- Comment #10 from Richard Guenther  2012-06-20 
13:16:43 UTC ---
Author: rguenth
Date: Wed Jun 20 13:16:35 2012
New Revision: 188830

URL: http://gcc.gnu.org/viewcvs?root=gcc&view=rev&rev=188830
Log:
2012-06-20  Richard Guenther  

Backport from mainline
2012-02-27  Mikael Pettersson  

PR libffi/52223
* Makefile.am (FLAGS_TO_PASS): Define.
* Makefile.in: Regenerate.

Modified:
branches/gcc-4_5-branch/libffi/ChangeLog
branches/gcc-4_5-branch/libffi/Makefile.am
branches/gcc-4_5-branch/libffi/Makefile.in

[Bug libffi/52223] [4.5/4.6 Regression] libffi's man page install breaks with multilibs and overridden mandir

[rguenth at gcc dot gnu.org]

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

Richard Guenther  changed:

   What|Removed |Added

   Priority|P3  |P2
 Status|REOPENED|RESOLVED
 Resolution||FIXED

--- Comment #10 from Richard Guenther  2012-06-20 
13:16:43 UTC ---
Author: rguenth
Date: Wed Jun 20 13:16:35 2012
New Revision: 188830

URL: http://gcc.gnu.org/viewcvs?root=gcc&view=rev&rev=188830
Log:
2012-06-20  Richard Guenther  

Backport from mainline
2012-02-27  Mikael Pettersson  

PR libffi/52223
* Makefile.am (FLAGS_TO_PASS): Define.
* Makefile.in: Regenerate.

Modified:
branches/gcc-4_5-branch/libffi/ChangeLog
branches/gcc-4_5-branch/libffi/Makefile.am
branches/gcc-4_5-branch/libffi/Makefile.in

--- Comment #11 from Richard Guenther  2012-06-20 
13:16:54 UTC ---
Fixed.

[Bug libffi/52223] [4.5/4.6 Regression] libffi's man page install breaks with multilibs and overridden mandir

[rguenth at gcc dot gnu.org]

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

Richard Guenther  changed:

   What|Removed |Added

   Priority|P3  |P2
 Status|REOPENED|RESOLVED
 Resolution||FIXED

--- Comment #11 from Richard Guenther  2012-06-20 
13:16:54 UTC ---
Fixed.

[Bug libstdc++/70788] New: LaTeX formulae in doxygen comments should be suppressed in man-page output

[redi at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=70788

Bug ID: 70788
   Summary: LaTeX formulae in doxygen comments should be
suppressed in man-page output
   Product: gcc
   Version: 7.0
Status: UNCONFIRMED
  Keywords: documentation
  Severity: minor
  Priority: P3
 Component: libstdc++
  Assignee: unassigned at gcc dot gnu.org
  Reporter: redi at gcc dot gnu.org
  Target Milestone: ---

Doxygen's formula support only works for HTML and LaTeX output, so the
generated man pages contain garbled LaTeX such as "x_{i+1}tarrow(ax_{i} + c) d
]"

[Bug other/87353] New: gcc man page formatting issue due to leading spaces in .texi contents

[vincent-gcc at vinc17 dot net]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=87353

Bug ID: 87353
   Summary: gcc man page formatting issue due to leading spaces in
.texi contents
   Product: gcc
   Version: 9.0
Status: UNCONFIRMED
  Severity: normal
  Priority: P3
 Component: other
  Assignee: unassigned at gcc dot gnu.org
  Reporter: vincent-gcc at vinc17 dot net
  Target Milestone: ---

The gcc(1) man page (gcc.1) shows as:

   Therefore, the G++ and driver automatically adds -shared-libgcc
whenever you build a shared library or a main executable, because
   C++
programs typically use exceptions, so this is the right thing to
   do.

This is due to gcc/doc/invoke.texi containing leading spaces:

Therefore, the G++ and driver automatically adds @option{-shared-libgcc}
 whenever you build a shared library or a main executable, because C++
 programs typically use exceptions, so this is the right thing to do.

Removing these spaces should solve the problem (I haven't checked other parts
of the manual), but AFAIK, such spaces are valid and do not yield any issue in
generated .info files. Thus the real bug could be in conversion utilities
(contrib/texi2pod.pl, provided by GCC, or pod2man).

[Bug middle-end/59634] Documentation (info/man page): lack of information for cache size parameters (--param)

[sandra at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=59634

--- Comment #3 from sandra at gcc dot gnu.org ---
Author: sandra
Date: Tue Nov 13 03:40:53 2018
New Revision: 266048

URL: https://gcc.gnu.org/viewcvs?rev=266048&root=gcc&view=rev
Log:
2018-11-13  Sandra Loosemore  

PR middle-end/59634

gcc/
* doc/invoke.texi (Optimize Options): Clarify that the
l1-cache-line-size, l1-cache-size, and l2-cache-size parameters
apply to data cache size.

Modified:
trunk/gcc/ChangeLog
trunk/gcc/doc/invoke.texi

[Bug middle-end/59634] Documentation (info/man page): lack of information for cache size parameters (--param)

[sandra at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=59634

sandra at gcc dot gnu.org changed:

   What|Removed |Added

 Status|UNCONFIRMED |RESOLVED
 CC||sandra at gcc dot gnu.org
 Resolution|--- |FIXED

--- Comment #4 from sandra at gcc dot gnu.org ---
Documentation fixed on trunk.

[Bug web/59634] New: Documentation (info/man page): lack of information for cache size parameters (--param)

[ytrezq at myopera dot com]

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

Bug ID: 59634
   Summary: Documentation (info/man page): lack of information for
cache size parameters (--param)
   Product: gcc
   Version: unknown
Status: UNCONFIRMED
  Severity: normal
  Priority: P3
 Component: web
  Assignee: unassigned at gcc dot gnu.org
  Reporter: ytrezq at myopera dot com

gcc have several --param for suggesting cache size (l1-cache-line-size
l1-cache-size l2-cache-size)


However some processors/SoC (like the BCM6358) have separates caches for
instructions and data. The documentation don't say which size to consider.
For example if you have a processor where you get those info with dmesg:

"Primary instruction cache 32kB, VIPT, 2-way, linesize 16 bytes" and "Primary
data cache 16kB, 2-way, VIPT, cache aliases, linesize 16 bytes"

You know the value for --param l1-cache-line-size is 16 but for l1-cache-size
you don't know if it is 32Kb or 16Kb.

[Bug libffi/52223] [4.5/4.6/4.7 Regression] libffi's man page install breaks with multilibs and overridden mandir

[rguenth at gcc dot gnu.org]

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

Richard Guenther  changed:

   What|Removed |Added

 Status|UNCONFIRMED |WAITING
   Last reconfirmed||2012-02-13
   Target Milestone|--- |4.5.4
Summary|[4.5,4.6,4.7 regression]|[4.5/4.6/4.7 Regression]
   |libffi's man page install   |libffi's man page install
   |breaks with multilibs and   |breaks with multilibs and
   |overridden mandir   |overridden mandir
 Ever Confirmed|0   |1

--- Comment #1 from Richard Guenther  2012-02-13 
11:17:21 UTC ---
I think you should always use DESTDIR instead of setting prefix or mandir
at install time.

[Bug libffi/52223] [4.5/4.6/4.7 Regression] libffi's man page install breaks with multilibs and overridden mandir

[mikpe at it dot uu.se]

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

Mikael Pettersson  changed:

   What|Removed |Added

 Status|WAITING |RESOLVED
 Resolution||INVALID

--- Comment #2 from Mikael Pettersson  2012-02-13 
14:07:15 UTC ---
"make DESTDIR=... install" does work, and it's documented.  "make prefix=...
mandir=... install" doesn't seem to be documented, so presumably this was a
procedural error I inherited from Fedora's gcc spec file, sigh.

[Bug libffi/52223] [4.5/4.6/4.7 Regression] libffi's man page install breaks with multilibs and overridden mandir

[joseph at codesourcery dot com]

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

--- Comment #3 from joseph at codesourcery dot com  2012-02-13 16:50:17 UTC ---
This ought to work.  Does applying the fix I discuss in 
 - setting 
FLAGS_TO_PASS = $(AM_MAKEFLAGS) in Makefile.am - for libffi help here?

[Bug libffi/52223] [4.5/4.6/4.7 Regression] libffi's man page install breaks with multilibs and overridden mandir

[mikpe at it dot uu.se]

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

--- Comment #4 from Mikael Pettersson  2012-02-13 
19:15:07 UTC ---
(In reply to comment #3)
> This ought to work.  Does applying the fix I discuss in 
>  - setting 
> FLAGS_TO_PASS = $(AM_MAKEFLAGS) in Makefile.am - for libffi help here?

Yes, with that applied overriding mandir at install does work.

I had to adapt the patch a little, this is what I tested:

--- gcc-4.7-20120211/libffi/Makefile.am.~1~
+++ gcc-4.7-20120211/libffi/Makefile.am
@@ -76,6 +76,9 @@ AM_MAKEFLAGS = \
"RANLIB=$(RANLIB)" \
"DESTDIR=$(DESTDIR)"

+# Subdir rules rely on $(FLAGS_TO_PASS)
+FLAGS_TO_PASS = $(AM_MAKEFLAGS)
+
 MAKEOVERRIDES=

 toolexeclib_LTLIBRARIES = libffi.la
--- gcc-4.7-20120211/libffi/Makefile.in.~1~
+++ gcc-4.7-20120211/libffi/Makefile.in
@@ -455,6 +455,8 @@ AM_MAKEFLAGS = \
"RANLIB=$(RANLIB)" \
"DESTDIR=$(DESTDIR)"

+# Subdir rules rely on $(FLAGS_TO_PASS)
+FLAGS_TO_PASS = $(AM_MAKEFLAGS)
 MAKEOVERRIDES = 
 toolexeclib_LTLIBRARIES = libffi.la
 noinst_LTLIBRARIES = libffi_convenience.la

[Bug libffi/52223] [4.5/4.6/4.7 Regression] libffi's man page install breaks with multilibs and overridden mandir

[mikpe at it dot uu.se]

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

Mikael Pettersson  changed:

   What|Removed |Added

 Status|RESOLVED|REOPENED
 Resolution|INVALID |

--- Comment #5 from Mikael Pettersson  2012-02-19 
10:16:09 UTC ---
Reopening, since Joseph's comment and analogous patch for libquadmath implies
that this is in fact expected to work.

[Bug libffi/52223] [4.5/4.6/4.7 Regression] libffi's man page install breaks with multilibs and overridden mandir

[jakub at gcc dot gnu.org]

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

Jakub Jelinek  changed:

   What|Removed |Added

 CC||jakub at gcc dot gnu.org

--- Comment #6 from Jakub Jelinek  2012-02-22 
15:03:34 UTC ---
(In reply to comment #4)
> (In reply to comment #3)
> > This ought to work.  Does applying the fix I discuss in 
> >  - setting 
> > FLAGS_TO_PASS = $(AM_MAKEFLAGS) in Makefile.am - for libffi help here?
> 
> Yes, with that applied overriding mandir at install does work.
> 
> I had to adapt the patch a little, this is what I tested:
> 
> --- gcc-4.7-20120211/libffi/Makefile.am.~1~
> +++ gcc-4.7-20120211/libffi/Makefile.am
> @@ -76,6 +76,9 @@ AM_MAKEFLAGS = \
> "RANLIB=$(RANLIB)" \
> "DESTDIR=$(DESTDIR)"
> 
> +# Subdir rules rely on $(FLAGS_TO_PASS)
> +FLAGS_TO_PASS = $(AM_MAKEFLAGS)
> +
>  MAKEOVERRIDES=
> 
>  toolexeclib_LTLIBRARIES = libffi.la
> --- gcc-4.7-20120211/libffi/Makefile.in.~1~
> +++ gcc-4.7-20120211/libffi/Makefile.in
> @@ -455,6 +455,8 @@ AM_MAKEFLAGS = \
> "RANLIB=$(RANLIB)" \
> "DESTDIR=$(DESTDIR)"
> 
> +# Subdir rules rely on $(FLAGS_TO_PASS)
> +FLAGS_TO_PASS = $(AM_MAKEFLAGS)
>  MAKEOVERRIDES = 
>  toolexeclib_LTLIBRARIES = libffi.la
>  noinst_LTLIBRARIES = libffi_convenience.la

Are you going to post this to gcc-patches?  Please CC the build maintainers.