Debian Codegraph @

texmf-dist/source/latex/decorule/decorule.dtx

raw
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{\&#1;}}
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