[latexrefman-commits] r361 - in /trunk: ChangeLog latex2e.texi

[jhefferon at domain.hid]

Author: jhefferon
Date: Fri Jun 12 02:01:46 2015
New Revision: 361

URL: http://svn.gna.org/viewcvs/latexrefman?rev=361&view=rev
Log:
information in low-level font commands

Modified:
    trunk/ChangeLog
    trunk/latex2e.texi

Modified: trunk/ChangeLog
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/ChangeLog?rev=361&r1=360&r2=361&view=diff
==============================================================================
--- trunk/ChangeLog	(original)
+++ trunk/ChangeLog	Fri Jun 12 02:01:46 2015
@@ -1,3 +1,8 @@
+2015-06-11  Jim Hefferon  <jhefferon at domain.hid>
+
+	* latex2e.texi: (Low-level font commands) Add some information about
+	options.  Not sure about options formatting.
+
 2015-06-09  Karl Berry  <karl at domain.hid>
 
 	* latex2e.texi: Let's consistently have one blank line

Modified: trunk/latex2e.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e.texi?rev=361&r1=360&r2=361&view=diff
==============================================================================
--- trunk/latex2e.texi	(original)
+++ trunk/latex2e.texi	Fri Jun 12 02:01:46 2015
@@ -931,13 +931,16 @@
 ones.
 
 @table @code
- at domain.hid \fontencoding at domain.hid@}
+ at item \fontencoding at domain.hid}@}
 @findex \fontencoding
-Select font encoding. Valid encodings include @code{OT1} and @code{T1}.
-
- at domain.hid \fontfamily at domain.hid@}
+Select font encoding, the encoding of the output font. Valid encodings
+include @code{OT1}, Knuth's original encoding for Computer Modern, and
+ at code{T1}, also known as the Cork encoding, which allows for most
+characters in Latin alphabets.
+
+ at item \fontfamily at domain.hid}@}
 @findex \fontfamily
-Select font family. Valid families include:
+Select the font family. Valid families include:
 
 @itemize @bullet
 @item @code{cmr}  for Computer Modern Roman
@@ -947,9 +950,12 @@
 
 and numerous others.
 
- at domain.hid \fontseries at domain.hid@}
+ at item \fontseries at domain.hid}@}
 @findex \fontseries
-Select font series. Valid series include:
+Select the font series. 
+A @var{series} is a combination of a @dfn{weight} and a @dfn{width}.
+Note that typically fonts have only a few of the possible combinations.
+The most common values for @var{series} include:
 
 @itemize @bullet
 @item @code{m}  Medium (normal)
@@ -959,9 +965,57 @@
 @item @code{bx} Bold extended
 @end itemize
 
-and various other combinations.
-
- at domain.hid \fontshape at domain.hid@}
+The possible values for weight are:
+
+ at table @option
+ at item ul 
+Ultra light
+ at item el 
+Extra light
+ at item l  
+Light
+ at item sl 
+Semi light
+ at item m  
+Medium (normal)
+ at item sb 
+Semi bold
+ at item b  
+Bold
+ at item eb 
+Extra bold
+ at item ub 
+Ultra bold
+ at end table
+ 
+The possible values for width are:
+
+ at table @option
+ at item uc 
+Ultra condensed, 50%
+ at item ec 
+Extra condensed, 62.5%
+ at item c  
+Condensed, 75%
+ at item sc
+Semi condensed, 87.5%
+ at item m  
+Medium, 100%
+ at item sx
+Semi expanded, 112.5%
+ at item x
+Expanded, 125%
+ at item ex
+Extra expanded, 150%
+ at item ux 
+Ultra expanded, 200%
+ at end table
+
+When forming the @var{series} string from the weight and width, drop the
+ at code{m} that stands for medium weight or medium width, unless both
+weight and width are @code{m}, in which case you just use one @code{m}.
+ 
+ at item \fontshape at domain.hid}@}
 @findex \fontshape
 Select font shape. Valid shapes are:
 
@@ -976,14 +1030,13 @@
 
 The two last shapes are not available for most font families.
 
- at domain.hid \fontsize at domain.hid@}
+ at item \fontsize at domain.hid}@}
 @findex \fontsize
 @findex \baselineskip
-Set font size. The first parameter is the font size to switch to and
-the second is the line spacing to use; this is stored in a parameter
-named @code{\baselineskip}.  The unit of both parameters defaults to
-pt.  The default @code{\baselineskip} for the Computer Modern typeface
-is 1.2 times the @code{\fontsize}.
+Set the font size and the line spacing.  The line spacing is stored in a
+parameter named @code{\baselineskip}.  The unit of both parameters
+defaults to points (@code{pt}).  The default @code{\baselineskip} for
+the Computer Modern typeface is 1.2 times the @code{\fontsize}.
 
 @findex \baselinestretch
 @cindex @code{setspace} package
@@ -1007,7 +1060,7 @@
 The changes made by calling the font commands described above do
 not come into effect until @code{\selectfont} is called.
 
- at domain.hid \usefont at domain.hid@}
+ at item \usefont at domain.hid}@}
 @findex \usefont
 The same as invoking @code{\fontencoding}, @code{\fontfamily},
 @code{\fontseries} and @code{\fontshape} with the given parameters,