[latexrefman-commits] [SCM] latexrefman updated: r1152 - trunk
Karl Berry
INVALID.NOREPLY at gnu.org.ua
Mon May 29 00:16:39 CEST 2023
Author: karl
Date: 2023-05-28 22:16:39 +0000 (Sun, 28 May 2023)
New Revision: 1152
Modified:
trunk/ChangeLog
trunk/NEWS
trunk/latex2e.texi
Log:
new node for \slash; \samepage not obsolete; \pagenumbering edit
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2023-03-22 21:18:47 UTC (rev 1151)
+++ trunk/ChangeLog 2023-05-28 22:16:39 UTC (rev 1152)
@@ -1,3 +1,9 @@
+2023-05-28 Karl Berry <karl at freefriends.org>
+
+ * latex2e.texi (\slash): new node for this simple command.
+ (\pagebreak & \nopagebreak) <\samepage>: not obsolete.
+ (\pagenumbering): rearrange.
+
2023-03-22 Karl Berry <karl at freefriends.org>
* latex2e.texi (list): \setlength{\itemsep} was missing the \.
Modified: trunk/NEWS
===================================================================
--- trunk/NEWS 2023-03-22 21:18:47 UTC (rev 1151)
+++ trunk/NEWS 2023-05-28 22:16:39 UTC (rev 1152)
@@ -6,6 +6,9 @@
Spanish translation from Nacho Pacheco.
Updates are welcome.
+Additions:
+* Description of the (simple) \slash command.
+
Notable changes in January 2023 release:
Additions:
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2023-03-22 21:18:47 UTC (rev 1151)
+++ trunk/latex2e.texi 2023-05-28 22:16:39 UTC (rev 1152)
@@ -8594,7 +8594,8 @@
* \obeycr & \restorecr:: Make each input line start a new output line.
* \newline:: Break the line
* \- (hyphenation):: Insert explicit hyphenation.
-* \discretionary:: Explicit control of the hyphen character.
+* \slash:: Insert a breakable /.
+* \discretionary:: Explicit control of hyphenation character(s).
* \fussy & \sloppy:: Be more or less particular with line breaking.
* \hyphenation:: Tell @LaTeX{} how to hyphenate a word.
* \linebreak & \nolinebreak:: Forcing & avoiding line breaks.
@@ -8813,6 +8814,23 @@
requires care.
+ at node \slash
+ at section @code{\slash}: breakable @samp{/}
+
+ at findex \slash
+ at cindex slash character, breakable
+
+The @code{\slash} command produces a @samp{/} character and then a
+penalty of the same value as an explicit @samp{-} character
+(@code{\exhyphenpenalty}). This allows @TeX{} to break a line at the
+ at samp{/}, similar to a hyphen. Hyphenation is allowed in the word part
+preceding the @samp{/}, but not after. For example:
+
+ at example
+The input\slash output of the program is complicated.
+ at end example
+
+
@node \discretionary
@section @code{\discretionary} (generalized hyphenation point)
@cindex hyphenation, discretionary
@@ -8960,7 +8978,7 @@
Declares allowed hyphenation points within the words in the list. The
words in that list are separated by spaces. Show permitted points for
-hyphenation with a dash character, @code{-}.
+hyphenation with an ASCII dash character, @code{-}.
Here is an example:
@@ -8969,7 +8987,7 @@
@end example
Use lowercase letters. @TeX{} will only hyphenate if the word matches
-exactly, no inflections are tried. Multiple @code{\hyphenation}
+exactly; no inflections are tried. Multiple @code{\hyphenation}
commands accumulate.
@c xx Re-align on LaTeX-fr which also mentions fontenc, and that
@@ -9268,11 +9286,10 @@
@findex \samepage
@findex samepage @r{environment}
-(There is an obsolete declaration @code{\samepage}, which tries to only
-allow a break between two paragraphs. There is a related environment
- at code{samepage}, also obsolete. Neither of these work reliably. For
-more on keeping material on the same page, see the FAQ entry
- at url{https://texfaq.org/FAQ-nopagebrk}.)
+A declaration @code{\samepage} and corresponding @code{samepage}
+environment try to only allow breaks between paragraphs. They are not
+perfectly reliable. For more on keeping material on the same page,
+see the FAQ entry @url{https://texfaq.org/FAQ-nopagebrk}.)
@node Footnotes
@@ -15117,20 +15134,11 @@
so its effect is not stopped by an end of group such as a closing brace
or an end of environment.
-In this example, before the @samp{Main} section the pages are numbered
- at samp{a}, etc. Starting on the page containing the
- at code{\pagenumbering} call in that section, the pages are numbered
- at samp{1}, etc.
+By default, @LaTeX{} numbers pages starting at 1, using Arabic
+numerals.
- at example
-\begin@{document@}\pagenumbering@{alph@}
- ...
-\section@{Main@}\pagenumbering@{arabic@}
- ...
- at end example
-
The argument @var{number-style} is one of the following (see
-also at tie{}@ref{\alph \Alph \arabic \roman \Roman \fnsymbol}).
+also @ref{\alph \Alph \arabic \roman \Roman \fnsymbol}).
@table @code
@item arabic
@@ -15151,24 +15159,43 @@
get @samp{LaTeX Error: Counter too large}.
@item gobble
- at PkgIndex{hyperref} @LaTeX{} does not output a page number, although it
-does get reset. References to that page also are blank. (This does not
-work with the popular package @package{hyperref} so to have the page number
-not appear you may want to instead use @code{\pagestyle@{empty@}} or
- at code{\thispagestyle@{empty@}}.)
+no page number is output, though the number is still reset.
+References to that page also are blank.
+ at PkgIndex{hyperref}
+This setting does not work with the popular package @package{hyperref},
+so to omit page numbers you may want to instead use
+ at code{\pagestyle@{empty@}} or @code{\thispagestyle@{empty@}}.
+
@end table
+If you want to typeset the page number in some other way, or change
+where the page number appears on the page, see at tie{}@ref{\pagestyle}
+(in short: use the @code{fancyhdr} package). The list above of
+ at LaTeX{}'s built-in numbering styles cannot be extended.
+
Traditionally, if a document has front matter---preface, table of
-contents, etc.---then it is numbered with lowercase Roman numerals. The
-main matter of a document uses arabic. @xref{\frontmatter & \mainmatter
-& \backmatter}.
+contents, etc.---then it is numbered with lowercase Roman
+numerals. The main matter of a document uses arabic. @LaTeX{}
+implements this, by providing explicit commands for the different parts
+(@pxref{\frontmatter & \mainmatter & \backmatter}).
-If you want to change where the page number appears on the page,
-see at tie{}@ref{\pagestyle}. If you want to change the value of the page
-number, then you manipulate the @code{page} counter (@pxref{Counters}).
+As an explicit example, before the @samp{Main} section the pages are
+numbered @samp{a}, etc. Starting on the page containing the
+ at code{\pagenumbering} call in that section, the pages are numbered
+ at samp{1}, etc.
+ at example
+\begin@{document@}\pagenumbering@{alph@}
+ ...
+\section@{Main@}\pagenumbering@{arabic@}
+ ...
+ at end example
+If you want to change the value of the page number, then you
+manipulate the @code{page} counter (@pxref{Counters}).
+
+
@node \pagestyle
@section @code{\pagestyle}
@@ -15191,7 +15218,7 @@
@package{fancyhdr} is now the standard way to manipulate headers and
footers. New documents that need to do anything other than one of the
standard options below should use this package. See its documentation
-on CTAN.
+(@url{https://ctan.org/pkg/fancyhdr}).
Values for @var{style}:
More information about the latexrefman-commits
mailing list.