texlive[43640] Master/texmf-dist: nfssext-cfr (29mar17)
commits+karl at tug.org
commits+karl at tug.org
Thu Mar 30 00:31:45 CEST 2017
Revision: 43640
http://tug.org/svn/texlive?view=revision&revision=43640
Author: karl
Date: 2017-03-30 00:31:45 +0200 (Thu, 30 Mar 2017)
Log Message:
-----------
nfssext-cfr (29mar17)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/latex/nfssext-cfr/README
trunk/Master/texmf-dist/doc/latex/nfssext-cfr/nfssext-cfr.pdf
trunk/Master/texmf-dist/doc/latex/nfssext-cfr/nfssext-cfr.tex
trunk/Master/texmf-dist/tex/latex/nfssext-cfr/nfssext-cfr.sty
Modified: trunk/Master/texmf-dist/doc/latex/nfssext-cfr/README
===================================================================
--- trunk/Master/texmf-dist/doc/latex/nfssext-cfr/README 2017-03-29 22:29:20 UTC (rev 43639)
+++ trunk/Master/texmf-dist/doc/latex/nfssext-cfr/README 2017-03-29 22:31:45 UTC (rev 43640)
@@ -23,4 +23,4 @@
enhanced support included for variant font families.
- Clea F. Rees (ReesC21 <at> cardiff <dot> ac <dot> uk)
-2015/06/18
+2017/03/28
Modified: trunk/Master/texmf-dist/doc/latex/nfssext-cfr/nfssext-cfr.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/nfssext-cfr/nfssext-cfr.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/nfssext-cfr/nfssext-cfr.tex 2017-03-29 22:29:20 UTC (rev 43639)
+++ trunk/Master/texmf-dist/doc/latex/nfssext-cfr/nfssext-cfr.tex 2017-03-29 22:31:45 UTC (rev 43640)
@@ -2,32 +2,37 @@
% !TEX encoding = UTF-8 Unicode
% arara: pdflatex: { synctex: true }
\pdfminorversion=7
-\documentclass[pagesize=auto, fontsize=14pt, DIV=11]{scrartcl}
+\RequirePackage{svn-prov}
+\ProvidesFileSVN{$Id: nfssext-cfr.tex 6143 2017-03-28 22:45:37Z cfrees $}[\revinfo{}]
+\documentclass[pagesize=auto, fontsize=10pt, DIV=11]{scrartcl}
-\usepackage{fixltx2e}
\usepackage{cfr-lm}
-\usepackage{textcomp}
+\usepackage{textcomp,longtable,array,booktabs}
\usepackage{microtype}
\newcommand*{\mail}[1]{\texttt{#1}}
\newcommand*{\pkg}[1]{\mbox{\textsf{#1}}}
+\newcommand*{\cs}[1]{\texttt{\textbackslash #1}}
\addtokomafont{title}{\rmfamily}
\title{The \pkg{nfssext-cfr} package}
\author{Clea F. Rees\thanks{\mail{ReesC21 <at> cardiff <dot> ac <dot> uk}}}
-\date{2010/07/17}
+\date{2017/03/28}
\begin{document}
-\maketitle\thispagestyle{empty}
+\maketitle
-\noindent
-\pkg{nfssext-cfr} is an extension of Philipp Lehman's \pkg{nfssext}\@.
-\pkg{nfssext} provides commands which enable one to specify font features not covered by the New Font Selection Scheme of \LaTeXe\@.
-\pkg{nfssext-cfr} provides additional commands, further extending the facilities offered by NFSS.
+\begin{abstract}
+ \noindent \pkg{nfssext-cfr} is an extension of Philipp Lehman's \pkg{nfssext}\@.
+ \pkg{nfssext} provides commands which enables one to specify font features not covered by the New Font Selection Scheme of \LaTeXe\@.
+ \pkg{nfssext-cfr} provides additional commands, further extending the facilities offered by NFSS.
+\end{abstract}
+\section*{Introduction}
+
\pkg{nfssext-cfr} is required by various font support packages I've written.
It is being released separately to avoid unnecessary duplication and confusion.
At least, I hope it will remove at least one source of unnecessary confusion.
@@ -39,6 +44,147 @@
If you discover problems, please let me know.
If you know how to fix them, even better.
+\section*{Caveats, Warnings and Qualifications}
+
+The actual effect of any macro depends on any changes made to the defaults for various font features, the current font and, of course, what is available.
+
+For example, \cs{itdefault} is intended to be the name of italic shape and is used by the redefined \cs{itshape} supplied by this package.
+By default, \cs{itdefault} is \texttt{it}.
+However, if you change that to, say, \texttt{sl}, then \cs{itshape} will use \texttt{sl} instead.
+
+Moreover, if the current shape is small-caps, \cs{itshape} will attempt to merge the default italic shape with the small-caps.
+That is, it will try to select small-caps italic, if possible, before resorting to plain italic.
+
+The macros operating on family names are almost entirely reliant on font names adhering strictly to the Karl Berry schema.
+This includes the stipulation that multiple variants be listed in alphabetical order.
+These macros cannot be used with fonts named in any other way.
+
+Likewise, the macros for series and shapes are unlikely to have their expected effects if fonts are not packaged in ways which both adhere to the NFSS schema and, where relevant, to the specific way that schema is extended here.
+In particular, note that italic small-caps is assumed to be coded as \texttt{si}.
+
+If a macro's attempt to enable or disable a font feature fails, a warning will generally be written to the console, but the code tries hard not to trigger errors.
+If an attempt triggers an error, that's a bug, so please let me know.
+If an attempt triggers a warning, please note that there may be no bug at all and, if there is a bug, it is probably not in this package.
+
+To be clear, there certainly are bugs.
+It is just statistically unlikely that any given warning is caused by one.
+
+{%
+ \fontfamily{pzc}\fontshape{it}\fontseries{m}\selectfont\Large Caveat emptor \dots\par
+}
+
+\section*{Macros}
+
+The following table includes macros supplied by the original \pkg{nfssext} and additions available with \pkg{nfssext-cfr}.
+
+The third column lists the default letter codes for various font features.
+As explained above, if the defaults are changed, the macros will try to do something different.
+
+A \texttt{+} indicates that the macro will attempt to merge the addition into the current font's family name, series or shape.
+For example, if the current font uses oldstyle figures, the \texttt{+2} indicates that \cs{pstyle} will attempt to select a font with figures which are both proportional and oldstyle.
+
+A \textt{-} indicates that the macro will attempt to subtract from the current font's family name, series or shape.
+For example, if the current font uses oldstyle figures, the \texttt{-2} indicates that \cs{tstyle} will attempt to select a font with figures which are both tabular and oldstyle.
+
+A comma-separated list indicates consecutive additions and/or subtraction.
+
+If no \texttt{+-} is used, the macro tries to select a font with the given feature without merging.
+For example \cs{sistyle} tries to switch to \texttt{si} shape regardless of the current font shape.
+
+A \texttt{--} indicates that the macro will try to clear all relevant letter codes from the current font's family name, series or shape.
+For example, \cs{regwidth} tries to switch to a series with no letter codes indicating non-standard widths in its name.
+
+Additions, subtractions and clearances operate on font family names, series or shapes, as appropriate.
+In general, macros with \texttt{style} in their names operate on family names; those with \texttt{shape} operate on shape codes; and those with \textt{width} or \texttt{weight} operate on series codes.
+
+The letter codes correspond to those specified by the NFSS specification, unless the specification does not include the relevant feature.
+In the latter case, I tried to choose something sensible i.e.~something which made sense to me at the time.
+
+
+\begin{longtable}{lll>{\ttfamily}ll}
+ \toprule\endhead
+ \bottomrule\endfoot
+ \multicolumn{5}{l}{\sffamily Standard macros redefined:}\\
+ \cmidrule(lr){1-5}
+ & \cs{itshape}\\
+ & \cs{scshape}\\
+ & \cs{upshape}\\
+ \cmidrule(lr){1-5}
+ \multicolumn{5}{l}{\sffamily Families --- Styles:}\\
+ \cmidrule(lr){1-5}
+ & \cs{textti} & \cs{tistyle} & +d & titling/display\\
+ & \cs{textlt} & \cs{ltstyle} & +l & light (when separate family)\\
+ & \cs{textof} & \cs{ofstyle} & +l & open-face (or outline or blank) style\\
+ & \cs{textalt} & \cs{altstyle} & +a & alternative style\\
+ & \cs{textreg} & \cs{regstyle} & -- & regular style\\
+ & \cs{emboss} & \cs{embossstyle} & +e & \\
+ & \cs{textorn} & \cs{ornamentalstyle} & +p & intended primarily for decorative initials etc.\\
+ & \cs{ornament} & \\
+ & \cs{textqt} & \cs{qtstyle} & +q & quotation style\\
+ & \cs{textsh} & \cs{shstyle} & +h & shadowed style\\
+ & \cs{texttm} & \cs{tmstyle} & -s,-v,+t & monowidth typewriter\\
+ & \cs{texttv} & \cs{tvstyle} & -s,-t,+v & variable width typewriter\\
+ & \cs{textswash} & \cs{swashstyle} & +w & an attempt to improve on \cs{textsw}\\
+ \cmidrule(lr){1-5}
+ \multicolumn{5}{l}{\sffamily Families --- Figures:}\\
+ \cmidrule(lr){1-5}
+ & \cs{textln} & \cs{lnstyle} & -- & lining figures (cf.~macro below)\\
+ & \cs{textos} & \cs{osstyle} & j & oldstyle figures (cf.~macro below)\\
+ & \cs{textin} & \cs{instyle} & 0 & inferior figures\\
+ & \cs{textsu} & \cs{sustyle} & 1 & superior figures\\
+ & \cs{textl} & \cs{lstyle} & -j & lining figures (cf.~command above)\\
+ & \cs{texto} & \cs{ostyle} & +j & oldstyle figures (cf.~original \cs{osstyle} above)\\
+ & \cs{textp} & \cs{pstyle} & +2 & proportional figures\\
+ & \cs{textt} & \cs{tstyle} & -2 & tabular figures\\
+ & \cs{textpl} & \cs{plstyle} & -j,+2 & proportional lining figures \\
+ & \cs{textpo} & \cs{postyle} & +2j & proportional oldstyle figures \\
+ & \cs{texttl} & \cs{tlstyle} & -j,-2 & tabular lining figures\\
+ & \cs{textto} & \cs{tostyle} & +j,-2 & tabular oldstyle figures\\
+ \cmidrule(lr){1-5}
+ \multicolumn{5}{l}{\sffamily Shapes:}\\
+ \cmidrule(lr){1-5}
+ & \cs{scolshape} & & scol & \\
+ & \cs{textol} & \cs{olshape} & ol & outline\\
+ & \cs{textsi} & \cs{sishape} & si & italic small-caps\\
+ & \cs{textu} & \cs{ushape} & u & \\
+ & \cs{textscu} & \cs{scushape} & su & \\
+ & \cs{textui} & \cs{uishape} & ui & upright italic\\
+ & \cs{textri} & \cs{rishape} & ri & reverse italic\\
+ & \cs{textdf} & \cs{dfshape} & n & default shape\\
+ & \cs{textsw} & \cs{swshape} & it & swash shape (cf.~\cs{swstyle} above)\\
+ & & \cs{swstyle} & \\
+ \cmidrule(lr){1-5}
+ \multicolumn{5}{l}{\sffamily Series --- Widths:}\\
+ \cmidrule(lr){1-5}
+ & \cs{textnw} & \cs{nwwidth} & +c & \\
+ & \cs{textcd} & \cs{cdwidth} & +c & \\
+ & \cs{textec} & \cs{ecwidth} & +ec & \\
+ & \cs{textuc} & \cs{ucwidth} & +uc & \\
+ & \cs{textet} & \cs{etwidth} & +x & \\
+ & \cs{textep} & \cs{epwidth} & +x & \\
+ & \cs{textex} & \cs{exwidth} & +ex & \\
+ & \cs{textux} & \cs{uxwidth} & +ux & \\
+ & \cs{textrw} & \cs{regwidth} & -- & \\
+ \cmidrule(lr){1-5}
+ \multicolumn{5}{l}{\sffamily Series --- Weights:}\\
+ \cmidrule(lr){1-5}
+ & \cs{textmb} & \cs{mbweight} & +mb & \\
+ & \cs{textdb} & \cs{dbweight} & +db & \\
+ & \cs{textsb} & \cs{sbweight} & +sb & \\
+ & \cs{texteb} & \cs{ebweight} & +eb & \\
+ & \cs{textub} & \cs{ubweight} & +ub & \\
+ & \cs{textlg} & \cs{lgweight} & +l & \\
+ & \cs{textel} & \cs{elweight} & +el & \\
+ & \cs{textul} & \cs{ulweight} & +ul & \\
+\end{longtable}
+
+\section*{History}
+
+\subsection*{2017-03-28}
+Attempt to modify \cs{tmstyle} and \cs{tvstyle} to work as advertised.
+Extend documentation somewhat.
+
+\subsection*{2010}
The 2010 update includes an attempt to improve the behaviour of \verb|\ofstyle|, and to add support for \pkg{microtype}.
I didn't publish this at the time because I wanted to test it first.
I have just discovered that I am still using a local copy.
Modified: trunk/Master/texmf-dist/tex/latex/nfssext-cfr/nfssext-cfr.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/nfssext-cfr/nfssext-cfr.sty 2017-03-29 22:29:20 UTC (rev 43639)
+++ trunk/Master/texmf-dist/tex/latex/nfssext-cfr/nfssext-cfr.sty 2017-03-29 22:31:45 UTC (rev 43640)
@@ -1,5 +1,5 @@
%% nfssext-cfr.sty
-%% Additions and changes are copyright 2010 Clea F. Rees
+%% Additions and changes are copyright 2017 Clea F. Rees
%% Code from nfssext.sty copyright 2003 Philipp Lehman (see below)
%
% This work may be distributed and/or modified under the
@@ -11,23 +11,27 @@
% version 2005/12/01 or later.
%
% This work has the LPPL maintenance status `maintained'.
-%
+%
% The Current Maintainer of this work is Clea F. Rees.
%
% This work consists of the file nfssext-cfr.sty.
%
-% The file nfssext-cfr.sty is a derived work under the terms of the
-% LPPL. It is based on version 1.2 of nfssext.sty which is part of The
-% Font Installation Guide by Philipp Lehman. A copy of the The Font
-% Installation Guide, including the unmodified version of nfssext.sty
-% is available from
+% The file nfssext-cfr.sty is a derived work under the terms of the
+% LPPL. It is based on version 1.2 of nfssext.sty which is part of The
+% Font Installation Guide by Philipp Lehman. A copy of the The Font
+% Installation Guide, including the unmodified version of nfssext.sty
+% is available from
% http://tug.ctan.org/cgi-bin/ctanPackageInformation.py?id=fontinstallationguide.
% nfssext.sty is part of the included archive figuide-examples.tar.gz
% which consists of examples and templates released under the LPPL.
% nfssext.sty is included in the files for tutorials 3, 5 and 6.
%
+% 2017-03-28: modify \tmstyle and \tvstyle to unmerge sans and other
+% typewriter before mergining appropriate variant
+%
\NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{nfssext-cfr}[2010/07/17 specially mangled by cfr; based on 2003/03/14 v1.2 Experimental NFSS Extensions]
+\RequirePackage{svn-prov}
+\ProvidesPackageSVN{$Id: nfssext-cfr.sty 6140 2017-03-28 18:07:31Z cfrees $}[\revinfo{} specially mangled by cfr; based on 2003/03/14 v1.2 Experimental NFSS Extensions]
%:cfr-added: use ifthen
\RequirePackage{ifthen}
%:end-added
@@ -122,7 +126,7 @@
\gdef\set{0,1,2,a,d,e,f,h,j,l,p,q,s,t,v,w}% these are the variants to consider - the order here and in the font name is crucial
\ifx\tempo\exfs at tempf
\@for \xx:=\set \do {%
- % check whether there are variants left - if not set the ``next variant'' to empty
+ % check whether there are variants left - if not set the ``next variant'' to empty
\ifx\tempa\@empty
\let\exfs at tempn\@empty
\else
@@ -186,7 +190,7 @@
\fi
\fi
\fi
- \fi
+ \fi
}%
\fi
\fi
@@ -238,12 +242,16 @@
\DeclareRobustCommand{\swashstyle}{% an attempt to improve on \swstyle
\not at math@alphabet\swashstyle\relax
\exfs at merge@families{w}}
-\DeclareRobustCommand{\tmstyle}{% monowidth typewriter
- \not at math@alphabet\tmstyle\relax
- \exfs at merge@families{t}}
-\DeclareRobustCommand{\tvstyle}{% variable width typewriter
- \not at math@alphabet\tvstyle\relax
- \exfs at merge@families{v}}
+\DeclareRobustCommand{\tmstyle}{% monowidth typewriter
+ \not at math@alphabet\tmstyle\relax
+ \exfs at unmerge@families{s}%
+ \exfs at unmerge@families{v}%
+ \exfs at merge@families{t}}
+\DeclareRobustCommand{\tvstyle}{% variable width typewriter
+ \not at math@alphabet\tvstyle\relax
+ \exfs at unmerge@families{s}%
+ \exfs at unmerge@families{t}%
+ \exfs at merge@families{v}}
%:cfr-added - unmerge families
\newcounter{taken}%
\newcommand*\exfs at unmerge@families[1]{%
@@ -435,7 +443,7 @@
\newcommand*{\uxdefault}{ux}
\DeclareRobustCommand{\uxwidth}{%
\not at math@alphabet\uxwidth\relax
- \exfs at merge@width{\uxdefault}}
+ \exfs at merge@width{\uxdefault}}
%:cfr-added merge weight changes into series
\newcommand*{\exfs at merge@weight}[1]{%
\edef\exfs at tempg{#1}%
More information about the tex-live-commits
mailing list