[latexrefman-commits] [SCM] latexrefman updated: r1180 - trunk
Karl Berry
INVALID.NOREPLY at gnu.org.ua
Wed Oct 23 19:42:47 CEST 2024
Author: karl
Date: 2024-10-23 17:42:47 +0000 (Wed, 23 Oct 2024)
New Revision: 1180
Modified:
trunk/ChangeLog
trunk/NEWS
trunk/latex2e.texi
Log:
\ClassNoteNoLine and \PackageNoteNoLine added, other msg command tweaks
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2024-07-26 15:18:37 UTC (rev 1179)
+++ trunk/ChangeLog 2024-10-23 17:42:47 UTC (rev 1180)
@@ -1,3 +1,13 @@
+2024-10-23 Karl Berry <karl at freefriends.org>
+
+ * latex2e.texi (\ClassError and \PackageError and other messages):
+ new name for node. Remove nonexistent \{Package,Class}InfoNoLine,
+ and add \{Package,Class}Note{,NoLine}.
+ Add missing d in "ignored".
+ Report from Markus Kurtz, 22 Oct 2024 14:46:29.
+
+ (Also other small tweaks throughout.)
+
2024-07-24 Karl Berry <karl at freefriends.org>
* latex2e.texi (Delimiters): mixed up left and right braces.
Modified: trunk/NEWS
===================================================================
--- trunk/NEWS 2024-07-26 15:18:37 UTC (rev 1179)
+++ trunk/NEWS 2024-10-23 17:42:47 UTC (rev 1180)
@@ -6,6 +6,9 @@
Spanish translation from Nacho Pacheco.
Updates are welcome.
+Additions:
+* \ClassNoteNoLine and \PackageNoteNoLine descriptions added.
+
Notable changes in May 2024 release:
Additions:
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2024-07-26 15:18:37 UTC (rev 1179)
+++ trunk/latex2e.texi 2024-10-23 17:42:47 UTC (rev 1180)
@@ -10718,7 +10718,7 @@
* \AtBeginDvi & \AtEndDvi::
* \AtEndOfClass & \AtEndOfPackage::
* \CheckCommand::
-* \ClassError and \PackageError and others::
+* \ClassError and \PackageError and other messages::
* \CurrentOption::
* \DeclareOption::
* \DeclareRobustCommand::
@@ -10816,19 +10816,22 @@
that no other package has already redefined this command.
- at node \ClassError and \PackageError and others
- at subsection @code{\ClassError} and @code{\PackageError} and others
+ at node \ClassError and \PackageError and other messages
+ at subsection @code{\ClassError} and @code{\PackageError} and other messages
+ at anchor{\ClassError and \PackageError and others}@c old name
@anchor{\ClassError}
@anchor{\ClassWarning}
@anchor{\ClassWarningNoLine}
+ at anchor{\ClassNote}
+ at anchor{\ClassNoteNoLine}
@anchor{\ClassInfo}
- at anchor{\ClassInfoNoLine}
@anchor{\PackageError}
@anchor{\PackageWarning}
@anchor{\PackageWarningNoLine}
+ at anchor{\PackageNote}
+ at anchor{\PackageNoteNoLine}
@anchor{\PackageInfo}
- at anchor{\PackageInfoNoLine}
Produce error, warning, and informational messages for classes:
@@ -10836,13 +10839,15 @@
@item \ClassError@{@var{class name}@}@{@var{error-text}@}@{@var{help-text}@}
@itemx \ClassWarning@{@var{class name}@}@{@var{warning-text}@}
@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 \ClassNote@{@var{class name}@}@{@var{note-text}@}
+ at itemx \ClassNoteNoLine@{@var{class name}@}@{@var{note-text}@}
+ at itemx \ClassInfo@{@var{class name}@}@{@var{log-text}@}
@findex \ClassError
@findex \ClassWarning
@findex \ClassWarningNoLine
+ at findex \ClassNote
+ at findex \ClassNoteNoLine
@findex \ClassInfo
- at findex \ClassInfoNoLine
@end table
@noindent and the same for packages:
@@ -10850,37 +10855,45 @@
@item \PackageError@{@var{package name}@}@{@var{error-text}@}@{@var{help-text}@}
@itemx \PackageWarning@{@var{package name}@}@{@var{warning-text}@}
@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}@}
+ at itemx \PackageNote@{@var{package name}@}@{@var{note-text}@}
+ at itemx \PackageNoteNoLine@{@var{package name}@}@{@var{note-text}@}
+ at itemx \PackageInfo@{@var{package name}@}@{@var{log-text}@}
@findex \PackageError
@findex \PackageWarning
@findex \PackageWarningNoLine
+ at findex \PackageNote
+ at findex \PackageNoteNoLine
@findex \PackageInfo
- at findex \PackageInfoNoLine
@end table
For @code{\ClassError} and @code{\PackageError} the message is
@var{error-text}, followed by @TeX{}'s `@code{?}' error prompt. If the
-user then asks for help by typing @code{h}, they see the @var{help
-text}.
+user then asks for help by typing @code{h}, they see @var{help-text}.
-The four @code{Warning} commands are similar except that they write
- at var{warning-text} on the screen with no error prompt. The four
- at code{Info} commands write @var{info-text} only in the transcript
-file. The @code{NoLine} versions omit the number of the line
+The four @code{Warning} commands write @var{warning-text} on the
+terminal and log file (with no error prompt), prefixed by the text
+ at samp{Warning:}.
+
+ at c https://github.com/wspr/hardwrap/issues/19
+The four @code{Note} commands also write the @var{note-text} to the
+terminal and log file, without the @samp{Warning:} prefix.
+
+The @code{NoLine} versions omit the number of the input line
generating the message, while the other versions do show that number.
+The two @code{Info} commands write @var{log-text} only in the
+transcript file and not to the terminal.
+
@cindex @code{\protect}, and message text
@cindex @code{\space}, and message text
@cindex @code{\MessageBreak}, and message text
To format the messages, including the @var{help-text}: use
@code{\protect} to stop a command from expanding, get a line break
-with @code{\MessageBreak}, and get a space with @code{\space} when a
-space character is ignore, most commonly after a command.
+with @code{\MessageBreak}, and get a space with @code{\space} where a
+space character is ignored, most commonly after a command.
@LaTeX{} appends a period to the messages.
-
@node \CurrentOption
@subsection @code{\CurrentOption}
@@ -16331,11 +16344,10 @@
@var{capital-letter}\@@.
@end example
-Treat a period (or other punctuation) as sentence-ending, where
- at LaTeX{} would otherwise think it is part of an abbreviation.
- at LaTeX{} thinks that a period ends an abbreviation if the period comes
-after a capital letter, and otherwise thinks the period ends the
-sentence.
+Treat a following period (or other punctuation) as sentence-ending.
+By default, @LaTeX{} thinks that a period ends an abbreviation if the
+period comes after a capital letter, and otherwise thinks the period
+ends the sentence.
This example shows the two cases to remember.
@@ -16379,7 +16391,7 @@
sentence. @LaTeX{} also increases spacing after colon, semicolon, and
comma characters (@pxref{\spacefactor}).
-In addition: the converse case is a period (or other punctuation) that
+In contrast: the converse case is a period (or other punctuation) that
does not end a sentence. For that case, follow the period with a
backslash-space, (@code{\ }), or a tie, (@code{~}), or @code{\@@}.
Examples are @code{Nat.\ Acad.\ Science}, and @code{Mr.~Bean}, and
More information about the latexrefman-commits
mailing list.