summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/sansmath
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-04-26 00:19:50 +0000
committerKarl Berry <karl@freefriends.org>2010-04-26 00:19:50 +0000
commit4b3e24f9fd2358785feef4daa64d4fdf84171f02 (patch)
treecad1e93de69f5c549bbf4ba377f0ea0198306644 /Master/texmf-dist/doc/latex/sansmath
parent0e583582a5df712714661b05da53cf99e99c3d79 (diff)
sansmath doc+own pkg (22apr10)
git-svn-id: svn://tug.org/texlive/trunk@17997 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/sansmath')
-rw-r--r--Master/texmf-dist/doc/latex/sansmath/miscdoc.sty115
-rw-r--r--Master/texmf-dist/doc/latex/sansmath/sansmath.pdfbin0 -> 185988 bytes
-rw-r--r--Master/texmf-dist/doc/latex/sansmath/sansmath.tex65
3 files changed, 180 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/sansmath/miscdoc.sty b/Master/texmf-dist/doc/latex/sansmath/miscdoc.sty
new file mode 100644
index 00000000000..6b87603c995
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/sansmath/miscdoc.sty
@@ -0,0 +1,115 @@
+\ProvidesPackage{miscdoc}[2010/01/20 v1.2 documentation macros misc latex pkgs]
+
+% miscdoc.sty
+% Copyright 2010 Robin Fairbairns
+%
+% This work may be distributed and/or modified under the
+% conditions of the LaTeX Project Public License, either version 1.3
+% of this license or (at your option) any later version.
+% The latest version of this license is in
+% http://www.latex-project.org/lppl.txt
+% and version 1.3 or later is part of all distributions of LaTeX
+% version 2005/12/01 or later.
+%
+% This work has the LPPL maintenance status `maintained'.
+%
+% The Current Maintainer of this work is Robin Fairbairns.
+%
+% This work consists of the file miscdoc.sty (only)
+
+\setcounter{errorcontextlines}{1274}
+
+% The package arose from a small exercise to document packages whose
+% previous documentation consisted solely of comments in the package files.
+% The macros here defined are lifted from the author's faq.sty
+% (written for the UK TeX FAQ, CTAN:help/uk-tex-faq) or are inspired
+% by others' work (credited where the author is known) ... except
+% where they came as a flash of inspiration while actually writing the
+% documentation.
+
+% this option suggested by Heiko Oberdiek, 2010-01-29
+\DeclareOption{hyper}{%
+ \AtEndOfPackage{%
+ \RequirePackage[pdfusetitle]{hyperref}
+ \RequirePackage{bookmark}
+ \bookmarksetup{numbered,open,openlevel=1}
+ }
+}
+\ProcessOptions\relax
+
+% note: T1 encoding assumed
+\usepackage{lmodern}
+\usepackage[T1]{fontenc}
+\usepackage{booktabs}
+
+% from faq.sty
+\newcommand\cs[1]{\texttt{\char`\\#1}}
+\let\csx\cs
+\def\bsbs{\cs{\char`\\}}
+
+% \cmdinvoke\cs<argument sequence>
+% \cs typeset as above
+% <argument sequence> may consist of optional or mandatory arguments;
+%
+% the `arguments' are simply typesett \texttt, as yet -- if something
+% fancier is needed, there's a bunch of code needs rewriting here...
+\DeclareRobustCommand\cmdinvoke{\@ifstar
+ {\let\@tempa\emph\@scmdinvoke}%
+ {\let\@tempa\relax\@scmdinvoke}%
+}
+\def\@scmdinvoke#1{\texttt{\symbol{92}#1}%
+ \futurelet\@let@token\@cmdinvoke
+}
+\def\@cmdinvoke{\ifx\@let@token\bgroup
+ \let\@tempb\@cmdinvoke@lbrace
+ \else
+ \ifx\@let@token[% ]
+ \let\@tempb\@cmdinvoke@lbrack
+ \else
+ \ifx\@let@token(% )
+ \let\@tempb\@cmdinvoke@lparen
+ \else
+ \let\@tempb\@empty
+ \fi
+ \fi
+ \fi
+ \@tempb
+}
+\def\@cmdinvoke@lbrace#1{\penalty0\hskip0pt\relax
+ \texttt{\symbol{123}\@tempa{#1}\symbol{125}}%
+ \futurelet\@let@token\@cmdinvoke
+}
+\def\@cmdinvoke@lbrack[#1]{\penalty-150\hskip0pt\relax
+ \texttt{[\@tempa{#1}]}%
+ \futurelet\@let@token\@cmdinvoke
+}
+\def\@cmdinvoke@lparen(#1){\penalty-150\hskip0pt\relax
+ \texttt{(\@tempa{#1})}%
+ \futurelet\@let@token\@cmdinvoke
+}
+% and extension -- versions that take a single extra (delimiter)
+% argument, such as \delcmdinvoke{lscrunge}( ... awful syntax, but...
+\DeclareRobustCommand\delcmdinvoke{\@ifstar
+ {\let\@tempa\emph\@sdelcmdinvoke}%
+ {\let\@tempa\relax\@sdelcmdinvoke}%
+}
+\def\@sdelcmdinvoke#1#2{\texttt{\symbol{92}#1#2}%
+ \futurelet\@let@token\@cmdinvoke
+}
+
+% sui generis
+\newcommand\newitem{\par\addvspace{1ex}\noindent}
+
+% inspired by doc.sty in latex distribution
+\newcommand\meta[1]{\ensuremath{\langle}\emph{#1}\ensuremath{\rangle}}
+
+% meaningful names, as in faq.sty
+\newcommand\environment[1]{\texttt{#1}}
+\newcommand\pkgoption[1]{\texttt{#1}}
+\newcommand\extension[1]{\texttt{.#1}}
+\newcommand\Package[1]{\textsf{#1}}
+\def\option{\@ifnextchar[\@optionb\@option}% ]
+\def\@optionb[#1]{[{\normalfont\ttfamily#1}]}
+\def\@option#1{\texttt{#1}}
+
+\let\FontName\textsf \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/sansmath/sansmath.pdf b/Master/texmf-dist/doc/latex/sansmath/sansmath.pdf
new file mode 100644
index 00000000000..0701047bc34
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/sansmath/sansmath.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/sansmath/sansmath.tex b/Master/texmf-dist/doc/latex/sansmath/sansmath.tex
new file mode 100644
index 00000000000..ce89962389e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/sansmath/sansmath.tex
@@ -0,0 +1,65 @@
+\documentclass[a4paper]{article}
+\usepackage[a4paper]{geometry}
+\usepackage{miscdoc}
+\usepackage[scaled=0.85]{luximono}
+\begin{document}
+\title{The \Package{sansmath} package}
+\author{Donald Arseneau\thanks{Documentation file assembled by Robin
+ Fairbairns}}
+\date{2003-08-13, version 1.0}
+\maketitle
+
+\section{Outline}
+The package is designed to offer sans-serif mathematics in the absence
+of proper sans maths fonts.
+
+The package's name could be misconstrued: there was an ambition to
+do the job for ``non-standard'' sans fonts (as indicated by the value
+of \cs{sfdefault}), but the only good results have been with Computer
+Modern and \FontName{cmss}.
+
+\section{Use}
+
+After \cmdinvoke{usepackage}{sansmath}, a new ``math version''
+\texttt{sans} is defined, together with a command \cs{sansmath}, which
+behaves as \cs{boldmath} does.
+
+There is also a command \cs{unsansmath} (which does what you might
+imagine), but if maths are to be sans-serif for a limited area of
+document, it is better to limit it to a local group, for example by
+\cmdinvoke{begin}{sansmath} \texttt{\dots} \cmdinvoke{end}{sansmath}
+
+Within the scope of the \cs{sansmath} declaration, maths characters
+will be taken from the text sans-serif family as much as possible.
+The actual sans fonts are OT1 encodings of those indicated by the
+meaning of \cs{sfdefault} \emph{WHEN THE PACKAGE WAS LOADED}, not the
+meaning at each maths environment!
+
+Since the \texttt{OT1} text fonts do not provide the lower-case greek letters,
+there is a package option \option[eulergreek] to take the lowercase
+greek from the Euler maths fonts.
+
+Since some (many) sans fonts have no uppercase greek letters either
+(missing characters from the \texttt{OT1} encoding), there is an
+option \option[EULERGREEK] to take \emph{all} greek letters from the
+euler fonts. In this case one should also investigate using
+\FontName{Euler} fonts for \emph{all maths} in the document, using
+package \Package{euler} instead of this one!
+
+\texttt{OT1} encoding is normally required to get the uppercase greek
+letters, but if you use the \option[EULERGREEK] option or don't use
+any uppercase greek letters, then you are welcome to define
+\cs{sansmathencoding} \emph{before} loading this package. There is
+also a package option \option[T1] to perform that particuler
+definition. Note the comment above about only \FontName{cmss} being
+good~--- even the \texttt{T1}-encoded \FontName{ec} fonts are poor
+substitutes.
+
+The package achieves maths-italic by reloading the slanted version of
+the text sans-serif font, and changing a \texttt{fontdimen} parameter
+(spaceskip). This causes the italic correction to be applied between
+letters (good) but does not break up the `fi' and `fl' ligatures
+(bad). (Why does a sans font have these ligatures anyway?) As yet,
+nothing is done about this bug.
+
+\end{document}