diff options
author | Karl Berry <karl@freefriends.org> | 2009-11-27 18:53:34 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2009-11-27 18:53:34 +0000 |
commit | b2ca732dee27faa563c88f7bbb49f0b86f76d4ed (patch) | |
tree | cfb6d63ffddbc61149bd840522fb57304943b4f9 /Master/texmf-dist/tex/latex/ltxmisc | |
parent | 4e77d990cd9e623c9db4b4bd9a8a0fff579057b8 (diff) |
separate relsize into its own package
git-svn-id: svn://tug.org/texlive/trunk@16203 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/tex/latex/ltxmisc')
-rw-r--r-- | Master/texmf-dist/tex/latex/ltxmisc/relsize.sty | 393 |
1 files changed, 0 insertions, 393 deletions
diff --git a/Master/texmf-dist/tex/latex/ltxmisc/relsize.sty b/Master/texmf-dist/tex/latex/ltxmisc/relsize.sty deleted file mode 100644 index febbf0ac7a8..00000000000 --- a/Master/texmf-dist/tex/latex/ltxmisc/relsize.sty +++ /dev/null @@ -1,393 +0,0 @@ -% relsize.sty 3.1 July 4, 2003 -% This software is contributed to the public domain. - -% LaTex2e version by Donald Arseneau <asnd@triumf.ca> and -% Matt Swift <swift@bu.edu>. -% Original LaTex2.09 smaller.sty author: Bernie Cosell <cosell@WILMA.BBN.COM> -% -% Setting the font size relative to the current size -% -% commands are: -% \relsize{n} where n gives the number of steps ("mag-step" = factor of 1.2) -% to change the size by; n = 3 changes from \normalsize to -% \LARGE size. Negative n selects smaller fonts. -% \smaller == \relsize{-1} -% \larger == \relsize{1} -% \textsmaller{text}, \textlarger{text} - versions that take an argument -% -% \relscale{f} is equivalent to \relsize, but instead of scale-steps, -% the parameter is a scale factor, such as .75 -% \textscale{f}{text} -% -% The font-size command nearest the requested size will be used, and if -% the size error is more than \RSpercentTolerance, then the size will -% be adjusted more precisely. (The default empty \RSpercentTolerance -% signals automatic handling, choosing the tolerance based on the -% font declarations.) -% -% \mathsmaller{A}, \mathlarger{B} - math versions -% (The math versions are entirely different from the text versions.) -% -% There are more instructions at the end of this file (after \endinput). - -\ProvidesPackage{relsize}[2003/07/04 ver 3.1] - -% The next two aren't the real initializations! The real ones are done -% in \@tempb below. The user can change them afterwards. - -\def\RSsmallest{999pt} -\def\RSlargest{1pt} - -% First, right now, we assemble a list of the font sizes - -\def\rs@size{\noexpand\rs@size\noexpand} -\def\rs@fontsizes{} -\def\@tempa#1{\ifx\@undefined#1\else - \expandafter\@tempb#1\delimiter{#1}\fi} -\def\@absVal#1{\ifnum#1<\z@-\fi#1} -% parse definition of font-size command (like \large) -% #1 = \@setfontsize #2 = the command (\large) #3 = size #4 = rest -\def\@tempb#1#2#3#4\delimiter#5{% - \@tempdimb\z@ - \ifx\@setfontsize#1\relax\ifx#5#2\@firstofone\relax - \afterassignment\strip@prefix \@tempdimb #3pt>% - \fi\fi - \ifdim\@tempdimb=\z@ - \def\rs@fontsizes{}% - \let\@tempa\@gobble - \else - \edef\rs@fontsizes{\rs@fontsizes\rs@size#2{\the\@tempdimb}}% - \ifdim\@tempdimb<\RSsmallest \edef\RSsmallest{\the\@tempdimb}\fi - \ifdim\@tempdimb>\RSlargest \edef\RSlargest{\the\@tempdimb}\fi - \fi} - -% examine each (expected) pre-defined font size -\@tempa\normalsize -\@tempa\small -\@tempa\footnotesize -\@tempa\large -\@tempa\Large -\@tempa\LARGE -\@tempa\scriptsize -\@tempa\tiny -\@tempa\huge -\@tempa\Huge -\@tempa\HUGE % moresize.sty -\@tempa\ssmall - -\ifx\rs@fontsizes\@empty % ---------------------------------------------- - -\PackageWarning{relsize}{Failed to get list of font sizes.\MessageBreak - Falling back to old definition.} - -\DeclareRobustCommand\relsize[1]{% -\ifmmode \@nomath\relsize\else - \begingroup - \@tempcnta % assign number representing current font size - \ifx\@currsize\normalsize 4\else % funny order is to have most ... - \ifx\@currsize\small 3\else % ...likely sizes checked first - \ifx\@currsize\footnotesize 2\else - \ifx\@currsize\large 5\else - \ifx\@currsize\Large 6\else - \ifx\@currsize\LARGE 7\else - \ifx\@currsize\scriptsize 1\else - \ifx\@currsize\tiny 0\else - \ifx\@currsize\huge 8\else - \ifx\@currsize\Huge 9\else - 4\rs@unknown@warning % unknown state: \normalsize as starting point - \fi\fi\fi\fi\fi\fi\fi\fi\fi\fi -% Change the number by the given increment: - \advance\@tempcnta#1\relax -% watch out for size underflow: - \ifnum\@tempcnta<\z@ \rs@size@warning{small}{\string\tiny}\@tempcnta\z@ \fi - \expandafter\endgroup - \ifcase\@tempcnta % set new size based on altered number - \tiny \or \scriptsize \or \footnotesize \or \small \or \normalsize \or - \large \or \Large \or \LARGE \or \huge \or \Huge \else - \rs@size@warning{large}{\string\Huge}\Huge -\fi\fi} - -\else % ---------------------------------------------- - -\DeclareRobustCommand\relsize[1]{% -\ifmmode \@nomath\relsize\else - \begingroup - % number of demi-magsteps -> \@tempcnta - \@tempdima#1\p@ \@tempdima2.0002\@tempdima \divide\@tempdima\p@ - \@tempcnta\@tempdima - % \message{^^JChange \the\@tempcnta\space half-magsteps from \f@size. }% - % calculate desired target size -> \@tempdimb - \@tempdimb\f@size\p@ - \ifnum\@tempcnta<\z@ - \def\@tempa{.912871}\@tempcnta=-\@tempcnta - \else - \def\@tempa{1.09545}% - \fi - \@whilenum {\@tempcnta>\z@}\do {% - \advance\@tempcnta\m@ne - \@tempdimb\@tempa\@tempdimb}% - % \message{ target size \the\@tempdimb. }% - \rs@scaleToB -\fi} - -\DeclareRobustCommand\relscale[1]{% -\ifmmode \@nomath\relscale\else - \begingroup - \@tempdimb\f@size\p@ \@tempdimb#1\@tempdimb - \rs@scaleToB -\fi} - -\DeclareRobustCommand\textscale[2]{\leavevmode - \begingroup\relscale{#1}#2\endgroup} - -% Change font size to \@tempdimb. Follows from \relsize or \relscale -\def\rs@scaleToB{% - % perform automatic tolerance adjustment, if requested - \ifx\RSpercentTolerance\@empty \rs@autoTol \fi - % apply limits - \ifdim\@tempdimb<\RSsmallest \@tempdimb=\RSsmallest - \rs@size@warning{small}{\RSsmallest}\fi - \ifdim\@tempdimb>\RSlargest \@tempdimb=\RSlargest - \rs@size@warning{large}{\RSlargest}\fi - % look up that size in list of pre-defined sizes. Puts error of - % closest match in \@tempdima - \let\@tempa\relax \@tempdima\maxdimen - \let\rs@size\rs@lookup \rs@fontsizes - % \message{ Look up best as \expandafter\string\@tempa\space - % (off by \the\@tempdima}% - % See how close match was (abs difference -> \@tempdima) - \ifdim\@tempdima<\z@ \@tempdima-\@tempdima\fi - % ... percentage error in \@tempdima (as a count) - \@tempdima 100\@tempdima \divide\@tempdima\@tempdimb - % if error is beyond tolerance, append \fontsize adjustment - % \message{ or \number\@tempdima \expandafter\@gobble\string\%). }% - \ifnum\@tempdima>\RSpercentTolerance - % \message{ adjust size to \strip@pt\@tempdimb. }% - \@tempdima1.2\@tempdimb % baselineskip - \edef\@tempa{\expandafter\noexpand\@tempa \noexpand\fontsize - {\strip@pt\@tempdimb}{\strip@pt\@tempdima}\noexpand\selectfont}\fi - % Now execute size-change command \@tempa - \expandafter\endgroup\@tempa} - -% For each defined font size, compare its actual size to the desired -% size (\@tempdimb) and the error of the best previous match (\@tempdima). -% Record this command (\@tempa) if it is closer. -\def\rs@lookup#1#2{% #1=command #2=size - \begingroup - \advance\@tempdimb-#2\relax - \ifdim\@absVal\@tempdimb<\@absVal\@tempdima % improvement - \endgroup - \def\@tempa{#1}% - \@tempdima#2\relax \advance\@tempdima-\@tempdimb - \else - \endgroup - \fi} - -\fi % ---------------------------------------------- - - -% Tolerance for size mis-match (%). The empty definition triggers -% automatic selection: 5 for scalable fonts, 30 otherwise. - -\def\RSpercentTolerance{} - -\def\rs@autoTol{% - \expandafter\expandafter\expandafter\rs@autoTOL - \expandafter\meaning - \csname\f@encoding/\f@family/\f@series/\f@shape\endcsname-\delimiter -} -\def\rs@autoTOL#1>#2-#3\delimiter{% - \ifx\delimiter#3\delimiter % no - - \def\RSpercentTolerance{30}% - \else % font size def has -, assume it covers continuum - \def\RSpercentTolerance{5}% - \fi - % \message{ Automatic tolerance is \RSpercentTolerance. }% -} - -% Warning messages - -\newcommand\rs@size@warning[2]{\PackageWarning{relsize}{% - Size requested is too #1.\MessageBreak Using #2 instead}} - -\newcommand\rs@unknown@warning{\PackageWarning{relsize}{Current font size - is unknown! (Why?!?)\MessageBreak Assuming \string\normalsize}} - -% derived commands - -\DeclareRobustCommand\larger[1][\@ne]{\relsize{+#1}} -\DeclareRobustCommand\smaller[1][\@ne]{\relsize{-#1}} -\DeclareRobustCommand\textlarger[2][\@ne]{{\relsize{+#1}#2}} -\DeclareRobustCommand\textsmaller[2][\@ne]{{\relsize{-#1}#2}} - -% math commands (completely different) - -\DeclareRobustCommand\mathsmaller[1]{\bgroup - \let\rs@makechoice\rs@makesmallerchoice - \def\rs@mathatom{#1}% - \futurelet\@tempa\rs@collect@decor -} -\DeclareRobustCommand\mathlarger[1]{\bgroup - \let\rs@makechoice\rs@makelargerchoice - \def\rs@mathatom{#1}% - \futurelet\@tempa\rs@collect@decor -} - -% math so far is in \rs@mathatom; next tok is \@tempa; continuation is \@tempb -% Don't nest \ifs because token may be \if or \fi or \or... -\def\rs@collect@decor{% - \let\@tempb\rs@makechoice - \ifx\@tempa\limits \let\@tempb\rs@collect@one@decor \fi - \ifx\@tempa\displaylimits \let\@tempb\rs@collect@one@decor \fi - \ifx\@tempa\nolimits \let\@tempb\rs@collect@one@decor \fi - \if\noexpand\@tempa^\let\@tempb\rs@collect@two@decor \fi - \if\noexpand\@tempa_\let\@tempb\rs@collect@two@decor \fi - \ifx\@tempa\sp \let\@tempb\rs@collect@two@decor \fi - \ifx\@tempa\sb \let\@tempb\rs@collect@two@decor \fi - \@tempb} -\def\rs@collect@one@decor#1{% - \expandafter\def\expandafter\rs@mathatom\expandafter{\rs@mathatom#1}% - \futurelet\@tempa\rs@collect@decor} -\def\rs@collect@two@decor#1#2{\expandafter - \def\expandafter\rs@mathatom\expandafter{\rs@mathatom#1{\rs@sstyle{#2}}}% - \futurelet\@tempa\rs@collect@decor} -\let\rs@sstyle\@firstofone - -\def\rs@makesmallerchoice{\mathchoice - {\textstyle \let\rs@sstyle\scriptstyle \rs@mathatom}% - {\scriptstyle \let\rs@sstyle\scriptstyle \rs@mathatom}% - {\scriptscriptstyle \let\rs@sstyle\scriptscriptstyle \rs@mathatom}% - {\scriptscriptstyle \let\rs@sstyle\scriptscriptstyle \rs@mathatom}% - \egroup} -\def\rs@makelargerchoice{\mathchoice - {\protected@edef\rs@sstyle##1{% - \protect\set@fontsize {1}{\f@size}{\f@baselineskip}\protect\selectfont - \hbox{$\scriptstyle ##1\m@th$}}% - \mbox{\larger$\displaystyle\rs@mathatom\m@th$}}% - {\displaystyle \let\rs@sstyle\scriptstyle \rs@mathatom}% - {\textstyle \let\rs@sstyle\scriptscriptstyle \rs@mathatom}% - {\scriptstyle \let\rs@sstyle\scriptscriptstyle \rs@mathatom}% - \egroup} - -\endinput -========================================================== - -R E L S I Z E . S T Y ver 3.1 July 4, 2003 - -by Donald Arseneau, asnd@triumf.ca, Vancouver, Canada -origianally based on smaller.sty by Bernie Cosell, cosell@WILMA.BBN.COM, -and combined with the version by Matt Swift, swift@bu.edu. - - -It is frequently the case that something should be typeset somewhat larger -or smaller than the surrounding text, whatever that size happens to be. -Specifying such sizing commands explicitly makes it difficult to modify the -font sizes of a document at a later time, and makes it hard to write macros -that work at arbitrary sizes. Relsize.sty defines several commands for LaTeX -to set font sizes relative to the current size. - -To refresh your memory, the font sizing commands in LaTeX are, in order: -\tiny, \scriptsize, \footnotesize, \small, \normalsize, \large, \Large, -\LARGE, \huge, \Huge (package moresize adds \ssmall and \HUGE). The main -new command provided by relsize.sty is \relsize, which takes one (positive -or negative) number as its argument; the number specifies how many "steps" -by which to change the font size, where each step is a scaling factor of -1.2, corresponding to the usual difference between the size commands. For -example, if "{\relsize{-2} smaller}" appears in normal sized text, the word -"smaller" is printed in script size type. If the same command appears in a -\Large section title, then "smaller" is printed in normal size. - -There are also the commands \larger and \smaller, which normally change the -font size by one step in the obvious direction; \larger is an abbreviation -for \relsize{+1}, and \smaller is an abbreviation for \relsize{-1}. For -example, {\large... \larger{WOW!}} prints "WOW" in \Large type. You can -also specify bigger steps as an optional argument for \larger and \smaller: -\larger[3] is equivalent to \relsize{3}; \smaller[2] is \relsize{-2}. -Both \larger and \smaller accept negative arguments, but please don't make -things so obscure! If you want to change size by several steps it is -much better to give an increment than to string several \larger commands -together; i.e., \relsize{3} or \larger[3], but not \larger\larger\larger. - -All of the \relsize, \larger, and \smaller commands are "switches" just -like the regular sizing commands. That is, they change the size for all -following text until the scope is ended by a closing brace. There are -alternate versions called \textlarger and \textsmaller that take some text -as an argument and apply the size change to only that text: -\textlarger{big}. - -Using the number of "magnification steps" to indicate font size can -be confusing to some people, and limiting in certain uses. There are -commands with syntax \textscale{factor}{text} and \relscale{factor} to -select the size based on a scale factor, like {0.75}. - -If the size requested is too small or too large, a warning is given, and -the size will only change as far as appropriate, typically \tiny or \Huge. -These limits are controlled by the commands \RSsmallest and \RSlargest, which -get set automatically when relsize.sty is loaded, but you can redefine them -to other length values: \renewcommand\RSlargest{50pt}. - -Fine point: The combination \relsize{n}\relsize{-n} is not guaranteed to -restore the current font size! That is because the increment "n" may be -enough to overflow the range of sizes. Say you are in \huge text already, -and you do \relsize{4}. There is nothing bigger than \Huge so that is the -size you get. Then an ensuing \relsize{-4} will take four steps smaller -and change the size to \large. You should use grouping to undo relative -size changes because it is unsafe to counteract one change with an "equal" -change in the opposite direction. - -Typically, the font-size commands do not select fonts at regular size -intervals. \relsize (and the others) will select, and execute, the command -for the size closest to the desired size. Then, if the relative difference -from the target size is more than \RSpercentTolerance a further font-size -selection is made. By default, \RSpercentTolerance is an empty macro, which -causes automatic selection: "30" (30%) when the current "fontshape" definition -is composed of only discrete sizes, and "5" when the fontshape definition -covers ranges of sizes. The higher setting for discrete fonts ensures -only the pre-defined sizes get used. (By default LaTeX uses Computer -Modern fonts at discrete sizes; you get full coverage of sizes by using -\usepackage{type1cm}.) For special uses, or when the font shape definitions -are not parsed properly, you can redefine the percent tolerance: -\renewcommand\RSpercentTolerance{10}. - -All of the commands described above are text commands; they cannot be used -in math mode. There are special \mathsmaller and \mathlarger commands -provided, but these do not use the same sizes that the text versions use. -Instead, they step between the usual math "styles" which you can explicitly -set using the commands \displaystyle, \textstyle, \scriptstyle, and -\scriptscriptstyle [see Lamport, LaTeX/Manual (1st ed, p.54); GMS The LaTeX -Companion, p.255]. However, the \mathlarger command will also increase the -size beyond regular \displaystyle by selecting a larger regular font size -(using \larger). (Yes, this is a kludge, and doesn't work very well, but -it can still be useful.) If you want to use this to create big integral -signs, then you must also load the package "exscale" so that math symbols -can change size. The sizes selected are: - -Current style \mathsmaller gives \mathlarger gives ---------------- ---------------------- ------------------------ -\displaystyle \textstyle (almost same) \displaystyle in a \larger font -\textstyle \scriptstyle \displaystyle (almost same) -\scriptstyle \scriptscriptstyle \textstyle -\scriptscriptstyle \scriptscriptstyle (same) \scriptstyle - -For example, try $\frac{\mathlarger{E}}{E}$. Note that, for most symbols, -\displaystyle and \textstyle are the same size, so $N \mathlarger{N}$ -gives two identical N's, but \sum and \int do get bigger in display style: -$\int\mathlarger{\int}$, and fractions are treated differently too: -$\frac{1}{2} \mathlarger{\frac{1}{2}}$. As you might have guessed, -\mathlarger and \mathsmaller should only be used in math mode. - -These commands will attempt to attach superscripts and subscripts to the -symbol as if the symbol were used alone: $\mathlarger{\int}_{0}^{\infty}$ -but math accents and the math spacing behave as if the symbol is enclosed -in braces (which it is). Comparing -\[ -| \times | {\times} | \mathlarger{\times} | \mathbin{\mathlarger{\times}} | -\] -shows that operators must be explicitly declared to use the right operator -type (\mathrel, \mathbin, \mathop) to get the correct spacing. - -Due to their oddities, the math larger/smaller commands should not be -trusted blindly, and they will not be useful in every instance. - - -Donald Arseneau asnd@triumf.ca |