diff options
author | Karl Berry <karl@freefriends.org> | 2024-09-29 20:38:51 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2024-09-29 20:38:51 +0000 |
commit | df846589a82aa0823fe3d8103de4757a23d3d17c (patch) | |
tree | 7ace428fd49ed0a97fc2b212856c07db5d8d0175 /Master/texmf-dist/doc | |
parent | 252cc349ce5416528790e00a9cbbfa2ba42bfc5c (diff) |
nfssext-cfr (29sep24)
git-svn-id: svn://tug.org/texlive/trunk@72402 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r-- | Master/texmf-dist/doc/latex/nfssext-cfr/README | 26 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/nfssext-cfr/README.md | 114 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/nfssext-cfr/manifest.txt | 71 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/nfssext-cfr/nfssext-cfr.pdf | bin | 180398 -> 919965 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/nfssext-cfr/nfssext-cfr.tex | 196 |
5 files changed, 185 insertions, 222 deletions
diff --git a/Master/texmf-dist/doc/latex/nfssext-cfr/README b/Master/texmf-dist/doc/latex/nfssext-cfr/README deleted file mode 100644 index 5a59f6bf043..00000000000 --- a/Master/texmf-dist/doc/latex/nfssext-cfr/README +++ /dev/null @@ -1,26 +0,0 @@ -nfssext-cfr.sty is an extension of Philipp Lehman's nfssext.sty. nfssext.sty -provides commands which enable one to specify font features not covered by -the New Font Selection Scheme of LaTeX-2e. nfssext-cfr.sty provides -additional commands, further extending the facilities offered by NFSS. - -nfssext-cfr.sty 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. I have no reason to think it will avoid any of the others. - -The code is somewhat experimental. It works for me. So far. If you discover -problems, please let me know. If you know how to fix them, even better. - -The 2010 update includes an attempt to improve the behaviour of \ofstyle, and to -add support for 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. -Insofar as one person can test something, I figure that 5 years ought to be -enough to pick up the most obvious problems. However, your kilometres may, as -always, vary. - -There should be no changes for the end user except that in certain cases it is -possible that line-breaks may be altered if microtype is in use due to the -enhanced support included for variant font families. - -- Clea F. Rees (ReesC21 <at> cardiff <dot> ac <dot> uk) -2017/03/28 diff --git a/Master/texmf-dist/doc/latex/nfssext-cfr/README.md b/Master/texmf-dist/doc/latex/nfssext-cfr/README.md new file mode 100644 index 00000000000..66c1c187703 --- /dev/null +++ b/Master/texmf-dist/doc/latex/nfssext-cfr/README.md @@ -0,0 +1,114 @@ +$Id: README.md 10366 2024-09-18 14:25:21Z cfrees $ + +================================================= +# nfssext-cfr +================================================= + +Additions and changes Copyright (C) 2008-2024 Clea F. Rees. +Code from The Font Installation Guide Copyright (C) 2002-2004 Philipp Lehman +(see below) + +This work may be distributed and/or modified under the conditions of the +LaTeX Project Public License, either version 1.3c of this license or (at your +option) any later version. The latest version of this license is in + https://www.latex-project.org/lppl.txt +and version 1.3c or later is part of all distributions of LaTeX version +2008-05-04 or later. + +This work has the LPPL maintenance status `maintained'. + +The Current Maintainer of this work is Clea F. Rees. + +This work consists of all files listed in manifest.txt. + + +The files nfssext-cfr.sty, nfssext-cfr-nfss.sty and nfssext-cfr-nnfss.sty are +derived works under the terms of the LPPL. They are based on version 1.2 of +nfssext.sty which was supplied with fontinstallationguide by Philipp Lehman. +A copy of fontinstallationguide, including an unmodified version of +nfssext.sty is available from + https://tug.ctan.org/pkg/fontinstallationguide. +nfssext.sty wajs part of the included archive figuide-examples.tar.gz which +consisted of examples and templates released under the LPPL. nfssext.sty was +included in the files for tutorials 3, 5 and 6. + +The main modifications made to this file are described in nfssext-cfr.dtx. + + +In versions which use docstrip, the docstrip files nfssext-cfr.ins, +nfssext-cfr.dtx, nfssext-cfr-t1.dtx and nfssext-cfr-t1.ins are derived +from skeleton.ins and skeleton.dtx, both part of of version 2.4 of Scott +Pakin's dtxtut. A copy of dtxtut including unmodified copies of skeleton.dtx +and skeleton ins is available from https://www.ctan.org/pkg/dtxtut and +released under the LPPL. + +Other attributions are included in the source of the package itself. + +================================================= +## Origins & Purpose +================================================= + +nfssext-cfr is an extension of Philipp Lehman's nfssext. nfssext +provides commands which enable one to specify font features not covered by +the New Font Selection Scheme of LaTeX-2e. nfssext-cfr provides +additional commands, further extending the facilities offered by NFSS. + +nfssext-cfr is required by various font support packages I've written. +It is released separately both to avoid unnecessary duplication and +confusion and to make it available for other purposes. + +================================================= +## Revision History +================================================= + +Please see nfssext-cfr.pdf and nfssext-cfr.dtx. + +================================================= +## Current Version +================================================= + +The current version is an extremely belated update for compatibility with +the (New) New Font Selection Scheme (NNFSS) introduced in 2020. This has +somewhat complicated things in various ways and the current version may best +be described as a compromise which will please nobody equally. + +The package includes three .sty files. The main package is a wrapper which +decides which of the other two to load, together with a small amount of common +code. + +The documentation explains changes required in font definition files for +backwards compatibility and the options users have if reliant on files which +have not been updated. No additional incompabilities should be introduced by +the update to nfssext-cfr. At worst, things which were broken in 2020 will +remain broken, but breakage which can be fixed in this package _should_ be +fixed. + +nfssext-cfr interferes with kernel code in various ways. This is nothing new. +nfssext rewrote kernel definitions. nfssext-cfr rewrote kernel definitions. +The new version of nfssext-cfr rewrites kernel definitions. Details of what is +done under what conditions are included in the documentation. + +================================================= +## Code Repositories +================================================= + +Code for the LaTeX support package is hosted at + https://codeberg.org/cfr/nfssext +For convenience, the repository is mirrored at + https://github.com/cfr42/nfssext + +================================================= +## Contact Details +================================================= + +Bug reports, feature requests etc. concerning the LaTeX support or packaging +should be filed at + https://codeberg.org/cfr/nfssext/issues + + +Clea F. Rees +Version 1.0 +2024-09-18 + +================================================= +vim: et:tw=80:sw=2: diff --git a/Master/texmf-dist/doc/latex/nfssext-cfr/manifest.txt b/Master/texmf-dist/doc/latex/nfssext-cfr/manifest.txt new file mode 100644 index 00000000000..6d7b8ab324f --- /dev/null +++ b/Master/texmf-dist/doc/latex/nfssext-cfr/manifest.txt @@ -0,0 +1,71 @@ +# Manifest for nfssext-cfr + +Copyright (C) 2008-2024 Clea F. Rees + +This work may be distributed and/or modified under the conditions of the LaTeX +Project Public License, either version 1.3c of this license or (at your option) +any later version. The latest version of this license is in + https://www.latex-project.org/lppl.txt +and version 1.3 or later is part of all distributions of LaTeX version +2008-05-04 or later. + +This work has the LPPL maintenance status `maintained'. + +The Current Maintainer of this work is Clea F. Rees. + +This work consists of all files listed in manifest.txt. + +This file was automatically generated by `l3build manifest`. + +## Source files + + +### Package files + + +* manifest.txt +* README.md +* nfssext-cfr.dtx +* nfssext-cfr.ins + +### Development files + + +* build.lua +* manifest.lua +* tag.lua +* ot1cmrw.fd +* ot1cmrj.fd +* ot1cmr2j.fd +* ot1cmr1.fd +* ot1cmr0.fd +* ot1cmr-mod.fd +* ot1cmr2.fd +* ot1cmr2dj.fd +* nfssext-cfr-t1-fam.tlg +* nfssext-cfr-t1-series.tlg +* nfssext-cfr-t1-shape.tlg +* nfssext-cfr-t1.dtx +* nfssext-cfr-t1.ins + + +## Derived files + + +### Package files + +* nfssext-cfr-nfss.sty +* nfssext-cfr-nnfss.sty +* nfssext-cfr.sty + +### Development files + +* nfssext-cfr-t1-fam.lvt +* nfssext-cfr-t1-series.lvt +* nfssext-cfr-t1-shape.lvt +* nfssext-cfr-t1-splitter.lvt +* nfssext-cfr-t1-splitter.lve + +### Typeset documentation + +* nfssext-cfr.pdf diff --git a/Master/texmf-dist/doc/latex/nfssext-cfr/nfssext-cfr.pdf b/Master/texmf-dist/doc/latex/nfssext-cfr/nfssext-cfr.pdf Binary files differindex 42380dd2241..50889614464 100644 --- a/Master/texmf-dist/doc/latex/nfssext-cfr/nfssext-cfr.pdf +++ b/Master/texmf-dist/doc/latex/nfssext-cfr/nfssext-cfr.pdf diff --git a/Master/texmf-dist/doc/latex/nfssext-cfr/nfssext-cfr.tex b/Master/texmf-dist/doc/latex/nfssext-cfr/nfssext-cfr.tex deleted file mode 100644 index 8cf5a6c788f..00000000000 --- a/Master/texmf-dist/doc/latex/nfssext-cfr/nfssext-cfr.tex +++ /dev/null @@ -1,196 +0,0 @@ -% !TEX TS-program = pdflatex -% !TEX encoding = UTF-8 Unicode -% arara: pdflatex: { synctex: true } -\pdfminorversion=7 -\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{cfr-lm} -\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{2017/03/28} - - -\begin{document} - -\maketitle - -\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. -I have no reason to think it will avoid any of the others. - -The code is somewhat experimental. -It works for me. -So far. -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. -Insofar as one person can test something, I figure that 5 years ought to be enough to pick up the most obvious problems. -However, your kilometres may, as always, vary. - -There should be no changes for the end user except that in certain cases it is possible that line-breaks may be altered if \pkg{microtype} is in use due to the enhanced support included for variant font families. - -\end{document} |