[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
branch master updated: * doc/texinfo.texi (Heading Format): Revise. Ment
From: |
Gavin D. Smith |
Subject: |
branch master updated: * doc/texinfo.texi (Heading Format): Revise. Mention that chapter pages might be different. |
Date: |
Mon, 05 Sep 2022 12:51:45 -0400 |
This is an automated email from the git hooks/post-receive script.
gavin pushed a commit to branch master
in repository texinfo.
The following commit(s) were added to refs/heads/master by this push:
new e54b39ccd4 * doc/texinfo.texi (Heading Format): Revise. Mention that
chapter pages might be different.
e54b39ccd4 is described below
commit e54b39ccd4d08fdc5fda4c8e601659a02d24e517
Author: Gavin Smith <gavinsmith0123@gmail.com>
AuthorDate: Mon Sep 5 17:51:35 2022 +0100
* doc/texinfo.texi (Heading Format):
Revise. Mention that chapter pages might be different.
---
ChangeLog | 5 +++++
doc/texinfo.texi | 40 +++++++++++++++++++++-------------------
2 files changed, 26 insertions(+), 19 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index 7c71ad09e5..540e3058cc 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2022-09-04 Gavin Smith <gavinsmith0123@gmail.com>
+
+ * doc/texinfo.texi (Heading Format):
+ Revise. Mention that chapter pages might be different.
+
2022-09-04 Patrice Dumas <pertusus@free.fr>
Rename spaces type extra command as spaces_associated_command
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index e796265004..ddeb9ebd8e 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -23053,16 +23053,10 @@ Texinfo provides two standard heading formats, one
for manuals printed
on one side of each sheet of paper, and the other for manuals printed
on both sides of the paper.
-By default, nothing is specified for the footing of a Texinfo file,
-so the footing remains blank.
-
The standard format for single-sided printing consists of a header
line in which the left-hand part contains the name of the chapter, the
central part is blank, and the right-hand part contains the page
-number.
-
-@need 950
-A single-sided page looks like this:
+number. A single-sided page looks like this:
@example
@group
@@ -23076,24 +23070,14 @@ A single-sided page looks like this:
@end group
@end example
-The standard format for two-sided printing depends on whether the page
-number is even or odd. By convention, even-numbered pages are on the
-left- and odd-numbered pages are on the right. (@TeX{} will adjust the
-widths of the left- and right-hand margins. Usually, widths are
-correct, but during double-sided printing, it is wise to check that
-pages will bind properly---sometimes a printer will produce output in
-which the even-numbered pages have a larger right-hand margin than the
-odd-numbered pages.)
-
In the standard double-sided format, the left part of the left-hand
(even-numbered) page contains the page number, the central part is
blank, and the right part contains the title (specified by the
@code{@@settitle} command). The left part of the right-hand
(odd-numbered) page contains the name of the chapter, the central part
is blank, and the right part contains the page number.
-
-@need 750
-Two pages, side by side as in an open book, look like this:
+An even-numbered page and an odd-numbered page, side by side as in an
+open book, look like this:
@example
@group
@@ -23112,6 +23096,24 @@ The chapter name is preceded by the word ``Chapter'',
the chapter number
and a colon. This makes it easier to keep track of where you are in the
manual.
+Note that on pages where a new chapter starts, some text may be omitted
+from the heading line.
+
+@ignore
+@c not germane to headings? we don't document \bindingoffset or \normaloffset
+@c anywhere.
+In double sided printing, @TeX{} will adjust the
+widths of the left- and right-hand margins. Usually, widths are
+correct, but during double-sided printing, it is wise to check that
+pages will bind properly---sometimes a printer will produce output in
+which the even-numbered pages have a larger right-hand margin than the
+odd-numbered pages.)
+@end ignore
+
+By default, nothing is specified for the footing of a Texinfo file,
+so the footing remains blank.
+
+
@node Custom Headings
@subsection How to Make Your Own Headings
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- branch master updated: * doc/texinfo.texi (Heading Format): Revise. Mention that chapter pages might be different.,
Gavin D. Smith <=
- Prev by Date:
branch master updated: Remove @setfilename for tests, use test_input_file_name
- Next by Date:
branch master updated: * tp/Texinfo/ParserNonXS.pm (_abort_empty_line, _parse_texi), tp/Texinfo/XS/parsetexi/handle_commands.c (handle_other_command), tp/Texinfo/XS/parsetexi/parser.c (abort_empty_line): do not handle especially @indent and @noindent, except that they are are never directly associated with following space.
- Previous by thread:
branch master updated: Remove @setfilename for tests, use test_input_file_name
- Next by thread:
branch master updated: * tp/Texinfo/ParserNonXS.pm (_abort_empty_line, _parse_texi), tp/Texinfo/XS/parsetexi/handle_commands.c (handle_other_command), tp/Texinfo/XS/parsetexi/parser.c (abort_empty_line): do not handle especially @indent and @noindent, except that they are are never directly associated with following space.
- Index(es):