[latexrefman-commits] [SCM] latexrefman updated: r909 - trunk
jimhefferon at gnu.org.ua
jimhefferon at gnu.org.ua
Mon May 24 22:25:20 CEST 2021
Author: jimhefferon
Date: 2021-05-24 20:25:20 +0000 (Mon, 24 May 2021)
New Revision: 909
Modified:
trunk/latex2e.html
trunk/latex2e.info
trunk/latex2e.pdf
trunk/latex2e.texi
Log:
add section on inputenc package
Modified: trunk/latex2e.html
===================================================================
--- trunk/latex2e.html 2021-05-24 16:11:21 UTC (rev 908)
+++ trunk/latex2e.html 2021-05-24 20:25:20 UTC (rev 909)
@@ -490,8 +490,9 @@
<li><a id="toc-_005caccent-1" href="#g_t_005caccent">23.5.1 <code>\accent</code></a></li>
</ul></li>
<li><a id="toc-Additional-Latin-letters-1" href="#Additional-Latin-letters">23.6 Additional Latin letters</a></li>
- <li><a id="toc-_005crule-1" href="#g_t_005crule">23.7 <code>\rule</code></a></li>
- <li><a id="toc-_005ctoday-1" href="#g_t_005ctoday">23.8 <code>\today</code></a></li>
+ <li><a id="toc-Inputenc-package-1" href="#Inputenc-package">23.7 Inputenc package</a></li>
+ <li><a id="toc-_005crule-1" href="#g_t_005crule">23.8 <code>\rule</code></a></li>
+ <li><a id="toc-_005ctoday-1" href="#g_t_005ctoday">23.9 <code>\today</code></a></li>
</ul></li>
<li><a id="toc-Splitting-the-input-1" href="#Splitting-the-input">24 Splitting the input</a>
<ul class="no-bullet">
@@ -19683,10 +19684,12 @@
</td></tr>
<tr><td align="left" valign="top">• <a href="#Additional-Latin-letters" accesskey="6">Additional Latin letters</a></td><td> </td><td align="left" valign="top">Inserting other non-English characters.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#g_t_005crule" accesskey="7">\rule</a></td><td> </td><td align="left" valign="top">Inserting lines and rectangles.
+<tr><td align="left" valign="top">• <a href="#Inputenc-package" accesskey="7">Inputenc package</a></td><td> </td><td align="left" valign="top">Set the input file text encoding.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#g_t_005ctoday" accesskey="8">\today</a></td><td> </td><td align="left" valign="top">Inserting today’s date.
+<tr><td align="left" valign="top">• <a href="#g_t_005crule" accesskey="8">\rule</a></td><td> </td><td align="left" valign="top">Inserting lines and rectangles.
</td></tr>
+<tr><td align="left" valign="top">• <a href="#g_t_005ctoday" accesskey="9">\today</a></td><td> </td><td align="left" valign="top">Inserting today’s date.
+</td></tr>
</table>
@@ -20592,7 +20595,7 @@
<hr>
<span id="Additional-Latin-letters"></span><div class="header">
<p>
-Next: <a href="#g_t_005crule" accesskey="n" rel="next">\rule</a>, Previous: <a href="#Accents" accesskey="p" rel="prev">Accents</a>, Up: <a href="#Special-insertions" accesskey="u" rel="up">Special insertions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Inputenc-package" accesskey="n" rel="next">Inputenc package</a>, Previous: <a href="#Accents" accesskey="p" rel="prev">Accents</a>, Up: <a href="#Special-insertions" accesskey="u" rel="up">Special insertions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="Additional-Latin-letters-1"></span><h3 class="section">23.6 Additional Latin letters</h3>
@@ -20707,11 +20710,69 @@
<hr>
+<span id="Inputenc-package"></span><div class="header">
+<p>
+Next: <a href="#g_t_005crule" accesskey="n" rel="next">\rule</a>, Previous: <a href="#Additional-Latin-letters" accesskey="p" rel="prev">Additional Latin letters</a>, Up: <a href="#Special-insertions" accesskey="u" rel="up">Special insertions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<span id="Inputenc-package-1"></span><h3 class="section">23.7 Inputenc package</h3>
+
+<span id="index-inputenc"></span>
+
+<p>Synopsis, one of:
+</p>
+<div class="example">
+<pre class="example">\usepackage{inputenc}
+\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
+some scheme, called the encoding. There are many different encodings.
+The simplest is ASCII, but it does not accomodate many characters so
+that for instance to get the a-umlaut character ä in an
+ASCII-encoded text file a user must enter <code>\"a</code>, which makes the
+file hard to read and also means that TeX won’t hyphenation the word
+containing that character. Often a more inclusive encoding is more
+convenient. The modern standard, in some ways a union of the others, is
+UTF-8.
+</p>
+<p>In short, to enter material a user sets their file editor to use an
+encoding scheme and this package is how LaTeX knows what encoding
+they used. For instance, the following command says that the input file
+is UTF-8 (note the lack of a dash).
+</p>
+<div class="example">
+<pre class="example">\usepackage[utf8]{inputenc}
+</pre></div>
+
+<p>Caution: use this package only with the pdfTeX engine (see <a href="#TeX-engines">TeX engines</a>). The XeTeX and LuaTeX engines assume that the input
+file is UTF-8 encoded. If you invoke LaTeX with either the
+<code>xelatex</code> command or the <code>lualatex</code> command and use the
+above example line, then you will be warned <code>inputenc package
+ignored with utf8 based engines</code>. And, if you instead declare a
+non-UTF-8 encoding such as <code>latin1</code> then you will get the error
+<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
+not explicitly include this package.
+</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
+<code>\inputencoding{<var>encoding-name</var>}</code>. The most common values
+for <var>encoding-name</var> are: <code>ascii</code>, <code>latin1</code>, <code>latin2</code>,
+<code>latin3</code>, <code>latin4</code>, <code>latin5</code>, <code>latin9</code>,
+<code>latin10</code>, and <code>utf8</code>.
+</p>
+
+<hr>
<span id="g_t_005crule"></span><div class="header">
<p>
-Next: <a href="#g_t_005ctoday" accesskey="n" rel="next">\today</a>, Previous: <a href="#Additional-Latin-letters" accesskey="p" rel="prev">Additional Latin letters</a>, Up: <a href="#Special-insertions" accesskey="u" rel="up">Special insertions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#g_t_005ctoday" accesskey="n" rel="next">\today</a>, Previous: <a href="#Inputenc-package" accesskey="p" rel="prev">Inputenc package</a>, Up: <a href="#Special-insertions" accesskey="u" rel="up">Special insertions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="g_t_005crule-1"></span><h3 class="section">23.7 <code>\rule</code></h3>
+<span id="g_t_005crule-1"></span><h3 class="section">23.8 <code>\rule</code></h3>
<span id="index-_005crule"></span>
@@ -20764,7 +20825,7 @@
<p>
Previous: <a href="#g_t_005crule" accesskey="p" rel="prev">\rule</a>, Up: <a href="#Special-insertions" accesskey="u" rel="up">Special insertions</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<span id="g_t_005ctoday-1"></span><h3 class="section">23.8 <code>\today</code></h3>
+<span id="g_t_005ctoday-1"></span><h3 class="section">23.9 <code>\today</code></h3>
<span id="index-_005ctoday"></span>
<span id="index-date_002c-today_0027s"></span>
@@ -25571,6 +25632,7 @@
<tr><td></td><td valign="top"><a href="#index-input_002c-on-command-line">input, on command line</a>:</td><td> </td><td valign="top"><a href="#Command-line-input">Command line input</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-input_002foutput">input/output</a>:</td><td> </td><td valign="top"><a href="#Input_002foutput">Input/output</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-input_002foutput_002c-to-terminal">input/output, to terminal</a>:</td><td> </td><td valign="top"><a href="#Input_002foutput">Input/output</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-inputenc"><code>inputenc</code></a>:</td><td> </td><td valign="top"><a href="#Inputenc-package">Inputenc package</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-inserting-figures">inserting figures</a>:</td><td> </td><td valign="top"><a href="#figure">figure</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-insertions-of-special-characters">insertions of special characters</a>:</td><td> </td><td valign="top"><a href="#Special-insertions">Special insertions</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-internal-vertical-mode">internal vertical mode</a>:</td><td> </td><td valign="top"><a href="#Modes">Modes</a></td></tr>
Modified: trunk/latex2e.info
===================================================================
--- trunk/latex2e.info 2021-05-24 16:11:21 UTC (rev 908)
+++ trunk/latex2e.info 2021-05-24 20:25:20 UTC (rev 909)
@@ -13706,6 +13706,7 @@
* Text symbols:: Inserting other non-letter symbols in text.
* Accents:: Inserting accents.
* Additional Latin letters:: Inserting other non-English characters.
+* Inputenc package:: Set the input file text encoding.
* \rule:: Inserting lines and rectangles.
* \today:: Inserting today's date.
@@ -14155,7 +14156,7 @@
as it cannot analyze upper/lower case.
-File: latex2e.info, Node: Additional Latin letters, Next: \rule, Prev: Accents, Up: Special insertions
+File: latex2e.info, Node: Additional Latin letters, Next: Inputenc package, Prev: Accents, Up: Special insertions
23.6 Additional Latin letters
=============================
@@ -14215,9 +14216,56 @@
encoding, such as T1.
-File: latex2e.info, Node: \rule, Next: \today, Prev: Additional Latin letters, Up: Special insertions
+File: latex2e.info, Node: Inputenc package, Next: \rule, Prev: Additional Latin letters, Up: Special insertions
-23.7 '\rule'
+23.7 Inputenc package
+=====================
+
+Synopsis, one of:
+
+ \usepackage{inputenc}
+ \usepackage[ENCODING-NAME]{inputenc}
+
+ Declare the input file's text encoding.
+
+ In a computer file, the characters are stored as binary according to
+some scheme, called the encoding. There are many different encodings.
+The simplest is ASCII, but it does not accomodate many characters so
+that for instance to get the a-umlaut character ä in an ASCII-encoded
+text file a user must enter '\"a', which makes the file hard to read and
+also means that TeX won't hyphenation the word containing that
+character. Often a more inclusive encoding is more convenient. The
+modern standard, in some ways a union of the others, is UTF-8.
+
+ In short, to enter material a user sets their file editor to use an
+encoding scheme and this package is how LaTeX knows what encoding they
+used. For instance, the following command says that the input file is
+UTF-8 (note the lack of a dash).
+
+ \usepackage[utf8]{inputenc}
+
+ Caution: use this package only with the pdfTeX engine (*note TeX
+engines::). The XeTeX and LuaTeX engines assume that the input file is
+UTF-8 encoded. If you invoke LaTeX with either the 'xelatex' command or
+the 'lualatex' command and use the above example line, then you will be
+warned 'inputenc package ignored with utf8 based engines'. And, if you
+instead declare a non-UTF-8 encoding such as 'latin1' then you will get
+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
+not explicitly include this package.
+
+ 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
+common values for ENCODING-NAME are: 'ascii', 'latin1', 'latin2',
+'latin3', 'latin4', 'latin5', 'latin9', 'latin10', and 'utf8'.
+
+
+File: latex2e.info, Node: \rule, Next: \today, Prev: Inputenc package, Up: Special insertions
+
+23.8 '\rule'
============
Synopsis, one of:
@@ -14255,7 +14303,7 @@
File: latex2e.info, Node: \today, Prev: \rule, Up: Special insertions
-23.8 '\today'
+23.9 '\today'
=============
Synopsis:
@@ -18467,6 +18515,7 @@
* input, on command line: Command line input. (line 6)
* input/output: Input/output. (line 6)
* input/output, to terminal: Input/output. (line 6)
+* inputenc: Inputenc package. (line 6)
* inserting figures: figure. (line 6)
* insertions of special characters: Special insertions. (line 6)
* internal vertical mode: Modes. (line 38)
@@ -19781,91 +19830,92 @@
Node: \scalebox501568
Node: \resizebox502624
Node: Special insertions503816
-Node: Reserved characters504618
-Node: Upper and lower case505878
-Node: Symbols by font position508264
-Node: Text symbols508943
-Node: Accents513128
-Node: \accent515281
-Node: Additional Latin letters517043
-Ref: Non-English characters517214
-Node: \rule518233
-Node: \today519406
-Node: Splitting the input520342
-Node: \endinput522084
-Node: \include & \includeonly523387
-Node: \input527684
-Node: Front/back matter528899
-Node: Table of contents etc.529232
-Node: \addcontentsline533057
-Node: \addtocontents535899
-Node: \nofiles537490
-Node: Indexes538222
-Node: \index539830
-Node: makeindex544935
-Ref: makeindex preamble546603
-Ref: makeindex postamble546743
-Ref: makeindex group skip546828
-Ref: makeindex letheadflag547161
-Ref: makeindex lethead prefix547622
-Ref: makeindex lethead suffix547774
-Ref: makeindex item 0547922
-Ref: makeindex item 1548002
-Ref: makeindex item 2548077
-Ref: makeindex item 01548155
-Ref: makeindex item x1548260
-Ref: makeindex item 12548465
-Ref: makeindex item x2548573
-Ref: makeindex delim 0548733
-Ref: makeindex delim 1548863
-Ref: makeindex delim 2548993
-Ref: makeindex delim n549119
-Ref: makeindex delim r549254
-Ref: makeindex line max549362
-Ref: makeindex indent space549497
-Ref: makeindex indent length549592
-Ref: makeindex page precedence549777
-Node: \printindex550651
-Node: Glossaries551124
-Node: \newglossaryentry553091
-Node: \gls554558
-Node: Letters555352
-Node: \address558970
-Node: \cc559781
-Node: \closing560223
-Node: \encl560537
-Node: \location560951
-Node: \makelabels561215
-Node: \name563532
-Node: \opening563773
-Node: \ps564054
-Node: \signature564343
-Node: \telephone565571
-Node: Input/output565936
-Node: \openin & \openout566666
-Node: \read569409
-Node: \typein570596
-Node: \typeout571856
-Node: \write572906
-Node: \write and security577633
-Node: \message578577
-Node: \wlog580406
-Node: \write18580907
-Node: Command line interface584398
-Ref: Command line584562
-Node: Command line options586645
-Ref: interaction modes587641
-Ref: output directory588595
-Node: Command line input590294
-Node: Jobname592123
-Node: Recovering from errors592938
-Node: Document templates594283
-Node: beamer template594717
-Node: article template595359
-Node: book template595822
-Node: Larger book template596301
-Node: Index597843
-Ref: Command Index597929
+Node: Reserved characters504684
+Node: Upper and lower case505944
+Node: Symbols by font position508330
+Node: Text symbols509009
+Node: Accents513194
+Node: \accent515347
+Node: Additional Latin letters517109
+Ref: Non-English characters517291
+Node: Inputenc package518310
+Node: \rule520447
+Node: \today521612
+Node: Splitting the input522548
+Node: \endinput524290
+Node: \include & \includeonly525593
+Node: \input529890
+Node: Front/back matter531105
+Node: Table of contents etc.531438
+Node: \addcontentsline535263
+Node: \addtocontents538105
+Node: \nofiles539696
+Node: Indexes540428
+Node: \index542036
+Node: makeindex547141
+Ref: makeindex preamble548809
+Ref: makeindex postamble548949
+Ref: makeindex group skip549034
+Ref: makeindex letheadflag549367
+Ref: makeindex lethead prefix549828
+Ref: makeindex lethead suffix549980
+Ref: makeindex item 0550128
+Ref: makeindex item 1550208
+Ref: makeindex item 2550283
+Ref: makeindex item 01550361
+Ref: makeindex item x1550466
+Ref: makeindex item 12550671
+Ref: makeindex item x2550779
+Ref: makeindex delim 0550939
+Ref: makeindex delim 1551069
+Ref: makeindex delim 2551199
+Ref: makeindex delim n551325
+Ref: makeindex delim r551460
+Ref: makeindex line max551568
+Ref: makeindex indent space551703
+Ref: makeindex indent length551798
+Ref: makeindex page precedence551983
+Node: \printindex552857
+Node: Glossaries553330
+Node: \newglossaryentry555297
+Node: \gls556764
+Node: Letters557558
+Node: \address561176
+Node: \cc561987
+Node: \closing562429
+Node: \encl562743
+Node: \location563157
+Node: \makelabels563421
+Node: \name565738
+Node: \opening565979
+Node: \ps566260
+Node: \signature566549
+Node: \telephone567777
+Node: Input/output568142
+Node: \openin & \openout568872
+Node: \read571615
+Node: \typein572802
+Node: \typeout574062
+Node: \write575112
+Node: \write and security579839
+Node: \message580783
+Node: \wlog582612
+Node: \write18583113
+Node: Command line interface586604
+Ref: Command line586768
+Node: Command line options588851
+Ref: interaction modes589847
+Ref: output directory590801
+Node: Command line input592500
+Node: Jobname594329
+Node: Recovering from errors595144
+Node: Document templates596489
+Node: beamer template596923
+Node: article template597565
+Node: book template598028
+Node: Larger book template598507
+Node: Index600049
+Ref: Command Index600135
End Tag Table
Modified: trunk/latex2e.pdf
===================================================================
(Binary files differ)
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2021-05-24 16:11:21 UTC (rev 908)
+++ trunk/latex2e.texi 2021-05-24 20:25:20 UTC (rev 909)
@@ -17186,6 +17186,7 @@
* Text symbols:: Inserting other non-letter symbols in text.
* Accents:: Inserting accents.
* Additional Latin letters:: Inserting other non-English characters.
+* Inputenc package:: Set the input file text encoding.
* \rule:: Inserting lines and rectangles.
* \today:: Inserting today's date.
@end menu
@@ -17961,6 +17962,61 @@
@end table
+ at node Inputenc package
+ at section Inputenc package
+
+ at findex inputenc
+
+Synopsis, one of:
+
+ at example
+\usepackage@{inputenc@}
+\usepackage[@var{encoding-name}]@{inputenc@}
+ at end example
+
+Declare the input file's text encoding.
+
+In a computer file, the characters are stored as binary according to
+some scheme, called the encoding. There are many different encodings.
+The simplest is ASCII, but it does not accomodate many characters so
+that for instance to get the a-umlaut character @"{a} in an
+ASCII-encoded text file a user must enter @code{\"a}, which makes the
+file hard to read and also means that @TeX{} won't hyphenation the word
+containing that character. Often a more inclusive encoding is more
+convenient. The modern standard, in some ways a union of the others, is
+UTF-8.
+
+In short, to enter material a user sets their file editor to use an
+encoding scheme and this package is how @LaTeX{} knows what encoding
+they used. For instance, the following command says that the input file
+is UTF-8 (note the lack of a dash).
+
+ at example
+\usepackage[utf8]@{inputenc@}
+ at end example
+
+Caution: use this package only with the pdf at TeX{} engine (@pxref{@TeX{}
+engines}). The Xe at TeX{} and Lua at TeX{} engines assume that the input
+file is UTF-8 encoded. If you invoke @LaTeX{} with either the
+ at command{xelatex} command or the @command{lualatex} command and use the
+above example line, then you will be warned @code{inputenc package
+ignored with utf8 based engines}. And, if you instead declare a
+non-UTF-8 encoding such as @code{latin1} then you will get the error
+ at 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
+not explicitly include this package.
+
+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
+ at code{\inputencoding@{@var{encoding-name}@}}. The most common values
+for @var{encoding-name} are: @code{ascii}, @code{latin1}, @code{latin2},
+ at code{latin3}, @code{latin4}, @code{latin5}, @code{latin9},
+ at code{latin10}, and at tie{}@code{utf8}.
+
+
@node \rule
@section @code{\rule}
More information about the latexrefman-commits
mailing list.