[latexrefman-commits] [SCM] latexrefman updated: r1077 - trunk
Karl Berry
INVALID.NOREPLY at gnu.org.ua
Wed Jan 26 18:47:46 CET 2022
Author: karl
Date: 2022-01-26 17:47:45 +0000 (Wed, 26 Jan 2022)
New Revision: 1077
Modified:
trunk/ChangeLog
trunk/NEWS
trunk/latex2e.texi
Log:
pt/mm/cm equivalences
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2022-01-17 23:23:33 UTC (rev 1076)
+++ trunk/ChangeLog 2022-01-26 17:47:45 UTC (rev 1077)
@@ -1,3 +1,9 @@
+2022-01-26 Karl Berry <karl at freefriends.org>
+
+ * latex2e.texi (Units of length): correct pt/mm/cm equivalences.
+ Report from Geoff Odhner, 24 Jan 2022 22:08:58.
+ Also use @ftable, other wording changes.
+
2022-01-17 Pieter van Oostrum <pieter at vanoostrum.org>
* latex2e.texi (\hrulefill & \dotfill): replace "@" macros
@@ -2850,6 +2856,10 @@
* latex2e.texi (minipage): Typoes + insert a few TODO comments.
+2020-07-124 Jim Hefferon <jim at joshua.smcvt.edu>
+
+ * July 2020 release.
+
2020-07-13 Vincent Bela\"iche <vincentb1 at users.sourceforge.net>
* latex2e.texi (\appendix): Fix \og\appendixname\fg description.
Modified: trunk/NEWS
===================================================================
--- trunk/NEWS 2022-01-17 23:23:33 UTC (rev 1076)
+++ trunk/NEWS 2022-01-26 17:47:45 UTC (rev 1077)
@@ -1,13 +1,19 @@
$Id$
NEWS for latex2e.texi, aka the latex2e-help-texinfo package.
Public domain. Originally written 1995, Torsten Martinsen.
-Spanish translation originally from Nacho Pacheco (currently unmaintained).
French translation originally from Vincent Belaiche.
+Spanish translation originally from Nacho Pacheco (currently looking for
+a maintainer).
+
Changes in January 2022 release:
-Changes in July 2020 release:
+Some noteworthy changes since the last release:
-Among the changes since the last release:
+
+
+
Changes in July 2020 release:
+
+Some noteworthy changes since the last release:
* Entries for \openin, \openout, \message, \write, \write18.
* Section on fontenc.
* Section on math delimiters.
@@ -16,9 +22,8 @@
* Section on expressions.
* Entry on \contentsline.
+
Changes in October 2018 release:
-Changes in October 2018 release:
-
The main change is that we now offer the manual in a version that
is split into separate web pages for each section or subsection.
This new version is more host-friendly. To celebrate we have
@@ -35,10 +40,8 @@
In addition to the format news, there were many bug fixes and new entries,
including \smash and \phantom.
-----------------------------------------------------------------
+
Changes in July 2018 release:
-Changes in July 2018 release:
-
We have gone through the two documents latex-info and
latex2e-reference and checked that any information in those documents
is in this one.
@@ -54,10 +57,8 @@
In addition, there were many bug fixes, including greatly shrinking
the size of one of the graphics.
-----------------------------------------------------------------
+
Changes in April 2018 release:
-Changes in April 2018 release:
-
There is a new chapter on color and a new chapter on graphics
inclusion (all the commands from grfguide.pdf are now covered),
there is much greater coverage of the list environment including a
@@ -65,8 +66,7 @@
environment.
-----------------------------------------------------------------
-Changes in Aug 2017 release:
+
Changes in Aug 2017 release:
Besides the usual bug fixes, some of the changes in this version
include coverage of \makeatletter and \makeatother, \@startsection,
@@ -74,8 +74,7 @@
in the descriptions of floats, the letter environment, \raisebox,
\onecolumn and \twocolumn, and many more.
-----------------------------------------------------------------
-Changes in Apr 2016 release:
+
Changes in Apr 2016 release:
Provide first complete French translation --- still not fully aligned
on the latest revisions of the English version.
@@ -86,8 +85,7 @@
for optional parameters. Improve naming of Math symbols. Usual bug and
typo fixes.
-----------------------------------------------------------------
-Changes in Oct 2015 release:
+
Changes in Oct 2015 release:
Many examples added, often using typical constructs.
Extend many entries to include points frequently asked.
@@ -95,8 +93,7 @@
Translations not yet part of update; needs to be worked out.
Thanks to Vincent Belaiche for many contributions.
-----------------------------------------------------------------
-Changes in May 2015 release:
+
Changes in May 2015 release:
Usual bug fixes, more indexing, template updates.
Improve document and LaTeX overview, including general syntax.
@@ -106,53 +103,46 @@
For HTML, make the Up from Top be http://tug.org/texinfohtml.
Exception word list for spell checking, and make target for spell
checking and doubled words.
--
+
French translation begun (only in sources); Spanish translation updated.
Thanks to Vincent Belaiche and Jim Hefferon for their many contributions.
-----------------------------------------------------------------
-Changes in May 2014 release:
+
Changes in May 2014 release:
Usual bug fixes, template updates.
Add filecontents description, fnsymbol info, non-obsolescence of \tt et al.,
mostly due to Vincent Belaiche.
Updates to Spanish translation, also from Vincent.
-----------------------------------------------------------------
-Changes in May 2013 release:
+
Changes in May 2013 release:
Usual bug fixes, template updates.
Mention \unitlength default (1pt) and \oldstylenums.
Fix in ltx-help.el to find correct nodes for environments, etc.
-----------------------------------------------------------------
-Changes in May 2012 release:
+
Changes in May 2012 release:
Template updates and references.
More on floats.
Mention a few other documents.
-----------------------------------------------------------------
-Changes in May 2011 release:
+
Changes in May 2011 release:
Usual bug fixes, additional background info.
TUGboat sample document updated.
Discussion of width parameters.
-----------------------------------------------------------------
-Changes in July 2010 release:
+
Changes in July 2010 release:
Usual bug fixes. Added a number of control sequences from ltoutenc that
typeset particular glyphs.
-----------------------------------------------------------------
-Changes in September 2009 release:
+
Changes in September 2009 release:
A bit more about figures and indexes, use of @table where appropriate in
the source, usual array of minor fixes, added references, etc.
-----------------------------------------------------------------
-Changes in release 2.0:
+
Changes in release 2.0:
After discussions with Torsten and Stephen Gilmore, maintainership of
this document has been handed off to me. See the README for more
@@ -170,8 +160,7 @@
Karl Berry (karl at freefriends.org), June 12 2008
-----------------------------------------------------------------
-Changes in release 1.6:
+
Changes in release 1.6:
Some minor bug fixes; thanks to Piet van Oostrum and Ralf
Fassel for those.
@@ -187,8 +176,7 @@
Torsten Martinsen, April 24 1996
-----------------------------------------------------------------
-Changes in release 1.3:
+
Changes in release 1.3:
A selection of low-level NFSS2 commands added.
A short description of how to use BibTeX.
@@ -200,8 +188,7 @@
Torsten Martinsen, March 13th 1995
-----------------------------------------------------------------
-Changes in release 1.4:
+
Changes in release 1.4:
NOTE: The name of the generated Info file is now `latex' and not `latex2e'.
More commands added to function index (ahem).
@@ -210,8 +197,7 @@
Torsten Martinsen, April 5th 1995
-----------------------------------------------------------------
-Changes in release 1.5:
+
Changes in release 1.5:
All menu items now have one-line descriptions.
Major cleanup of next/previous links.
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2022-01-17 23:23:33 UTC (rev 1076)
+++ trunk/latex2e.texi 2022-01-26 17:47:45 UTC (rev 1077)
@@ -11154,10 +11154,10 @@
\end@{minipage@}
@end example
- at TeX{} actually has three levels of infinity for glue components:
- at code{fil}, @code{fill}, and @code{filll}. The later ones are more
-infinite than the earlier ones. Ordinarily document authors only use
-the middle one (@pxref{\hfill} and @pxref{\vfill}).
+ at TeX{} has three levels of infinity for glue components: @code{fil},
+ at code{fill}, and @code{filll}. The later ones are more infinite than
+the earlier ones. Ordinarily document authors only use the middle one
+(@pxref{\hfill} and @pxref{\vfill}).
Multiplying a rubber length by a number turns it into a rigid length, so
that after @code{\setlength@{\ylength@}@{1in plus 0.2in@}} and
@@ -11173,7 +11173,6 @@
* \settowidth:: Set a length to the width of something.
* \stretch:: Add infinite stretchability.
* Expressions:: Compute with lengths and integers.
- at c * Predefined lengths:: Lengths that are, like, predefined.
@end menu
@@ -11185,96 +11184,97 @@
@TeX{} and @LaTeX{} know about these units both inside and outside of
math mode.
- at table @code
+ at ftable @code
@item pt
- at findex pt
@cindex point
@anchor{units of length pt}
-Point, 1/72.27 inch. The conversion to metric units
-is 1 at dmn{point} = 2.845 at dmn{mm} = .2845 at dmn{cm}.
+Point, 1/72.27 inch. The (approximate) conversion to metric units
+is 1 at dmn{point} = .35146 at dmn{mm} = .035146 at dmn{cm}.
@item pc
@cindex pica
- at findex pc
@anchor{units of length pc}
Pica, 12 pt
@item in
- at findex in
- at findex inch
+ at cindex inch
@anchor{units of length in}
-Inch, 72.27 pt
+Inch, 72.27 pt
- at item bp
- at findex bp
+ at item bp
@cindex big point
+ at cindex PostScript point
@anchor{units of length bp}
Big point, 1/72 inch. This length is the definition of a point in
PostScript and many desktop publishing systems.
+ at item mm
+ at cindex millimeter
+ at anchor{units of length mm}
+Millimeter, 2.845 pt
+
@item cm
@cindex centimeter
- at findex cm
@anchor{units of length cm}
-Centimeter
+Centimeter, 10 mm
- at item mm
- at cindex millimeter
- at findex mm
- at anchor{units of length mm}
-Millimeter
-
@item dd
@cindex didot point
- at findex dd
@anchor{units of length dd}
Didot point, 1.07 pt
@item cc
@cindex cicero
- at findex cc
@anchor{units of length cc}
Cicero, 12 dd
@item sp
@cindex scaled point
- at findex sp
@anchor{units of length sp}
Scaled point, 1/65536 pt
- at end table
+ at end ftable
+Three other units are defined according to the current font, rather
+than being an absolute dimension.
+
+ at ftable @code
+ at item ex
+ at cindex x-height
@cindex ex
- at cindex x-height
- at findex ex
+ at anchor{Lengths/ex}
+ at anchor{units of length ex}
+The x-height of the current font @dfn{ex}, traditionally the
+height of the lowercase letter x, is often used for vertical
+lengths.
+
+ at item em
@cindex m-width
@cindex em
- at findex em
@anchor{Lengths/em}
- at anchor{Lengths/en}
- at anchor{Lengths/ex}
@anchor{units of length em}
- at anchor{units of length en}
- at anchor{units of length ex}
-Two other lengths that are often used are values set by the designer of
-the font. The x-height of the current font @dfn{ex}, traditionally the
-height of the lowercase letter x, is often used for vertical
-lengths. Similarly @dfn{em}, traditionally the width of the capital
-letter M, is often used for horizontal lengths (there is also
- at code{\enspace}, which is @code{0.5em}). Use of these can help make a
-definition work better across font changes. For example, a definition
-of the vertical space between list items given as
- at code{\setlength@{\itemsep@}@{1ex plus 0.05ex minus 0.01ex@}} is more
-likely to still be reasonable if the font is changed than a definition
-given in points.
+Similarly @dfn{em}, traditionally the width of the capital
+letter M, is often used for horizontal lengths. This is also often
+the size of the current font, e.g., a nominal 10 at dmn{pt} font will
+have 1 at dmn{em} = 10 at dmn{pt}. @LaTeX{} has several commands to produce
+horizontal spaces based on the em (@pxref{\enspace & \quad & \qquad}).
+ at item mu
@cindex mu, math unit
- at findex mu
-In math mode, many definitions are expressed in terms of the math unit
- at dfn{mu} given by 1 em = 18 mu, where the em is taken from the current
-math symbols family. @xref{Spacing in math mode}.
+ at anchor{units of length mu}
+Finally, in math mode, many definitions are expressed in terms
+of the math unit @dfn{mu}, defined by 1 at dmn{em} = 18 at dmn{mu}, where the
+em is taken from the current math symbols family. @xref{Spacing in
+math mode}.
+ at end ftable
+Using these units can help make a definition work better across font
+changes. For example, a definition of the vertical space between list
+items given as @code{\setlength@{\itemsep@}@{1ex plus 0.05ex minus
+0.01ex@}} is more likely to still be reasonable if the font is changed
+than a definition given in points.
+
@node \setlength
@section @code{\setlength}
@@ -11309,10 +11309,8 @@
@code{\newlength@{\specparindent@}\setlength@{\sepcparindent@}@{...@}},
then you get an error like @samp{Undefined control sequence. <argument>
\sepcindent}. If you omit the backslash at the start of the length name
-then you get an error like @samp{Missing number, treated as zero. <to be
-read again> \relax l.19 \setlength@{specparindent@}@{0.6\parindent@}}
+then you get an error like @samp{Missing number, treated as zero.}.
-
@node \addtolength
@section @code{\addtolength}
More information about the latexrefman-commits
mailing list.