% \iffalse meta-comment % % Transformed from decorule.xml by ClassPack db2dtx.xsl % version 1.19 (2020-05-19) on Thursday 21 May 2020 at 11:04:52 % % decorule.dtx is copyright © 2010-2020 by Peter Flynn % % This work may be distributed and/or modified under the % conditions of the LaTeX Project Public License, either % version 1.3 of this license or (at your option) any later % version. The latest version of this license is in: % % http://www.latex-project.org/lppl.txt % % and version 1.3 or later is part of all distributions of % LaTeX version 2005/12/01 or later. % % This work has the LPPL maintenance status ‘maintained’. % % The current maintainer of this work is Peter Flynn % % This work consists of the files decorule.dtx and decorule.ins, % the derived file , % and any other ancillary files listed in the MANIFEST. % % \fi % \iffalse %\NeedsTeXFormat{LaTeX2e}[2009/09/24] %\ProvidesPackage{decorule}[2020/04/01 v0.7 % A decorative swelled rule for LaTeX] %<*driver> \RequirePackage{fix-cm}% included by default. \PassOptionsToPackage{svgnames}{xcolor}% xcolor/dox/hyperref implied \documentclass[12pt]{ltxdoc} %% %% Packages added for documentation %% \usepackage{dox}% used by default. (0)% \makeatletter \doxitem[idxtype=attribute]{Attribute}{CPK@attribute}{attributes} \makeatother \makeatletter \doxitem[idxtype=attributevalue]{AttributeValue}{CPK@attributevalue}{attribute values} \makeatother \makeatletter \doxitem[idxtype=class]{Class}{CPK@class}{classes} \makeatother \makeatletter \doxitem[idxtype=colour]{Colour}{CPK@colour}{colours} \makeatother \makeatletter \doxitem[idxtype=counter]{Counter}{CPK@counter}{counters} \makeatother \makeatletter \doxitem[idxtype=DTD]{DTD}{CPK@dtd}{DTDs/Schemas} \makeatother \makeatletter \doxitem[idxtype=element]{Element}{CPK@element}{element types} \makeatother \makeatletter \doxitem[idxtype=entity]{Entity}{CPK@entity}{entities} \makeatother \makeatletter \doxitem[idxtype=error]{Error}{CPK@error}{errors} \makeatother \makeatletter \doxitem[idxtype=field]{Field}{CPK@field}{fields} \makeatother \makeatletter \doxitem[idxtype=file]{File}{CPK@file}{files} \makeatother \makeatletter \doxitem[idxtype=font]{Font}{CPK@font}{fonts} \makeatother \makeatletter \doxitem[idxtype=function]{Function}{CPK@function}{functions} \makeatother \makeatletter \doxitem[idxtype=language]{Language}{CPK@language}{languages} \makeatother \makeatletter \doxitem[macrolike,idxtype=length]{Length}{CPK@length}{lengths} \makeatother \makeatletter \doxitem[idxtype=mode]{Mode}{CPK@mode}{modes} \makeatother \makeatletter \doxitem[idxtype=option]{Option}{CPK@option}{options} \makeatother \makeatletter \doxitem[idxtype=package]{Package}{CPK@package}{packages} \makeatother \makeatletter \doxitem[idxtype=variable]{Variable}{CPK@variable}{variables} \makeatother \makeatletter \doxitem[idxtype=parameter]{Parameter}{CPK@parameter}{parameters} \makeatother \makeatletter \doxitem[macrolike,idxtype=switch]{Switch}{CPK@switch}{switches} \makeatother \makeatletter \doxitem[idxtype=template]{Template}{CPK@template}{templates} \makeatother \makeatletter \doxitem[idxtype=typeface]{Typeface}{CPK@typeface}{typefaces} \makeatother \makeatletter \doxitem[macrolike,idxtype=box]{Box}{CPK@box}{boxes} \makeatother \newcommand{\LabelFont}[2][\relax]{\strut {\fontencoding\encodingdefault \fontfamily{lmtt}\fontseries{lc}#1\selectfont#2}\space} \makeatletter \let\CPK@macro\macro\let\CPK@endmacro\endmacro \makeatother \makeatletter \let\CPK@environment\environment\let\CPK@endenvironment\endenvironment \makeatother \makeatletter \def\PrintAttributeName#1{\LabelFont{@#1}} \makeatother \def\PrintAttributeValueName#1{\LabelFont{"#1"}} \def\PrintClassName#1{\LabelFont[\fontfamily{lmss}]{#1}} \def\PrintColourName#1{\LabelFont[\color{#1}]{#1}} \def\PrintCounterName#1{\LabelFont{#1}} \def\PrintDTDName#1{\LabelFont{#1}} \def\PrintElementName#1{\LabelFont{<#1>}} \def\PrintEntityName#1{\LabelFont{\}} \def\PrintEnvironmentName#1{\LabelFont[\fontfamily{lmss}]{#1}} \def\PrintErrorName#1{\LabelFont[\color{Red}!]{#1}} \def\PrintFunctionName#1{\LabelFont[\bfseries\itshape]{#1}} \def\PrintLanguageName#1{\LabelFont{#1}} \def\PrintLengthName#1{\LabelFont{#1}} \def\PrintMacroName#1{\LabelFont{#1}} \def\PrintModeName#1{\LabelFont[\sffamily]{\textlangle#1\textrangle}} \def\PrintOptionName#1{\LabelFont[\bfseries]{#1}} \def\PrintPackageName#1{\LabelFont[\fontfamily{lmss}]{#1}} \def\PrintSwitchName#1{\LabelFont{#1}} \def\PrintTemplateName#1{\LabelFont[\bfseries]{#1}} \def\PrintVariableName#1{\LabelFont[\ttfamily]{#1}} \def\PrintParameterName#1{\LabelFont[\ttfamily]{#1}} \def\PrintFieldName#1{\LabelFont[\ttfamily]{#1}} \usepackage[T1]{fontenc}% used by default. (3)% \let\SavedShow\show \let\SavedShow\show \usepackage[utf8]{inputenc}[2008/03/30]% requested by author (6)% \usepackage{mflogo}% used by default. (35)% \usepackage[british]{babel}% used by default. (40)% \usepackage[backend=biber,doi=true, isbn=true,url=true,uniquename=false,style=apa]{biblatex}% bibliography/@arch=biblatex detected. (41)% \makeatletter \AtBeginDocument{% \setlength{\bibitemsep}{1ex}% \setlength{\bibnamesep}{1.5\itemsep}% \defbibheading{shortbib}[References]% {\section{#1}}} \@ifpackagewith{babel}{british}{% \DeclareLanguageMapping{british}% {british-apa}}{\relax} \makeatother \makeatletter \providetoggle{blx@skipbiblist} \makeatother \usepackage{csquotes}% bibliography/@arch=biblatex detected. (43)% \usepackage{array}% use of 'tgroup' detected (46)% \usepackage{calc}% used by default. (49)% \makeatletter {\scriptsize \global\advance\@totalleftmargin by1em \global\advance\MacroIndent by.5em} \makeatother \usepackage{ccaption}% used by default. (52)% \captionnamefont{\bfseries} \captionstyle{\raggedright} \usepackage[inline]{enumitem}% use of 'variablelist' detected (56)% \setlist[description]{style=unboxed} \setlist[itemize]{leftmargin=2em} \setlist[enumerate]{leftmargin=2em} \newlist{inlineenum}{enumerate*}{1} \setlist[inlineenum,1]{label=\emph{\alph*}), itemjoin={{; }},itemjoin*={{; and }}} \usepackage{fancybox}% use of 'note' detected (57)% \usepackage{fancyvrb}% use of 'bibliography' detected (60)% \usepackage{relsize}% use of 'acronym' detected (64)% \usepackage{textcase}% used by default. (67)% \usepackage{float}% used by default. (69)% \renewcommand{\topfraction}{.85} \renewcommand{\bottomfraction}{.7} \renewcommand{\textfraction}{.15} \renewcommand{\floatpagefraction}{.66} \renewcommand{\dbltopfraction}{.66} \renewcommand{\dblfloatpagefraction}{.66} \setcounter{topnumber}{9} \setcounter{bottomnumber}{9} \setcounter{totalnumber}{20} \setcounter{dbltopnumber}{9} \usepackage[a4paper,left=30mm,top=25mm, textwidth=150mm,textheight=225mm,headheight=15pt]{geometry}% used by default. (71)% \usepackage{listings}% use of 'programlisting' detected (83)% \lstdefinelanguage{dummy} {morekeywords={dummy}} \lstdefinelanguage{Makefile} {otherkeywords={.PHONY,.DEFAULT},% morekeywords={PHONY,DEFAULT,shell,ifeq,else,endif},% keywordsprefix={.},% moredelim=[l][\color{Green}]{:},% morecomment=[l]{\#},% moredelim=[s][\color{Blue}]{\$(}{)}% } \lstdefinelanguage{DocBook}[]{XML} {morekeywords={abstract,address,affiliation,annotation,arg, author,book,chapter,classname,cmdsynopsis,command, constraintdef,contrib,copyright,cover,date,email,emphasis, envar,filename,firstname,footnote,guibutton,guilabel, guimenu,guimenuitem,guisubmenu,holder,info,itemizedlist, listitem,literal,member,option,orderedlist,orgdiv,orgname, package,para,parameter,part,personname,phrase,procedure, productname,programlisting,quote,refsection,remark, constructorsynopsis,methodparan,modifier,funcparams,olink, bibliography,biblioentry,biblioset,subtitle,artpagenums, volumenum,issuenum,DOCTYPE,SYSTEM,xml:id,releaseinfo, replaceable,revdescription,revhistory,revision,sect1,sect2, sect3,sect4,seg,seglistitem,segmentedlist,segtitle, simplelist,step,surname,systemitem,tag,term,title,uri, userinput,variablelist,varlistentry,wordasword,xref,year, xlink:href}} \makeatletter \lstdefinelanguage{bash} {morestring=[s]{[]},morekeywords={exit,logout,yes,no,@, password,ssh,URL,cd,dvips,latex,ls,makeindex,man,mkdir, pdflatex,sudo,texconfig,texdoc,updmap,xelatex,biber, latexmk,bibtex}} \makeatother \lstdefinelanguage{APA}[]{XML} {morekeywords={TTL}} \lstdefinelanguage{OOXML}[]{XML} {morekeywords={w:p,w:pPr,w:pStyle,w:rPr,w:rFonts, w:r,w:t,w:lang}} \lstdefinelanguage{SGML}[]{XML} {morekeywords={sec,ttl}} \lstdefinelanguage{DTD}[]{XML} {morekeywords={ELEMENT,ENTITY,ATTLIST,CDATA,ID,REQUIRED, IMPLIED,PCDATA}} \lstdefinelanguage{Runoff} {morekeywords={h1}} \lstdefinelanguage{GML} {morekeywords={h1}} \lstdefinelanguage{Scribe} {morekeywords={Heading},morestring=[s]{[]}} \lstdefinelanguage{RTF}[]{TeX} {moretexcs={rtf,ansi,deff,adeflang,fonttbl,f,froman,fprq, fcharset,f1,fswiss,falt,fnil,colortbl,red,green,blue, stylesheet,s,snext,nowidctlpar,hyphen,hyphlead,hyphtrail, hyphmax,cf,kerning,dbch,af,langfe,afs,alang,loch,fs, pgndec,pard,plain,qc,sb,sa,keepn,b,ab,rtlch,ltrch,par}} \lstdefinelanguage{TEI}[]{XML} {morekeywords={TEI,TEI.2,teiHeader,fileDesc,sourceDesc, titleStmt,title,author,editor,respStmt,resp,name, editionStmt,edition,text,body,publicationStmt,publisher, div,div1,placeName,lg,l,s,cl,phr,w,list,distinct,p,pb, mls,div2,head,num,val,app,lem,rdg,q,sup,uncl,note, DOCTYPE,SYSTEM,xml:id}}[keywords,comments,strings] \lstdefinelanguage{XSLT2}[]{XML} {morekeywords={xsl:stylesheet,xsl:transform, xsl:apply-imports,xsl:attribute-set,xsl:decimal-format, xsl:import,xsl:include,xsl:key,xsl:namespace-alias, xsl:output,xsl:param, xsl:preserve-space,xsl:strip-space,xsl:template, xsl:variable,xsl:character-map,xsl:function, xsl:import-schema,xsl:param,xsl:variable, xsl:apply-imports,xsl:apply-templates,xsl:attribute, xsl:call-template,xsl:choose,xsl:comment,xsl:copy, xsl:copy-of,xsl:element,xsl:fallback,xsl:for-each, xsl:if,xsl:message,xsl:number,xsl:otherwise, xsl:processing-instruction,xsl:text,xsl:value-of, xsl:variable,xsl:when,xsl:with-param,xsl:sort, xsl:for-each-group,xsl:next-match,xsl:analyze-string, xsl:namespace,xsl:result-document,xsl:copy, xsl:fallback,xsl:document,xsl:sequence, xsl:matching-substring,xsl:non-matching-substring, xsl:perform-sort,xsl:output-character}, alsodigit={-}} \lstdefinelanguage{LaTeXe}[LaTeX]{TeX} {morekeywords = {selectlanguage,foreignlanguage, textbrokenbar,textlangle,textrangle,subsection,url, chapter,tableofcontents,part,subsubsection,paragraph, subparagraph,maketitle,setlength,listoffigures, listoftables,color,arraybackslash,includegraphics, textcite,parencite,graphicspath,lstinline, DeclareLanguageMapping,textcolor,definecolor,colorbox, fcolorbox,RequirePackage,PassOptionsToPackage}} \lstdefinelanguage{BIBTeX}{ morekeywords = {title,author,edition,publisher,year, address}, morestring=[b]", } \lstdefinelanguage{Email}{ morekeywords={From,Subject,To,Date}, } \lstset{defaultdialect=LaTeXe,frame=single, framesep=.5em,backgroundcolor=\color{AliceBlue}, rulecolor=\color{LightSteelBlue},framerule=1pt} \lstloadlanguages{LaTeXe,DocBook,XML,XSLT2,bash} \lstdefinelanguage{XMLFRAG}{tag=**[s]<>}[html] \lstnewenvironment{listingsdoc} {\lstset{language={[LaTeX]TeX}}} {} \newcommand\basicdefault[1]{\footnotesize \color{Black}\ttfamily#1} \lstset{basicstyle=\basicdefault{\spaceskip.5em}} \lstset{literate= {§}{{\S}}1 {©}{{\raisebox{.125ex}{\copyright}\enspace}}1 {«}{{\guillemotleft}}1 {»}{{\guillemotright}}1 {Á}{{\'A}}1 {Ä}{{\"A}}1 {É}{{\'E}}1 {Í}{{\'I}}1 {Ó}{{\'O}}1 {Ö}{{\"O}}1 {Ú}{{\'U}}1 {Ü}{{\"U}}1 {ß}{{\ss}}2 {à}{{\`a}}1 {á}{{\'a}}1 {ä}{{\"a}}1 {é}{{\'e}}1 {í}{{\'i}}1 {ó}{{\'o}}1 {ö}{{\"o}}1 {ú}{{\'u}}1 {ü}{{\"u}}1 {¹}{{\textsuperscript1}}1 {²}{{\textsuperscript2}}1 {³}{{\textsuperscript3}}1 {ı}{{\i}}1 {—}{{---}}1 {’}{{'}}1 {…}{{\dots}}1 {➝}{{$leftarrow$}}1 {⮠}{{$\hookleftarrow$}}1 {␣}{{\textvisiblespace}}1, keywordstyle=\color{DarkGreen}\bfseries, identifierstyle=\color{DarkRed}, commentstyle=\color{Gray}\upshape, stringstyle=\color{DarkBlue}\upshape, emphstyle=\color{Chocolate}\upshape, showstringspaces=false, columns=fullflexible, keepspaces=true} \usepackage{makeidx}% used by default. (85)% \makeindex \usepackage{nicefrac}% used by default. (91)% \def\textonehalf{\ensuremath{\nicefrac12}} \usepackage{parskip}% used by default. (93)% \usepackage{sectsty}% used by default. (96)% \allsectionsfont{\sffamily\raggedright} \renewcommand*{\descriptionlabel}[1]{\hspace\labelsep \sffamily\bfseries #1} \usepackage[normalem]{ulem}% use of 'link' detected (103)% \usepackage{url}% use of 'ulink' detected (104)% \AtBeginDocument{\urlstyle{tt}} \usepackage{varioref}% use of 'xref' detected (107)% \vrefwarning \labelformat{appendix}{Appendix~#1} \makeatletter \labelformat{chapter}{\@chapapp~#1} \makeatother \labelformat{section}{section~#1} \labelformat{subsection}{section~#1} \labelformat{subsubsection}{section~#1} \labelformat{paragraph}{section~#1} \labelformat{figure}{Figure~#1} \labelformat{table}{Table~#1} \labelformat{item}{item~#1} \renewcommand{\reftextcurrent}{elsewhere on this page} \def\reftextafter{on the \reftextvario{next}{following} page} \usepackage{xcolor}% used by default. (115)% \makeatletter \@ifundefined{T}{% \newcommand{\T}[2]{{\fontencoding{T1}% \selectfont#2}}}{} \makeatother \usepackage{menukeys}% use of 'guimenu' detected (118)% \renewmenumacro{\menu}[>]{roundedmenus} \renewmenumacro{\directory}[/]{hyphenatepathswithfolder} \renewmenumacro{\keys}{shadowedroundedkeys} \usepackage{classpack}[2020/05/19]% used by default. (120)% \usepackage{decorule}[2020/04/01]% added by spec \addbibresource{decorule.bib} % %% %% Settings for docstrip and ltxdoc %% \EnableCrossrefs \CodelineIndex \RecordChanges \begin{document} \DocInput{decorule.dtx} \end{document} % % \fi % % \CheckSum{145} % % \CharacterTable % {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 % 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 % Digits \0\1\2\3\4\5\6\7\8\9 % Exclamation \! Double quote \" Hash (number) \# % Dollar \$ Percent \% Ampersand \& % Acute accent \' Left paren \( Right paren \) % Asterisk \* Plus \+ Comma \, % Minus \- Point \. Solidus \/ % Colon \: Semicolon \; Less than \< % Equals \= Greater than \> Question mark \? % Commercial at \@ Left bracket \[ Backslash \\ % Right bracket \] Circumflex \^ Underscore \_ % Grave accent \` Left brace \{ Vertical bar \| % Right brace \} Tilde \~} % % \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..} % \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.} % \changes{v0.33}{2019/03/03}{Regression release: Recreated package with latest version (1.13) of ClassPack.} % \changes{v0.32}{2017/01/10}{Regression release: Recreated package with latest version (1.06) of ClassPack.} % \changes{v0.31}{2017/02/10}{Regression release: Recreated package with latest version (1.04) of ClassPack.} % \changes{v0.30}{2016/06/19}{Regression release: Recreated package with latest version (1.01) of ClassPack.} % \changes{v0.29}{2016/05/10}{Regenerated: Recreated package with new classpack code to create zip file to the CTAN standard.} % \changes{v0.28}{2014/04/01}{Maintenance release: Added PNG image for conversion to EPUB3.} % \changes{v0.27}{2013/03/27}{Maintenance release: Regression test for ClassPack v0.75 (autopackage with multifile).} % \changes{v0.26}{2013/02/23}{Internal update: Regression test for ClassPack v0.74 (autopackage).} % \changes{v0.25}{2012/06/15}{Internal update: Reworded final paragraph of documentation since the package is now available on CTAN. Removed palatino..} % \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.} % \changes{v0.23}{2011/08/15}{Maintenance release: Updated documentation with docmfp, varioref, and geometry.} % \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.} % \changes{v0.21}{2011/06/11}{Revised for .dtx file: 1) Rewrote documentation; 2) Generated .dtx.} % \changes{v0.20}{2010/07/14}{Updated to package format: Wrote .dtx file by hand.} % \changes{v0.11}{2010/03/20}{Written for TUGboat: Developed by hand.} % % \GetFileInfo{decorule.dtx} % % \DoNotIndex{\@,\@@par,\@beginparpenalty,\@empty} % \DoNotIndex{\@flushglue,\@gobble,\@input,\@makefnmark} % \DoNotIndex{\@makeother,\@maketitle,\@namedef,\@ne} % \DoNotIndex{\@spaces,\@tempa,\@tempb,\@tempswafalse} % \DoNotIndex{\@tempswatrue,\@thanks,\@thefnmark,\@topnum} % \DoNotIndex{\@@,\@elt,\@forloop,\@fortmp,\@gtempa} % \DoNotIndex{\@totalleftmargin,\",\/,\@ifundefined,\@nil} % \DoNotIndex{\@verbatim,\@vobeyspaces,\|,\~,\ ,\active} % \DoNotIndex{\advance,\aftergroup,\begingroup,\bgroup} % \DoNotIndex{\mathcal,\csname,\def,\documentstyle} % \DoNotIndex{\dospecials,\edef,\egroup,\else,\endcsname} % \DoNotIndex{\endgroup,\endinput,\endtrivlist} % \DoNotIndex{\expandafter,\fi,\fnsymbol,\futurelet,\gdef} % \DoNotIndex{\global,\hbox,\hss,\if,\if@inlabel} % \DoNotIndex{\if@tempswa,\if@twocolumn,\ifcase,\ifcat} % \DoNotIndex{\iffalse,\ifx,\ignorespaces,\index,\input} % \DoNotIndex{\item,\jobname,\kern,\leavevmode,\leftskip} % \DoNotIndex{\let,\llap,\lower,\m@ne,\next,\newpage} % \DoNotIndex{\nobreak,\noexpand,\nonfrenchspacing} % \DoNotIndex{\obeylines,\or,\protect,\raggedleft} % \DoNotIndex{\rightskip,\rm,\sc,\setbox,\setcounter} % \DoNotIndex{\small,\space,\string,\strut,\strutbox} % \DoNotIndex{\thefootnote,\thispagestyle,\topmargin} % \DoNotIndex{\trivlist,\tt,\twocolumn,\typeout,\vss,\vtop} % \DoNotIndex{\xdef,\z@,\,,\@bsphack,\@esphack,\@noligs} % \DoNotIndex{\@vobeyspaces,\@xverbatim,\`,\catcode,\end} % \DoNotIndex{\escapechar,\frenchspacing,\glossary} % \DoNotIndex{\hangindent,\hfil,\hfill,\hskip,\hspace,\ht} % \DoNotIndex{\it,\langle,\leaders,\long,\makelabel} % \DoNotIndex{\marginpar,\markboth,\mathcode,\mathsurround} % \DoNotIndex{\mbox,\newcount,\newdimen,\newskip} % \DoNotIndex{\nopagebreak,\parfillskip,\parindent} % \DoNotIndex{\parskip,\penalty,\raise,\rangle,\section} % \DoNotIndex{\setlength,\TeX,\topsep,\underline,\unskip} % \DoNotIndex{\verb,\vskip,\vspace,\widetilde,\\,\%,\@date} % \DoNotIndex{\@defpar,\[,\{,\},\],\count@,\ifnum,\loop} % \DoNotIndex{\today,\uppercase,\uccode,\baselineskip} % \DoNotIndex{\begin,\tw@,\a,\b,\c,\d,\e,\f,\g,\h,\i,\j,\k} % \DoNotIndex{\l,\m,\n,\o,\p,\q,\r,\s,\t,\u,\v,\w,\x,\y,\z} % \DoNotIndex{\A,\B,\C,\D,\E,\F,\G,\H,\I,\J,\K,\L,\M,\N,\O} % \DoNotIndex{\P,\Q,\R,\S,\T,\U,\V,\W,\X,\Y,\Z,\1,\2,\3,\4} % \DoNotIndex{\5,\6,\7,\8,\9,\0,\!,\#,\$,\&,\',\(,\)} % \DoNotIndex{\+,\.,\:,\;,\<,\=,\>,\?,\_,\discretionary} % \DoNotIndex{\immediate,\makeatletter,\makeatother} % \DoNotIndex{\meaning,\newenvironment,\par,\relax} % \DoNotIndex{\renewenvironment,\repeat,\scriptsize} % \DoNotIndex{\selectfont,\the,\undefined,\arabic,\do} % \DoNotIndex{\makeindex,\null,\number,\show,\write,\@ehc} % \DoNotIndex{\@author,\@ehc,\@ifstar,\@sanitize,\@title} % \DoNotIndex{\everypar,\if@minipage,\if@restonecol,\ifeof} % \DoNotIndex{\ifmmode,\lccode,\newtoks,\onecolumn,\openin} % \DoNotIndex{\p@,\SelfDocumenting,\settowidth} % \DoNotIndex{\@resetonecoltrue,\@resetonecolfalse,\bf} % \DoNotIndex{\clearpage,\closein,\lowercase} % \DoNotIndex{\@inlabelfalse,\selectfont,\mathcode} % \DoNotIndex{\newmathalphabet,\rmdefault,\bfdefault} % \DoNotIndex{\DeclareRobustCommand} % \DoNotIndex{\sim} % \DoNotIndex{\decorule} % \DoNotIndex{\hbox} % \DoNotIndex{\hss} % % \def\fileversion{0.7} % \def\filedate{2020/04/01} % \title{The \textsf{decorule} \LaTeXe\ package\thanks{% % This document corresponds to \textsf{decorule} % \textit{v.}\ \fileversion p, dated \filedate.} % \\[1em]\Large % A decorative swelled rule for % \LaTeX{}} % \author{Peter Flynn\\\normalsize Silmaril Consultants\\[-.25ex]\normalsize Textual Therapy Division\\\normalsize(\url{peter@silmaril.ie})} % \maketitle % \renewcommand{\abstractname}{Summary}\thispagestyle{empty} % \begin{abstract} % \parskip=0.5\baselineskip % \advance\parskip by 0pt plus 2pt % \parindent=0pt% \noindent % This package implements a decorative swelled rule using % only a symbol from a font installed with all distributions of % \TeX{}, so it works independently, without the need to install % any additional software or fonts.\par % This is the packaged version of the macro which was % originally published in the `Typographers' Inn' % column in TUGboat \parencite{tb97}.\par % \end{abstract} % \clearpage % \tableofcontents % \clearpage % \section*{Latest changes} % \subsection*{v.0.7 (2020-04-01)} % \paragraph*{Regression release} % \begin{itemize} % \item Updated to use ClassPack 1.19\par % \item Switched all conformance attributes on revision % dates to YYYY-MM-DD\par % \item 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.\par % \end{itemize} % \subsection*{v.0.34 (2020-04-01)} % \paragraph*{Regression release} % \begin{itemize} % \item Recreated package with latest version (1.18) of % \emph{ClassPack}\par % \item Fixed bug in using the angle counter that was % preventing \XeLaTeX{} generating output\par % \end{itemize} % \subsection*{v.0.33 (2019-03-03)} % \paragraph*{Regression release} % \begin{itemize} % \item Recreated package with latest version (1.13) of % \emph{ClassPack}\par % \end{itemize} % \subsection*{v.0.31 (2017-02-10)} % \paragraph*{Regression release} % \begin{itemize} % \item Recreated package with latest version (1.04) of % \emph{ClassPack}\par % \end{itemize} % See p.\thinspace\pageref{} for earlier changes. % \clearpage % \section{Swelled rules} % Swelled rules were a popular device in 19th century % typesetting, and were usually done as special sorts from a % typefounder, or in some cases fabricated from combinations of % decorative brass rule cut to calculated lengths.\par % In digital systems, they can be implemented as images or % as glyphs in fonts, but are not usually extensible except by % distortion. This example is constructed programmatically so % that it could be adapted to the width it is required for (that % feature is not implemented in this version and is left as an % exercise to the user).\par % \subsection{Other work} % As discussed in the original article \parencite{tb97} there is an \textsf{swrule} package % by Tobias Dussa \parencite{dussa} which builds a % geometric lozenge from very fine lines, and there is a paper % by Steve Peter \parencite{peter} which describes % a more extensible method using \MP{} for % Con\TeX t{}.\par % \subsection{This solution} % However, it is also possible to produce one using just a % character from a font, combined with some looping in a macro % with careful positioning and kerning. This example was % constructed from the swung dash ({\ttfamily{}\textbackslash{}sim}) % character in math mode, rotated and scaled to fit in an % ascending and then descending series.\par % {\bigskip\centering{}\decorule{}\par} % \changes{v0.25}{2012/06/15}{Changed order of paragraphs and added space} % {\par\medskip{}The package is available on % {\smaller CTAN} in % \url{http://ctan.org/pkg/decorule}, and the development % files will be available at % \url{http://latex.silmaril.ie/packages} when the % \textsf{classpack} toolkit is released. % Suggestions for improving and extending this package are % welcome.\par} % \clearpage % \raggedright % \raggedright\printbibliography % \StopEventually{\label{endcode}% % \clearpage % \newgeometry{left=3cm}% % \addcontentsline{toc}{section}{Change History}% % \label{}% % \PrintChanges % \clearpage % \label{codeindex}% % \addcontentsline{toc}{section}{Index}% % \PrintIndex} % \addtolength{\CPKrevmarg}{\widthof{\LabelFont{DCR@rotate}}} % \newgeometry{left=\CPKrevmarg} % \message{Margin reset to \the\CPKrevmarg, to fit } % \iffalse %<*package> % \fi % \clearpage % \section{Implementation} % The package consists of a single main macro {\ttfamily{}\textbackslash{}decorule}, which cycles through sizes % of the symbol from minimum to maximum, rotating and scaling % according to values preset here; and then from the maximum % back down to the minimum.\par % \subsection{Auto-initialisation}\label{:autoinit} % This section is added automatically by \textit{ClassPack} % as a preamble to all classes and style packages. % The \textsf{fixltx2e} package, which used to be included % automatically, is no longer preloaded, as its % features are now a part of the latest \LaTeXe\ kernel.\par % The code starts with identity and requirements which are % generated automatically as needed by the Doc\TeX\ system. % For details see the \textsf{ltxdoc} package documentation. % \par\smallskip % \begingroup\color{DarkRed}\tabcolsep3pt\footnotesize % \begin{tabular}{>{\refstepcounter{CodelineNo}\tiny\theCodelineNo}r@{\enspace}l} % &\verb`\NeedsTeXFormat{LaTeX2e}[2009/09/24]`\\ % &\verb`\ProvidesPackage{decorule}[2020/04/01 v0.7`\\ % &\verb` A decorative swelled rule for \LaTeX{}]` % \end{tabular}\endgroup % \setcounter{CodelineNo}{3} %\iffalse %% %% Packages required for the class or package %% % \fi % \subsection{Packages required}\label{stypackages} % \begin{CPK@package}{fix-cm} % Allow infinitely-variable font scaling. % \iffalse %% Allow infinitely-variable font scaling. % \fi % \begin{macrocode} \RequirePackage{fix-cm}% % \end{macrocode} % \end{CPK@package} % \begin{CPK@package}{graphicx} % Provide for graphics (PNG, JPG, or PDF format (only) for % pdflatex; EPS format (only) for standard \LaTeX{}). % \iffalse %% Provide for graphics (PNG, JPG, or PDF format (only) for pdflatex; EPS format (only) for standard \LaTeX{}). % \fi % \begin{macrocode} \RequirePackage{graphicx}% % \end{macrocode} % \end{CPK@package} % % \subsection{Preliminary declarations}\label{packages-here} % \iffalse %% %% ****************************************************************** %% %% Preliminary declarations % \fi % \begin{CPK@counter}{DCR@min}\label{counter--DCR@min} % Define a counter and a minimum point size to start and % end with. This value is an integer, hence a counter is % used.\par % \begin{macrocode} \newcounter{DCR@min} \setcounter{DCR@min}{1} % \end{macrocode} % \end{CPK@counter} % \begin{CPK@counter}{DCR@max}\label{counter--DCR@max} % Do the same for the maximum point size that the rule % will get to in the middle.\par % \begin{macrocode} \newcounter{DCR@max} \setcounter{DCR@max}{20} % \end{macrocode} % \end{CPK@counter} % \begin{CPK@counter}{DCR@step}\label{counter--DCR@step} % Set the step size or the increments of the glyph in % whole points.\par % \begin{macrocode} \newcounter{DCR@step} \setcounter{DCR@step}{1} % \end{macrocode} % \end{CPK@counter} % \begin{CPK@counter}{DCR@rotate}\label{counter--DCR@rotate} % Specify the amount in (whole) degrees by which we will % need to rotate the symbol to make each glyph mesh with the % previous one.\par % \begin{macrocode} \newcounter{DCR@rotate} \setcounter{DCR@rotate}{45} % \end{macrocode} % \end{CPK@counter} % \begin{CPK@counter}{DCR@size}\label{counter--DCR@size} % Define a counter to hold the current (calculated) size % as we loop through the sizes.\par % \begin{macrocode} \newcounter{DCR@size} % \end{macrocode} % \end{CPK@counter} % \begin{CPK@length}{\DCR@raise}\label{length--DCR@raise} % Define a length to hold the amount calculated at each % step to raise/lower each glyph by (because we rotate them as % we go).\par % \begin{macrocode} \newlength{\DCR@raise} % \end{macrocode} % \end{CPK@length} % \begin{CPK@length}{\DCR@skip}\label{length--DCR@skip} % Define another length to hold the amount calculated to % backspace between successive glyphs to make sure they % touch.\par % \begin{macrocode} \newlength{\DCR@skip} % \end{macrocode} % \end{CPK@length} % \begin{CPK@macro}{\DCR@symbol}\label{macro--DCR@symbol} % Lastly, define the font character to use as the glyph. % For the swelled rule we use the swung dash.\par % \begin{macrocode} \newcommand{\DCR@symbol}{\ensuremath{\sim}} % \end{macrocode} % \end{CPK@macro} % \subsection{The main macro} % \iffalse %% %% ****************************************************************** %% %% The main macro % \fi % \begin{CPK@macro}{\decorule}\label{macro--decorule} % Now we can define the macro that does the actual % work.\par % \changes{v0.21}{2011/06/06}{Rearranged spacing to suit the .dtx layout} % \begin{macrocode} \newcommand{\decorule}{% % \end{macrocode} % Start by setting the initial size to the minimum size % declared above:\par % \begin{macrocode} \begingroup\fontencoding{OT1}\fontfamily{cmr}\selectfont% \setcounter{DCR@size}{\c@DCR@min}% % \end{macrocode} % Loop through the steps up to, but not including, the % maximum size (this loop ends on line 28):\par % \begin{macrocode} \loop % \end{macrocode} % We want to raise each glyph above the baseline by half the % point size that we will use, so set the amount to the % current size and then divide by two:\par % \begin{macrocode} \setlength{\DCR@raise}{\c@DCR@size pt}% \divide\DCR@raise by2 % \end{macrocode} % Raise, rotate, and (in this case of % {\ttfamily{}\textbackslash{}sim}) reflect the glyph in a % {\ttfamily{}\textbackslash{}hbox} of its own point size, using % {\ttfamily{}\textbackslash{}hss} as % infinitely-flexible space to prevent \TeX{} squawking if % the glyph is slightly oversized:\par % \begin{macrocode} \raisebox{-\DCR@raise}{\fontsize{\c@DCR@size}{0}\selectfont \rotatebox{\the\c@DCR@rotate}{% \reflectbox{\hbox to\c@DCR@size pt{\hss\DCR@symbol\hss}}}}% % \end{macrocode} % Calculate the amount to backspace as \nicefrac23 of the % current size:\par % \begin{macrocode} \setlength{\DCR@skip}{\c@DCR@size pt}% \divide\DCR@skip by3 \multiply\DCR@skip by2 \kern-\DCR@skip % \end{macrocode} % Increment the counter and repeat:\par % \begin{macrocode} \addtocounter{DCR@size}{\c@DCR@step}% \ifnum\c@DCR@size<\c@DCR@max \repeat % \end{macrocode} % Now do the same for the sole occurrence of the maximum % size: this marks the mid-point of the rule:\par % \begin{macrocode} \setlength{\DCR@raise}{\c@DCR@max pt}% \divide\DCR@raise by2 \raisebox{-\DCR@raise}{% \fontsize{\c@DCR@max}{0}\selectfont \rotatebox{\the\c@DCR@rotate}{\reflectbox{\hbox to\c@DCR@max pt{\hss\DCR@symbol\hss}}}}% % \end{macrocode} % Start back down following the exact same pattern in % reverse, using the current size (one step less than the % maximum just used). The value has been left undisturbed % from the last loop of the outward journey. This time, % however, do the kerning \emph{before} the % glyph.\par % \begin{macrocode} \loop \setlength{\DCR@skip}{\c@DCR@size pt}% \divide\DCR@skip by3 \multiply\DCR@skip by2 \kern-\DCR@skip \setlength{\DCR@raise}{\c@DCR@size pt}% \divide\DCR@raise by2 \raisebox{-\DCR@raise}{% \fontsize{\c@DCR@size}{0}\selectfont \rotatebox{\the\c@DCR@rotate}{\reflectbox{\hbox to\c@DCR@size pt{\hss\DCR@symbol\hss}}}}% \addtocounter{DCR@size}{-\c@DCR@step}% \ifnum\c@DCR@size>\c@DCR@min \repeat % \end{macrocode} % Finally, do the minimum size:\par % \begin{macrocode} \setlength{\DCR@skip}{\c@DCR@min pt}% \divide\DCR@skip by3 \multiply\DCR@skip by2 \kern-\DCR@skip \setlength{\DCR@raise}{\c@DCR@min pt}% \divide\DCR@raise by2 \raisebox{-\DCR@raise}{% \fontsize{\c@DCR@min}{0}\selectfont \rotatebox{\the\c@DCR@rotate}{\reflectbox{\hbox to\c@DCR@min pt{\hss\DCR@symbol\hss}}}}% \endgroup} % \end{macrocode} % \end{CPK@macro} % \iffalse % % \fi % \appendix % \newgeometry{left=3cm} % \clearpage % \section{The \LaTeX{} Project Public License (v\thinspace{}1.3c)}\label{LPPL} % \begin{quotation}\small\sffamily\parindent0pt % \parskip.5\baselineskip % \color{DarkBlue}\noindent % Everyone is allowed to distribute verbatim copies of this % license document, but modification of it is not allowed.\par % \end{quotation} % \subsection{Preamble}\label{Preamble} % The \LaTeX{} Project Public License ({\smaller LPPL}) % is the primary license under which the \LaTeX{} kernel and the % base \LaTeX{} packages are distributed.\par % You may use this license for any work of which you hold the % copyright and which you wish to distribute. This license may be % particularly suitable if your work is \TeX{}-related (such as a % \LaTeX{} package), but it is written in such a way that you can % use it even if your work is unrelated to \TeX{}.\par % The section “Whether and How to Distribute Works under This % License”, below, gives instructions, examples, and % recommendations for authors who are considering distributing % their works under this license.\par % This license gives conditions under which a work may be % distributed and modified, as well as conditions under which % modified versions of that work may be distributed.\par % We, the \LaTeX{3} Project, believe that the conditions below % give you the freedom to make and distribute modified versions of % your work that conform with whatever technical specifications % you wish while maintaining the availability, integrity, and % reliability of that work. If you do not see how to achieve your % goal while meeting these conditions, then read the document % {\ttfamily{}cfgguide.tex} and {\ttfamily{}modguide.tex} in the base \LaTeX{} % distribution for suggestions.\par % \subsection{Definitions}\label{Definitions} % In this license document the following terms are used:\par % \begin{description}[style=unboxed] % \item[Work\thinspace:]Any work being distributed under this License.\par % \item[Derived Work\thinspace:]Any work that under any applicable law is derived from % the Work.\par % \item[Modification\thinspace:]Any procedure that produces a Derived Work under any % applicable law~--- for example, the production of a file % containing an original file associated with the Work or a % significant portion of such a file, either verbatim or % with modifications and/or translated into another % language.\par % \item[Modify\thinspace:]To apply any procedure that produces a Derived Work % under any applicable law.\par % \item[Distribution\thinspace:]Making copies of the Work available from one person to % another, in whole or in part. Distribution includes (but % is not limited to) making any electronic components of the % Work accessible by file transfer protocols such as % {\smaller FTP} or {\smaller HTTP} or by % shared file systems such as Sun's Network File System % ({\smaller NFS}).\par % \item[Compiled Work\thinspace:]A version of the Work that has been processed into a % form where it is directly usable on a computer system. % This processing may include using installation facilities % provided by the Work, transformations of the Work, copying % of components of the Work, or other activities. Note that % modification of any installation facilities provided by % the Work constitutes modification of the Work.\par % \item[Current Maintainer\thinspace:]A person or persons nominated as such within the Work. % If there is no such explicit nomination then it is the % `Copyright Holder' under any applicable % law.\par % \item[Base Interpreter\thinspace:]A program or process that is normally needed for % running or interpreting a part or the whole of the % Work.\par % A Base Interpreter may depend on external components % but these are not considered part of the Base Interpreter % provided that each external component clearly identifies % itself whenever it is used interactively. Unless % explicitly specified when applying the license to the % Work, the only applicable Base Interpreter is a % `\LaTeX{}-Format' or in the case of files % belonging to the `\LaTeX{}-format' a program % implementing the `\TeX{} language'.\par % \end{description} % \subsection{Conditions on Distribution and Modification}\label{Conditions} % \begin{enumerate} % \item Activities other than distribution and/or modification % of the Work are not covered by this license; they are % outside its scope. In particular, the act of running the % Work is not restricted and no requirements are made % concerning any offers of support for the Work.\par % \item \label{item-distribute}You may distribute a complete, unmodified copy of the % Work as you received it. Distribution of only part of the % Work is considered modification of the Work, and no right to % distribute such a Derived Work may be assumed under the % terms of this clause.\par % \item You may distribute a Compiled Work that has been % generated from a complete, unmodified copy of the Work as % distributed under Clause~item~\ref{item-distribute} above above, as % long as that Compiled Work is distributed in such a way that % the recipients may install the Compiled Work on their system % exactly as it would have been installed if they generated a % Compiled Work directly from the Work.\par % \item \label{item-currmaint}If you are the Current Maintainer of the Work, you may, % without restriction, modify the Work, thus creating a % Derived Work. You may also distribute the Derived Work % without restriction, including Compiled Works generated from % the Derived Work. Derived Works distributed in this manner % by the Current Maintainer are considered to be updated % versions of the Work.\par % \item If you are not the Current Maintainer of the Work, you % may modify your copy of the Work, thus creating a Derived % Work based on the Work, and compile this Derived Work, thus % creating a Compiled Work based on the Derived Work.\par % \item \label{item-conditions}If you are not the Current Maintainer of the Work, you % may distribute a Derived Work provided the following % conditions are met for every component of the Work unless % that component clearly states in the copyright notice that % it is exempt from that condition. Only the Current % Maintainer is allowed to add such statements of exemption to % a component of the Work.\par % \begin{enumerate} % \item If a component of this Derived Work can be a direct % replacement for a component of the Work when that % component is used with the Base Interpreter, then, % wherever this component of the Work identifies itself to % the user when used interactively with that Base % Interpreter, the replacement component of this Derived % Work clearly and unambiguously identifies itself as a % modified version of this component to the user when used % interactively with that Base Interpreter.\par % \item Every component of the Derived Work contains % prominent notices detailing the nature of the changes to % that component, or a prominent reference to another file % that is distributed as part of the Derived Work and that % contains a complete and accurate log of the % changes.\par % \item No information in the Derived Work implies that any % persons, including (but not limited to) the authors of % the original version of the Work, provide any support, % including (but not limited to) the reporting and % handling of errors, to recipients of the Derived Work % unless those persons have stated explicitly that they do % provide such support for the Derived Work.\par % \item You distribute at least one of the following with % the Derived Work:\par % \begin{enumerate} % \item A complete, unmodified copy of the Work; if your % distribution of a modified component is made by % offering access to copy the modified component from % a designated place, then offering equivalent access % to copy the Work from the same or some similar place % meets this condition, even though third parties are % not compelled to copy the Work along with the % modified component;\par % \item Information that is sufficient to obtain a % complete, unmodified copy of the Work.\par % \end{enumerate} % \end{enumerate} % \item If you are not the Current Maintainer of the Work, you % may distribute a Compiled Work generated from a Derived % Work, as long as the Derived Work is distributed to all % recipients of the Compiled Work, and as long as the % conditions of Clause~item~\ref{item-conditions} above, above, are met % with regard to the Derived Work.\par % \item The conditions above are not intended to prohibit, and % hence do not apply to, the modification, by any method, of % any component so that it becomes identical to an updated % version of that component of the Work as it is distributed % by the Current Maintainer under Clause~item~\ref{item-currmaint} above, above.\par % \item Distribution of the Work or any Derived Work in an % alternative format, where the Work or that Derived Work (in % whole or in part) is then produced by applying some process % to that format, does not relax or nullify any sections of % this license as they pertain to the results of applying that % process.\par % \item % \begin{enumerate} % \item A Derived Work may be distributed under a different % license provided that license itself honors the % conditions listed in Clause~item~\ref{item-conditions} in the list on p.\thinspace\pageref{item-conditions} above, in % regard to the Work, though it does not have to honor the % rest of the conditions in this license.\par % \item If a Derived Work is distributed under a different % license, that Derived Work must provide sufficient % documentation as part of itself to allow each recipient % of that Derived Work to honor the restrictions in % Clause~item~\ref{item-conditions} in the list on p.\thinspace\pageref{item-conditions} above, concerning % changes from the Work.\par % \end{enumerate} % \item This license places no restrictions on works that are % unrelated to the Work, nor does this license place any % restrictions on aggregating such works with the Work by any % means.\par % \item Nothing in this license is intended to, or may be used % to, prevent complete compliance by all parties with all % applicable laws.\par % \end{enumerate} % \subsection{No Warranty}\label{Warranty} % There is no warranty for the Work. Except when otherwise % stated in writing, the Copyright Holder provides the Work % `as is', without warranty of any kind, either % expressed or implied, including, but not limited to, the implied % warranties of merchantability and fitness for a particular % purpose. The entire risk as to the quality and performance of % the Work is with you. Should the Work prove defective, you % assume the cost of all necessary servicing, repair, or % correction.\par % In no event unless required by applicable law or agreed to % in writing will The Copyright Holder, or any author named in the % components of the Work, or any other party who may distribute % and/or modify the Work as permitted above, be liable to you for % damages, including any general, special, incidental or % consequential damages arising out of any use of the Work or out % of inability to use the Work (including, but not limited to, % loss of data, data being rendered inaccurate, or losses % sustained by anyone as a result of any failure of the Work to % operate with any other programs), even if the Copyright Holder % or said author or said other party has been advised of the % possibility of such damages.\par % \subsection{Maintenance of The Work}\label{Maintenance} % The Work has the status `author-maintained' % if the Copyright Holder explicitly and prominently states near % the primary copyright notice in the Work that the Work can only % be maintained by the Copyright Holder or simply that it is % `author-maintained'.\par % The Work has the status `maintained' if there % is a Current Maintainer who has indicated in the Work that they % are willing to receive error reports for the Work (for example, % by supplying a valid e-mail address). It is not required for the % Current Maintainer to acknowledge or act upon these error % reports.\par % The Work changes from status `maintained' to % `unmaintained' if there is no Current Maintainer, % or the person stated to be Current Maintainer of the work cannot % be reached through the indicated means of communication for a % period of six months, and there are no other significant signs % of active maintenance.\par % You can become the Current Maintainer of the Work by % agreement with any existing Current Maintainer to take over this % role.\par % If the Work is unmaintained, you can become the Current % Maintainer of the Work through the following steps:\par % \begin{enumerate} % \item Make a reasonable attempt to trace the Current % Maintainer (and the Copyright Holder, if the two differ) % through the means of an Internet or similar search.\par % \item If this search is successful, then enquire whether the % Work is still maintained.\par % \begin{enumerate} % \item If it is being maintained, then ask the Current % Maintainer to update their communication data within one % month.\par % \item \label{item-intention}If the search is unsuccessful or no action to resume % active maintenance is taken by the Current Maintainer, % then announce within the pertinent community your % intention to take over maintenance. (If the Work is a % \LaTeX{} work, this could be done, for example, by % posting to \url{news:comp.text.tex}.)\par % \end{enumerate} % \item % \begin{enumerate} % \item If the Current Maintainer is reachable and agrees to % pass maintenance of the Work to you, then this takes % effect immediately upon announcement.\par % \item \label{item-announce}If the Current Maintainer is not reachable and the % Copyright Holder agrees that maintenance of the Work be % passed to you, then this takes effect immediately upon % announcement.\par % \end{enumerate} % \item \label{item-change}If you make an `intention announcement' % as described in~item~\ref{item-intention} in the list on p.\thinspace\pageref{item-intention} above and after three % months your intention is challenged neither by the Current % Maintainer nor by the Copyright Holder nor by other people, % then you may arrange for the Work to be changed so as to % name you as the (new) Current Maintainer.\par % \item If the previously unreachable Current Maintainer becomes % reachable once more within three months of a change % completed under the terms of~item~\ref{item-announce} in the list on p.\thinspace\pageref{item-announce} % or~item~\ref{item-change} above, then that % Current % Maintainer must become or remain the Current Maintainer upon % request provided they then update their communication data % within one month.\par % \end{enumerate} % A change in the Current Maintainer does not, of itself, % alter the fact that the Work is distributed under the % {\smaller LPPL} license.\par % If you become the Current Maintainer of the Work, you should % immediately provide, within the Work, a prominent and % unambiguous statement of your status as Current Maintainer. You % should also announce your new status to the same pertinent % community as in~item~\ref{item-intention} in the list on p.\thinspace\pageref{item-intention} % above.\par % \subsection{Whether and How to Distribute Works under This % License}\label{Distribute} % This section contains important instructions, examples, and % recommendations for authors who are considering distributing % their works under this license. These authors are addressed as % `you' in this section.\par % \subsubsection{Choosing This License or Another License}\label{Choosing} % If for any part of your work you want or need to use % \emph{distribution} conditions that differ % significantly from those in this license, then do not refer to % this license anywhere in your work but, instead, distribute % your work under a different license. You may use the text of % this license as a model for your own license, but your license % should not refer to the {\smaller LPPL} or otherwise % give the impression that your work is distributed under the % {\smaller LPPL}.\par % The document {\ttfamily{}modguide.tex} in the base \LaTeX{} % distribution explains the motivation behind the conditions of % this license. It explains, for example, why distributing % \LaTeX{} under the {\smaller GNU} General Public % License ({\smaller GPL}) was considered inappropriate. % Even if your work is unrelated to \LaTeX{}, the discussion in % {\ttfamily{}modguide.tex} may still be % relevant, and authors intending to distribute their works % under any license are encouraged to read it.\par % \subsubsection{A Recommendation on Modification Without % Distribution}\label{WithoutDistribution} % It is wise never to modify a component of the Work, even % for your own personal use, without also meeting the above % conditions for distributing the modified component. While you % might intend that such modifications will never be % distributed, often this will happen by accident~--- you may % forget that you have modified that component; or it may not % occur to you when allowing others to access the modified % version that you are thus distributing it and violating the % conditions of this license in ways that could have legal % implications and, worse, cause problems for the community. It % is therefore usually in your best interest to keep your copy % of the Work identical with the public one. Many works provide % ways to control the behavior of that work without altering any % of its licensed components.\par % \subsubsection{How to Use This License}\label{HowTo} % To use this license, place in each of the components of % your work both an explicit copyright notice including your % name and the year the work was authored and/or last % substantially modified. Include also a statement that the % distribution and/or modification of that component is % constrained by the conditions in this license.\par % Here is an example of such a notice and statement:\par % \iffalse %<*ignore> % \fi \begin{lstlisting}[language={[LaTeX]TeX}] %%% pig.dtx %%% Copyright 2005 M. Y. Name %% %% This work may be distributed and/or modified under the %% conditions of the LaTeX Project Public License, either version 1.3 %% of this license or (at your option) any later version. %% The latest version of this license is in %% http://www.latex-project.org/lppl.txt %% and version 1.3 or later is part of all distributions of LaTeX %% version 2005/12/01 or later. %% %% This work has the LPPL maintenance status `maintained'. %% %% The Current Maintainer of this work is M. Y. Name. %% %% This work consists of the files pig.dtx and pig.ins %% and the derived file pig.sty. \end{lstlisting} % \iffalse % % \fi % Given such a notice and statement in a file, the % conditions given in this license document would apply, with % the `Work' referring to the three files % {\ttfamily{}pig.dtx}, {\ttfamily{}pig.ins}, and {\ttfamily{}pig.sty} (the last being generated % from {\ttfamily{}pig.dtx} using {\ttfamily{}pig.ins}), the `Base % Interpreter' referring to any % `\LaTeX{}-Format', and both `Copyright % Holder' and `Current Maintainer' % referring to the person % M.~Y.~Name\index{!}.\par % If you do not want the Maintenance section of % {\smaller LPPL} to apply to your Work, change % `maintained' above into % `author-maintained'. However, we recommend that % you use `maintained' as the Maintenance % section was added in order to ensure that your Work remains % useful to the community even when you can no longer maintain % and support it yourself.\par % \subsubsection{Derived Works That Are Not Replacements}\label{NotReplacements} % Several clauses of the {\smaller LPPL} specify % means to provide reliability and stability for the user % community. They therefore concern themselves with the case % that a Derived Work is intended to be used as a (compatible or % incompatible) replacement of the original Work. If this is not % the case (e.g., if a few lines of code are reused for a % completely different task), then clauses 6b and 6d shall not % apply.\par % \subsubsection{Important Recommendations}\label{Recommendations} % \paragraph[Defining What Constitutes the Work]{Defining What Constitutes the Work :} % The {\smaller LPPL} requires that distributions % of the Work contain all the files of the Work. It is % therefore important that you provide a way for the licensee % to determine which files constitute the Work. This could, % for example, be achieved by explicitly listing all the files % of the Work near the copyright notice of each file or by % using a line such as:\par % \iffalse %<*ignore> % \fi \begin{lstlisting}[language={[LaTeX]TeX}] %% This work consists of all files listed in manifest.txt. \end{lstlisting} % \iffalse % % \fi % in that place. In the absence of an unequivocal list it % might be impossible for the licensee to determine what is % considered by you to comprise the Work and, in such a case, % the licensee would be entitled to make reasonable % conjectures as to which files comprise the Work.\par % \Finale