| 1 |
% \iffalse meta-comment |
| 2 |
% |
| 3 |
% Transformed from decorule.xml by ClassPack db2dtx.xsl |
| 4 |
% version 1.19 (2020-05-19) on Thursday 21 May 2020 at 11:04:52 |
| 5 |
% |
| 6 |
% decorule.dtx is copyright © 2010-2020 by Peter Flynn <[email protected]> |
| 7 |
% |
| 8 |
% This work may be distributed and/or modified under the |
| 9 |
% conditions of the LaTeX Project Public License, either |
| 10 |
% version 1.3 of this license or (at your option) any later |
| 11 |
% version. The latest version of this license is in: |
| 12 |
% |
| 13 |
% http://www.latex-project.org/lppl.txt |
| 14 |
% |
| 15 |
% and version 1.3 or later is part of all distributions of |
| 16 |
% LaTeX version 2005/12/01 or later. |
| 17 |
% |
| 18 |
% This work has the LPPL maintenance status ‘maintained’. |
| 19 |
% |
| 20 |
% The current maintainer of this work is Peter Flynn <[email protected]> |
| 21 |
% |
| 22 |
% This work consists of the files decorule.dtx and decorule.ins, |
| 23 |
% the derived file , |
| 24 |
% and any other ancillary files listed in the MANIFEST. |
| 25 |
% |
| 26 |
% \fi |
| 27 |
% \iffalse |
| 28 |
%<package>\NeedsTeXFormat{LaTeX2e}[2009/09/24] |
| 29 |
%<package>\ProvidesPackage{decorule}[2020/04/01 v0.7 |
| 30 |
%<package> A decorative swelled rule for LaTeX] |
| 31 |
%<*driver> |
| 32 |
\RequirePackage{fix-cm}% included by default. |
| 33 |
\PassOptionsToPackage{svgnames}{xcolor}% xcolor/dox/hyperref implied |
| 34 |
\documentclass[12pt]{ltxdoc} |
| 35 |
%% |
| 36 |
%% Packages added for documentation |
| 37 |
%% |
| 38 |
\usepackage{dox}% used by default. (0)% |
| 39 |
\makeatletter |
| 40 |
\doxitem[idxtype=attribute]{Attribute}{CPK@attribute}{attributes} |
| 41 |
\makeatother |
| 42 |
\makeatletter |
| 43 |
\doxitem[idxtype=attributevalue]{AttributeValue}{CPK@attributevalue}{attribute values} |
| 44 |
\makeatother |
| 45 |
\makeatletter |
| 46 |
\doxitem[idxtype=class]{Class}{CPK@class}{classes} |
| 47 |
\makeatother |
| 48 |
\makeatletter |
| 49 |
\doxitem[idxtype=colour]{Colour}{CPK@colour}{colours} |
| 50 |
\makeatother |
| 51 |
\makeatletter |
| 52 |
\doxitem[idxtype=counter]{Counter}{CPK@counter}{counters} |
| 53 |
\makeatother |
| 54 |
\makeatletter |
| 55 |
\doxitem[idxtype=DTD]{DTD}{CPK@dtd}{DTDs/Schemas} |
| 56 |
\makeatother |
| 57 |
\makeatletter |
| 58 |
\doxitem[idxtype=element]{Element}{CPK@element}{element types} |
| 59 |
\makeatother |
| 60 |
\makeatletter |
| 61 |
\doxitem[idxtype=entity]{Entity}{CPK@entity}{entities} |
| 62 |
\makeatother |
| 63 |
\makeatletter |
| 64 |
\doxitem[idxtype=error]{Error}{CPK@error}{errors} |
| 65 |
\makeatother |
| 66 |
\makeatletter |
| 67 |
\doxitem[idxtype=field]{Field}{CPK@field}{fields} |
| 68 |
\makeatother |
| 69 |
\makeatletter |
| 70 |
\doxitem[idxtype=file]{File}{CPK@file}{files} |
| 71 |
\makeatother |
| 72 |
\makeatletter |
| 73 |
\doxitem[idxtype=font]{Font}{CPK@font}{fonts} |
| 74 |
\makeatother |
| 75 |
\makeatletter |
| 76 |
\doxitem[idxtype=function]{Function}{CPK@function}{functions} |
| 77 |
\makeatother |
| 78 |
\makeatletter |
| 79 |
\doxitem[idxtype=language]{Language}{CPK@language}{languages} |
| 80 |
\makeatother |
| 81 |
\makeatletter |
| 82 |
\doxitem[macrolike,idxtype=length]{Length}{CPK@length}{lengths} |
| 83 |
\makeatother |
| 84 |
\makeatletter |
| 85 |
\doxitem[idxtype=mode]{Mode}{CPK@mode}{modes} |
| 86 |
\makeatother |
| 87 |
\makeatletter |
| 88 |
\doxitem[idxtype=option]{Option}{CPK@option}{options} |
| 89 |
\makeatother |
| 90 |
\makeatletter |
| 91 |
\doxitem[idxtype=package]{Package}{CPK@package}{packages} |
| 92 |
\makeatother |
| 93 |
\makeatletter |
| 94 |
\doxitem[idxtype=variable]{Variable}{CPK@variable}{variables} |
| 95 |
\makeatother |
| 96 |
\makeatletter |
| 97 |
\doxitem[idxtype=parameter]{Parameter}{CPK@parameter}{parameters} |
| 98 |
\makeatother |
| 99 |
\makeatletter |
| 100 |
\doxitem[macrolike,idxtype=switch]{Switch}{CPK@switch}{switches} |
| 101 |
\makeatother |
| 102 |
\makeatletter |
| 103 |
\doxitem[idxtype=template]{Template}{CPK@template}{templates} |
| 104 |
\makeatother |
| 105 |
\makeatletter |
| 106 |
\doxitem[idxtype=typeface]{Typeface}{CPK@typeface}{typefaces} |
| 107 |
\makeatother |
| 108 |
\makeatletter |
| 109 |
\doxitem[macrolike,idxtype=box]{Box}{CPK@box}{boxes} |
| 110 |
\makeatother |
| 111 |
\newcommand{\LabelFont}[2][\relax]{\strut |
| 112 |
{\fontencoding\encodingdefault |
| 113 |
\fontfamily{lmtt}\fontseries{lc}#1\selectfont#2}\space} |
| 114 |
\makeatletter |
| 115 |
\let\CPK@macro\macro\let\CPK@endmacro\endmacro |
| 116 |
\makeatother |
| 117 |
\makeatletter |
| 118 |
\let\CPK@environment\environment\let\CPK@endenvironment\endenvironment |
| 119 |
\makeatother |
| 120 |
\makeatletter |
| 121 |
\def\PrintAttributeName#1{\LabelFont{@#1}} |
| 122 |
\makeatother |
| 123 |
\def\PrintAttributeValueName#1{\LabelFont{"#1"}} |
| 124 |
\def\PrintClassName#1{\LabelFont[\fontfamily{lmss}]{#1}} |
| 125 |
\def\PrintColourName#1{\LabelFont[\color{#1}]{#1}} |
| 126 |
\def\PrintCounterName#1{\LabelFont{#1}} |
| 127 |
\def\PrintDTDName#1{\LabelFont{#1}} |
| 128 |
\def\PrintElementName#1{\LabelFont{<#1>}} |
| 129 |
\def\PrintEntityName#1{\LabelFont{\}} |
| 130 |
\def\PrintEnvironmentName#1{\LabelFont[\fontfamily{lmss}]{#1}} |
| 131 |
\def\PrintErrorName#1{\LabelFont[\color{Red}!]{#1}} |
| 132 |
\def\PrintFunctionName#1{\LabelFont[\bfseries\itshape]{#1}} |
| 133 |
\def\PrintLanguageName#1{\LabelFont{#1}} |
| 134 |
\def\PrintLengthName#1{\LabelFont{#1}} |
| 135 |
\def\PrintMacroName#1{\LabelFont{#1}} |
| 136 |
\def\PrintModeName#1{\LabelFont[\sffamily]{\textlangle#1\textrangle}} |
| 137 |
\def\PrintOptionName#1{\LabelFont[\bfseries]{#1}} |
| 138 |
\def\PrintPackageName#1{\LabelFont[\fontfamily{lmss}]{#1}} |
| 139 |
\def\PrintSwitchName#1{\LabelFont{#1}} |
| 140 |
\def\PrintTemplateName#1{\LabelFont[\bfseries]{#1}} |
| 141 |
\def\PrintVariableName#1{\LabelFont[\ttfamily]{#1}} |
| 142 |
\def\PrintParameterName#1{\LabelFont[\ttfamily]{#1}} |
| 143 |
\def\PrintFieldName#1{\LabelFont[\ttfamily]{#1}} |
| 144 |
\usepackage[T1]{fontenc}% used by default. (3)% |
| 145 |
\let\SavedShow\show |
| 146 |
\let\SavedShow\show |
| 147 |
\usepackage[utf8]{inputenc}[2008/03/30]% requested by author (6)% |
| 148 |
\usepackage{mflogo}% used by default. (35)% |
| 149 |
\usepackage[british]{babel}% used by default. (40)% |
| 150 |
\usepackage[backend=biber,doi=true, |
| 151 |
isbn=true,url=true,uniquename=false,style=apa]{biblatex}% bibliography/@arch=biblatex detected. (41)% |
| 152 |
\makeatletter |
| 153 |
\AtBeginDocument{% |
| 154 |
\setlength{\bibitemsep}{1ex}% |
| 155 |
\setlength{\bibnamesep}{1.5\itemsep}% |
| 156 |
\defbibheading{shortbib}[References]% |
| 157 |
{\section{#1}}} |
| 158 |
\@ifpackagewith{babel}{british}{% |
| 159 |
\DeclareLanguageMapping{british}% |
| 160 |
{british-apa}}{\relax} |
| 161 |
\makeatother |
| 162 |
\makeatletter |
| 163 |
\providetoggle{blx@skipbiblist} |
| 164 |
\makeatother |
| 165 |
\usepackage{csquotes}% bibliography/@arch=biblatex detected. (43)% |
| 166 |
\usepackage{array}% use of 'tgroup' detected (46)% |
| 167 |
\usepackage{calc}% used by default. (49)% |
| 168 |
\makeatletter |
| 169 |
{\scriptsize |
| 170 |
\global\advance\@totalleftmargin by1em |
| 171 |
\global\advance\MacroIndent by.5em} |
| 172 |
\makeatother |
| 173 |
\usepackage{ccaption}% used by default. (52)% |
| 174 |
\captionnamefont{\bfseries} |
| 175 |
\captionstyle{\raggedright} |
| 176 |
\usepackage[inline]{enumitem}% use of 'variablelist' detected (56)% |
| 177 |
\setlist[description]{style=unboxed} |
| 178 |
\setlist[itemize]{leftmargin=2em} |
| 179 |
\setlist[enumerate]{leftmargin=2em} |
| 180 |
\newlist{inlineenum}{enumerate*}{1} |
| 181 |
\setlist[inlineenum,1]{label=\emph{\alph*}), |
| 182 |
itemjoin={{; }},itemjoin*={{; and }}} |
| 183 |
\usepackage{fancybox}% use of 'note' detected (57)% |
| 184 |
\usepackage{fancyvrb}% use of 'bibliography' detected (60)% |
| 185 |
\usepackage{relsize}% use of 'acronym' detected (64)% |
| 186 |
\usepackage{textcase}% used by default. (67)% |
| 187 |
\usepackage{float}% used by default. (69)% |
| 188 |
\renewcommand{\topfraction}{.85} |
| 189 |
\renewcommand{\bottomfraction}{.7} |
| 190 |
\renewcommand{\textfraction}{.15} |
| 191 |
\renewcommand{\floatpagefraction}{.66} |
| 192 |
\renewcommand{\dbltopfraction}{.66} |
| 193 |
\renewcommand{\dblfloatpagefraction}{.66} |
| 194 |
\setcounter{topnumber}{9} |
| 195 |
\setcounter{bottomnumber}{9} |
| 196 |
\setcounter{totalnumber}{20} |
| 197 |
\setcounter{dbltopnumber}{9} |
| 198 |
\usepackage[a4paper,left=30mm,top=25mm, |
| 199 |
textwidth=150mm,textheight=225mm,headheight=15pt]{geometry}% used by default. (71)% |
| 200 |
\usepackage{listings}% use of 'programlisting' detected (83)% |
| 201 |
\lstdefinelanguage{dummy} |
| 202 |
{morekeywords={dummy}} |
| 203 |
\lstdefinelanguage{Makefile} |
| 204 |
{otherkeywords={.PHONY,.DEFAULT},% |
| 205 |
morekeywords={PHONY,DEFAULT,shell,ifeq,else,endif},% |
| 206 |
keywordsprefix={.},% |
| 207 |
moredelim=[l][\color{Green}]{:},% |
| 208 |
morecomment=[l]{\#},% |
| 209 |
moredelim=[s][\color{Blue}]{\$(}{)}% |
| 210 |
} |
| 211 |
\lstdefinelanguage{DocBook}[]{XML} |
| 212 |
{morekeywords={abstract,address,affiliation,annotation,arg, |
| 213 |
author,book,chapter,classname,cmdsynopsis,command, |
| 214 |
constraintdef,contrib,copyright,cover,date,email,emphasis, |
| 215 |
envar,filename,firstname,footnote,guibutton,guilabel, |
| 216 |
guimenu,guimenuitem,guisubmenu,holder,info,itemizedlist, |
| 217 |
listitem,literal,member,option,orderedlist,orgdiv,orgname, |
| 218 |
package,para,parameter,part,personname,phrase,procedure, |
| 219 |
productname,programlisting,quote,refsection,remark, |
| 220 |
constructorsynopsis,methodparan,modifier,funcparams,olink, |
| 221 |
bibliography,biblioentry,biblioset,subtitle,artpagenums, |
| 222 |
volumenum,issuenum,DOCTYPE,SYSTEM,xml:id,releaseinfo, |
| 223 |
replaceable,revdescription,revhistory,revision,sect1,sect2, |
| 224 |
sect3,sect4,seg,seglistitem,segmentedlist,segtitle, |
| 225 |
simplelist,step,surname,systemitem,tag,term,title,uri, |
| 226 |
userinput,variablelist,varlistentry,wordasword,xref,year, |
| 227 |
xlink:href}} |
| 228 |
|
| 229 |
\makeatletter |
| 230 |
\lstdefinelanguage{bash} |
| 231 |
{morestring=[s]{[]},morekeywords={exit,logout,yes,no,@, |
| 232 |
password,ssh,URL,cd,dvips,latex,ls,makeindex,man,mkdir, |
| 233 |
pdflatex,sudo,texconfig,texdoc,updmap,xelatex,biber, |
| 234 |
latexmk,bibtex}} |
| 235 |
|
| 236 |
\makeatother |
| 237 |
\lstdefinelanguage{APA}[]{XML} |
| 238 |
{morekeywords={TTL}} |
| 239 |
|
| 240 |
\lstdefinelanguage{OOXML}[]{XML} |
| 241 |
{morekeywords={w:p,w:pPr,w:pStyle,w:rPr,w:rFonts, |
| 242 |
w:r,w:t,w:lang}} |
| 243 |
|
| 244 |
\lstdefinelanguage{SGML}[]{XML} |
| 245 |
{morekeywords={sec,ttl}} |
| 246 |
|
| 247 |
\lstdefinelanguage{DTD}[]{XML} |
| 248 |
{morekeywords={ELEMENT,ENTITY,ATTLIST,CDATA,ID,REQUIRED, |
| 249 |
IMPLIED,PCDATA}} |
| 250 |
|
| 251 |
\lstdefinelanguage{Runoff} |
| 252 |
{morekeywords={h1}} |
| 253 |
|
| 254 |
\lstdefinelanguage{GML} |
| 255 |
{morekeywords={h1}} |
| 256 |
|
| 257 |
\lstdefinelanguage{Scribe} |
| 258 |
{morekeywords={Heading},morestring=[s]{[]}} |
| 259 |
|
| 260 |
\lstdefinelanguage{RTF}[]{TeX} |
| 261 |
{moretexcs={rtf,ansi,deff,adeflang,fonttbl,f,froman,fprq, |
| 262 |
fcharset,f1,fswiss,falt,fnil,colortbl,red,green,blue, |
| 263 |
stylesheet,s,snext,nowidctlpar,hyphen,hyphlead,hyphtrail, |
| 264 |
hyphmax,cf,kerning,dbch,af,langfe,afs,alang,loch,fs, |
| 265 |
pgndec,pard,plain,qc,sb,sa,keepn,b,ab,rtlch,ltrch,par}} |
| 266 |
|
| 267 |
\lstdefinelanguage{TEI}[]{XML} |
| 268 |
{morekeywords={TEI,TEI.2,teiHeader,fileDesc,sourceDesc, |
| 269 |
titleStmt,title,author,editor,respStmt,resp,name, |
| 270 |
editionStmt,edition,text,body,publicationStmt,publisher, |
| 271 |
div,div1,placeName,lg,l,s,cl,phr,w,list,distinct,p,pb, |
| 272 |
mls,div2,head,num,val,app,lem,rdg,q,sup,uncl,note, |
| 273 |
DOCTYPE,SYSTEM,xml:id}}[keywords,comments,strings] |
| 274 |
|
| 275 |
\lstdefinelanguage{XSLT2}[]{XML} |
| 276 |
{morekeywords={xsl:stylesheet,xsl:transform, |
| 277 |
xsl:apply-imports,xsl:attribute-set,xsl:decimal-format, |
| 278 |
xsl:import,xsl:include,xsl:key,xsl:namespace-alias, |
| 279 |
xsl:output,xsl:param, |
| 280 |
xsl:preserve-space,xsl:strip-space,xsl:template, |
| 281 |
xsl:variable,xsl:character-map,xsl:function, |
| 282 |
xsl:import-schema,xsl:param,xsl:variable, |
| 283 |
xsl:apply-imports,xsl:apply-templates,xsl:attribute, |
| 284 |
xsl:call-template,xsl:choose,xsl:comment,xsl:copy, |
| 285 |
xsl:copy-of,xsl:element,xsl:fallback,xsl:for-each, |
| 286 |
xsl:if,xsl:message,xsl:number,xsl:otherwise, |
| 287 |
xsl:processing-instruction,xsl:text,xsl:value-of, |
| 288 |
xsl:variable,xsl:when,xsl:with-param,xsl:sort, |
| 289 |
xsl:for-each-group,xsl:next-match,xsl:analyze-string, |
| 290 |
xsl:namespace,xsl:result-document,xsl:copy, |
| 291 |
xsl:fallback,xsl:document,xsl:sequence, |
| 292 |
xsl:matching-substring,xsl:non-matching-substring, |
| 293 |
xsl:perform-sort,xsl:output-character}, |
| 294 |
alsodigit={-}} |
| 295 |
|
| 296 |
\lstdefinelanguage{LaTeXe}[LaTeX]{TeX} |
| 297 |
{morekeywords = {selectlanguage,foreignlanguage, |
| 298 |
textbrokenbar,textlangle,textrangle,subsection,url, |
| 299 |
chapter,tableofcontents,part,subsubsection,paragraph, |
| 300 |
subparagraph,maketitle,setlength,listoffigures, |
| 301 |
listoftables,color,arraybackslash,includegraphics, |
| 302 |
textcite,parencite,graphicspath,lstinline, |
| 303 |
DeclareLanguageMapping,textcolor,definecolor,colorbox, |
| 304 |
fcolorbox,RequirePackage,PassOptionsToPackage}} |
| 305 |
|
| 306 |
\lstdefinelanguage{BIBTeX}{ |
| 307 |
morekeywords = {title,author,edition,publisher,year, |
| 308 |
address}, |
| 309 |
morestring=[b]", |
| 310 |
} |
| 311 |
|
| 312 |
\lstdefinelanguage{Email}{ |
| 313 |
morekeywords={From,Subject,To,Date}, |
| 314 |
} |
| 315 |
|
| 316 |
\lstset{defaultdialect=LaTeXe,frame=single, |
| 317 |
framesep=.5em,backgroundcolor=\color{AliceBlue}, |
| 318 |
rulecolor=\color{LightSteelBlue},framerule=1pt} |
| 319 |
|
| 320 |
\lstloadlanguages{LaTeXe,DocBook,XML,XSLT2,bash} |
| 321 |
\lstdefinelanguage{XMLFRAG}{tag=**[s]<>}[html] |
| 322 |
\lstnewenvironment{listingsdoc} |
| 323 |
{\lstset{language={[LaTeX]TeX}}} |
| 324 |
{} |
| 325 |
\newcommand\basicdefault[1]{\footnotesize |
| 326 |
\color{Black}\ttfamily#1} |
| 327 |
|
| 328 |
\lstset{basicstyle=\basicdefault{\spaceskip.5em}} |
| 329 |
\lstset{literate= |
| 330 |
{§}{{\S}}1 |
| 331 |
{©}{{\raisebox{.125ex}{\copyright}\enspace}}1 |
| 332 |
{«}{{\guillemotleft}}1 |
| 333 |
{»}{{\guillemotright}}1 |
| 334 |
{Á}{{\'A}}1 |
| 335 |
{Ä}{{\"A}}1 |
| 336 |
{É}{{\'E}}1 |
| 337 |
{Í}{{\'I}}1 |
| 338 |
{Ó}{{\'O}}1 |
| 339 |
{Ö}{{\"O}}1 |
| 340 |
{Ú}{{\'U}}1 |
| 341 |
{Ü}{{\"U}}1 |
| 342 |
{ß}{{\ss}}2 |
| 343 |
{à}{{\`a}}1 |
| 344 |
{á}{{\'a}}1 |
| 345 |
{ä}{{\"a}}1 |
| 346 |
{é}{{\'e}}1 |
| 347 |
{í}{{\'i}}1 |
| 348 |
{ó}{{\'o}}1 |
| 349 |
{ö}{{\"o}}1 |
| 350 |
{ú}{{\'u}}1 |
| 351 |
{ü}{{\"u}}1 |
| 352 |
{¹}{{\textsuperscript1}}1 |
| 353 |
{²}{{\textsuperscript2}}1 |
| 354 |
{³}{{\textsuperscript3}}1 |
| 355 |
{ı}{{\i}}1 |
| 356 |
{—}{{---}}1 |
| 357 |
{’}{{'}}1 |
| 358 |
{…}{{\dots}}1 |
| 359 |
{➝}{{$leftarrow$}}1 |
| 360 |
{⮠}{{$\hookleftarrow$}}1 |
| 361 |
{␣}{{\textvisiblespace}}1, |
| 362 |
keywordstyle=\color{DarkGreen}\bfseries, |
| 363 |
identifierstyle=\color{DarkRed}, |
| 364 |
commentstyle=\color{Gray}\upshape, |
| 365 |
stringstyle=\color{DarkBlue}\upshape, |
| 366 |
emphstyle=\color{Chocolate}\upshape, |
| 367 |
showstringspaces=false, |
| 368 |
columns=fullflexible, |
| 369 |
keepspaces=true} |
| 370 |
\usepackage{makeidx}% used by default. (85)% |
| 371 |
\makeindex |
| 372 |
\usepackage{nicefrac}% used by default. (91)% |
| 373 |
\def\textonehalf{\ensuremath{\nicefrac12}} |
| 374 |
\usepackage{parskip}% used by default. (93)% |
| 375 |
\usepackage{sectsty}% used by default. (96)% |
| 376 |
\allsectionsfont{\sffamily\raggedright} |
| 377 |
\renewcommand*{\descriptionlabel}[1]{\hspace\labelsep |
| 378 |
\sffamily\bfseries #1} |
| 379 |
\usepackage[normalem]{ulem}% use of 'link' detected (103)% |
| 380 |
\usepackage{url}% use of 'ulink' detected (104)% |
| 381 |
\AtBeginDocument{\urlstyle{tt}} |
| 382 |
\usepackage{varioref}% use of 'xref' detected (107)% |
| 383 |
\vrefwarning |
| 384 |
\labelformat{appendix}{Appendix~#1} |
| 385 |
\makeatletter |
| 386 |
\labelformat{chapter}{\@chapapp~#1} |
| 387 |
\makeatother |
| 388 |
\labelformat{section}{section~#1} |
| 389 |
\labelformat{subsection}{section~#1} |
| 390 |
\labelformat{subsubsection}{section~#1} |
| 391 |
\labelformat{paragraph}{section~#1} |
| 392 |
\labelformat{figure}{Figure~#1} |
| 393 |
\labelformat{table}{Table~#1} |
| 394 |
\labelformat{item}{item~#1} |
| 395 |
\renewcommand{\reftextcurrent}{elsewhere on this |
| 396 |
page} |
| 397 |
\def\reftextafter{on the |
| 398 |
\reftextvario{next}{following} page} |
| 399 |
\usepackage{xcolor}% used by default. (115)% |
| 400 |
\makeatletter |
| 401 |
\@ifundefined{T}{% |
| 402 |
\newcommand{\T}[2]{{\fontencoding{T1}% |
| 403 |
\selectfont#2}}}{} |
| 404 |
\makeatother |
| 405 |
\usepackage{menukeys}% use of 'guimenu' detected (118)% |
| 406 |
\renewmenumacro{\menu}[>]{roundedmenus} |
| 407 |
\renewmenumacro{\directory}[/]{hyphenatepathswithfolder} |
| 408 |
\renewmenumacro{\keys}{shadowedroundedkeys} |
| 409 |
\usepackage{classpack}[2020/05/19]% used by default. (120)% |
| 410 |
\usepackage{decorule}[2020/04/01]% added by spec |
| 411 |
\addbibresource{decorule.bib} |
| 412 |
% |
| 413 |
%% |
| 414 |
%% Settings for docstrip and ltxdoc |
| 415 |
%% |
| 416 |
\EnableCrossrefs |
| 417 |
\CodelineIndex |
| 418 |
\RecordChanges |
| 419 |
\begin{document} |
| 420 |
\DocInput{decorule.dtx} |
| 421 |
\end{document} |
| 422 |
%</driver> |
| 423 |
% \fi |
| 424 |
% |
| 425 |
% \CheckSum{145} |
| 426 |
% |
| 427 |
% \CharacterTable |
| 428 |
% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z |
| 429 |
% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z |
| 430 |
% Digits \0\1\2\3\4\5\6\7\8\9 |
| 431 |
% Exclamation \! Double quote \" Hash (number) \# |
| 432 |
% Dollar \$ Percent \% Ampersand \& |
| 433 |
% Acute accent \' Left paren \( Right paren \) |
| 434 |
% Asterisk \* Plus \+ Comma \, |
| 435 |
% Minus \- Point \. Solidus \/ |
| 436 |
% Colon \: Semicolon \; Less than \< |
| 437 |
% Equals \= Greater than \> Question mark \? |
| 438 |
% Commercial at \@ Left bracket \[ Backslash \\ |
| 439 |
% Right bracket \] Circumflex \^ Underscore \_ |
| 440 |
% Grave accent \` Left brace \{ Vertical bar \| |
| 441 |
% Right brace \} Tilde \~} |
| 442 |
% |
| 443 |
% \changes{v0.7}{2020/04/01}{Regression release: 1) Updated to use ClassPack 1.19; 2) Switched all conformance attributes on revision dates to YYYY-MM-DD; 3) The jump in versions is because the previously submitted version was misnumbered as 0.6 when it should have been 0.06. Thanks to Erik Braun at CTAN for spotting this..} |
| 444 |
% \changes{v0.34}{2020/04/01}{Regression release: 1) Recreated package with latest version (1.18) of ClassPack; 2) Fixed bug in using the angle counter that was preventing \XeLaTeX{} generating output.} |
| 445 |
% \changes{v0.33}{2019/03/03}{Regression release: Recreated package with latest version (1.13) of ClassPack.} |
| 446 |
% \changes{v0.32}{2017/01/10}{Regression release: Recreated package with latest version (1.06) of ClassPack.} |
| 447 |
% \changes{v0.31}{2017/02/10}{Regression release: Recreated package with latest version (1.04) of ClassPack.} |
| 448 |
% \changes{v0.30}{2016/06/19}{Regression release: Recreated package with latest version (1.01) of ClassPack.} |
| 449 |
% \changes{v0.29}{2016/05/10}{Regenerated: Recreated package with new classpack code to create zip file to the CTAN standard.} |
| 450 |
% \changes{v0.28}{2014/04/01}{Maintenance release: Added PNG image for conversion to EPUB3.} |
| 451 |
% \changes{v0.27}{2013/03/27}{Maintenance release: Regression test for ClassPack v0.75 (autopackage with multifile).} |
| 452 |
% \changes{v0.26}{2013/02/23}{Internal update: Regression test for ClassPack v0.74 (autopackage).} |
| 453 |
% \changes{v0.25}{2012/06/15}{Internal update: Reworded final paragraph of documentation since the package is now available on CTAN. Removed palatino..} |
| 454 |
% \changes{v0.24}{2012/03/23}{Internal update: Updated header, replaced docmfp with dox package, checked conformance with latest version of classpack, added packages calc, listings, and palatino.} |
| 455 |
% \changes{v0.23}{2011/08/15}{Maintenance release: Updated documentation with docmfp, varioref, and geometry.} |
| 456 |
% \changes{v0.22}{2011/06/13}{Bugs fixed on first release: 1) Added missing packages (graphicx and fix-cm); 2) Removed bogus change record from .sty file.} |
| 457 |
% \changes{v0.21}{2011/06/11}{Revised for .dtx file: 1) Rewrote documentation; 2) Generated .dtx.} |
| 458 |
% \changes{v0.20}{2010/07/14}{Updated to package format: Wrote .dtx file by hand.} |
| 459 |
% \changes{v0.11}{2010/03/20}{Written for TUGboat: Developed by hand.} |
| 460 |
% |
| 461 |
% \GetFileInfo{decorule.dtx} |
| 462 |
% |
| 463 |
% \DoNotIndex{\@,\@@par,\@beginparpenalty,\@empty} |
| 464 |
% \DoNotIndex{\@flushglue,\@gobble,\@input,\@makefnmark} |
| 465 |
% \DoNotIndex{\@makeother,\@maketitle,\@namedef,\@ne} |
| 466 |
% \DoNotIndex{\@spaces,\@tempa,\@tempb,\@tempswafalse} |
| 467 |
% \DoNotIndex{\@tempswatrue,\@thanks,\@thefnmark,\@topnum} |
| 468 |
% \DoNotIndex{\@@,\@elt,\@forloop,\@fortmp,\@gtempa} |
| 469 |
% \DoNotIndex{\@totalleftmargin,\",\/,\@ifundefined,\@nil} |
| 470 |
% \DoNotIndex{\@verbatim,\@vobeyspaces,\|,\~,\ ,\active} |
| 471 |
% \DoNotIndex{\advance,\aftergroup,\begingroup,\bgroup} |
| 472 |
% \DoNotIndex{\mathcal,\csname,\def,\documentstyle} |
| 473 |
% \DoNotIndex{\dospecials,\edef,\egroup,\else,\endcsname} |
| 474 |
% \DoNotIndex{\endgroup,\endinput,\endtrivlist} |
| 475 |
% \DoNotIndex{\expandafter,\fi,\fnsymbol,\futurelet,\gdef} |
| 476 |
% \DoNotIndex{\global,\hbox,\hss,\if,\if@inlabel} |
| 477 |
% \DoNotIndex{\if@tempswa,\if@twocolumn,\ifcase,\ifcat} |
| 478 |
% \DoNotIndex{\iffalse,\ifx,\ignorespaces,\index,\input} |
| 479 |
% \DoNotIndex{\item,\jobname,\kern,\leavevmode,\leftskip} |
| 480 |
% \DoNotIndex{\let,\llap,\lower,\m@ne,\next,\newpage} |
| 481 |
% \DoNotIndex{\nobreak,\noexpand,\nonfrenchspacing} |
| 482 |
% \DoNotIndex{\obeylines,\or,\protect,\raggedleft} |
| 483 |
% \DoNotIndex{\rightskip,\rm,\sc,\setbox,\setcounter} |
| 484 |
% \DoNotIndex{\small,\space,\string,\strut,\strutbox} |
| 485 |
% \DoNotIndex{\thefootnote,\thispagestyle,\topmargin} |
| 486 |
% \DoNotIndex{\trivlist,\tt,\twocolumn,\typeout,\vss,\vtop} |
| 487 |
% \DoNotIndex{\xdef,\z@,\,,\@bsphack,\@esphack,\@noligs} |
| 488 |
% \DoNotIndex{\@vobeyspaces,\@xverbatim,\`,\catcode,\end} |
| 489 |
% \DoNotIndex{\escapechar,\frenchspacing,\glossary} |
| 490 |
% \DoNotIndex{\hangindent,\hfil,\hfill,\hskip,\hspace,\ht} |
| 491 |
% \DoNotIndex{\it,\langle,\leaders,\long,\makelabel} |
| 492 |
% \DoNotIndex{\marginpar,\markboth,\mathcode,\mathsurround} |
| 493 |
% \DoNotIndex{\mbox,\newcount,\newdimen,\newskip} |
| 494 |
% \DoNotIndex{\nopagebreak,\parfillskip,\parindent} |
| 495 |
% \DoNotIndex{\parskip,\penalty,\raise,\rangle,\section} |
| 496 |
% \DoNotIndex{\setlength,\TeX,\topsep,\underline,\unskip} |
| 497 |
% \DoNotIndex{\verb,\vskip,\vspace,\widetilde,\\,\%,\@date} |
| 498 |
% \DoNotIndex{\@defpar,\[,\{,\},\],\count@,\ifnum,\loop} |
| 499 |
% \DoNotIndex{\today,\uppercase,\uccode,\baselineskip} |
| 500 |
% \DoNotIndex{\begin,\tw@,\a,\b,\c,\d,\e,\f,\g,\h,\i,\j,\k} |
| 501 |
% \DoNotIndex{\l,\m,\n,\o,\p,\q,\r,\s,\t,\u,\v,\w,\x,\y,\z} |
| 502 |
% \DoNotIndex{\A,\B,\C,\D,\E,\F,\G,\H,\I,\J,\K,\L,\M,\N,\O} |
| 503 |
% \DoNotIndex{\P,\Q,\R,\S,\T,\U,\V,\W,\X,\Y,\Z,\1,\2,\3,\4} |
| 504 |
% \DoNotIndex{\5,\6,\7,\8,\9,\0,\!,\#,\$,\&,\',\(,\)} |
| 505 |
% \DoNotIndex{\+,\.,\:,\;,\<,\=,\>,\?,\_,\discretionary} |
| 506 |
% \DoNotIndex{\immediate,\makeatletter,\makeatother} |
| 507 |
% \DoNotIndex{\meaning,\newenvironment,\par,\relax} |
| 508 |
% \DoNotIndex{\renewenvironment,\repeat,\scriptsize} |
| 509 |
% \DoNotIndex{\selectfont,\the,\undefined,\arabic,\do} |
| 510 |
% \DoNotIndex{\makeindex,\null,\number,\show,\write,\@ehc} |
| 511 |
% \DoNotIndex{\@author,\@ehc,\@ifstar,\@sanitize,\@title} |
| 512 |
% \DoNotIndex{\everypar,\if@minipage,\if@restonecol,\ifeof} |
| 513 |
% \DoNotIndex{\ifmmode,\lccode,\newtoks,\onecolumn,\openin} |
| 514 |
% \DoNotIndex{\p@,\SelfDocumenting,\settowidth} |
| 515 |
% \DoNotIndex{\@resetonecoltrue,\@resetonecolfalse,\bf} |
| 516 |
% \DoNotIndex{\clearpage,\closein,\lowercase} |
| 517 |
% \DoNotIndex{\@inlabelfalse,\selectfont,\mathcode} |
| 518 |
% \DoNotIndex{\newmathalphabet,\rmdefault,\bfdefault} |
| 519 |
% \DoNotIndex{\DeclareRobustCommand} |
| 520 |
% \DoNotIndex{\sim} |
| 521 |
% \DoNotIndex{\decorule} |
| 522 |
% \DoNotIndex{\hbox} |
| 523 |
% \DoNotIndex{\hss} |
| 524 |
% |
| 525 |
% \def\fileversion{0.7} |
| 526 |
% \def\filedate{2020/04/01} |
| 527 |
% \title{The \textsf{decorule} \LaTeXe\ package\thanks{% |
| 528 |
% This document corresponds to \textsf{decorule} |
| 529 |
% \textit{v.}\ \fileversion p, dated \filedate.} |
| 530 |
% \\[1em]\Large |
| 531 |
% A decorative swelled rule for |
| 532 |
% \LaTeX{}} |
| 533 |
% \author{Peter Flynn\\\normalsize Silmaril Consultants\\[-.25ex]\normalsize Textual Therapy Division\\\normalsize(\url{[email protected]})} |
| 534 |
% \maketitle |
| 535 |
% \renewcommand{\abstractname}{Summary}\thispagestyle{empty} |
| 536 |
% \begin{abstract} |
| 537 |
% \parskip=0.5\baselineskip |
| 538 |
% \advance\parskip by 0pt plus 2pt |
| 539 |
% \parindent=0pt% \noindent |
| 540 |
% This package implements a decorative swelled rule using |
| 541 |
% only a symbol from a font installed with all distributions of |
| 542 |
% \TeX{}, so it works independently, without the need to install |
| 543 |
% any additional software or fonts.\par |
| 544 |
% This is the packaged version of the macro which was |
| 545 |
% originally published in the `Typographers' Inn' |
| 546 |
% column in TUGboat \parencite{tb97}.\par |
| 547 |
% \end{abstract} |
| 548 |
% \clearpage |
| 549 |
% \tableofcontents |
| 550 |
% \clearpage |
| 551 |
% \section*{Latest changes} |
| 552 |
% \subsection*{v.0.7 (2020-04-01)} |
| 553 |
% \paragraph*{Regression release} |
| 554 |
% \begin{itemize} |
| 555 |
% \item Updated to use ClassPack 1.19\par |
| 556 |
% \item Switched all conformance attributes on revision |
| 557 |
% dates to YYYY-MM-DD\par |
| 558 |
% \item The jump in versions is because the previously |
| 559 |
% submitted version was misnumbered as 0.6 when it |
| 560 |
% should have been 0.06. Thanks to Erik Braun at CTAN |
| 561 |
% for spotting this.\par |
| 562 |
% \end{itemize} |
| 563 |
% \subsection*{v.0.34 (2020-04-01)} |
| 564 |
% \paragraph*{Regression release} |
| 565 |
% \begin{itemize} |
| 566 |
% \item Recreated package with latest version (1.18) of |
| 567 |
% \emph{ClassPack}\par |
| 568 |
% \item Fixed bug in using the angle counter that was |
| 569 |
% preventing \XeLaTeX{} generating output\par |
| 570 |
% \end{itemize} |
| 571 |
% \subsection*{v.0.33 (2019-03-03)} |
| 572 |
% \paragraph*{Regression release} |
| 573 |
% \begin{itemize} |
| 574 |
% \item Recreated package with latest version (1.13) of |
| 575 |
% \emph{ClassPack}\par |
| 576 |
% \end{itemize} |
| 577 |
% \subsection*{v.0.31 (2017-02-10)} |
| 578 |
% \paragraph*{Regression release} |
| 579 |
% \begin{itemize} |
| 580 |
% \item Recreated package with latest version (1.04) of |
| 581 |
% \emph{ClassPack}\par |
| 582 |
% \end{itemize} |
| 583 |
% See p.\thinspace\pageref{} for earlier changes. |
| 584 |
% \clearpage |
| 585 |
% \section{Swelled rules} |
| 586 |
% Swelled rules were a popular device in 19th century |
| 587 |
% typesetting, and were usually done as special sorts from a |
| 588 |
% typefounder, or in some cases fabricated from combinations of |
| 589 |
% decorative brass rule cut to calculated lengths.\par |
| 590 |
% In digital systems, they can be implemented as images or |
| 591 |
% as glyphs in fonts, but are not usually extensible except by |
| 592 |
% distortion. This example is constructed programmatically so |
| 593 |
% that it could be adapted to the width it is required for (that |
| 594 |
% feature is not implemented in this version and is left as an |
| 595 |
% exercise to the user).\par |
| 596 |
% \subsection{Other work} |
| 597 |
% As discussed in the original article \parencite{tb97} there is an \textsf{swrule} package |
| 598 |
% by Tobias Dussa \parencite{dussa} which builds a |
| 599 |
% geometric lozenge from very fine lines, and there is a paper |
| 600 |
% by Steve Peter \parencite{peter} which describes |
| 601 |
% a more extensible method using \MP{} for |
| 602 |
% Con\TeX t{}.\par |
| 603 |
% \subsection{This solution} |
| 604 |
% However, it is also possible to produce one using just a |
| 605 |
% character from a font, combined with some looping in a macro |
| 606 |
% with careful positioning and kerning. This example was |
| 607 |
% constructed from the swung dash ({\ttfamily{}\textbackslash{}sim}) |
| 608 |
% character in math mode, rotated and scaled to fit in an |
| 609 |
% ascending and then descending series.\par |
| 610 |
% {\bigskip\centering{}\decorule{}\par} |
| 611 |
% \changes{v0.25}{2012/06/15}{Changed order of paragraphs and added space} |
| 612 |
% {\par\medskip{}The package is available on |
| 613 |
% {\smaller CTAN} in |
| 614 |
% \url{http://ctan.org/pkg/decorule}, and the development |
| 615 |
% files will be available at |
| 616 |
% \url{http://latex.silmaril.ie/packages} when the |
| 617 |
% \textsf{classpack} toolkit is released. |
| 618 |
% Suggestions for improving and extending this package are |
| 619 |
% welcome.\par} |
| 620 |
% \clearpage |
| 621 |
% \raggedright |
| 622 |
% \raggedright\printbibliography |
| 623 |
% \StopEventually{\label{endcode}% |
| 624 |
% \clearpage |
| 625 |
% \newgeometry{left=3cm}% |
| 626 |
% \addcontentsline{toc}{section}{Change History}% |
| 627 |
% \label{}% |
| 628 |
% \PrintChanges |
| 629 |
% \clearpage |
| 630 |
% \label{codeindex}% |
| 631 |
% \addcontentsline{toc}{section}{Index}% |
| 632 |
% \PrintIndex} |
| 633 |
% \addtolength{\CPKrevmarg}{\widthof{\LabelFont{DCR@rotate}}} |
| 634 |
% \newgeometry{left=\CPKrevmarg} |
| 635 |
% \message{Margin reset to \the\CPKrevmarg, to fit <DCR@rotate>} |
| 636 |
% \iffalse |
| 637 |
%<*package> |
| 638 |
% \fi |
| 639 |
% \clearpage |
| 640 |
% \section{Implementation} |
| 641 |
% The package consists of a single main macro {\ttfamily{}\textbackslash{}decorule}, which cycles through sizes |
| 642 |
% of the symbol from minimum to maximum, rotating and scaling |
| 643 |
% according to values preset here; and then from the maximum |
| 644 |
% back down to the minimum.\par |
| 645 |
% \subsection{Auto-initialisation}\label{:autoinit} |
| 646 |
% This section is added automatically by \textit{ClassPack} |
| 647 |
% as a preamble to all classes and style packages. |
| 648 |
% The \textsf{fixltx2e} package, which used to be included |
| 649 |
% automatically, is no longer preloaded, as its |
| 650 |
% features are now a part of the latest \LaTeXe\ kernel.\par |
| 651 |
% The code starts with identity and requirements which are |
| 652 |
% generated automatically as needed by the Doc\TeX\ system. |
| 653 |
% For details see the \textsf{ltxdoc} package documentation. |
| 654 |
% \par\smallskip |
| 655 |
% \begingroup\color{DarkRed}\tabcolsep3pt\footnotesize |
| 656 |
% \begin{tabular}{>{\refstepcounter{CodelineNo}\tiny\theCodelineNo}r@{\enspace}l} |
| 657 |
% &\verb`\NeedsTeXFormat{LaTeX2e}[2009/09/24]`\\ |
| 658 |
% &\verb`\ProvidesPackage{decorule}[2020/04/01 v0.7`\\ |
| 659 |
% &\verb` A decorative swelled rule for \LaTeX{}]` |
| 660 |
% \end{tabular}\endgroup |
| 661 |
% \setcounter{CodelineNo}{3} |
| 662 |
%\iffalse |
| 663 |
%% |
| 664 |
%% Packages required for the class or package |
| 665 |
%% |
| 666 |
% \fi |
| 667 |
% \subsection{Packages required}\label{stypackages} |
| 668 |
% \begin{CPK@package}{fix-cm} |
| 669 |
% Allow infinitely-variable font scaling. |
| 670 |
% \iffalse |
| 671 |
%% Allow infinitely-variable font scaling. |
| 672 |
% \fi |
| 673 |
% \begin{macrocode} |
| 674 |
\RequirePackage{fix-cm}% |
| 675 |
% \end{macrocode} |
| 676 |
% \end{CPK@package} |
| 677 |
% \begin{CPK@package}{graphicx} |
| 678 |
% Provide for graphics (PNG, JPG, or PDF format (only) for |
| 679 |
% pdflatex; EPS format (only) for standard \LaTeX{}). |
| 680 |
% \iffalse |
| 681 |
%% Provide for graphics (PNG, JPG, or PDF format (only) for pdflatex; EPS format (only) for standard \LaTeX{}). |
| 682 |
% \fi |
| 683 |
% \begin{macrocode} |
| 684 |
\RequirePackage{graphicx}% |
| 685 |
% \end{macrocode} |
| 686 |
% \end{CPK@package} |
| 687 |
% |
| 688 |
% \subsection{Preliminary declarations}\label{packages-here} |
| 689 |
% \iffalse |
| 690 |
%% |
| 691 |
%% ****************************************************************** |
| 692 |
%% |
| 693 |
%% Preliminary declarations |
| 694 |
% \fi |
| 695 |
% \begin{CPK@counter}{DCR@min}\label{counter--DCR@min} |
| 696 |
% Define a counter and a minimum point size to start and |
| 697 |
% end with. This value is an integer, hence a counter is |
| 698 |
% used.\par |
| 699 |
% \begin{macrocode} |
| 700 |
\newcounter{DCR@min} |
| 701 |
\setcounter{DCR@min}{1} |
| 702 |
% \end{macrocode} |
| 703 |
% \end{CPK@counter} |
| 704 |
% \begin{CPK@counter}{DCR@max}\label{counter--DCR@max} |
| 705 |
% Do the same for the maximum point size that the rule |
| 706 |
% will get to in the middle.\par |
| 707 |
% \begin{macrocode} |
| 708 |
\newcounter{DCR@max} |
| 709 |
\setcounter{DCR@max}{20} |
| 710 |
% \end{macrocode} |
| 711 |
% \end{CPK@counter} |
| 712 |
% \begin{CPK@counter}{DCR@step}\label{counter--DCR@step} |
| 713 |
% Set the step size or the increments of the glyph in |
| 714 |
% whole points.\par |
| 715 |
% \begin{macrocode} |
| 716 |
\newcounter{DCR@step} |
| 717 |
\setcounter{DCR@step}{1} |
| 718 |
% \end{macrocode} |
| 719 |
% \end{CPK@counter} |
| 720 |
% \begin{CPK@counter}{DCR@rotate}\label{counter--DCR@rotate} |
| 721 |
% Specify the amount in (whole) degrees by which we will |
| 722 |
% need to rotate the symbol to make each glyph mesh with the |
| 723 |
% previous one.\par |
| 724 |
% \begin{macrocode} |
| 725 |
\newcounter{DCR@rotate} |
| 726 |
\setcounter{DCR@rotate}{45} |
| 727 |
% \end{macrocode} |
| 728 |
% \end{CPK@counter} |
| 729 |
% \begin{CPK@counter}{DCR@size}\label{counter--DCR@size} |
| 730 |
% Define a counter to hold the current (calculated) size |
| 731 |
% as we loop through the sizes.\par |
| 732 |
% \begin{macrocode} |
| 733 |
\newcounter{DCR@size} |
| 734 |
% \end{macrocode} |
| 735 |
% \end{CPK@counter} |
| 736 |
% \begin{CPK@length}{\DCR@raise}\label{length--DCR@raise} |
| 737 |
% Define a length to hold the amount calculated at each |
| 738 |
% step to raise/lower each glyph by (because we rotate them as |
| 739 |
% we go).\par |
| 740 |
% \begin{macrocode} |
| 741 |
\newlength{\DCR@raise} |
| 742 |
% \end{macrocode} |
| 743 |
% \end{CPK@length} |
| 744 |
% \begin{CPK@length}{\DCR@skip}\label{length--DCR@skip} |
| 745 |
% Define another length to hold the amount calculated to |
| 746 |
% backspace between successive glyphs to make sure they |
| 747 |
% touch.\par |
| 748 |
% \begin{macrocode} |
| 749 |
\newlength{\DCR@skip} |
| 750 |
% \end{macrocode} |
| 751 |
% \end{CPK@length} |
| 752 |
% \begin{CPK@macro}{\DCR@symbol}\label{macro--DCR@symbol} |
| 753 |
% Lastly, define the font character to use as the glyph. |
| 754 |
% For the swelled rule we use the swung dash.\par |
| 755 |
% \begin{macrocode} |
| 756 |
\newcommand{\DCR@symbol}{\ensuremath{\sim}} |
| 757 |
% \end{macrocode} |
| 758 |
% \end{CPK@macro} |
| 759 |
% \subsection{The main macro} |
| 760 |
% \iffalse |
| 761 |
%% |
| 762 |
%% ****************************************************************** |
| 763 |
%% |
| 764 |
%% The main macro |
| 765 |
% \fi |
| 766 |
% \begin{CPK@macro}{\decorule}\label{macro--decorule} |
| 767 |
% Now we can define the macro that does the actual |
| 768 |
% work.\par |
| 769 |
% \changes{v0.21}{2011/06/06}{Rearranged spacing to suit the .dtx layout} |
| 770 |
% \begin{macrocode} |
| 771 |
\newcommand{\decorule}{% |
| 772 |
% \end{macrocode} |
| 773 |
% Start by setting the initial size to the minimum size |
| 774 |
% declared above:\par |
| 775 |
% \begin{macrocode} |
| 776 |
\begingroup\fontencoding{OT1}\fontfamily{cmr}\selectfont% |
| 777 |
\setcounter{DCR@size}{\c@DCR@min}% |
| 778 |
% \end{macrocode} |
| 779 |
% Loop through the steps up to, but not including, the |
| 780 |
% maximum size (this loop ends on line 28):\par |
| 781 |
% \begin{macrocode} |
| 782 |
\loop |
| 783 |
% \end{macrocode} |
| 784 |
% We want to raise each glyph above the baseline by half the |
| 785 |
% point size that we will use, so set the amount to the |
| 786 |
% current size and then divide by two:\par |
| 787 |
% \begin{macrocode} |
| 788 |
\setlength{\DCR@raise}{\c@DCR@size pt}% |
| 789 |
\divide\DCR@raise by2 |
| 790 |
% \end{macrocode} |
| 791 |
% Raise, rotate, and (in this case of |
| 792 |
% {\ttfamily{}\textbackslash{}sim}) reflect the glyph in a |
| 793 |
% {\ttfamily{}\textbackslash{}hbox} of its own point size, using |
| 794 |
% {\ttfamily{}\textbackslash{}hss} as |
| 795 |
% infinitely-flexible space to prevent \TeX{} squawking if |
| 796 |
% the glyph is slightly oversized:\par |
| 797 |
% \begin{macrocode} |
| 798 |
\raisebox{-\DCR@raise}{\fontsize{\c@DCR@size}{0}\selectfont |
| 799 |
\rotatebox{\the\c@DCR@rotate}{% |
| 800 |
\reflectbox{\hbox to\c@DCR@size pt{\hss\DCR@symbol\hss}}}}% |
| 801 |
% \end{macrocode} |
| 802 |
% Calculate the amount to backspace as \nicefrac23 of the |
| 803 |
% current size:\par |
| 804 |
% \begin{macrocode} |
| 805 |
\setlength{\DCR@skip}{\c@DCR@size pt}% |
| 806 |
\divide\DCR@skip by3 |
| 807 |
\multiply\DCR@skip by2 |
| 808 |
\kern-\DCR@skip |
| 809 |
% \end{macrocode} |
| 810 |
% Increment the counter and repeat:\par |
| 811 |
% \begin{macrocode} |
| 812 |
\addtocounter{DCR@size}{\c@DCR@step}% |
| 813 |
\ifnum\c@DCR@size<\c@DCR@max |
| 814 |
\repeat |
| 815 |
% \end{macrocode} |
| 816 |
% Now do the same for the sole occurrence of the maximum |
| 817 |
% size: this marks the mid-point of the rule:\par |
| 818 |
% \begin{macrocode} |
| 819 |
\setlength{\DCR@raise}{\c@DCR@max pt}% |
| 820 |
\divide\DCR@raise by2 |
| 821 |
\raisebox{-\DCR@raise}{% |
| 822 |
\fontsize{\c@DCR@max}{0}\selectfont |
| 823 |
\rotatebox{\the\c@DCR@rotate}{\reflectbox{\hbox |
| 824 |
to\c@DCR@max pt{\hss\DCR@symbol\hss}}}}% |
| 825 |
% \end{macrocode} |
| 826 |
% Start back down following the exact same pattern in |
| 827 |
% reverse, using the current size (one step less than the |
| 828 |
% maximum just used). The value has been left undisturbed |
| 829 |
% from the last loop of the outward journey. This time, |
| 830 |
% however, do the kerning \emph{before} the |
| 831 |
% glyph.\par |
| 832 |
% \begin{macrocode} |
| 833 |
\loop |
| 834 |
\setlength{\DCR@skip}{\c@DCR@size pt}% |
| 835 |
\divide\DCR@skip by3 |
| 836 |
\multiply\DCR@skip by2 |
| 837 |
\kern-\DCR@skip |
| 838 |
\setlength{\DCR@raise}{\c@DCR@size pt}% |
| 839 |
\divide\DCR@raise by2 |
| 840 |
\raisebox{-\DCR@raise}{% |
| 841 |
\fontsize{\c@DCR@size}{0}\selectfont |
| 842 |
\rotatebox{\the\c@DCR@rotate}{\reflectbox{\hbox |
| 843 |
to\c@DCR@size pt{\hss\DCR@symbol\hss}}}}% |
| 844 |
\addtocounter{DCR@size}{-\c@DCR@step}% |
| 845 |
\ifnum\c@DCR@size>\c@DCR@min |
| 846 |
\repeat |
| 847 |
% \end{macrocode} |
| 848 |
% Finally, do the minimum size:\par |
| 849 |
% \begin{macrocode} |
| 850 |
\setlength{\DCR@skip}{\c@DCR@min pt}% |
| 851 |
\divide\DCR@skip by3 |
| 852 |
\multiply\DCR@skip by2 |
| 853 |
\kern-\DCR@skip |
| 854 |
\setlength{\DCR@raise}{\c@DCR@min pt}% |
| 855 |
\divide\DCR@raise by2 |
| 856 |
\raisebox{-\DCR@raise}{% |
| 857 |
\fontsize{\c@DCR@min}{0}\selectfont |
| 858 |
\rotatebox{\the\c@DCR@rotate}{\reflectbox{\hbox |
| 859 |
to\c@DCR@min pt{\hss\DCR@symbol\hss}}}}% |
| 860 |
\endgroup} |
| 861 |
% \end{macrocode} |
| 862 |
% \end{CPK@macro} |
| 863 |
% \iffalse |
| 864 |
%</package> |
| 865 |
% \fi |
| 866 |
% \appendix |
| 867 |
% \newgeometry{left=3cm} |
| 868 |
% \clearpage |
| 869 |
% \section{The \LaTeX{} Project Public License (v\thinspace{}1.3c)}\label{LPPL} |
| 870 |
% \begin{quotation}\small\sffamily\parindent0pt |
| 871 |
% \parskip.5\baselineskip |
| 872 |
% \color{DarkBlue}\noindent |
| 873 |
% Everyone is allowed to distribute verbatim copies of this |
| 874 |
% license document, but modification of it is not allowed.\par |
| 875 |
% \end{quotation} |
| 876 |
% \subsection{Preamble}\label{Preamble} |
| 877 |
% The \LaTeX{} Project Public License ({\smaller LPPL}) |
| 878 |
% is the primary license under which the \LaTeX{} kernel and the |
| 879 |
% base \LaTeX{} packages are distributed.\par |
| 880 |
% You may use this license for any work of which you hold the |
| 881 |
% copyright and which you wish to distribute. This license may be |
| 882 |
% particularly suitable if your work is \TeX{}-related (such as a |
| 883 |
% \LaTeX{} package), but it is written in such a way that you can |
| 884 |
% use it even if your work is unrelated to \TeX{}.\par |
| 885 |
% The section “Whether and How to Distribute Works under This |
| 886 |
% License”, below, gives instructions, examples, and |
| 887 |
% recommendations for authors who are considering distributing |
| 888 |
% their works under this license.\par |
| 889 |
% This license gives conditions under which a work may be |
| 890 |
% distributed and modified, as well as conditions under which |
| 891 |
% modified versions of that work may be distributed.\par |
| 892 |
% We, the \LaTeX{3} Project, believe that the conditions below |
| 893 |
% give you the freedom to make and distribute modified versions of |
| 894 |
% your work that conform with whatever technical specifications |
| 895 |
% you wish while maintaining the availability, integrity, and |
| 896 |
% reliability of that work. If you do not see how to achieve your |
| 897 |
% goal while meeting these conditions, then read the document |
| 898 |
% {\ttfamily{}cfgguide.tex} and {\ttfamily{}modguide.tex} in the base \LaTeX{} |
| 899 |
% distribution for suggestions.\par |
| 900 |
% \subsection{Definitions}\label{Definitions} |
| 901 |
% In this license document the following terms are used:\par |
| 902 |
% \begin{description}[style=unboxed] |
| 903 |
% \item[Work\thinspace:]Any work being distributed under this License.\par |
| 904 |
% \item[Derived Work\thinspace:]Any work that under any applicable law is derived from |
| 905 |
% the Work.\par |
| 906 |
% \item[Modification\thinspace:]Any procedure that produces a Derived Work under any |
| 907 |
% applicable law~--- for example, the production of a file |
| 908 |
% containing an original file associated with the Work or a |
| 909 |
% significant portion of such a file, either verbatim or |
| 910 |
% with modifications and/or translated into another |
| 911 |
% language.\par |
| 912 |
% \item[Modify\thinspace:]To apply any procedure that produces a Derived Work |
| 913 |
% under any applicable law.\par |
| 914 |
% \item[Distribution\thinspace:]Making copies of the Work available from one person to |
| 915 |
% another, in whole or in part. Distribution includes (but |
| 916 |
% is not limited to) making any electronic components of the |
| 917 |
% Work accessible by file transfer protocols such as |
| 918 |
% {\smaller FTP} or {\smaller HTTP} or by |
| 919 |
% shared file systems such as Sun's Network File System |
| 920 |
% ({\smaller NFS}).\par |
| 921 |
% \item[Compiled Work\thinspace:]A version of the Work that has been processed into a |
| 922 |
% form where it is directly usable on a computer system. |
| 923 |
% This processing may include using installation facilities |
| 924 |
% provided by the Work, transformations of the Work, copying |
| 925 |
% of components of the Work, or other activities. Note that |
| 926 |
% modification of any installation facilities provided by |
| 927 |
% the Work constitutes modification of the Work.\par |
| 928 |
% \item[Current Maintainer\thinspace:]A person or persons nominated as such within the Work. |
| 929 |
% If there is no such explicit nomination then it is the |
| 930 |
% `Copyright Holder' under any applicable |
| 931 |
% law.\par |
| 932 |
% \item[Base Interpreter\thinspace:]A program or process that is normally needed for |
| 933 |
% running or interpreting a part or the whole of the |
| 934 |
% Work.\par |
| 935 |
% A Base Interpreter may depend on external components |
| 936 |
% but these are not considered part of the Base Interpreter |
| 937 |
% provided that each external component clearly identifies |
| 938 |
% itself whenever it is used interactively. Unless |
| 939 |
% explicitly specified when applying the license to the |
| 940 |
% Work, the only applicable Base Interpreter is a |
| 941 |
% `\LaTeX{}-Format' or in the case of files |
| 942 |
% belonging to the `\LaTeX{}-format' a program |
| 943 |
% implementing the `\TeX{} language'.\par |
| 944 |
% \end{description} |
| 945 |
% \subsection{Conditions on Distribution and Modification}\label{Conditions} |
| 946 |
% \begin{enumerate} |
| 947 |
% \item Activities other than distribution and/or modification |
| 948 |
% of the Work are not covered by this license; they are |
| 949 |
% outside its scope. In particular, the act of running the |
| 950 |
% Work is not restricted and no requirements are made |
| 951 |
% concerning any offers of support for the Work.\par |
| 952 |
% \item \label{item-distribute}You may distribute a complete, unmodified copy of the |
| 953 |
% Work as you received it. Distribution of only part of the |
| 954 |
% Work is considered modification of the Work, and no right to |
| 955 |
% distribute such a Derived Work may be assumed under the |
| 956 |
% terms of this clause.\par |
| 957 |
% \item You may distribute a Compiled Work that has been |
| 958 |
% generated from a complete, unmodified copy of the Work as |
| 959 |
% distributed under Clause~item~\ref{item-distribute} above above, as |
| 960 |
% long as that Compiled Work is distributed in such a way that |
| 961 |
% the recipients may install the Compiled Work on their system |
| 962 |
% exactly as it would have been installed if they generated a |
| 963 |
% Compiled Work directly from the Work.\par |
| 964 |
% \item \label{item-currmaint}If you are the Current Maintainer of the Work, you may, |
| 965 |
% without restriction, modify the Work, thus creating a |
| 966 |
% Derived Work. You may also distribute the Derived Work |
| 967 |
% without restriction, including Compiled Works generated from |
| 968 |
% the Derived Work. Derived Works distributed in this manner |
| 969 |
% by the Current Maintainer are considered to be updated |
| 970 |
% versions of the Work.\par |
| 971 |
% \item If you are not the Current Maintainer of the Work, you |
| 972 |
% may modify your copy of the Work, thus creating a Derived |
| 973 |
% Work based on the Work, and compile this Derived Work, thus |
| 974 |
% creating a Compiled Work based on the Derived Work.\par |
| 975 |
% \item \label{item-conditions}If you are not the Current Maintainer of the Work, you |
| 976 |
% may distribute a Derived Work provided the following |
| 977 |
% conditions are met for every component of the Work unless |
| 978 |
% that component clearly states in the copyright notice that |
| 979 |
% it is exempt from that condition. Only the Current |
| 980 |
% Maintainer is allowed to add such statements of exemption to |
| 981 |
% a component of the Work.\par |
| 982 |
% \begin{enumerate} |
| 983 |
% \item If a component of this Derived Work can be a direct |
| 984 |
% replacement for a component of the Work when that |
| 985 |
% component is used with the Base Interpreter, then, |
| 986 |
% wherever this component of the Work identifies itself to |
| 987 |
% the user when used interactively with that Base |
| 988 |
% Interpreter, the replacement component of this Derived |
| 989 |
% Work clearly and unambiguously identifies itself as a |
| 990 |
% modified version of this component to the user when used |
| 991 |
% interactively with that Base Interpreter.\par |
| 992 |
% \item Every component of the Derived Work contains |
| 993 |
% prominent notices detailing the nature of the changes to |
| 994 |
% that component, or a prominent reference to another file |
| 995 |
% that is distributed as part of the Derived Work and that |
| 996 |
% contains a complete and accurate log of the |
| 997 |
% changes.\par |
| 998 |
% \item No information in the Derived Work implies that any |
| 999 |
% persons, including (but not limited to) the authors of |
| 1000 |
% the original version of the Work, provide any support, |
| 1001 |
% including (but not limited to) the reporting and |
| 1002 |
% handling of errors, to recipients of the Derived Work |
| 1003 |
% unless those persons have stated explicitly that they do |
| 1004 |
% provide such support for the Derived Work.\par |
| 1005 |
% \item You distribute at least one of the following with |
| 1006 |
% the Derived Work:\par |
| 1007 |
% \begin{enumerate} |
| 1008 |
% \item A complete, unmodified copy of the Work; if your |
| 1009 |
% distribution of a modified component is made by |
| 1010 |
% offering access to copy the modified component from |
| 1011 |
% a designated place, then offering equivalent access |
| 1012 |
% to copy the Work from the same or some similar place |
| 1013 |
% meets this condition, even though third parties are |
| 1014 |
% not compelled to copy the Work along with the |
| 1015 |
% modified component;\par |
| 1016 |
% \item Information that is sufficient to obtain a |
| 1017 |
% complete, unmodified copy of the Work.\par |
| 1018 |
% \end{enumerate} |
| 1019 |
% \end{enumerate} |
| 1020 |
% \item If you are not the Current Maintainer of the Work, you |
| 1021 |
% may distribute a Compiled Work generated from a Derived |
| 1022 |
% Work, as long as the Derived Work is distributed to all |
| 1023 |
% recipients of the Compiled Work, and as long as the |
| 1024 |
% conditions of Clause~item~\ref{item-conditions} above, above, are met |
| 1025 |
% with regard to the Derived Work.\par |
| 1026 |
% \item The conditions above are not intended to prohibit, and |
| 1027 |
% hence do not apply to, the modification, by any method, of |
| 1028 |
% any component so that it becomes identical to an updated |
| 1029 |
% version of that component of the Work as it is distributed |
| 1030 |
% by the Current Maintainer under Clause~item~\ref{item-currmaint} above, above.\par |
| 1031 |
% \item Distribution of the Work or any Derived Work in an |
| 1032 |
% alternative format, where the Work or that Derived Work (in |
| 1033 |
% whole or in part) is then produced by applying some process |
| 1034 |
% to that format, does not relax or nullify any sections of |
| 1035 |
% this license as they pertain to the results of applying that |
| 1036 |
% process.\par |
| 1037 |
% \item % \begin{enumerate} |
| 1038 |
% \item A Derived Work may be distributed under a different |
| 1039 |
% license provided that license itself honors the |
| 1040 |
% conditions listed in Clause~item~\ref{item-conditions} in the list on p.\thinspace\pageref{item-conditions} above, in |
| 1041 |
% regard to the Work, though it does not have to honor the |
| 1042 |
% rest of the conditions in this license.\par |
| 1043 |
% \item If a Derived Work is distributed under a different |
| 1044 |
% license, that Derived Work must provide sufficient |
| 1045 |
% documentation as part of itself to allow each recipient |
| 1046 |
% of that Derived Work to honor the restrictions in |
| 1047 |
% Clause~item~\ref{item-conditions} in the list on p.\thinspace\pageref{item-conditions} above, concerning |
| 1048 |
% changes from the Work.\par |
| 1049 |
% \end{enumerate} |
| 1050 |
% \item This license places no restrictions on works that are |
| 1051 |
% unrelated to the Work, nor does this license place any |
| 1052 |
% restrictions on aggregating such works with the Work by any |
| 1053 |
% means.\par |
| 1054 |
% \item Nothing in this license is intended to, or may be used |
| 1055 |
% to, prevent complete compliance by all parties with all |
| 1056 |
% applicable laws.\par |
| 1057 |
% \end{enumerate} |
| 1058 |
% \subsection{No Warranty}\label{Warranty} |
| 1059 |
% There is no warranty for the Work. Except when otherwise |
| 1060 |
% stated in writing, the Copyright Holder provides the Work |
| 1061 |
% `as is', without warranty of any kind, either |
| 1062 |
% expressed or implied, including, but not limited to, the implied |
| 1063 |
% warranties of merchantability and fitness for a particular |
| 1064 |
% purpose. The entire risk as to the quality and performance of |
| 1065 |
% the Work is with you. Should the Work prove defective, you |
| 1066 |
% assume the cost of all necessary servicing, repair, or |
| 1067 |
% correction.\par |
| 1068 |
% In no event unless required by applicable law or agreed to |
| 1069 |
% in writing will The Copyright Holder, or any author named in the |
| 1070 |
% components of the Work, or any other party who may distribute |
| 1071 |
% and/or modify the Work as permitted above, be liable to you for |
| 1072 |
% damages, including any general, special, incidental or |
| 1073 |
% consequential damages arising out of any use of the Work or out |
| 1074 |
% of inability to use the Work (including, but not limited to, |
| 1075 |
% loss of data, data being rendered inaccurate, or losses |
| 1076 |
% sustained by anyone as a result of any failure of the Work to |
| 1077 |
% operate with any other programs), even if the Copyright Holder |
| 1078 |
% or said author or said other party has been advised of the |
| 1079 |
% possibility of such damages.\par |
| 1080 |
% \subsection{Maintenance of The Work}\label{Maintenance} |
| 1081 |
% The Work has the status `author-maintained' |
| 1082 |
% if the Copyright Holder explicitly and prominently states near |
| 1083 |
% the primary copyright notice in the Work that the Work can only |
| 1084 |
% be maintained by the Copyright Holder or simply that it is |
| 1085 |
% `author-maintained'.\par |
| 1086 |
% The Work has the status `maintained' if there |
| 1087 |
% is a Current Maintainer who has indicated in the Work that they |
| 1088 |
% are willing to receive error reports for the Work (for example, |
| 1089 |
% by supplying a valid e-mail address). It is not required for the |
| 1090 |
% Current Maintainer to acknowledge or act upon these error |
| 1091 |
% reports.\par |
| 1092 |
% The Work changes from status `maintained' to |
| 1093 |
% `unmaintained' if there is no Current Maintainer, |
| 1094 |
% or the person stated to be Current Maintainer of the work cannot |
| 1095 |
% be reached through the indicated means of communication for a |
| 1096 |
% period of six months, and there are no other significant signs |
| 1097 |
% of active maintenance.\par |
| 1098 |
% You can become the Current Maintainer of the Work by |
| 1099 |
% agreement with any existing Current Maintainer to take over this |
| 1100 |
% role.\par |
| 1101 |
% If the Work is unmaintained, you can become the Current |
| 1102 |
% Maintainer of the Work through the following steps:\par |
| 1103 |
% \begin{enumerate} |
| 1104 |
% \item Make a reasonable attempt to trace the Current |
| 1105 |
% Maintainer (and the Copyright Holder, if the two differ) |
| 1106 |
% through the means of an Internet or similar search.\par |
| 1107 |
% \item If this search is successful, then enquire whether the |
| 1108 |
% Work is still maintained.\par |
| 1109 |
% \begin{enumerate} |
| 1110 |
% \item If it is being maintained, then ask the Current |
| 1111 |
% Maintainer to update their communication data within one |
| 1112 |
% month.\par |
| 1113 |
% \item \label{item-intention}If the search is unsuccessful or no action to resume |
| 1114 |
% active maintenance is taken by the Current Maintainer, |
| 1115 |
% then announce within the pertinent community your |
| 1116 |
% intention to take over maintenance. (If the Work is a |
| 1117 |
% \LaTeX{} work, this could be done, for example, by |
| 1118 |
% posting to \url{news:comp.text.tex}.)\par |
| 1119 |
% \end{enumerate} |
| 1120 |
% \item % \begin{enumerate} |
| 1121 |
% \item If the Current Maintainer is reachable and agrees to |
| 1122 |
% pass maintenance of the Work to you, then this takes |
| 1123 |
% effect immediately upon announcement.\par |
| 1124 |
% \item \label{item-announce}If the Current Maintainer is not reachable and the |
| 1125 |
% Copyright Holder agrees that maintenance of the Work be |
| 1126 |
% passed to you, then this takes effect immediately upon |
| 1127 |
% announcement.\par |
| 1128 |
% \end{enumerate} |
| 1129 |
% \item \label{item-change}If you make an `intention announcement' |
| 1130 |
% as described in~item~\ref{item-intention} in the list on p.\thinspace\pageref{item-intention} above and after three |
| 1131 |
% months your intention is challenged neither by the Current |
| 1132 |
% Maintainer nor by the Copyright Holder nor by other people, |
| 1133 |
% then you may arrange for the Work to be changed so as to |
| 1134 |
% name you as the (new) Current Maintainer.\par |
| 1135 |
% \item If the previously unreachable Current Maintainer becomes |
| 1136 |
% reachable once more within three months of a change |
| 1137 |
% completed under the terms of~item~\ref{item-announce} in the list on p.\thinspace\pageref{item-announce} |
| 1138 |
% or~item~\ref{item-change} above, then that |
| 1139 |
% Current |
| 1140 |
% Maintainer must become or remain the Current Maintainer upon |
| 1141 |
% request provided they then update their communication data |
| 1142 |
% within one month.\par |
| 1143 |
% \end{enumerate} |
| 1144 |
% A change in the Current Maintainer does not, of itself, |
| 1145 |
% alter the fact that the Work is distributed under the |
| 1146 |
% {\smaller LPPL} license.\par |
| 1147 |
% If you become the Current Maintainer of the Work, you should |
| 1148 |
% immediately provide, within the Work, a prominent and |
| 1149 |
% unambiguous statement of your status as Current Maintainer. You |
| 1150 |
% should also announce your new status to the same pertinent |
| 1151 |
% community as in~item~\ref{item-intention} in the list on p.\thinspace\pageref{item-intention} |
| 1152 |
% above.\par |
| 1153 |
% \subsection{Whether and How to Distribute Works under This |
| 1154 |
% License}\label{Distribute} |
| 1155 |
% This section contains important instructions, examples, and |
| 1156 |
% recommendations for authors who are considering distributing |
| 1157 |
% their works under this license. These authors are addressed as |
| 1158 |
% `you' in this section.\par |
| 1159 |
% \subsubsection{Choosing This License or Another License}\label{Choosing} |
| 1160 |
% If for any part of your work you want or need to use |
| 1161 |
% \emph{distribution} conditions that differ |
| 1162 |
% significantly from those in this license, then do not refer to |
| 1163 |
% this license anywhere in your work but, instead, distribute |
| 1164 |
% your work under a different license. You may use the text of |
| 1165 |
% this license as a model for your own license, but your license |
| 1166 |
% should not refer to the {\smaller LPPL} or otherwise |
| 1167 |
% give the impression that your work is distributed under the |
| 1168 |
% {\smaller LPPL}.\par |
| 1169 |
% The document {\ttfamily{}modguide.tex} in the base \LaTeX{} |
| 1170 |
% distribution explains the motivation behind the conditions of |
| 1171 |
% this license. It explains, for example, why distributing |
| 1172 |
% \LaTeX{} under the {\smaller GNU} General Public |
| 1173 |
% License ({\smaller GPL}) was considered inappropriate. |
| 1174 |
% Even if your work is unrelated to \LaTeX{}, the discussion in |
| 1175 |
% {\ttfamily{}modguide.tex} may still be |
| 1176 |
% relevant, and authors intending to distribute their works |
| 1177 |
% under any license are encouraged to read it.\par |
| 1178 |
% \subsubsection{A Recommendation on Modification Without |
| 1179 |
% Distribution}\label{WithoutDistribution} |
| 1180 |
% It is wise never to modify a component of the Work, even |
| 1181 |
% for your own personal use, without also meeting the above |
| 1182 |
% conditions for distributing the modified component. While you |
| 1183 |
% might intend that such modifications will never be |
| 1184 |
% distributed, often this will happen by accident~--- you may |
| 1185 |
% forget that you have modified that component; or it may not |
| 1186 |
% occur to you when allowing others to access the modified |
| 1187 |
% version that you are thus distributing it and violating the |
| 1188 |
% conditions of this license in ways that could have legal |
| 1189 |
% implications and, worse, cause problems for the community. It |
| 1190 |
% is therefore usually in your best interest to keep your copy |
| 1191 |
% of the Work identical with the public one. Many works provide |
| 1192 |
% ways to control the behavior of that work without altering any |
| 1193 |
% of its licensed components.\par |
| 1194 |
% \subsubsection{How to Use This License}\label{HowTo} |
| 1195 |
% To use this license, place in each of the components of |
| 1196 |
% your work both an explicit copyright notice including your |
| 1197 |
% name and the year the work was authored and/or last |
| 1198 |
% substantially modified. Include also a statement that the |
| 1199 |
% distribution and/or modification of that component is |
| 1200 |
% constrained by the conditions in this license.\par |
| 1201 |
% Here is an example of such a notice and statement:\par |
| 1202 |
% \iffalse |
| 1203 |
%<*ignore> |
| 1204 |
% \fi |
| 1205 |
\begin{lstlisting}[language={[LaTeX]TeX}] |
| 1206 |
%%% pig.dtx |
| 1207 |
%%% Copyright 2005 M. Y. Name |
| 1208 |
%% |
| 1209 |
%% This work may be distributed and/or modified under the |
| 1210 |
%% conditions of the LaTeX Project Public License, either version 1.3 |
| 1211 |
%% of this license or (at your option) any later version. |
| 1212 |
%% The latest version of this license is in |
| 1213 |
%% http://www.latex-project.org/lppl.txt |
| 1214 |
%% and version 1.3 or later is part of all distributions of LaTeX |
| 1215 |
%% version 2005/12/01 or later. |
| 1216 |
%% |
| 1217 |
%% This work has the LPPL maintenance status `maintained'. |
| 1218 |
%% |
| 1219 |
%% The Current Maintainer of this work is M. Y. Name. |
| 1220 |
%% |
| 1221 |
%% This work consists of the files pig.dtx and pig.ins |
| 1222 |
%% and the derived file pig.sty. |
| 1223 |
\end{lstlisting} |
| 1224 |
% \iffalse |
| 1225 |
%</ignore> |
| 1226 |
% \fi |
| 1227 |
% Given such a notice and statement in a file, the |
| 1228 |
% conditions given in this license document would apply, with |
| 1229 |
% the `Work' referring to the three files |
| 1230 |
% {\ttfamily{}pig.dtx}, {\ttfamily{}pig.ins}, and {\ttfamily{}pig.sty} (the last being generated |
| 1231 |
% from {\ttfamily{}pig.dtx} using {\ttfamily{}pig.ins}), the `Base |
| 1232 |
% Interpreter' referring to any |
| 1233 |
% `\LaTeX{}-Format', and both `Copyright |
| 1234 |
% Holder' and `Current Maintainer' |
| 1235 |
% referring to the person |
| 1236 |
% M.~Y.~Name\index{!}.\par |
| 1237 |
% If you do not want the Maintenance section of |
| 1238 |
% {\smaller LPPL} to apply to your Work, change |
| 1239 |
% `maintained' above into |
| 1240 |
% `author-maintained'. However, we recommend that |
| 1241 |
% you use `maintained' as the Maintenance |
| 1242 |
% section was added in order to ensure that your Work remains |
| 1243 |
% useful to the community even when you can no longer maintain |
| 1244 |
% and support it yourself.\par |
| 1245 |
% \subsubsection{Derived Works That Are Not Replacements}\label{NotReplacements} |
| 1246 |
% Several clauses of the {\smaller LPPL} specify |
| 1247 |
% means to provide reliability and stability for the user |
| 1248 |
% community. They therefore concern themselves with the case |
| 1249 |
% that a Derived Work is intended to be used as a (compatible or |
| 1250 |
% incompatible) replacement of the original Work. If this is not |
| 1251 |
% the case (e.g., if a few lines of code are reused for a |
| 1252 |
% completely different task), then clauses 6b and 6d shall not |
| 1253 |
% apply.\par |
| 1254 |
% \subsubsection{Important Recommendations}\label{Recommendations} |
| 1255 |
% \paragraph[Defining What Constitutes the Work]{Defining What Constitutes the Work :} |
| 1256 |
% The {\smaller LPPL} requires that distributions |
| 1257 |
% of the Work contain all the files of the Work. It is |
| 1258 |
% therefore important that you provide a way for the licensee |
| 1259 |
% to determine which files constitute the Work. This could, |
| 1260 |
% for example, be achieved by explicitly listing all the files |
| 1261 |
% of the Work near the copyright notice of each file or by |
| 1262 |
% using a line such as:\par |
| 1263 |
% \iffalse |
| 1264 |
%<*ignore> |
| 1265 |
% \fi |
| 1266 |
\begin{lstlisting}[language={[LaTeX]TeX}] |
| 1267 |
%% This work consists of all files listed in manifest.txt. |
| 1268 |
\end{lstlisting} |
| 1269 |
% \iffalse |
| 1270 |
%</ignore> |
| 1271 |
% \fi |
| 1272 |
% in that place. In the absence of an unequivocal list it |
| 1273 |
% might be impossible for the licensee to determine what is |
| 1274 |
% considered by you to comprise the Work and, in such a case, |
| 1275 |
% the licensee would be entitled to make reasonable |
| 1276 |
% conjectures as to which files comprise the Work.\par |
| 1277 |
% \Finale |
| 1278 |
|