Patchwork Fix texinfo warnings for doc/gcc.texi [was: Re: doc bugs]

login
register
mail settings
Submitter Tobias Burnus
Date March 29, 2014, 9:51 a.m.
Message ID <533697BE.7090206@net-b.de>
Download mbox | patch
Permalink /patch/334942/
State New
Headers show

Comments

Tobias Burnus - March 29, 2014, 9:51 a.m.
H.J. Lu wrote:
> On Fri, Mar 28, 2014 at 12:41 PM, Mike Stump <mikestump@comcast.net> wrote:
>> Since we are nearing release, I thought I'd mention I see:
>> ../../gcc/gcc/doc/invoke.texi:1114: warning: node next `Overall Options' in menu `C Dialect Options' and in sectioning `Invoking G++' differ
> http://gcc.gnu.org/bugzilla/show_bug.cgi?id=59055

I think one reason that there are (and were) that many warnings is that 
only recently texinfo gained support for diagnosing these issues. (Or 
maybe not that recent but distributions were slow in adapting newer 
texinfo versions.)

Attached is a warning-removal patch.
OK for the trunk?

Regarding invoke.texi: It had (nearly) the same @menu twice, once under 
@chapter where it belongs to and once under a @section where it doesn't.

Tobias
Tobias Burnus - April 2, 2014, 7:18 p.m.
*PING*

Tobias Burnus wrote:
> H.J. Lu wrote:
>> On Fri, Mar 28, 2014 at 12:41 PM, Mike Stump <mikestump@comcast.net> 
>> wrote:
>>> Since we are nearing release, I thought I'd mention I see:
>>> ../../gcc/gcc/doc/invoke.texi:1114: warning: node next `Overall 
>>> Options' in menu `C Dialect Options' and in sectioning `Invoking 
>>> G++' differ
>> http://gcc.gnu.org/bugzilla/show_bug.cgi?id=59055
>
> I think one reason that there are (and were) that many warnings is 
> that only recently texinfo gained support for diagnosing these issues. 
> (Or maybe not that recent but distributions were slow in adapting 
> newer texinfo versions.)
>
> Attached is a warning-removal patch.
> OK for the trunk?
>
> Regarding invoke.texi: It had (nearly) the same @menu twice, once 
> under @chapter where it belongs to and once under a @section where it 
> doesn't.
>
> Tobias
Tobias Burnus - April 7, 2014, 6:41 a.m.
* PING *

Tobias Burnus wrote:
> *PING*
>
> Tobias Burnus wrote:
>> H.J. Lu wrote:
>>> On Fri, Mar 28, 2014 at 12:41 PM, Mike Stump <mikestump@comcast.net> 
>>> wrote:
>>>> Since we are nearing release, I thought I'd mention I see:
>>>> ../../gcc/gcc/doc/invoke.texi:1114: warning: node next `Overall 
>>>> Options' in menu `C Dialect Options' and in sectioning `Invoking 
>>>> G++' differ
>>> http://gcc.gnu.org/bugzilla/show_bug.cgi?id=59055
>>
>> I think one reason that there are (and were) that many warnings is 
>> that only recently texinfo gained support for diagnosing these 
>> issues. (Or maybe not that recent but distributions were slow in 
>> adapting newer texinfo versions.)
>>
>> Attached is a warning-removal patch.
>> OK for the trunk?
>>
>> Regarding invoke.texi: It had (nearly) the same @menu twice, once 
>> under @chapter where it belongs to and once under a @section where it 
>> doesn't.
>>
>> Tobias
>
>
Jakub Jelinek - April 11, 2014, 11:55 a.m.
On Sat, Mar 29, 2014 at 10:51:58AM +0100, Tobias Burnus wrote:
> 2014-03-29  Tobias Burnus  <burnus@net-b.de>
> 
> 	PR other/59055
> 	* doc/bugreport.texi (Bugs): Remove nodes pointing to the
> 	nirvana.
> 	* doc/gcc.texi (Service): Update description in the @menu
> 	* doc/invoke.texi (Option Summary): Remove misplaced and
> 	duplicated @menu.

Ok.

	Jakub

Patch

2014-03-29  Tobias Burnus  <burnus@net-b.de>

	PR other/59055
	* doc/bugreport.texi (Bugs): Remove nodes pointing to the
	nirvana.
	* doc/gcc.texi (Service): Update description in the @menu
	* doc/invoke.texi (Option Summary): Remove misplaced and
	duplicated @menu.

diff --git a/gcc/doc/bugreport.texi b/gcc/doc/bugreport.texi
index be03522..e465c24 100644
--- a/gcc/doc/bugreport.texi
+++ b/gcc/doc/bugreport.texi
@@ -16,11 +16,9 @@  report the problem.
 @menu
 * Criteria:  Bug Criteria.   Have you really found a bug?
 * Reporting: Bug Reporting.  How to report a bug effectively.
-* Known: Trouble.            Known problems.
-* Help: Service.             Where to ask for help.
 @end menu
 
-@node Bug Criteria,Bug Reporting,,Bugs
+@node Bug Criteria
 @section Have You Found a Bug?
 @cindex bug criteria
 
@@ -83,7 +81,7 @@  If you are an experienced user of one of the languages GCC supports, your
 suggestions for improvement of GCC are welcome in any case.
 @end itemize
 
-@node Bug Reporting,,Bug Criteria,Bugs
+@node Bug Reporting
 @section How and where to Report Bugs
 @cindex compiler bugs, reporting
 
diff --git a/gcc/doc/gcc.texi b/gcc/doc/gcc.texi
index 1e0fc46..c1f3857 100644
--- a/gcc/doc/gcc.texi
+++ b/gcc/doc/gcc.texi
@@ -140,7 +140,7 @@  Introduction, gccint, GNU Compiler Collection (GCC) Internals}.
 * Gcov::            @command{gcov}---a test coverage program.
 * Trouble::         If you have trouble using GCC.
 * Bugs::            How, why and where to report bugs.
-* Service::         How to find suppliers of support for GCC.
+* Service::         How To Get Help with GCC
 * Contributing::    How to contribute to testing and developing GCC.
 
 * Funding::         How to help assure funding for free software.
diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index 78ddde0..b623b05 100644
--- a/gcc/doc/invoke.texi
+++ b/gcc/doc/invoke.texi
@@ -1088,28 +1088,6 @@  See S/390 and zSeries Options.
 -fvisibility -fstrict-volatile-bitfields -fsync-libcalls}
 @end table
 
-@menu
-* Overall Options::     Controlling the kind of output:
-                        an executable, object files, assembler files,
-                        or preprocessed source.
-* C Dialect Options::   Controlling the variant of C language compiled.
-* C++ Dialect Options:: Variations on C++.
-* Objective-C and Objective-C++ Dialect Options:: Variations on Objective-C
-                        and Objective-C++.
-* Language Independent Options:: Controlling how diagnostics should be
-                        formatted.
-* Warning Options::     How picky should the compiler be?
-* Debugging Options::   Symbol tables, measurements, and debugging dumps.
-* Optimize Options::    How much optimization?
-* Preprocessor Options:: Controlling header files and macro definitions.
-                         Also, getting dependency information for Make.
-* Assembler Options::   Passing options to the assembler.
-* Link Options::        Specifying libraries and so on.
-* Directory Options::   Where to find header files and libraries.
-                        Where to find the compiler executable files.
-* Spec Files::          How to pass switches to sub-processes.
-* Target Options::      Running a cross-compiler, or an old version of GCC.
-@end menu
 
 @node Overall Options
 @section Options Controlling the Kind of Output