From: Arsen Arsenović <arsen@aarsen.me>
Date: Fri, 10 Mar 2023 15:08:19 +0000 (+0100)
Subject: doc: Fix a few minor errors spotted by testers
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=e1e5ecb28969f2322145d75612beeb0860324bd7;p=people%2Fms%2Fgcc.git

doc: Fix a few minor errors spotted by testers

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.
---

diff --git a/gcc/doc/extend.texi b/gcc/doc/extend.texi
index dfe54a6ddf3..98a1adffe90 100644
--- a/gcc/doc/extend.texi
+++ b/gcc/doc/extend.texi
@@ -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
diff --git a/gcc/doc/gcc.texi b/gcc/doc/gcc.texi
index a284dd2fd93..b3d500d4f47 100644
--- a/gcc/doc/gcc.texi
+++ b/gcc/doc/gcc.texi
@@ -37,9 +37,12 @@
 
 @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