Date: Sun, 26 Oct 2003 15:08:40 -0800 (PST) From: Max Khon <fjoe@FreeBSD.org> To: FreeBSD-gnats-submit@FreeBSD.org Subject: gnu/58583: gcc.1, cpp.1 and gcov.1 manpages are outdated Message-ID: <200310262308.h9QN8eWs076088@freefall.freebsd.org> Resent-Message-ID: <200310262310.h9QNAOaG076151@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 58583
>Category: gnu
>Synopsis: gcc.1, cpp.1 and gcov.1 manpages are outdated
>Confidential: no
>Severity: non-critical
>Priority: medium
>Responsible: freebsd-bugs
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Sun Oct 26 15:10:23 PST 2003
>Closed-Date:
>Last-Modified:
>Originator: Max Khon
>Release: FreeBSD 5.1
>Organization:
>Environment:
>Description:
Man pages for gcc.1, cpp.1 and gcov.1 are outdated.
>How-To-Repeat:
>Fix:
One of possible solutions is:
1) Remove src/contrib/gcc/*.1.
2) Import src/contrib/gcc/doc/*.1 from gcc 3.3.1 distribution.
Patch that adds FreeBSD local changes from src/contrib/gcc/gcc.1:
--- ./gcc/doc/invoke.texi.orig Mon Jul 21 18:19:57 2003
+++ ./gcc/doc/invoke.texi Mon Oct 27 02:06:22 2003
@@ -42,8 +42,7 @@
remainder. @samp{g++} accepts mostly the same options as @samp{gcc}.
@c man end
@c man begin SEEALSO
-gpl(7), gfdl(7), fsf-funding(7),
-cpp(1), gcov(1), g77(1), as(1), ld(1), gdb(1), adb(1), dbx(1), sdb(1)
+as(1), cpp(1), gcov(1), ld(1), gdb(1)
and the Info entries for @file{gcc}, @file{cpp}, @file{g77}, @file{as},
@file{ld}, @file{binutils} and @file{gdb}.
@c man end
@@ -139,6 +138,7 @@
such as 68010 vs 68020.
* Code Gen Options:: Specifying conventions for function calls, data layout
and register usage.
+* FreeBSD Specific Options::
* Environment Variables:: Env vars that affect GCC.
* Running Protoize:: Automatically adding or removing function prototypes.
@end menu
@@ -665,6 +665,10 @@
-fargument-noalias-global -fleading-underscore @gol
-ftls-model=@var{model} @gol
-ftrapv -fbounds-check}
+
+@item FreeBSD Specific Options
+@xref{FreeBSD Specific Options,,Options Specific to FreeBSD}.
+@gccoptlist{-pthread}
@end table
@menu
@@ -10899,6 +10903,19 @@
The default without @option{-fpic} is @code{initial-exec}; with
@option{-fpic} the default is @code{global-dynamic}.
+@end table
+
+@node FreeBSD Specific Options
+@section Options Specific to FreeBSD
+@cindex FreeBSD Specific Options
+
+These options are specific to FreeBSD:
+
+@table @gcctabopt
+@item -pthread
+@opindex pthread
+Link a user-threaded process against libc_r instead of libc.
+
@end table
@c man end
After this patch is applied gcc.info and gcc.1 should be regenerated.
3) Apply the following patch for bmake glue:
Index: cc/Makefile
===================================================================
RCS file: /home/ncvs/src/gnu/usr.bin/cc/cc/Makefile,v
retrieving revision 1.28
diff -u -p -r1.28 Makefile
--- cc/Makefile 5 Jun 2002 21:30:43 -0000 1.28
+++ cc/Makefile 21 Oct 2003 11:29:04 -0000
@@ -3,7 +3,7 @@
.include "../Makefile.inc"
.include "../Makefile.fe"
-.PATH: ${GCCDIR}
+.PATH: ${GCCDIR} ${GCCDIR}/doc
PROG= cc
MAN= gcc.1
Index: cpp/Makefile
===================================================================
RCS file: /home/ncvs/src/gnu/usr.bin/cc/cpp/Makefile,v
retrieving revision 1.23
diff -u -p -r1.23 Makefile
--- cpp/Makefile 6 Jun 2003 13:46:55 -0000 1.23
+++ cpp/Makefile 21 Oct 2003 11:28:46 -0000
@@ -3,7 +3,7 @@
.include "../Makefile.inc"
.include "../Makefile.fe"
-.PATH: ${GCCDIR}
+.PATH: ${GCCDIR} ${GCCDIR}/doc
PROG= cpp
SRCS= gcc.c cppspec.c
@@ -13,10 +13,5 @@ CFLAGS+= -DDEFAULT_TARGET_MACHINE=\"$(ta
DPADD+= ${LIBCC_INT}
LDADD+= ${LIBCC_INT}
-
-CLEANFILES= cpp.1
-
-cpp.1: cccp.1
- cat ${.ALLSRC} > ${.TARGET}
.include <bsd.prog.mk>
>Release-Note:
>Audit-Trail:
>Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200310262308.h9QN8eWs076088>