From 9ed2be15b632f76247ead6f36a0cbc913057fa48 Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Fri, 22 May 2020 03:00:58 +0000 Subject: CTAN sync 202005220300 --- macros/latex/contrib/decorule/MANIFEST | 7 +- macros/latex/contrib/decorule/README | 87 -- macros/latex/contrib/decorule/README.md | 187 +++++ macros/latex/contrib/decorule/VERSION | 1 + macros/latex/contrib/decorule/decorule.dtx | 1194 +++++++++++++++++++--------- macros/latex/contrib/decorule/decorule.ins | 34 +- macros/latex/contrib/decorule/decorule.pdf | Bin 423349 -> 396165 bytes 7 files changed, 1035 insertions(+), 475 deletions(-) delete mode 100644 macros/latex/contrib/decorule/README create mode 100644 macros/latex/contrib/decorule/README.md create mode 100644 macros/latex/contrib/decorule/VERSION (limited to 'macros/latex/contrib/decorule') diff --git a/macros/latex/contrib/decorule/MANIFEST b/macros/latex/contrib/decorule/MANIFEST index 5315031b5f..c4e0a46368 100644 --- a/macros/latex/contrib/decorule/MANIFEST +++ b/macros/latex/contrib/decorule/MANIFEST @@ -1,7 +1,6 @@ -README -MANIFEST decorule.dtx decorule.ins decorule.pdf -decorule.dvi -decorule.ps.gz +MANIFEST +README.md +VERSION diff --git a/macros/latex/contrib/decorule/README b/macros/latex/contrib/decorule/README deleted file mode 100644 index fa7fef1c5a..0000000000 --- a/macros/latex/contrib/decorule/README +++ /dev/null @@ -1,87 +0,0 @@ -This is the README file for the decorule package. - -Summary - -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. - -This is the packaged version of the macro which was -originally published in the 'Typographers' Inn' -column in TUGboat (Flynn 2010). - -This version fixes the bug caused by failing to supply the -correct values for DVI drivers for rendering glyph rotation. -The result now works in Postscript output but DVI viewers may -still display incorrectly. - -INSTALLATION - -To install this package, run LaTeX on the decorule.ins file. -This will create the package file decorule.sty, which you must -move to a directory (folder) where LaTeX will find it. - -For personal installations, that is: - -(Mac) ~/Library/texmf/tex/latex/decorule -(Unix / GNU/Linux) ~/texmf/tex/latex/decorule -(MS-Windows 95/XP) C:\texmf\tex\latex\decorule -(Windows 7/8) Computer\System\Users\your~name\texmf\tex\latex\decorule - [replacing your-name with your account name] - -Create that directory (folder) if it does not exist. - -If you are a Windows user with MiKTeX and this is your -first time installing packages by hand, you must also -add the texmf folder to MiKTeX's list of supported -folders (in the Roots tab of the MiKTeX Maintenance/Settings -program), and then update the FNDB in the General tab. - -For shared installations (multi-user systems), identify -the shared local directory with the command - - kpsewhich -expand-var '$TEXMFLOCAL' - -This will give you the texmf location within which you must -create the tex/latex/decorule subdirectories. Do not forget -to run the texhash or mktexlsr filename indexer program -after installation, otherwise the files will not be findable. - -USAGE - -Add this line to the Preamble of your LateX document: - - \usepackage[options]{decorule} - -Read the documentation for the options available. - - -BUGS - -None known of. - - -COPYRIGHT - -%% decorule.* -%% Copyright © 2010-2011 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 -% and the derived file decorule.sty. - -Please send comments and bug reports to the maintainer. diff --git a/macros/latex/contrib/decorule/README.md b/macros/latex/contrib/decorule/README.md new file mode 100644 index 0000000000..fdbc0de71a --- /dev/null +++ b/macros/latex/contrib/decorule/README.md @@ -0,0 +1,187 @@ + +[//]: # (decorule LaTeX package) + +# decorule + +This is the README.md file for the decorule LaTeX package v0.7 (2020-04-01) +generated by ClassPack v.1.19 (2020-05-19) on 21 May 2020 at 11:04:52 + +## Summary + +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. + +This is the packaged version of the macro which was originally published +in the “Typographers' Inn” column in TUGboat (Flynn, 2010). + + +## Automated installation + +If this package is distributed from CTAN, it should be in a zip file +which allows it to be installed automatically by the TeX Live Manager +(tlmgr) and similar automated installers. + +If you are using automated LaTeX package installation, no further action +is required: the package will be installed the first time you use it in +a LaTeX document. + +If you are using the TeX Live Manager (_tlmgr_) program manually, you +can install this package with the command: + + $ tlmgr install decorule + + +## TDS installation + +This package is also available as a TeX Directory System (TDS) zip file +(`.tds.zip`). This is the standard directory layout for a modern TeX +installation which enables the package to be unzipped directly into your +Personal TeX Directory without the need to use _tlmgr_. If you haven’t +yet created a Personal TeX Directory, see below for details of what one +is, and how to create it. + * You can install this package on any TDS-compliant personal system +(laptop, desktop, workstation, table, smartphone, PDA, etc) by unzipping +it straight into your Personal TeX Directory. This will put all the +files into the right places, so you can start using them immediately. + * On a shared (multiuser) system like a server, the administrator can +unzip it into the `$TEXMFLOCAL` directory instead (see below), and run +your TeX directory-indexing program (eg _texhash_, _mktexlsr_, etc) so +that everyone can use it. + * If you are using an old non-TDS-compliant system, see below under Manual +Installation. + +### Your Personal TeX Directory + +This is a directory (folder) where you should put all local manual +modifications (updates, additions such as new or updated classes, +packages, and fonts) that are _not_ handled automatically by _tlmgr_. +The name and location are fixed (for all practical purposes): + * Apple Mac OS X + + ~/Library/texmf + * Unix and GNU/Linux + + ~/texmf + * MS-Windows 95/XP/NT + + C:\texmf + * MS-Windows 2007 and above + + Computer\System\YOURNAME\texmf + +Create that folder now if it does not already exist. Put (or unzip) all +additions to your system that are _not_ handled by _tlmgr_ into this +directory, following _exactly_ the subdirectory structure that is used +in your main TeX distribution (unzipping a TDS file does this for you). +This is what enables LaTeX to find stuff automatically. + + +> #### If you are a Windows user running _MiKTeX_ +> When you create the folder for your Personal TeX Directory, you MUST add it to _MiKTeX_ ’s list of supported folders. Run the _MiKTeX Maintenance/Settings_ program, select the `Roots` tab, and add the folder. You only have to do this once. +> > Each time you add or remove software in your Personal TeX Directory, you MUST then click on the `Update FNDB` button in the `General` tab of the _MiKTeX Maintenance/Settings_ program, otherwise _MiKTeX_ will not find them and nothing will work! +> + +Unix (Mac and GNU/Linux) users do not need to (indeed, should not) run +their filename database indexer program (_mktexlsr_ or _texhash_) for +files put into a personal TeX directory. + + +## Installation on shared systems + +On multi-user systems (Unix-based), identify the shared local directory +tree with the command + + kpsewhich -expand-var '$TEXMFLOCAL' + +This will give you the location of the shared `texmf` directory into +which you must unzip these files. + +Do not forget to run your local TeX filename database indexer program +(_texhash_ or _mktexlsr_) after installation, otherwise the files will +not be found by LaTeX and nothing will work! + + +## Manual installation (non-TDS systems) + +To install this software manually, download and unzip the _non-_TDS zip +file into a temporary directory and move the class and/or package +file[s] and other files to the proper locations where LaTeX will find +them on your system. This is referred to in some documentation as “the +`TEXINPUTS` directory”, although it may be called something else on your +system. + +_It is your responsibility to know where this location is._ See the +question in the TeX FAQ at https://texfaq.org/FAQ-inst-wlcf.html for +more information. If you do not know, or cannot find it, or do not have +access to it, your TeX system may be out of date and may need replacing. + + + +## Online systems and “last resort” systems + +Some online LaTeX systems use CTAN, so a package from there should be +available on demand. For other online LaTeX systems where you do not +have access to the file system, unzip the _non-_TDS zip file into a +temporary directory and upload the files to the online system. Follow +their instructions for where to put them. + +In an emergency, or as a last resort on unmanageable systems, it is +possible simply to put the class and/or package file[s] into your +current working directory (the same folder as your `.tex` file[s]). + +While this may work, it is not supported, and may lead to other +resources (packages, fonts, images etc) not being found. + + +## Usage + +Include the line shown below in the Preamble of your LaTeX document; a +`\documentclass` line should be at the top; a `\usepackage` command +normally goes anywhere in the Preamble: + + \usepackage[options]{decorule} + +(similarly for other classes or packages if more than one is supplied +with this package). Read the documentation for the options available, if +any. The documentation is distributed as a PDF document in the zip file. +You can also regenerate it by typesetting the `decorule.dtx` file with +`pdflatex` (and `biber` and _makeindex_) in the normal way. + + +## Bugs and TODO + +No outstanding reported bugs at the time of this version. + +For TODO items, see the PDF documentation. + + +## Copyright + +The following statement is included in the source code: + + Transformed from decorule.xml by ClassPack db2dtx.xsl + version 1.19 (2020-05-19) on Thursday 21 May 2020 at 11:04:52 + + decorule.sty 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. + + diff --git a/macros/latex/contrib/decorule/VERSION b/macros/latex/contrib/decorule/VERSION new file mode 100644 index 0000000000..67e019434c --- /dev/null +++ b/macros/latex/contrib/decorule/VERSION @@ -0,0 +1 @@ +Date of most recent change is 2020-04-01 diff --git a/macros/latex/contrib/decorule/decorule.dtx b/macros/latex/contrib/decorule/decorule.dtx index 80f70bd597..b7dbb68009 100644 --- a/macros/latex/contrib/decorule/decorule.dtx +++ b/macros/latex/contrib/decorule/decorule.dtx @@ -1,7 +1,9 @@ % \iffalse meta-comment % -%% decorule.dtx -%% Copyright © 2010-2011 by Peter Flynn +% 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 @@ -13,38 +15,404 @@ % 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'. +% 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 -% and the derived file decorule.sty. +% 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}[2011/08/02 v0.6 The decorule LaTeX2e package] -%\RequirePackage{graphicx} -%\RequirePackage{fix-cm} +%\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} -\usepackage{decorule} -\usepackage[utf8x]{inputenc} -\usepackage[T1]{fontenc} -\usepackage{fancyvrb} -\usepackage{mflogo} -\usepackage{chicago} -\usepackage{url} -\usepackage{nicefrac} -\usepackage{lmodern} -\usepackage[a4paper,margin=3cm]{geometry} -\usepackage{parskip} -\usepackage{varioref} -\usepackage{listings} -\usepackage{textcomp} -\newcommand{\classorpackage}{package} -\newcommand{\ConTeXt}{% - C\kern-.0333emon\-\kern-.0667em\TeX\kern-.0333emt} +%% +%% 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 @@ -54,114 +422,166 @@ % % \fi % -% \CheckSum{142} +% \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 \~} +% 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.6}{2011/08/02}{Fix for the DVI-related display bug: Heiko Overdiek kindly identified the problem with the c@sym@rotate counter, that it isn't expandable. The graphics package only uses edef, but in the special, the explicit number is needed, because PostScript or GhostScript don't know \TeX{}. The result now works in Postscript output but DVI viewers may still display incorrectly..} -% \changes{v0.5}{2011/07/28}{Fixes after release: Added par breaks and centering. Attempted to identify why it fails when creating DVI but works for PDF (section on Bugs created)..} -% \changes{v0.4}{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.3}{2011/06/11}{Revised for .dtx file: 1) Rewrote documentation; 2) Generated .dtx.} -% \changes{v0.2}{2010/07/14}{Updated to package format: Wrote .dtx file by hand.} -% \changes{v0.1}{2010/03/20}{Written for TUGboat: Developed by hand.} +% \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} -% \DoNotIndex{\@makefnmark,\@makeother,\@maketitle} -% \DoNotIndex{\@namedef,\@ne,\@spaces,\@tempa} -% \DoNotIndex{\@tempb,\@tempswafalse,\@tempswatrue} -% \DoNotIndex{\@thanks,\@thefnmark,\@topnum} -% \DoNotIndex{\@@,\@elt,\@forloop,\@fortmp,\@gtempa,\@totalleftmargin} -% \DoNotIndex{\",\/,\@ifundefined,\@nil,\@verbatim,\@vobeyspaces} -% \DoNotIndex{\|,\~,\ ,\active,\advance,\aftergroup,\begingroup,\bgroup} -% \DoNotIndex{\mathcal,\csname,\def,\documentstyle,\dospecials,\edef} -% \DoNotIndex{\egroup} -% \DoNotIndex{\else,\endcsname,\endgroup,\endinput,\endtrivlist} -% \DoNotIndex{\expandafter,\fi,\fnsymbol,\futurelet,\gdef,\global} -% \DoNotIndex{\hbox,\hss,\if,\if@inlabel,\if@tempswa,\if@twocolumn} -% \DoNotIndex{\ifcase} -% \DoNotIndex{\ifcat,\iffalse,\ifx,\ignorespaces,\index,\input,\item} -% \DoNotIndex{\jobname,\kern,\leavevmode,\leftskip,\let,\llap,\lower} -% \DoNotIndex{\m@ne,\next,\newpage,\nobreak,\noexpand,\nonfrenchspacing} -% \DoNotIndex{\obeylines,\or,\protect,\raggedleft,\rightskip,\rm,\sc} -% \DoNotIndex{\setbox,\setcounter,\small,\space,\string,\strut} -% \DoNotIndex{\strutbox} -% \DoNotIndex{\thefootnote,\thispagestyle,\topmargin,\trivlist,\tt} -% \DoNotIndex{\twocolumn,\typeout,\vss,\vtop,\xdef,\z@} -% \DoNotIndex{\,,\@bsphack,\@esphack,\@noligs,\@vobeyspaces,\@xverbatim} -% \DoNotIndex{\`,\catcode,\end,\escapechar,\frenchspacing,\glossary} -% \DoNotIndex{\hangindent,\hfil,\hfill,\hskip,\hspace,\ht,\it,\langle} -% \DoNotIndex{\leaders,\long,\makelabel,\marginpar,\markboth,\mathcode} -% \DoNotIndex{\mathsurround,\mbox,\newcount,\newdimen,\newskip} -% \DoNotIndex{\nopagebreak} -% \DoNotIndex{\parfillskip,\parindent,\parskip,\penalty,\raise,\rangle} -% \DoNotIndex{\section,\setlength,\TeX,\topsep,\underline,\unskip,\verb} -% \DoNotIndex{\vskip,\vspace,\widetilde,\\,\%,\@date,\@defpar} -% \DoNotIndex{\[,\{,\},\]} -% \DoNotIndex{\count@,\ifnum,\loop,\today,\uppercase,\uccode} -% \DoNotIndex{\baselineskip,\begin,\tw@} -% \DoNotIndex{\a,\b,\c,\d,\e,\f,\g,\h,\i,\j,\k,\l,\m,\n,\o,\p,\q} -% \DoNotIndex{\r,\s,\t,\u,\v,\w,\x,\y,\z,\A,\B,\C,\D,\E,\F,\G,\H} -% \DoNotIndex{\I,\J,\K,\L,\M,\N,\O,\P,\Q,\R,\S,\T,\U,\V,\W,\X,\Y,\Z} -% \DoNotIndex{\1,\2,\3,\4,\5,\6,\7,\8,\9,\0} -% \DoNotIndex{\!,\#,\$,\&,\',\(,\),\+,\.,\:,\;,\<,\=,\>,\?,\_} -% \DoNotIndex{\discretionary,\immediate,\makeatletter,\makeatother} -% \DoNotIndex{\meaning,\newenvironment,\par,\relax,\renewenvironment} -% \DoNotIndex{\repeat,\scriptsize,\selectfont,\the,\undefined} -% \DoNotIndex{\arabic,\do,\makeindex,\null,\number,\show,\write,\@ehc} -% \DoNotIndex{\@author,\@ehc,\@ifstar,\@sanitize,\@title,\everypar} -% \DoNotIndex{\if@minipage,\if@restonecol,\ifeof,\ifmmode} -% \DoNotIndex{\lccode,\newtoks,\onecolumn,\openin,\p@,\SelfDocumenting} -% \DoNotIndex{\settowidth,\@resetonecoltrue,\@resetonecolfalse,\bf} -% \DoNotIndex{\clearpage,\closein,\lowercase,\@inlabelfalse} -% \DoNotIndex{\selectfont,\mathcode,\newmathalphabet,\rmdefault} -% \DoNotIndex{\bfdefault} +% \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.6} -% \def\filedate{2011/08/02} -% \title{The \textsf{decorule} LaTeX2e package\thanks{% +% \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, dated \filedate.} -% \\[1ex]\Large -% A decorative swelled rule} -% \author{Peter Flynn\\\normalsize -% Silmaril Consultants\\[-4pt]\normalsize -% Textual Therapy Division\\\normalsize -% (\texttt{peter@silmaril.ie})} +% \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}\noindent +% \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 \cite{tb97}.\par -% This version fixes the bug caused by failing to supply the -% correct values for DVI drivers for rendering glyph rotation. -% The result now works in Postscript output but DVI viewers may -% still display incorrectly.\par +% 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 @@ -174,228 +594,234 @@ % 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 \cite{tb97} there is an \textsf{swrule} package -% by Tobias Dussa \cite{dussa} which builds a +% 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 \cite{peter} which describes +% by Steve Peter \parencite{peter} which describes % a more extensible method using \MP{} for -% \ConTeXt{}.\par +% 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 (\DescribeMacro{\sim}\verb`\sim`) +% constructed from the swung dash ({\ttfamily{}\textbackslash{}sim}) % character in math mode, rotated and scaled to fit in an -% asending and then descending series.\par -% This package is available from your nearest CTAN -% respository in the directory \url{}. The original -% example is available at -% \url{http://latex.silmaril.ie/packages/decorule}. -% All suggestions for improving and extending it are -% welcome.\par -% \decorule{}\par -% \subsection{Bugs} -% Rainer adS and Herbert Schulz kindly pointed out on -% \url{comp.text.tex}\footnote{% -% \url{} -% and -% \url{}} that it failed when using standard (DVI) -% \LaTeX{}, although it was correct when using -% \emph{pdflatex}.\par -% Attempts to render the DVI with (eg) -% \emph{dvipdf} were failing with a -% Ghostscript error: \verb`/undefined in \c@sym@rotate`.\par -% Heiko Overdiek kindly identified the problem with the -% \DescribeMacro{\c@sym@rotate}\verb`\c@sym@rotate` counter, that `it -% isn't expandable. The graphics package only uses \texttt{edef}, but in the \texttt{special}, the explicit number is -% needed, because PostScript or GhostScript don't know -% \TeX{}.'\par -% The result now works in Postscript output but DVI -% viewers may still display incorrectly.\par +% 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 -% \addtocontents{toc}{\medskip} -% \addcontentsline{toc}{section}{\refname} -% \bibliography{decorule} -% \bibliographystyle{chicago} -% \begin{VerbatimOut}{decorule.bib} -%<*ignore> -@article{tb97, -author = {Peter Flynn}, -shortauthor = {Flynn}, -title = {{Typographers' Inn: Where have all the flowers gone?}}, -pages = {21-22}, -journal = {{TUGboat}}, -volume = {31}, -number = {1}, -year = {2010} -} -@article{peter, -author = {Steve Peter}, -shortauthor = {Peter}, -title = {{Swelled rules and \MP{}}}, -pages = {193-195}, -journal = {{TUGboat}}, -volume = {26}, -number = {3}, -year = {2005} -} -@misc{dussa, -author = {Tobias Dussa}, -shortauthor = {Dussa}, -title = {{swrule.sty}}, -year = {2001}, -month = {Oct}, -howpublished = {CTAN: \TeX{} Users Group}, -url = {http://mirror.ctan.org/macros/generic/misc/swrule.sty} -} -% -% \end{VerbatimOut} -% \StopEventually{% +% \raggedright\printbibliography +% \StopEventually{\label{endcode}% % \clearpage -% \newgeometry{left=3cm} +% \newgeometry{left=3cm}% +% \addcontentsline{toc}{section}{Change History}% +% \label{}% % \PrintChanges % \clearpage +% \label{codeindex}% +% \addcontentsline{toc}{section}{Index}% % \PrintIndex} -% \newgeometry{left=5cm} +% \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 \texttt{decorule}, which cycles through sizes +% 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{Preliminary declarations} -% \begin{macro}{\sym@min} +% \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{sym@min} -\setcounter{sym@min}{1} +\newcounter{DCR@min} +\setcounter{DCR@min}{1} % \end{macrocode} -% \end{macro} -% \begin{macro}{\sym@max} +% \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{sym@max} -\setcounter{sym@max}{20} +\newcounter{DCR@max} +\setcounter{DCR@max}{20} % \end{macrocode} -% \end{macro} -% \begin{macro}{\sym@step} +% \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{sym@step} -\setcounter{sym@step}{1} +\newcounter{DCR@step} +\setcounter{DCR@step}{1} % \end{macrocode} -% \end{macro} -% \begin{macro}{\sym@rotate} +% \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. The use of the -% \DescribeMacro{\thesym@rotate}\verb`\thesym@rotate` form is a bugfix due to -% Heiko Oberdiek in \url{news:comp.text.tex} at \textlangle\verb`j0sonk$q9v$1@dont-email.me`\textrangle{}.\par -% \changes{v0.6}{2011/08/02}{Added fix from Heiko for sym@rotate} +% previous one.\par % \begin{macrocode} -\newcounter{sym@rotate} -\renewcommand*{\thesym@rotate}{\the\c@sym@rotate}% -\setcounter{sym@rotate}{45} +\newcounter{DCR@rotate} +\setcounter{DCR@rotate}{45} % \end{macrocode} -% \end{macro} -% \begin{macro}{\sym@size} +% \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{sym@size} +\newcounter{DCR@size} % \end{macrocode} -% \end{macro} -% \begin{macro}{\sym@raise} +% \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{\sym@raise} +\newlength{\DCR@raise} % \end{macrocode} -% \end{macro} -% \begin{macro}{\sym@skip} +% \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{\sym@skip} +\newlength{\DCR@skip} % \end{macrocode} -% \end{macro} -% \begin{macro}{\sym@symbol} +% \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{\sym@symbol}{$\sim$} +\newcommand{\DCR@symbol}{\ensuremath{\sim}} % \end{macrocode} -% \end{macro} +% \end{CPK@macro} % \subsection{The main macro} -% \begin{macro}{\decorule} +% \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.3}{2011/06/11}{Rearranged spacing to suit the .dtx layout} -% \changes{v0.5}{2011/07/28}{Added par breaks and centering} +% \changes{v0.21}{2011/06/06}{Rearranged spacing to suit the .dtx layout} % \begin{macrocode} -\newcommand{\decorule}{\par\begingroup\centering +\newcommand{\decorule}{% % \end{macrocode} % Start by setting the initial size to the minimum size % declared above:\par % \begin{macrocode} -\setcounter{sym@size}{\c@sym@min} + \begingroup\fontencoding{OT1}\fontfamily{cmr}\selectfont% + \setcounter{DCR@size}{\c@DCR@min}% % \end{macrocode} -% Go through the steps up to, but not including, the -% maximum size:\par +% Loop through the steps up to, but not including, the +% maximum size (this loop ends on line 28):\par % \begin{macrocode} -\loop + \loop % \end{macrocode} -% Raise each glyph above the baseline by half the -% point size that we will use:\par +% 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{\sym@raise}{\c@sym@size pt}% - \divide\sym@raise by2 + \setlength{\DCR@raise}{\c@DCR@size pt}% + \divide\DCR@raise by2 % \end{macrocode} % Raise, rotate, and (in this case of -% \DescribeMacro{\sim}\verb`\sim`) reflect the glyph in a \texttt{hbox} of its own point size, -% using \texttt{hss} to prevent -% \TeX{} squawking. Heiko Oberdiek also identified the fix of -% using \DescribeMacro{\thesym@rotate}\verb`\thesym@rotate` instead of -% \DescribeMacro{\c@sym@rotate}\verb`\c@sym@rotate` for the box rotation, here -% and elsewhere below.\par -% \changes{v0.6}{2011/08/02}{Changed c@sym@rotate to thesym@rotate} +% {\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{-\sym@raise}{% - \fontsize{\c@sym@size}{0}\selectfont - \rotatebox{\thesym@rotate}{\reflectbox{\hbox - to\c@sym@size pt{\hss\sym@symbol\hss}}}}% + \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{\sym@skip}{\c@sym@size pt}% - \divide\sym@skip by3 - \multiply\sym@skip by2 - \kern-\sym@skip + \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{sym@size}{\c@sym@step}% - \ifnum\c@sym@size<\c@sym@max + \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:\par -% \changes{v0.6}{2011/08/02}{Changed c@sym@rotate to thesym@rotate} +% size: this marks the mid-point of the rule:\par % \begin{macrocode} -\setlength{\sym@raise}{\c@sym@max pt}% - \divide\sym@raise by2 - \raisebox{-\sym@raise}{% - \fontsize{\c@sym@max}{0}\selectfont - \rotatebox{\thesym@rotate}{\reflectbox{\hbox - to\c@sym@max pt{\hss\sym@symbol\hss}}}}% + \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 @@ -403,49 +829,52 @@ url = {http://mirror.ctan.org/macros/generic/misc/swrule.sty} % from the last loop of the outward journey. This time, % however, do the kerning \emph{before} the % glyph.\par -% \changes{v0.6}{2011/08/02}{Changed c@sym@rotate to thesym@rotate} % \begin{macrocode} -\loop - \setlength{\sym@skip}{\c@sym@size pt}% - \divide\sym@skip by3 - \multiply\sym@skip by2 - \kern-\sym@skip - \setlength{\sym@raise}{\c@sym@size pt}% - \divide\sym@raise by2 - \raisebox{-\sym@raise}{% - \fontsize{\c@sym@size}{0}\selectfont - \rotatebox{\thesym@rotate}{\reflectbox{\hbox - to\c@sym@size pt{\hss\sym@symbol\hss}}}}% - \addtocounter{sym@size}{-\c@sym@step}% - \ifnum\c@sym@size>\c@sym@min + \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 -% \changes{v0.6}{2011/08/02}{Changed c@sym@rotate to thesym@rotate} % \begin{macrocode} -\setlength{\sym@skip}{\c@sym@min pt}% - \divide\sym@skip by3 - \multiply\sym@skip by2 - \kern-\sym@skip - \setlength{\sym@raise}{\c@sym@min pt}% - \divide\sym@raise by2 - \raisebox{-\sym@raise}{% - \fontsize{\c@sym@min}{0}\selectfont - \rotatebox{\thesym@rotate}{\reflectbox{\hbox - to\c@sym@min pt{\hss\sym@symbol\hss}}}}% -\par\endgroup} + \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{macro} +% \end{CPK@macro} +% \iffalse +% +% \fi % \appendix -% \newgeometry{left=3cm} +% \newgeometry{left=3cm} % \clearpage -% \section{The \LaTeX{} Project Public License}\label{LPPL:LPPL} -% \begin{quotation}\small\noindent +% \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. +% license document, but modification of it is not allowed.\par % \end{quotation} -% \subsection{Preamble}\label{LPPL:Preamble} -% The \LaTeX{} Project Public License (\textsc{lppl}) +% \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 @@ -453,8 +882,8 @@ url = {http://mirror.ctan.org/macros/generic/misc/swrule.sty} % 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 \emph{Whether and How to Distribute Works under This -% License}, below, gives instructions, examples, and +% 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 @@ -466,42 +895,41 @@ url = {http://mirror.ctan.org/macros/generic/misc/swrule.sty} % 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 -% \url{cfgguide.tex} and \url{modguide.tex} in the base \LaTeX{} +% {\ttfamily{}cfgguide.tex} and {\ttfamily{}modguide.tex} in the base \LaTeX{} % distribution for suggestions.\par -% \subsection{Definitions}\label{LPPL:Definitions} +% \subsection{Definitions}\label{Definitions} % In this license document the following terms are used:\par -% \begingroup\raggedright -% \begin{description} -% \item[Work:]Any work being distributed under this License. -% \item[Derived Work:]Any work that under any applicable law is derived from -% the Work. -% \item[Modification:]Any procedure that produces a Derived Work under any +% \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. -% \item[Modify:]To apply any procedure that produces a Derived Work -% under any applicable law. -% \item[Distribution:]Making copies of the Work available from one person to +% 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 -% \textsc{ftp} or \textsc{http} or by +% {\smaller FTP} or {\smaller HTTP} or by % shared file systems such as Sun's Network File System -% (\textsc{nfs}). -% \item[Compiled Work:]A version of the Work that has been processed into a +% ({\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. -% \item[Current Maintainer:]A person or persons nominated as such within the Work. +% 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. -% \item[Base Interpreter:]A program or process that is normally needed for +% 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 @@ -512,45 +940,45 @@ url = {http://mirror.ctan.org/macros/generic/misc/swrule.sty} % 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'. -% \end{description}\endgroup -% \subsection{Conditions on Distribution and Modification}\label{LPPL:Conditions} +% 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. -% \item \label{LPPL:item:distribute}You may distribute a complete, unmodified copy of the +% 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. +% 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~\vref{LPPL:item:distribute} above, 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. -% \item \label{LPPL:item:currmaint}If you are the Current Maintainer of the Work, you may, +% 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. +% 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. -% \item \label{LPPL:item:conditions}If you are not the Current Maintainer of the Work, you +% 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. +% 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 @@ -560,22 +988,22 @@ url = {http://mirror.ctan.org/macros/generic/misc/swrule.sty} % 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. +% 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. +% 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. +% provide such support for the Derived Work.\par % \item You distribute at least one of the following with -% the Derived Work: +% the Derived Work:\par % \begin{enumerate} % \item A complete, unmodified copy of the Work; if your % distribution of a modified component is made by @@ -584,50 +1012,50 @@ url = {http://mirror.ctan.org/macros/generic/misc/swrule.sty} % 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; +% modified component;\par % \item Information that is sufficient to obtain a -% complete, unmodified copy of the Work. +% 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~\vref{LPPL:item:conditions}, above, are met -% with regard to the Derived Work. +% 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~\vref{LPPL:item:currmaint}, above. +% 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. +% 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~\vref{LPPL:item:conditions} above, in +% 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. +% 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~\vref{LPPL:item:conditions} above, concerning -% changes from the Work. +% 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. +% 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. +% applicable laws.\par % \end{enumerate} -% \subsection{No Warranty}\label{LPPL:Warranty} +% \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 @@ -649,7 +1077,7 @@ url = {http://mirror.ctan.org/macros/generic/misc/swrule.sty} % 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{LPPL:Maintenance} +% \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 @@ -675,80 +1103,80 @@ url = {http://mirror.ctan.org/macros/generic/misc/swrule.sty} % \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. +% through the means of an Internet or similar search.\par % \item If this search is successful, then enquire whether the -% Work is still maintained. +% 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. -% \item \label{LPPL:item:intention}If the search is unsuccessful or no action to resume +% 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}.) +% 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. -% \item \label{LPPL:item:announce}If the Current Maintainer is not reachable and the +% 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. +% announcement.\par % \end{enumerate} -% \item \label{LPPL:item:change}If you make an `intention announcement' -% as described in~\vref{LPPL:item:intention} above and after three +% \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. +% 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~\vref{LPPL:item:announce} -% or~\vref{LPPL:item:change}, then that +% 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. +% 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 -% \textsc{lppl} license.\par +% {\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~\vref{LPPL:item:intention} +% 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{LPPL:Distribute} +% 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{LPPL:Choosing} +% \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 \textsc{lppl} or otherwise +% should not refer to the {\smaller LPPL} or otherwise % give the impression that your work is distributed under the -% \textsc{lppl}.\par -% The document \url{modguide.tex} in the base \LaTeX{} +% {\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 \textsc{gnu} General Public -% License (\textsc{gpl}) was considered inappropriate. +% \LaTeX{} under the {\smaller GNU} General Public +% License ({\smaller GPL}) was considered inappropriate. % Even if your work is unrelated to \LaTeX{}, the discussion in -% \url{modguide.tex} may still be +% {\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{LPPL:WithoutDistribution} +% 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 @@ -763,7 +1191,7 @@ url = {http://mirror.ctan.org/macros/generic/misc/swrule.sty} % 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{LPPL:HowTo} +% \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 @@ -771,7 +1199,10 @@ url = {http://mirror.ctan.org/macros/generic/misc/swrule.sty} % 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 -% \begin{verbatim} +% \iffalse +%<*ignore> +% \fi +\begin{lstlisting}[language={[LaTeX]TeX}] %%% pig.dtx %%% Copyright 2005 M. Y. Name %% @@ -789,27 +1220,30 @@ url = {http://mirror.ctan.org/macros/generic/misc/swrule.sty} %% %% This work consists of the files pig.dtx and pig.ins %% and the derived file pig.sty. -% \end{verbatim} +\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 -% \url{pig.dtx}, \url{pig.ins}, and \url{pig.sty} (the last being generated -% from \url{pig.dtx} using \url{pig.ins}), the `Base +% {\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{M.~Y.~Name}.\par +% M.~Y.~Name\index{!}.\par % If you do not want the Maintenance section of -% \textsc{lppl} to apply to your Work, change +% {\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{LPPL:NotReplacements} -% Several clauses of the \textsc{lppl} specify +% \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 @@ -817,22 +1251,28 @@ url = {http://mirror.ctan.org/macros/generic/misc/swrule.sty} % 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{LPPL:Recommendations} -% \paragraph{Defining What Constitutes the Work} -% The \textsc{lppl} requires that distributions +% \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 -% \begin{verbatim} +% \iffalse +%<*ignore> +% \fi +\begin{lstlisting}[language={[LaTeX]TeX}] %% This work consists of all files listed in manifest.txt. -% \end{verbatim} +\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 -\endinput + diff --git a/macros/latex/contrib/decorule/decorule.ins b/macros/latex/contrib/decorule/decorule.ins index b6080f8753..9033256828 100644 --- a/macros/latex/contrib/decorule/decorule.ins +++ b/macros/latex/contrib/decorule/decorule.ins @@ -1,5 +1,7 @@ -%%% decorule.ins -%% Copyright © 2010-2011 by Peter Flynn +% Transformed from decorule.xml by ClassPack db2dtx.xsl +% version 1.19 (2020-05-19) on Thursday 21 May 2020 at 11:04:52 +% +% decorule.ins 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 @@ -11,26 +13,44 @@ % 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'. +% 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 -% and the derived file decorule.sty. +% This work consists of the files decorule.dtx and decorule.ins, +% the derived file +% and any other ancillary files listed in the MANIFEST. % \input docstrip.tex \keepsilent \usedir{tex/latex/decorule} \preamble + +This is a generated file. + +Copyright © 2010 by Peter Flynn + This file was generated from an XML master source. Amendments and corrections should be notified to the maintiner for inclusion in future versions. + \endpreamble -\generate{\file{decorule.sty}{\from{decorule.dtx}{package}}} +\generate{\file{decorule.sty}{\from{decorule.dtx}{package}} +} \obeyspaces \Msg{********************************************************} \Msg{** **} -\Msg{** Read the documentation before using this package. **} +\Msg{** Read the documentation before using this package. **} +\Msg{** **} +\Msg{** To finish the installation you have to move the **} +\Msg{** following file into a directory searched by TeX: **} +\Msg{** **} +\Msg{** **} +\Msg{** **} +\Msg{** To produce the documentation run the file **} +\Msg{** decorule.dtx through pdfLaTeX and BiBTeX **} +\Msg{** **} +\Msg{** Happy LaTeXing! **} \Msg{** **} \Msg{********************************************************} \endbatchfile diff --git a/macros/latex/contrib/decorule/decorule.pdf b/macros/latex/contrib/decorule/decorule.pdf index 6cdb2bd06d..027e981ede 100644 Binary files a/macros/latex/contrib/decorule/decorule.pdf and b/macros/latex/contrib/decorule/decorule.pdf differ -- cgit v1.2.3