doc: Fix a few minor errors spotted by testers
authorArsen Arsenović <arsen@aarsen.me>
Fri, 10 Mar 2023 15:08:19 +0000 (16:08 +0100)
committerArsen Arsenović <arsen@aarsen.me>
Tue, 21 Mar 2023 08:47:33 +0000 (09:47 +0100)
This commit addresses a few minor errors that were spotted while testing
the GCC manual with a few people, and while working on wider changes.

gcc/ChangeLog:

* doc/extend.texi (Formatted Output Function Checking): New
subsection for  grouping together printf et al.
(Exception handling) Fix missing @ sign before copyright
header, which lead to the copyright line leaking into
'(gcc)Exception handling'.
* doc/gcc.texi: Set document language to en_US.
(@copying): Wrap front cover texts in quotations, move in manual
description text.

gcc/doc/extend.texi
gcc/doc/gcc.texi

index dfe54a6ddf3f64a8eea99835db1c41f0635d33d1..98a1adffe909d4fe3c79734ac13bb63e0aa01a1d 100644 (file)
@@ -1,4 +1,4 @@
-c Copyright (C) 1988-2023 Free Software Foundation, Inc.
+@c Copyright (C) 1988-2023 Free Software Foundation, Inc.
 
 @c This is part of the GCC manual.
 @c For copying conditions, see the file gcc.texi.
@@ -12995,6 +12995,7 @@ int __builtin___vsprintf_chk (char *s, int flag, size_t os, const char *fmt,
 int __builtin___vsnprintf_chk (char *s, size_t maxlen, int flag, size_t os,
                                const char *fmt, va_list ap);
 @end smallexample
+@subsubsection Formatted Output Function Checking
 
 The added @var{flag} argument is passed unchanged to @code{__sprintf_chk}
 etc.@: functions and can contain implementation specific flags on what
index a284dd2fd9338a34a5989f8e8407952c0aa0a4e5..b3d500d4f47dccf9a081584e028c381ad977907f 100644 (file)
 
 @paragraphindent 1
 
+@documentlanguage en_US
 @c %**end of header
 
 @copying
+This file documents the use of the GNU compilers.
+
 Copyright @copyright{} 1988-2023 Free Software Foundation, Inc.
 
 Permission is granted to copy, distribute and/or modify this document
@@ -52,13 +55,17 @@ Texts being (a) (see below), and with the Back-Cover Texts being (b)
 
 (a) The FSF's Front-Cover Text is:
 
+@quotation
      A GNU Manual
+@end quotation
 
 (b) The FSF's Back-Cover Text is:
 
+@quotation
      You have freedom to copy and modify this GNU Manual, like GNU
      software.  Copies published by the Free Software Foundation raise
      funds for GNU development.
+@end quotation
 @end copying
 @ifnottex
 @dircategory Software development
@@ -71,7 +78,6 @@ Texts being (a) (see below), and with the Back-Cover Texts being (b)
 * lto-dump: (gcc) lto-dump.    @command{lto-dump}---Tool for
 dumping LTO object files.
 @end direntry
-This file documents the use of the GNU compilers.
 @sp 1
 @insertcopying
 @sp 1