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

[jimhefferon at gnu.org.ua]

Author: jimhefferon
Date: 2021-05-26 14:36:00 +0000 (Wed, 26 May 2021)
New Revision: 912

Modified:
   trunk/latex2e.html
   trunk/latex2e.info
   trunk/latex2e.pdf
   trunk/latex2e.texi
Log:
add paragraph for inputenc on a common error message

Modified: trunk/latex2e.html
===================================================================
--- trunk/latex2e.html	2021-05-25 18:07:16 UTC (rev 911)
+++ trunk/latex2e.html	2021-05-26 14:36:00 UTC (rev 912)
@@ -20804,9 +20804,14 @@
 </p>
 <div class="example">
 <pre class="example">\usepackage{inputenc}
-\usepackage[<var>encoding-name</var>]{inputenc}
 </pre></div>
 
+<p>or
+</p>
+<div class="example">
+<pre class="example">\usepackage[<var>encoding-name</var>]{inputenc}
+</pre></div>
+
 <p>Declare the input file’s text encoding.
 </p>
 <p>In a computer file, the characters are stored as binary according to
@@ -20836,9 +20841,19 @@
 <code>inputenc is not designed for xetex or luatex</code>.
 </p>
 <p>In addition, LaTeX releases since 2018 default to an equivalent of
-the above command.  So documents started after that time will typically
+the above command.  So documents started after that time typically will
 not explicitly include this package.
 </p>
+<p>An <code>inputenc</code> package error like <code>Invalid UTF-8 byte "96</code>
+means that some of the material in the input file does not follow the
+encoding scheme.  Often these errors come from copying material from a
+document that uses a different encoding than the input file; this one is
+a left single quote from a web page that uses <code>latin1</code> inside a
+LaTeX input file that uses UTF-8.  The solution is to convert the
+character to the LaTeX equivalent, in this case a left single quote,
+or to erase it and enter the character using the input file’s encoding
+(consult your editor’s documentation).
+</p>
 <p>In some documents, such as in a collection of journal articles from a
 variety of authors, changing the encoding in mid-document may be
 necessary.  Use the command

Modified: trunk/latex2e.info
===================================================================
--- trunk/latex2e.info	2021-05-25 18:07:16 UTC (rev 911)
+++ trunk/latex2e.info	2021-05-26 14:36:00 UTC (rev 912)
@@ -14283,6 +14283,9 @@
 Synopsis, one of:
 
      \usepackage{inputenc}
+
+   or
+
      \usepackage[ENCODING-NAME]{inputenc}
 
    Declare the input file's text encoding.
@@ -14312,9 +14315,19 @@
 the error 'inputenc is not designed for xetex or luatex'.
 
    In addition, LaTeX releases since 2018 default to an equivalent of
-the above command.  So documents started after that time will typically
+the above command.  So documents started after that time typically will
 not explicitly include this package.
 
+   An 'inputenc' package error like 'Invalid UTF-8 byte "96' means that
+some of the material in the input file does not follow the encoding
+scheme.  Often these errors come from copying material from a document
+that uses a different encoding than the input file; this one is a left
+single quote from a web page that uses 'latin1' inside a LaTeX input
+file that uses UTF-8.  The solution is to convert the character to the
+LaTeX equivalent, in this case a left single quote, or to erase it and
+enter the character using the input file's encoding (consult your
+editor's documentation).
+
    In some documents, such as in a collection of journal articles from a
 variety of authors, changing the encoding in mid-document may be
 necessary.  Use the command '\inputencoding{ENCODING-NAME}'.  The most
@@ -19903,83 +19916,83 @@
 Node: Additional Latin letters519018
 Ref: Non-English characters519200
 Node: Inputenc package520219
-Node: \rule522350
-Node: \today523515
-Node: Splitting the input524451
-Node: \endinput526193
-Node: \include & \includeonly527496
-Node: \input531793
-Node: Front/back matter533008
-Node: Table of contents etc.533341
-Node: \addcontentsline537166
-Node: \addtocontents540008
-Node: \nofiles541599
-Node: Indexes542331
-Node: \index543939
-Node: makeindex549044
-Ref: makeindex preamble550712
-Ref: makeindex postamble550852
-Ref: makeindex group skip550937
-Ref: makeindex letheadflag551270
-Ref: makeindex lethead prefix551731
-Ref: makeindex lethead suffix551883
-Ref: makeindex item 0552031
-Ref: makeindex item 1552111
-Ref: makeindex item 2552186
-Ref: makeindex item 01552264
-Ref: makeindex item x1552369
-Ref: makeindex item 12552574
-Ref: makeindex item x2552682
-Ref: makeindex delim 0552842
-Ref: makeindex delim 1552972
-Ref: makeindex delim 2553102
-Ref: makeindex delim n553228
-Ref: makeindex delim r553363
-Ref: makeindex line max553471
-Ref: makeindex indent space553606
-Ref: makeindex indent length553701
-Ref: makeindex page precedence553886
-Node: \printindex554760
-Node: Glossaries555233
-Node: \newglossaryentry557200
-Node: \gls558667
-Node: Letters559461
-Node: \address563079
-Node: \cc563890
-Node: \closing564332
-Node: \encl564646
-Node: \location565060
-Node: \makelabels565324
-Node: \name567641
-Node: \opening567882
-Node: \ps568163
-Node: \signature568452
-Node: \telephone569680
-Node: Input/output570045
-Node: \openin & \openout570775
-Node: \read573518
-Node: \typein574705
-Node: \typeout575965
-Node: \write577015
-Node: \write and security581742
-Node: \message582686
-Node: \wlog584515
-Node: \write18585016
-Node: Command line interface588507
-Ref: Command line588671
-Node: Command line options590754
-Ref: interaction modes591750
-Ref: output directory592704
-Node: Command line input594403
-Node: Jobname596232
-Node: Recovering from errors597047
-Node: Document templates598392
-Node: beamer template598826
-Node: article template599468
-Node: book template599931
-Node: Larger book template600410
-Node: Index601952
-Ref: Command Index602038
+Node: \rule522943
+Node: \today524108
+Node: Splitting the input525044
+Node: \endinput526786
+Node: \include & \includeonly528089
+Node: \input532386
+Node: Front/back matter533601
+Node: Table of contents etc.533934
+Node: \addcontentsline537759
+Node: \addtocontents540601
+Node: \nofiles542192
+Node: Indexes542924
+Node: \index544532
+Node: makeindex549637
+Ref: makeindex preamble551305
+Ref: makeindex postamble551445
+Ref: makeindex group skip551530
+Ref: makeindex letheadflag551863
+Ref: makeindex lethead prefix552324
+Ref: makeindex lethead suffix552476
+Ref: makeindex item 0552624
+Ref: makeindex item 1552704
+Ref: makeindex item 2552779
+Ref: makeindex item 01552857
+Ref: makeindex item x1552962
+Ref: makeindex item 12553167
+Ref: makeindex item x2553275
+Ref: makeindex delim 0553435
+Ref: makeindex delim 1553565
+Ref: makeindex delim 2553695
+Ref: makeindex delim n553821
+Ref: makeindex delim r553956
+Ref: makeindex line max554064
+Ref: makeindex indent space554199
+Ref: makeindex indent length554294
+Ref: makeindex page precedence554479
+Node: \printindex555353
+Node: Glossaries555826
+Node: \newglossaryentry557793
+Node: \gls559260
+Node: Letters560054
+Node: \address563672
+Node: \cc564483
+Node: \closing564925
+Node: \encl565239
+Node: \location565653
+Node: \makelabels565917
+Node: \name568234
+Node: \opening568475
+Node: \ps568756
+Node: \signature569045
+Node: \telephone570273
+Node: Input/output570638
+Node: \openin & \openout571368
+Node: \read574111
+Node: \typein575298
+Node: \typeout576558
+Node: \write577608
+Node: \write and security582335
+Node: \message583279
+Node: \wlog585108
+Node: \write18585609
+Node: Command line interface589100
+Ref: Command line589264
+Node: Command line options591347
+Ref: interaction modes592343
+Ref: output directory593297
+Node: Command line input594996
+Node: Jobname596825
+Node: Recovering from errors597640
+Node: Document templates598985
+Node: beamer template599419
+Node: article template600061
+Node: book template600524
+Node: Larger book template601003
+Node: Index602545
+Ref: Command Index602631
 
 End Tag Table
 

Modified: trunk/latex2e.pdf
===================================================================
(Binary files differ)

Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi	2021-05-25 18:07:16 UTC (rev 911)
+++ trunk/latex2e.texi	2021-05-26 14:36:00 UTC (rev 912)
@@ -18047,6 +18047,11 @@
 
 @example
 \usepackage@{inputenc@}
+ at end example
+
+or
+
+ at example
 \usepackage[@var{encoding-name}]@{inputenc@}
 @end example
 
@@ -18080,9 +18085,19 @@
 @code{inputenc is not designed for xetex or luatex}.
 
 In addition, @LaTeX{} releases since 2018 default to an equivalent of
-the above command.  So documents started after that time will typically
+the above command.  So documents started after that time typically will
 not explicitly include this package.
 
+An @code{inputenc} package error like @code{Invalid UTF-8 byte "96}
+means that some of the material in the input file does not follow the
+encoding scheme.  Often these errors come from copying material from a
+document that uses a different encoding than the input file; this one is
+a left single quote from a web page that uses @code{latin1} inside a
+ at LaTeX{} input file that uses UTF-8.  The solution is to convert the
+character to the @LaTeX{} equivalent, in this case a left single quote,
+or to erase it and enter the character using the input file's encoding
+(consult your editor's documentation).
+
 In some documents, such as in a collection of journal articles from a
 variety of authors, changing the encoding in mid-document may be
 necessary.  Use the command