[latexrefman-commits] [SCM] latexrefman updated: r1137 - trunk

Karl Berry INVALID.NOREPLY at gnu.org.ua
Sat Sep 17 18:25:47 CEST 2022


Author: karl
Date: 2022-09-17 16:25:46 +0000 (Sat, 17 Sep 2022)
New Revision: 1137

Modified:
   trunk/ChangeLog
   trunk/NEWS
   trunk/aspell.en.pws
   trunk/latex2e.texi
Log:
mention need for T1 (or other non-default) for \texttt{\textbackslash}, etc., to produce typewriter

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog	2022-09-07 19:42:46 UTC (rev 1136)
+++ trunk/ChangeLog	2022-09-17 16:25:46 UTC (rev 1137)
@@ -1,3 +1,14 @@
+2022-09-17  Karl Berry  <karl at freefriends.org>
+
+	* latex2e.texi (\lastlinefit): reset to 0 (latest texinfo.tex sets
+	to 500) to avoid numerous new underfull box warnings for last
+	lines of paragraphs.
+	(Class and package commands): use @itemx for second and subsequent
+	items.
+	(Text symbols) <\textbackslash>: note that \texttt{\textbackslash}
+	does not produce a typewriter backslash without [T1]{fontenc}.
+	<\textbraceleft, \textbraceright>: likewise.
+
 2022-09-07  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>
 
 	* latex2e.texi (Page breaking): @dfn{...}-ize word ``badness''.

Modified: trunk/NEWS
===================================================================
--- trunk/NEWS	2022-09-07 19:42:46 UTC (rev 1136)
+++ trunk/NEWS	2022-09-17 16:25:46 UTC (rev 1137)
@@ -12,8 +12,9 @@
 bar, so they can be referenced individually, especially online.
 
 Fixes:
-* description of definition and use of optional arguments somewhat
-clarified.
+* description of definition and use of optional arguments somewhat clarified.
+* \texttt{\textbackslash} (and \textbraceleft and \textbraceright)
+require T1 or other non-default encoding to produce typewriter characters.
 
  Notable changes in January 2022 release:
 

Modified: trunk/aspell.en.pws
===================================================================
--- trunk/aspell.en.pws	2022-09-07 19:42:46 UTC (rev 1136)
+++ trunk/aspell.en.pws	2022-09-17 16:25:46 UTC (rev 1137)
@@ -289,3 +289,4 @@
 unimagined
 vitalism
 tablefootnote
+Infimum

Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi	2022-09-07 19:42:46 UTC (rev 1136)
+++ trunk/latex2e.texi	2022-09-17 16:25:46 UTC (rev 1137)
@@ -2,7 +2,7 @@
 @c $Id$
 @comment %**start of header (This is for running Texinfo on a region.)
 @setfilename latex2e.info
- at set UPDATED May 2022
+ at set UPDATED September 2022
 @include common.texi
 @settitle @LaTeX{}2e unofficial reference manual (@value{UPDATED})
 @comment %**end of header (This is for running Texinfo on a region.)
@@ -90,6 +90,7 @@
 
 @tex
 \global\hbadness=4444 % don't complain much
+\global\lastlinefit=0 % work around August 2022 texinfo.tex
 @end tex
 
 @html
@@ -1046,7 +1047,7 @@
 at the beginning of the shipout of the first page of the document.
 
 @item \AtEndOfClass@{@var{code}@}
- at item \AtEndOfPackage@{@var{code}@}
+ at itemx \AtEndOfPackage@{@var{code}@}
 @findex \AtEndOfClass
 @findex \AtEndOfPackage
 Hook to insert @var{code} to be executed when @LaTeX{} finishes
@@ -1055,10 +1056,10 @@
 called it.  See also @ref{\AtBeginDocument}.
 
 @item \CheckCommand@{@var{cmd}@}[@var{num}][@var{default}]@{@var{definition}@}
- at item \CheckCommand*@{@var{cmd}@}[@var{num}][@var{default}]@{@var{definition}@}
+ at itemx \CheckCommand*@{@var{cmd}@}[@var{num}][@var{default}]@{@var{definition}@}
 @findex \CheckCommand
 @findex \CheckCommand*
- at cindex new command, check
+ at cindex new command, checking
 Like @code{\newcommand} (@pxref{\newcommand & \renewcommand}) but does
 not define @var{cmd}; instead it checks that the current definition of
 @var{cmd} is exactly as given by @var{definition} and is or is not 
@@ -1071,15 +1072,15 @@
 redefined this command.
 
 @item \ClassError@{@var{class name}@}@{@var{error text}@}@{@var{help text}@}
- at item \PackageError@{@var{package name}@}@{@var{error text}@}@{@var{help text}@}
- at item \ClassWarning@{@var{class name}@}@{@var{warning text}@}
- at item \PackageWarning@{@var{package name}@}@{@var{warning text}@}
- at item \ClassWarningNoLine@{@var{class name}@}@{@var{warning text}@}
- at item \PackageWarningNoLine@{@var{package name}@}@{@var{warning text}@}
- at item \ClassInfo@{@var{class name}@}@{@var{info text}@}
- at item \PackageInfo@{@var{package name}@}@{@var{info text}@}
- at item \ClassInfoNoLine@{@var{class name}@}@{@var{info text}@}
- at item \PackageInfoNoLine@{@var{package name}@}@{@var{info text}@}
+ at itemx \ClassWarning@{@var{class name}@}@{@var{warning text}@}
+ at itemx \ClassWarningNoLine@{@var{class name}@}@{@var{warning text}@}
+ at itemx \ClassInfo@{@var{class name}@}@{@var{info text}@}
+ at itemx \ClassInfoNoLine@{@var{class name}@}@{@var{info text}@}
+ at itemx \PackageError@{@var{package name}@}@{@var{error text}@}@{@var{help text}@}
+ at itemx \PackageWarning@{@var{package name}@}@{@var{warning text}@}
+ at itemx \PackageWarningNoLine@{@var{package name}@}@{@var{warning text}@}
+ at itemx \PackageInfo@{@var{package name}@}@{@var{info text}@}
+ at itemx \PackageInfoNoLine@{@var{package name}@}@{@var{info text}@}
 @findex \ClassError
 @findex \PackageError
 @findex \ClassWarning
@@ -1116,7 +1117,7 @@
 or @code{\DeclareOption*}.
 
 @item \DeclareOption@{@var{option}@}@{@var{code}@}
- at item \DeclareOption*@{@var{code}@}
+ at itemx \DeclareOption*@{@var{code}@}
 @findex \DeclareOption
 @findex \DeclareOption*
 @cindex class options
@@ -1156,7 +1157,7 @@
 @end example
 
 @item \DeclareRobustCommand@{@var{cmd}@}[@var{num}][@var{default}]@{@var{definition}@} 
- at item \DeclareRobustCommand*@{@var{cmd}@}[@var{num}][@var{default}]@{@var{definition}@}
+ at item* \DeclareRobustCommand*@{@var{cmd}@}[@var{num}][@var{default}]@{@var{definition}@}
 @findex \DeclareRobustCommand
 @findex \DeclareRobustCommand*
 @cindex new command, definition
@@ -1194,9 +1195,8 @@
 @code{\renew at dots{}} or @code{\provide at dots{}} or you get an error.
 @end enumerate
 
-
 @item \IfFileExists@{@var{filename}@}@{@var{true code}@}@{@var{false code}@}
- at item \InputIfFileExists@{@var{filename}@}@{@var{true code}@}@{@var{false code}@}
+ at itemx \InputIfFileExists@{@var{filename}@}@{@var{true code}@}@{@var{false code}@}
 @findex \IfFileExists
 @findex \InputIfFileExists
 Execute @var{true code} if @LaTeX{} finds the file @file{@var{file
@@ -1221,7 +1221,7 @@
 extensions see @ref{\input}.
 
 @item \LoadClass[@var{options list}]@{@var{class name}@}[@var{release date}]
- at item \LoadClassWithOptions@{@var{class name}@}[@var{release date}]
+ at itemx \LoadClassWithOptions@{@var{class name}@}[@var{release date}]
 @findex \LoadClass
 @findex \LoadClassWithOptions
 Load a class, as with @code{\documentclass[@var{options
@@ -1296,7 +1296,7 @@
 @c reaches @code{\begin@{document@}}.
 
 @item \PassOptionsToClass@{@var{option list}@}@{@var{class name}@}
- at item \PassOptionsToPackage@{@var{option list}@}@{@var{package name}@}
+ at itemx \PassOptionsToPackage@{@var{option list}@}@{@var{package name}@}
 @findex \PassOptionsToClass
 @findex \PassOptionsToPackage
 Adds the options in the comma-separated list @var{option list} to the
@@ -1338,7 +1338,7 @@
 @code{\PassOptionsToPackage@{draft@}@{graphicx@}\documentclass@{foo@}}.
 
 @item \ProcessOptions
- at item \ProcessOptions*@var{\@@options}
+ at itemx \ProcessOptions*@var{\@@options}
 @findex \ProcessOptions
 @findex \ProcessOptions*
 Execute the code for each option that the user has invoked.  Include it
@@ -1381,9 +1381,9 @@
 means that the global options are processed first.
 
 @item \ProvidesClass@{@var{class name}@}[@var{release date} @var{brief additional information}]
- at item \ProvidesClass@{@var{class name}@}[@var{release date}]
- at item \ProvidesPackage@{@var{package name}@}[@var{release date} @var{brief additional information}]
- at item \ProvidesPackage@{@var{package name}@}[@var{release date}]
+ at itemx \ProvidesClass@{@var{class name}@}[@var{release date}]
+ at itemx \ProvidesPackage@{@var{package name}@}[@var{release date} @var{brief additional information}]
+ at itemx \ProvidesPackage@{@var{package name}@}[@var{release date}]
 @findex \ProvidesClass
 @findex \ProvidesPackage
 Identifies the class or package, printing a message to the screen and
@@ -1427,7 +1427,7 @@
 @samp{2017/10/12 config file for test.cls}.
 
 @item \RequirePackage[@var{option list}]@{@var{package name}@}[@var{release date}]
- at item \RequirePackageWithOptions@{@var{package name}@}[@var{release date}]
+ at itemx \RequirePackageWithOptions@{@var{package name}@}[@var{release date}]
 @findex \RequirePackage
 @findex \RequirePackageWithOptions
 Load a package, like the command @code{\usepackage} (@pxref{Additional
@@ -2232,13 +2232,8 @@
 The following commands are for use in math mode.  They are not
 cumulative, so @code{\mathbf@{\mathit@{@var{symbol}@}@}} does not
 create a boldface and italic @var{symbol}; instead, it will just be in
-italics. @c xx TODO, improve wording of the sequel to be more down to
- at c earth, do not use words consistent or environment. See French version
- at c ``C'est ainsi car typiquement les symboles mathématiques ont besoin
- at c d'être toujours traités typographiquement de la même manière,
- at c indépendamment de ce qui les entoure''
-This is because typically math symbols need consistent typographic
-treatment, regardless of the surrounding environment.
+italics.  This is because typically math symbols need consistent
+typographic treatment, regardless of the surrounding environment.
 
 @table @code
 @item \mathrm
@@ -18283,8 +18278,8 @@
 the text body, enter @code{\textbackslash@{@}}.
 
 To produce the reserved characters in a typewriter font use
- at code{\verb!!} as below (the double backslash at tie{}@code{\\} is only
-there to split the lines in the output).
+ at code{\verb!!} as below (the double backslash at tie{}@code{\\} in the
+example is only there to split the lines in the output).
 
 @example
 \begin@{center@}
@@ -18501,8 +18496,16 @@
 
 @item \textbackslash
 @cindex backslash, in text
-\ Backslash.
+\ Backslash. However, @code{\texttt@{\textbackslash@}} produces a roman
+(not typewriter) backslash by default; for a typewriter backslash, it
+is necessary to use the T1 (or other non-default) font encoding, as
+in:
 
+ at example
+\usepackage[T1]@{fontenc@}
+ at end example
+ at c https://github.com/latex3/latex2e/issues/824
+
 @item \textbar
 @cindex vertical bar, in text
 @cindex bar, vertical, in text
@@ -18522,12 +18525,14 @@
 @item \textbraceleft
 @cindex left brace, in text
 @cindex brace, left, in text
-@{ Left brace.
+@{ Left brace.  See remarks at @code{\textbackslash} above about
+making @code{\texttt@{\textbraceleft@}} produce a typewriter brace.
 
 @item \textbraceright
 @cindex right brace, in text
 @cindex brace, right, in text
-@} Right brace.
+@} Right brace.  See remarks at @code{\textbackslash} above about
+making @code{\texttt@{\textbraceright@}} produce a typewriter brace.
 
 @item \textbullet
 @cindex bullet, in text



More information about the latexrefman-commits mailing list.