From a1c3d5afa1daf60d772eb18931e05c5397e7404c Mon Sep 17 00:00:00 2001
From: Norbert Preining <norbert@preining.info>
Date: Tue, 10 Sep 2019 03:00:50 +0000
Subject: CTAN sync 201909100300

---
 fonts/step/doc/step-fonts.tex | 67 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 67 insertions(+)
 create mode 100644 fonts/step/doc/step-fonts.tex

(limited to 'fonts/step/doc/step-fonts.tex')

diff --git a/fonts/step/doc/step-fonts.tex b/fonts/step/doc/step-fonts.tex
new file mode 100644
index 0000000000..96b15ddc83
--- /dev/null
+++ b/fonts/step/doc/step-fonts.tex
@@ -0,0 +1,67 @@
+% !TEX TS-program = pdflatex
+\documentclass[12pt]{article}
+\usepackage[utf8]{inputenc}
+\usepackage[T1]{fontenc}
+\usepackage[oldstyle]{step}
+\usepackage[letterpaper]{geometry}
+\usepackage[protrusion=true,expansion=true]{microtype}
+\usepackage[main=english]{babel}
+\usepackage{booktabs}
+\title{The STEP fonts}
+\date{Version 1.0\\September 8, 2019}
+\author{Daniel~Benjamin Miller\thanks{\texttt{dbmiller@dbmiller.org}}}
+\begin{document}
+\maketitle
+The STEP fonts are a free Times-like (i.e., Times replacement) font family, implementing a design first created for \textit{The Times} of London in 1932. These fonts are meant to be compatible in design with Adobe's digitization of Linotype Times, commonly used in publishing. Linotype's Times design is similar, but not exactly identical to Monotype's Times New Roman. STEP is an acronym which can intentionally have multiple meanings, its primary meaning is \textit{Serif Typeface for Electronic Publishing}.
+\section{History}
+The STEP fonts are based on the (original) STIX\footnote{\texttt{https://ctan.org/pkg/stix}} and XITS\footnote{\texttt{https://github.com/alif-type/xits}} fonts. The core character set came from STIX; Khaled Hosny made some improvements and fixes in XITS. Other improvements were made my myself in upstream XITS. STEP, unlike XITS, does not hold itself to the goal of strict backwards compatibility. STEP's math fonts (available in OpenType format only at present) are almost unchanged from XITS'. STEP changes vertical metrics from XITS (mostly useful for non-\TeX\ applications) to match those of Adobe's Linotype Times. Further, for text fonts, STEP supports the Type 1 format and includes support for use with \LaTeX, although more features remain available in OpenType only.
+\section{Why STEP?}
+The STEP fonts are far from the only free digitization of Times available for use with \LaTeX. It does, however, provide some features not found in other commonly-used fonts. Unlike \TeX\ Gyre Termes, it has small capitals and old-style figures which were manually drawn instead of scaled (semi-)automatically, ensuring higher quality; other Times fonts available often do not include small capitals or old-style figures at all. STEP also includes superior and inferior figures. The utmost care has been taken to ensure that all characters in STEP are of high quality.
+
+Still, STEP does not work for all situations; it does not support Greek or Cyrillic well (both are found in the OpenType versions, but missing kerning, and the Greek font in particular is suited only to mathematics and not Greek text). For Greek text, it is recommended that you use a different package; a Greek text font may be created to accompany STEP in the future. STEP's character support for certain other languages which use the Latin alphabet is also lacking, and improvements are planned for the future.
+\section{Usage with \texttt{fontspec}}
+If you do not need to use a legacy \TeX\ engine, simply use \texttt{fontspec}\footnote{\texttt{https://ctan.org/pkg/fontspec}} as follows:
+\begin{verbatim}
+\usepackage{fontspec}
+\setmainfont{STEP}
+\end{verbatim}
+If you wish to use the math font as well, this is possible:
+\begin{verbatim}
+\usepackage{unicode-math}
+\setmathfont{STEP Math}
+\end{verbatim}
+When using \texttt{fontspec}, all font options are handled according to that package's facilities. See its documentation for details.
+\section{Usage with the \texttt{step} \LaTeX\ package}
+To use the STEP fonts in older \TeX\ engines, you may use the \LaTeX\ package \texttt{step}.
+\begin{verbatim}
+\usepackage{step}
+\end{verbatim}
+Do remember that it is usually wise to load \texttt{fontenc} with the appropriate encoding(s). The \LaTeX\ package does not include support for any math fonts; I recommend that you use STIX's math fonts instead with \texttt{\textbackslash usepackage[notext]\{stix\}}.
+\subsection{Package Options}
+\begin{tabular}{@{} ll @{}}
+\toprule
+Package Option & Feature \\
+\midrule
+\texttt{lining} & Use lining figures (default) \lining{1234567890}\\
+\texttt{oldstyle} & Use old-style figures \oldstyle{1234567890}\\
+\bottomrule
+\end{tabular}
+\subsection{Text Commands}
+\begin{tabular}{@{} ll @{}}
+\toprule
+Text Command & Feature \\
+\midrule
+\texttt{\textbackslash lining\{\}} & Use lining figures \lining{1234567890}\\
+\texttt{\textbackslash oldstyle\{\}} & Use old-style figures \oldstyle{1234567890}\\
+\texttt{\textbackslash textsc\{\}} & Use small caps (regular font only) \textsc{abcde\$\&}\\
+\texttt{\textbackslash textsu\{\}} & Use superior figures \textsu{1234567890}\\
+\texttt{\textbackslash textin\{\}} & Use inferior figures \textin{1234567890}\\
+\bottomrule
+\end{tabular}
+\section{Contributing}
+Contributions to the fonts themselves may be sent as pull requests to their GitHub repository.\footnote{\texttt{https://github.com/dbenjaminmiller/step}} Contributions to the \LaTeX\ support should be emailed directly to me for inclusion (with credit, of course).
+\section{Licensing}
+STEP is licensed under the Open Font License (OFL) version 1.1; see \texttt{STEP-COPYING} for details.
+\section{Known Issues}
+The \LaTeX\ package as of now inserts ligatures in small capitals by default even when they don't belong; e.g., \textsc{offer}. \textbackslash/ can be used to break these up for the moment (\textsc{of\/fer}). A fix is planned for the next release.
+\end{document}
\ No newline at end of file
-- 
cgit v1.2.3

