% \iffalse meta-comment % % Transformed from euflag.xml by ClassPack db2dtx.xsl % version 1.28 (2024-02-21) on Friday 1 March 2024 at 10:07:56 % % euflag.dtx is copyright © 2019-2023 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 euflag.dtx and euflag.ins, % and any other ancillary files listed in the MANIFEST. % % \fi % \iffalse %\NeedsTeXFormat{LaTeX2e}[2016/02/01] %\ProvidesPackage{euflag}[2023/12/30 v0.91 % A command to reproduce the flag of the European Union] %<*driver> \PassOptionsToPackage{hyphens}{url}% because dependencies guit requires hyphens \PassOptionsToPackage{svgnames}{xcolor}% because dependencies dox hypdoc hyperref classpack requires svgnames \providecommand{\CPKdocname}{euflag} \providecommand{\CPKdoctype}{package} \PassOptionsToPackage{british}{babel}% use of other (non-en-IE) languages \documentclass[12pt]{ltxdoc} %% %% Packages for documentation %% \usepackage{dox}% \newcommand{\LabelFont}[2][\relax]{\strut {\fontencoding\encodingdefault \fontfamily{lmtt}\fontseries{lc}#1\selectfont#2}} \let\CPKmacro\macro\let\CPKendmacro\endmacro \let\CPKenvironment\environment\let\CPKendenvironment\endenvironment \doxitem[idxtype=attribute]{Attribute}{CPKattribute}{attributes} \def\PrintAttributeName#1{\LabelFont{@#1}} \doxitem[idxtype=class]{Class}{CPKclass}{classs} \def\PrintClassName#1{\LabelFont[\fontfamily{lmss}]{#1}} \doxitem[idxtype=color]{Color}{CPKcolor}{colors} \def\PrintColorName#1{\LabelFont[\color{#1}]{#1}} \doxitem[idxtype=comment]{Comment}{CPKcomment}{comments} \def\PrintCommentName#1{\LabelFont[\color{LightGrey}]{#1}} \doxitem[idxtype=file]{File}{CPKfile}{files} \def\PrintFileName#1{\LabelFont{#1}} \doxitem[idxtype=length]{Length}{CPKlength}{lengths} \def\PrintLengthName#1{\LabelFont{#1}} \doxitem[idxtype=option]{Option}{CPKoption}{options} \def\PrintOptionName#1{\LabelFont{#1}} \doxitem[idxtype=package]{Package}{CPKpackage}{packages} \def\PrintPackageName#1{\LabelFont{#1}} \usepackage{fontspec}% \makeatletter \newcommand{\printexternalcurrentfont}{% \expandafter\format@externalcurrentfont\fontname\font:\@nil}% \def\format@externalcurrentfont[#1]:#2\@nil{% \texttt{\@ifnextchar"{\@gobble}{}#1}% }% \makeatother %% fontenc (1.006) omitted in favour of fontspec %% inputenc (1.009) omitted in favour of fontspec \usepackage{noto}% \usepackage{bbding}% \usepackage{mflogo}% \usepackage[british]{babel}% \usepackage[backend=biber,doi=true, isbn=true,url=true,uniquename=false,style=apa]{biblatex}% \makeatletter \AtBeginDocument{% \setlength{\bibitemsep}{1ex}% \setlength{\bibnamesep}{1.5\itemsep}% \defbibheading{shortbib}[References]% {\section{#1}\parindent0pt}} \@ifpackagewith{babel}{british}{% \DeclareLanguageMapping{british}% {british-apa}}{\relax} \makeatother \makeatletter \providetoggle{blx@skipbiblist} \makeatother \usepackage{array}% \usepackage{calc}% \makeatletter {\scriptsize \global\advance\@totalleftmargin by1em \global\advance\MacroIndent by.5em} \makeatother \usepackage{ccaption}% \captionnamefont{\bfseries} \captionstyle{\raggedright} \usepackage[inline]{enumitem}% \setlist[description]{style=unboxed,font=\sffamily\bfseries} \setlist[itemize]{leftmargin=2em} \setlist[enumerate]{leftmargin=2em} \usepackage{relsize}% \usepackage{textcase}% \usepackage{float}% \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[level]{fmtcount}% \usepackage[a4paper,left=35mm,top=25mm, textwidth=150mm,textheight=229mm,headheight=15pt]{geometry}% \usepackage{fancyhdr}% \renewcommand{\MakeUppercase}{\relax} \pagestyle{fancy} \fancyhead[L]{\sffamily\footnotesize\rightmark} \fancyhead[R]{\sffamily\footnotesize\thepage} \fancyfoot[C]{} \fancyfoot[L]{\sffamily\footnotesize\leftmark} \fancyfoot[R]{\sffamily\footnotesize The \LaTeX\ \textrm{\CPKdocname} \CPKdoctype} \renewcommand{\headrulewidth}{0pt} \renewcommand{\footrulewidth}{0pt} \usepackage{graphicx}% \usepackage{listings}% \lstset{defaultdialect=LaTeXe,frame=single, framesep=.5em,backgroundcolor=\color{AliceBlue}, rulecolor=\color{LightSteelBlue},framerule=1pt} \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{DarkCyan}\bfseries, identifierstyle=\color{DarkRed}, commentstyle=\color{Gray}\upshape, stringstyle=\color{DarkBlue}\upshape, emphstyle=\color{DarkGreen}\upshape, showstringspaces=false, columns=fullflexible, keepspaces=true} \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,doxitem, DeclareLanguageMapping,textcolor,definecolor,colorbox, fcolorbox,RequirePackage,PassOptionsToPackage}% } \lstloadlanguages{LaTeXe} \usepackage{ltxcmds}% \usepackage{makeidx}% \makeindex \usepackage{parskip}% \usepackage{sectsty}% \allsectionsfont{\sffamily\raggedright} \renewcommand*{\descriptionlabel}[1]{\hspace\labelsep \sffamily\bfseries #1} \usepackage[normalem]{ulem}% \usepackage{url}% \AtBeginDocument{\urlstyle{tt}} \usepackage{varioref}% \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}{on this page} \def\reftextafter{on the \reftextvario{next}{following} page} \usepackage{xcolor}% svgnames (1.126)% \makeatletter \@ifundefined{T}{% \newcommand{\T}[2]{{\fontencoding{T1}% \selectfont#2}}}{} \makeatother \usepackage{classpack}% \usepackage{hypdoc}% \hypersetup{linkcolor=DarkGreen,citecolor=DarkRed,urlcolor=Blue,colorlinks=true} \makeatletter \@ifpackageloaded{biblatex}{% \makeatother \ExecuteBibliographyOptions{maxcitenames=1} \DeclareFieldFormat{citehyperref}{% \DeclareFieldAlias{bibhyperref}{noformat}% Avoid nested links \bibhyperref{#1}} \DeclareFieldFormat{textcitehyperref}{% \DeclareFieldAlias{bibhyperref}{noformat}% Avoid nested links \bibhyperref{% #1% \ifbool{cbx:parens} {\bibcloseparen\global\boolfalse{cbx:parens}} {}}} \savebibmacro{cite} \savebibmacro{textcite} \renewbibmacro*{cite}{% \printtext[citehyperref]{% \restorebibmacro{cite}% \usebibmacro{cite}}} \renewbibmacro*{textcite}{% \ifboolexpr{ ( not test {\iffieldundef{prenote}} and test {\ifnumequal{\value{citecount}}{1}} ) or ( not test {\iffieldundef{postnote}} and test {\ifnumequal{\value{citecount}}{\value{citetotal}}} ) } {\DeclareFieldAlias{textcitehyperref}{noformat}} {}% \printtext[textcitehyperref]{% \restorebibmacro{textcite}% \usebibmacro{textcite}}} }{\relax} \usepackage{hyperref}% \hypersetup{linkcolor=DarkGreen,citecolor=DarkRed, urlcolor=Blue,colorlinks=true} \AtBeginDocument{\renewcommand{\UrlFont}{\ttfamily}} \usepackage{nicefrac}% \def\textonehalf{\ensuremath{1\nicefrac12}} \usepackage{nicefrac}% \def\textonehalf{\ensuremath{1\nicefrac12}} \usepackage{guit}% \usepackage{euflag}[2023/12/30]% added by spec \newcommand{\classorpackage}{package} \addbibresource{euflag.bib} \hypersetup{pdfauthor={Peter Flynn}, pdftitle={The euflag LaTeX2e document package}, pdfsubject={A command to reproduce the flag of the European Union}, pdfkeywords={}, pdfproducer={XeLateX with hyperref}, pdfcreator={Emacs/psgml, ClassPack/Saxon, LaTeX/TeX Live}} \setmonofont[Scale=MatchLowercase]{zcoN} \allsectionsfont{\sffamily} % %% %% Settings for docstrip and ltxdoc %% \EnableCrossrefs \CodelineIndex \RecordChanges \begin{document}\raggedright \DocInput{euflag.dtx} \end{document} % % \fi % % \CheckSum{92} % % \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.91}{2023/12/30}{Regression update for updated db2dtx: Move to ClassPack 1.26.} % \changes{v0.9}{2023/06/05}{Regression update: Move to ClassPack 1.23.} % \changes{v0.8}{2020/05/22}{Reference update: Added missing reference to Claudio's paper.} % \changes{v0.7}{2020/05/16}{Regression release: 1) Updated to use ClassPack 1.19; 2) Switched all conformance attributes on revision dates to YYYY-MM-DD.} % \changes{v0.6}{2020/04/01}{Maintenance release: 1) Updated to ClassPack 1.18; 2) Prepare to switch conformance attributes on revision dates to YYYY-MM-DD.} % \changes{v0.5}{2019/07/24}{Separated stars from flag and added baseline option: 1) Made the ring of stars a separate macro so that they can be used on their own as well as in the flag.; 2) Added a baseline package option to align the bottom star with the text, and a command option to do it on a per-command basis..} % \changes{v0.4}{2019/02/02}{Changed the star: Changed from the bbdingFiveStar to the amssymbbigstar command..} % \changes{v0.3}{2019/02/02}{Mods to ClassPack: Added switch in db2dtx.xsl to detect the use of a package in its own documentation (as here) and code around the PassOptionsToPackage for svgnames on xcolor, which was causing an Option Clash error..} % \changes{v0.2}{2019/02/01}{Works in table cells: Fixed bug (a vfill) that was crashing (well, locking up) \LaTeX{} when euflag was used in a table cell..} % \changes{v0.1}{2019/01/31}{First version: Simple picture mode is all that is needed, plus a decent star..} % % \GetFileInfo{euflag.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,\@tempdima} % \DoNotIndex{\@inlabelfalse,\selectfont,\mathcode} % \DoNotIndex{\newmathalphabet,\rmdefault,\bfdefault} % \DoNotIndex{\DeclareRobustCommand,\@ifpackagewith} % \DoNotIndex{\#,\%,\&,\*,\-,\^,\_,\|,\~,\$} % \DoNotIndex{\acro,\addbibresource,\addcontentsline,\addtolength} % \DoNotIndex{\allowbreak,\alph,\@Alph,\and,\appendix,\arrayrulewidth} % \DoNotIndex{\ast,\baselinestretch,\bfseries,\bgroup,\Bib,\BibTeX} % \DoNotIndex{\BiBTeX,\BIBTeX,\bigskip,\box,\caption,\centering,\char} % \DoNotIndex{\CharacterTable,\CheckSum,\citeyear,\cjktext,\ClassError} % \DoNotIndex{\classorpackage,\CodelineIndex,\color,\colorbox} % \DoNotIndex{\columnsep,\columnwidth,\Con,\ConTeXt} % \DoNotIndex{\CPKannotationindent,\CPKdocname,\CPKdoctype,\CPKmenusep} % \DoNotIndex{\CPKpoststrut,\CPKprestrut,\CPKrevmarg,\CPKrunningecho} % \DoNotIndex{\CPKthisjob,\CPKthispackage,\CPKvstrut,\c@section} % \DoNotIndex{\@currsize,\DeclareOption,\declarepostamble} % \DoNotIndex{\declarepreamble,\DescribeColor,\DescribeEnv} % \DoNotIndex{\DescribeError,\DescribeOption,\DescribePackage} % \DoNotIndex{\DescribeTemplate,\descriptionlabel,\divide,\DoNotIndex} % \DoNotIndex{\dotfill,\dots,\@dottedtocline,\DoubleperCent,\doxitem} % \DoNotIndex{\dp,\egroup,\emph,\empty,\EnableCrossrefs} % \DoNotIndex{\encodingdefault,\endbatchfile,\endpreamble,\enspace} % \DoNotIndex{\ensuremath,\fa,\fbox,\fboxrule,\fboxsep,\file,\Finale} % \DoNotIndex{\flushright,\fnote,\font,\fontdimen,\fontencoding} % \DoNotIndex{\fontfamily,\fontseries,\fontshape,\fontsize,\footnote} % \DoNotIndex{\footnotesize,\from,\generate,\GetFileInfo,\HandRight} % \DoNotIndex{\@height,\@@hline,\href,\hrule,\hsize,\huge,\Huge} % \DoNotIndex{\hyperref,\hypersetup,\hyphenation,\ifdim,\@ifnextchar} % \DoNotIndex{\itshape,\keepsilent,\keys,\labelenumi,\LabelFont} % \DoNotIndex{\labelformat,\large,\Large,\LARGE,\LaTeX,\LaTeXe} % \DoNotIndex{\leftmark,\lfoot,\lhead,\longestline,\lstloadlanguages} % \DoNotIndex{\l@subsection,\l@subsubsection,\ltx@ifpackageloaded} % \DoNotIndex{\LyX,\MacroFont,\marginfont,\marginnote,\medskip} % \DoNotIndex{\menu,\menusep,\message,\MF,\@minus,\MP,\Msg} % \DoNotIndex{\multirow,\NeedsTeXFormat,\newcommand,\newcounter} % \DoNotIndex{\newgeometry,\newlength,\newwrite,\nicefrac,\noalign} % \DoNotIndex{\nocite,\noindent,\nolinkurl,\nopreamble,\normalfont} % \DoNotIndex{\normalsize,\numberstring,\obeyspaces,\ordinal} % \DoNotIndex{\PackageError,\pageref,\phantomsection,\@plus} % \DoNotIndex{\@pnumwidth,\preamble,\PrintChanges} % \DoNotIndex{\printexternalcurrentfont,\PrintIndex,\Provides} % \DoNotIndex{\qquad,\quad,\raisebox,\RecordChanges,\reflectbox} % \DoNotIndex{\refname,\renewcommand,\renewmenumacro,\reserved@a} % \DoNotIndex{\rightarrow,\rightmark,\rmfamily,\rotatebox,\rule} % \DoNotIndex{\school,\sloppy,\smallskip,\SMC,\SMC@unknown@warning} % \DoNotIndex{\Square,\stanza,\star,\@startsection,\stepcounter} % \DoNotIndex{\StopEventually,\subsubsection,\tableofcontents} % \DoNotIndex{\textbackslash,\textbf,\textdegree,\texteiad} % \DoNotIndex{\textheight,\textit,\textlangle,\textrangle,\textsf} % \DoNotIndex{\textSMC,\textsuperscript,\texttt,\TheSbox} % \DoNotIndex{\thesection,\thinspace,\tiny,\@tocrmarg} % \DoNotIndex{\tubhideheight,\tubreflect,\uline,\updefault} % \DoNotIndex{\upshape,\use@babel,\@usebib,\usedir,\usepostamble} % \DoNotIndex{\usepreamble,\vbox,\vfill,\vrefrange,\vrule} % \DoNotIndex{\Xe,\XeLaTeX,\XeTeX,\@xhline} % \DoNotIndex{\classorpackage} % \DoNotIndex{\euflag} % \DoNotIndex{\FiveStar} % \DoNotIndex{\bigstar} % \DoNotIndex{\PassOptionsToPackage} % \DoNotIndex{\vfill} % \DoNotIndex{\euflag[-.167em]} % \DoNotIndex{\scalebox} % \DoNotIndex{\colorbox} % \DoNotIndex{\fboxsep} % \DoNotIndex{\vbox} % \setcounter{tocdepth}{5} % \setcounter{secnumdepth}{5} % \makeatletter % \def\@@doxdescribe#1#2{\endgroup \ifdox@noprint\else\marginpar{\raggedleft \@nameuse{PrintDescribe#1}{\LabelFont[\color{DarkRed}]{#2}}}\fi \ifdox@noindex\else \@nameuse{Special#1Index}{#2}\fi \endgroup\@esphack\ignorespaces} % \makeatother % % \def\fileversion{0.91} % \def\filedate{2023/12/30} % \title{The \textsf{euflag} \LaTeXe\ package\thanks{% % This document corresponds to \textsf{euflag} % \textit{v.}\ \fileversion $\beta$, dated \filedate.} % \\[1em]\Large % A command to reproduce the flag of the European Union} % \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 single command % {\ttfamily{}\textbackslash{}euflag} which reproduces the official flag % of the European Union\phantomsection\label{EU}\marginpar{\small\HandRight} (\textsc{eu})\index{European Union|see{EU}}\index{EU|textbf} using the % built-in \texttt{picture} environment (no need for % TikZ).\par % The flag is reproduced at 1em high based on the current % font size, so it can be scaled arbitrarily by changing the % font size locally (see examples in the table \vpageref{examples}). An option allows for the flag baseline % to be aligned on the bottom star.\par % \par\centering % \includegraphics[width=.666\columnwidth]{euflag.png} % \end{abstract} % \clearpage % \tableofcontents % \clearpage % \subsection*{Typographic representation}\label{typorep} % In this document, the following information items are shown in % this way:\par % \par\medskip{\sffamily\rmfamily % \small\sffamily % \begingroup % \centering % \begin{tabular}{@{}% % l% % >{\renewcommand{\baselinestretch}{0.8}\selectfont{}\raggedright{}\renewcommand{\baselinestretch}{0.8}\selectfont{}\CPKprestrut\arraybackslash}p{12cm}<{}% % @{}} % \multicolumn{1}{@{}>{\renewcommand{\baselinestretch}{0.8}\selectfont{}\raggedright{}\CPKprestrut}b{\widthof{environments}}<{}}{\sffamily\bfseries Item}& % \multicolumn{1}{>{\renewcommand{\baselinestretch}{0.8}\selectfont{}\raggedright{}\CPKprestrut\arraybackslash}b{12cm}<{}@{}}{\sffamily\bfseries Description}\\[2pt]\hline % \CPKvstrut % {\ttfamily{}\textbackslash{}command}&name of a \LaTeX{} `command' % (\TeX{} macro or control sequence)\\ % \texttt{environment}&name of a \LaTeX{} environment\\ % {\ttfamily{}filename}\thinspace&name of a file\\ % \textbf{\texttt{option}}&name of an option to a \LaTeX{} command, environment, % class, or package\\ % \textsf{package}&name of a \LaTeX{} package\\ % \emph{productname}&a product name\\ % {\ttfamily{}systemitem}\thinspace&a computer system item (eg hostname or data value)\\ % \texttt{}\index{tag=\texttt{\char'074 tag/\char'076 } (empty element)}\index{empty elements:!tag=\texttt{\char'074 tag/\char'076}}&a tag name in a markup language (eg \textsc{xml})\\ % {\ttfamily{}varname}&a variable name in a supported language\\[2pt]\hline % \end{tabular} % \par\endgroup % } % \par % \clearpage % \section*{Latest changes} % \subsection*{v.0.91 (2023-12-30)} % \paragraph*{Regression update for updated db2dtx} % \begin{itemize} % \item Move to ClassPack 1.26. % \end{itemize} % \subsection*{v.0.9 (2023-06-05)} % \paragraph*{Regression update} % \begin{itemize} % \item Move to ClassPack 1.23. % \end{itemize} % \subsection*{v.0.8 (2020-05-22)} % \paragraph*{Reference update} % \begin{itemize} % \item Added missing reference to Claudio's % paper. % \end{itemize} % \subsection*{v.0.7 (2020-05-16)} % \paragraph*{Regression release} % \begin{itemize} % \item Updated to use % \emph{ClassPack} 1.19; % \item Switched all \texttt{@conformance}\index{conformance=\texttt{\char'100 conformance} (attribute)}\index{attributes:!conformance=\texttt{\char'100 conformance}} attributes on % revision dates to \texttt{@YYYY-MM-DD}\index{YYYY-MM-DD=\texttt{\char'100 YYYY-MM-DD} (attribute)}\index{attributes:!YYYY-MM-DD=\texttt{\char'100 YYYY-MM-DD}}. % \end{itemize} % \par\bigskip % See p.\thinspace\pageref{changehistory} for earlier changes. % \section{Background} % This package provides a command {\ttfamily{}\textbackslash{}euflag} % for reproducing the flag of the European Union. It follows % exactly the official specification \parencite{emblem}. The EU’s web site says:\par % \begin{quotation}\small\sffamily\parindent0pt % \parskip.5\baselineskip % \color{DarkBlue}\noindent % The European flag symbolises both the European Union % and, more broadly, the identity and unity of Europe.\par % \textbf{It features a circle of 12 gold % stars on a blue background. They stand for the ideals of % unity, solidarity and harmony among the peoples of % Europe.}\par % The number of stars has nothing to do with the number of % member countries, though the circle is a symbol of % unity.\par % \subsubsection*{History of the European flag} % The history of the flag goes back to 1955. The Council % of Europe — which defends human rights and promotes European % culture — chose the present design for its own use. In the % years that followed, it encouraged the emerging European % institutions to adopt the same flag.\par % In 1983, the European Parliament decided that the % Communities’ flag should be that used by the Council of % Europe. In 1985, it was adopted by all EU leaders as the % official emblem of the European Communities, later to become % the European Union. In addition, all European institutions % now have their own emblems.\par % \hfill\begingroup % \scriptsize\color{Black}\url{https://europa.eu/european-union/about-eu/symbols/flag_en}\parfillskip=0pt\par\endgroup % \end{quotation} % The {\ttfamily{}\textbackslash{}euflag} command provides a simple % way to use the flag in any \LaTeX{} document. Details of % construction and spacing are taken from the official % specification in the \href{http://publications.europa.eu/code/en/en-5000100.htm}{Graphics % guide to the European emblem}\thinspace.\par % Since the publication of v0.4 of this package in February % 2019, Claudio Beccari % has investigated ways to produce the flag using only \LaTeX{}'s % drawing facilities and the \textsf{xfp} package. He % has written a very comprehensive paper about this in % \emph{\citefield{beccari2019}{journaltitle}}, the journal of the % Gruppo Utilizzatori % Italiani di \TeX{}\phantomsection\label{GUIT}\marginpar{\small\HandRight} (\guit)\index{Gruppo Utilizzatori Italiani di \TeX{}|see{GUIT}}\index{GUIT|textbf}, explaining how he did it % \parencite{beccari2019}.\par % More recently Wilhelm Haager has produced the % \textsf{worldflags} package, which reproduces all the % world's flags — including the flag of the European Union — % using the graphics language TikZ \parencite{wflags}.\par % For an extensive discussion of the flag and its precursors % and derivatives, see the Wikipedia entry for \emph{\citefield{euroflag}{booktitle}} \parencite{euroflag}.\par % \clearpage % \section{Usage}\label{usage} % The flag is reproduced at 1em high, with the bottom edge % at the current baseline like this: % \euflag\ using the % {\ttfamily{}\textbackslash{}euflag} command. % The \textbf{\texttt{baseline}} package option or an optional % length argument to the {\ttfamily{}\textbackslash{}euflag} command can % be used to change this (see below).\par % The font size of the enclosing environment can be changed % to make the flag appear at any size. In the examples below, % the code and the flags are in {\ttfamily{}m}-type % cells (middle-vertical-align, using the % \textsf{array} package), so their apparent baselines % differ.\par % \par\medskip{\sffamily\small\label{examples} % \small\sffamily % \begingroup % \centering % \begin{tabular}{@{}% % >{\renewcommand{\baselinestretch}{0.8}\selectfont{}\raggedright{}\renewcommand{\baselinestretch}{0.8}\selectfont{}\CPKprestrut}m{0.5\columnwidth}% % >{\renewcommand{\baselinestretch}{0.8}\selectfont{}\raggedright{}\renewcommand{\baselinestretch}{0.8}\selectfont{}\CPKprestrut\arraybackslash}m{0.5\columnwidth}<{}% % @{}} % \hline % \CPKvstrut % \verb|{\tiny\euflag}|\thinspace&\tiny\euflag\vrule height2em width0pt\\ % \verb|{\scriptsize\euflag}|\thinspace&\scriptsize\euflag\\ % \verb|{\footnotesize\euflag}|\thinspace&\footnotesize\euflag\\ % \verb|{\small\euflag}|\thinspace&\small\euflag\\ % \verb|{\normalsize\euflag}|\thinspace&\normalsize\euflag\\ % \verb|{\large\euflag}|\thinspace&\large\euflag\\ % \verb|{\Large\euflag}|\thinspace&\Large\euflag\\ % \verb|{\LARGE\euflag}|\thinspace&\LARGE\euflag\\ % \verb|{\huge\euflag}|\thinspace&\huge\euflag\\ % \verb|{\fontsize{64}{72}\selectfont\euflag}|\thinspace&\fontsize{64}{72}\selectfont\euflag\\ % \verb|{\fontsize{128}{0}\selectfont\euflag}|\thinspace&\fontsize{128}{0}\selectfont\euflag\\[2pt]\hline % \end{tabular} % \par\endgroup % } % To move the flag down so that the bottom star's baseline % becomes the flag's baseline, like this: % \euflag[-.167em], load % the package with the \textbf{\texttt{baseline}} option:\par % \iffalse %<*ignore> % \fi \begin{lstlisting}[language={[LaTeX]TeX}] \usepackage[baseline]{euflag} \end{lstlisting} % \iffalse % % \fi % (that will affect all {\ttfamily{}\textbackslash{}euflag} commands). % Alternatively, use the optional argument to % {\ttfamily{}\textbackslash{}euflag} to lower the flag by \nicefrac16em or % whatever amount you wish, on a single occasion, eg % {\ttfamily{}\textbackslash{}euflag[-.167em]}\par % \StopEventually{\label{endcode}% % \clearpage % \addcontentsline{toc}{section}{Change History}% % \label{changehistory}% % \PrintChanges % \clearpage % \label{codeindex}% % \addcontentsline{toc}{section}{Index}% % \PrintIndex} % \clearpage\subsection*{Code for the } % \iffalse %<*package> % \fi % \section{Implementation} % \par % \subsection{Auto-initialisation}\label{:autoinit} % This section is added automatically by \textit{ClassPack} % as a preamble to all classes and style packages. % For details see the \textsf{ltxdoc} package documentation. % \par\smallskip % % \begingroup\color{DarkRed}\footnotesize % \leavevmode\enspace{\scriptsize1}\quad{\ttfamily\textbackslash NeedsTeXFormat\{LaTeX2e\}[2016/02/01]}\\ % \leavevmode\enspace{\scriptsize2}\quad{\ttfamily\textbackslash ProvidesPackage\{euflag\}[2023/12/30 v0.91}\\ % \leavevmode\enspace{\scriptsize3}\qquad{\ttfamily A command to reproduce the flag of the European Union]}\\\endgroup % \setcounter{CodelineNo}{3} % \subsection{Options}\label{options} % \iffalse %% %% ****************************************************************** %% %% Options % \fi % \begin{CPKlength}{EUF@baseline}\label{length--EUF@baseline} % Define an option to set the default position to align % the lowest star with the text baseline of the surrounding % text. The default is zero, meaning the bottom of the flag % aligns with the text baseline; setting this option will % lower the flag so that the lowest star aligns with the % text baseline.\par % \begin{macrocode} \newlength{\EUF@baseline} \setlength{\EUF@baseline}{0pt} \DeclareOption{baseline}{\setlength\EUF@baseline{-.167em}} \DeclareOption*{% \PackageWarning{euflag}{Unknown option ‘\CurrentOption’; please Read The Fine Manual}% } \ProcessOptions % \end{macrocode} % \end{CPKlength} % Now invoke the options.\par % \iffalse %% Now invoke the options. % \fi % \begin{macrocode} \ExecuteOptions{} \ProcessOptions\relax % \end{macrocode} %\iffalse %% %% Packages required for the package %% % \fi % \subsection{Packages required for the package}\label{stypackages} % Packages required for operation: % \begin{CPKpackage}{noto} % Sets the Google NoTo typeface as the default. % \iffalse %% Sets the Google NoTo typeface as the default. % \fi % \begin{macrocode} \RequirePackage{noto}% % \end{macrocode} % \end{CPKpackage} % \begin{CPKpackage}{fancyhdr} % Provide for running headers and footers. % \iffalse %% Provide for running headers and footers. % \fi % \begin{macrocode} \RequirePackage{fancyhdr}% % \end{macrocode} % \end{CPKpackage} % \begin{CPKpackage}{ltxcmds} % Some \LaTeX{} kernel commands for general use, % but in the case of \emph{ClassPack}, % particularly % {\ttfamily{}\textbackslash{}ltx@ifpackageloaded}. % \iffalse %% Some \LaTeX{} kernel commands for general use, but in the case of ClassPack, particularly ltx@ifpackageloaded. % \fi % \begin{macrocode} \RequirePackage{ltxcmds}% % \end{macrocode} % Define the ltx@ifpackageloaded command. % \begin{macrocode} \ifdefined\IfPackageLoaded\relax \else\newcommand{\IfPackageLoaded}[3]{% \ltx@ifpackageloaded{#1}{#2}{#3}}\fi % \end{macrocode} % \end{CPKpackage} % \begin{CPKpackage}{parskip} % Creates paragraphs separated by white-space with no % indentation. % \iffalse %% Creates paragraphs separated by white-space with no indentation. % \fi % \begin{macrocode} \RequirePackage{parskip}% % \end{macrocode} % \end{CPKpackage} % \begin{CPKpackage}{xcolor} % Provide color. % \iffalse %% Provide color. % \fi % \begin{macrocode} \IfPackageLoaded{xcolor}{\relax}{% \RequirePackage[svgnames]{xcolor}% }% \@ifundefined{T}{% \newcommand{\T}[2]{{\fontencoding{T1}% \selectfont#2}}}{} % \end{macrocode} % There seems to be a bug in the T1 encoding of some package % (unidentified, but possibly \textsf{xcolor}) which % uses the command {\ttfamily{}\textbackslash{}T1}, which is an % impossibility (no digits allowed in command names). So we fake % it here to stop \LaTeX{} complaining, by dropping the first % argument on the floor. % \end{CPKpackage} % \begin{CPKpackage}{graphicx} % Provide for graphics (PNG, JPG, or PDF format (only) for % pdflatex; EPS format (only) for standard \LaTeX{}); and for % reflection and rotation features. % \iffalse %% Provide for graphics (PNG, JPG, or PDF format (only) for pdflatex; EPS format (only) for standard \LaTeX{}); and for reflection and rotation features. % \fi % \begin{macrocode} \RequirePackage{graphicx}% % \end{macrocode} % \end{CPKpackage} % \begin{CPKpackage}{amssymb} % Provide for the American Mathematical Society's symbols % (see their documentation for details). % \iffalse %% Provide for the American Mathematical Society's symbols (see their documentation for details). % \fi % \begin{macrocode} \RequirePackage{amssymb}% % \end{macrocode} % \end{CPKpackage} % \begin{CPKpackage}{anyfontsize} % \begin{macrocode} \RequirePackage{anyfontsize}% % \end{macrocode} % \end{CPKpackage} % % \subsection{Changes to package defaults}\label{packagemods} % \iffalse %% %% ****************************************************************** %% %% Changes to package defaults % \fi % The only changes are to implement the blue and yellow % according to the specification. Note that exact Pantone® % colour codes are not available, so the % \textsc{html} values used on the % \textsc{eu}\index{EU} web site are used here. The % \textsc{cmyk} values are commented out in the % code; they are available for users to test.\par % \definecolor{PantoneReflexBlue}{HTML}{003399} % \begin{CPKcolor}{PantoneReflexBlue}\label{color--PantoneReflexBlue} % As specified.\par % \begin{macrocode} \definecolor{PantoneReflexBlue}{HTML}{003399} %\definecolor{PantoneReflexBlue}{cmyk}{1.00,.67,0,.40} % \end{macrocode} % \end{CPKcolor} % \definecolor{PantoneYellow}{HTML}{FFCC00} % \begin{CPKcolor}{PantoneYellow}\label{color--PantoneYellow} % As specified.\par % \begin{macrocode} \definecolor{PantoneYellow}{HTML}{FFCC00} %\definecolor{PantoneYellow}{cmyk}{0,.2,1,0} % \end{macrocode} % We could have just used the Yellow from % the \textsf{xcolor} package, but it was felt % better to be explicit.\par % \end{CPKcolor} % \subsection{The flag} % \iffalse %% %% ****************************************************************** %% %% The flag % \fi % We now use the {\ttfamily{}\textbackslash{}bigstar} command from the % \textsf{amssymb} package (earlier versions used % the {\ttfamily{}\textbackslash{}FiveStar} command from the % \textsf{bbding} package, but that did not reliably % scale beyond about 100pt).\par % \begin{CPKmacro}{\eustar}\label{macro--eustar} % It needs to scale, so we implement it as a command % using {\ttfamily{}\textbackslash{}scalebox}.\par % \begin{macrocode} \newcommand{\eustar}{\scalebox{0.1}{\ensuremath{\bigstar}}} % \end{macrocode} % This is the only slightly uncertain part of the % implementation: the specification calls for the star to be % \nicefrac1{18} of the height of the flag, but \LaTeX{} only has % access to the bounding-box of the glyph. The value of 0.1 % given here is therefore experimental and subject to change % in future in the light of feedback.\par % \end{CPKmacro} % The command itself is a blue {\ttfamily{}\textbackslash{}colorbox} % containing the stars set at the clock-points of a circle in % a \LaTeX{} \texttt{picture} environment.\par % \begin{CPKmacro}{\makestars}\label{macro--makestars} % Separate the making of the ring of stars from the flag % itself so that the ring of stars can be used % separately.\par % For the \texttt{picture} environment, set the % unit to 1em and then divide it by 18. This enables us % conveniently to use six units for the axes behind the circle % of stars, because the specification says it must have a % radius of \nicefrac13 of the height (ie \nicefrac6{18}). The % positioning argument was found by trial and error.\par % \begin{macrocode} \newcommand{\makestars}{% \color{PantoneYellow}% \setlength{\unitlength}{1em} \divide\unitlength by18 \begin{picture}(6,6)(-2,3.5) \put(6,0){\eustar} \put(5.196,3){\eustar} \put(3,5.196){\eustar} \put(0,6){\eustar} \put(-3,5.196){\eustar} \put(-5.196,3){\eustar} \put(-6,0){\eustar} \put(-5.196,-3){\eustar} \put(-3,-5.196){\eustar} \put(0,-6){\eustar} \put(3,-5.196){\eustar} \put(5.196,-3){\eustar} \end{picture}% } % \end{macrocode} % The positioning of the individual stars was found with % simple trigonometry. It would have been possible to % construct this from a loop cycling through the 12 % positions, but it is simpler to do it like this.\par % \end{CPKmacro} % \begin{CPKmacro}{\euflag}\label{macro--euflag} % Before the {\ttfamily{}\textbackslash{}colorbox} is used, set % the {\ttfamily{}\textbackslash{}fboxsep} length to % zero so that there is no border around the box, and then % raise (lower) the box by the value of \DescribeLength{EUF@baseline}{\ttfamily{}\textbackslash{}EUF@baseline} as set by the % \textbf{\texttt{baseline}} option.\par % \begin{macrocode} \newcommand{\euflag}[1][\EUF@baseline]{% {% \fboxsep0pt \raisebox{#1}{% \colorbox{PantoneReflexBlue}{% % \end{macrocode} % The rectangle itself is formed from a % {\ttfamily{}\textbackslash{}vbox} 1em high and 1.5em wide. The % paragraph skip and indent are zeroed to avoid unwanted % space, and the content is centered and made % yellow.\par % \begin{macrocode} \vbox to1em{% \hsize1.5em \parskip0pt \parindent0pt \centering \makestars \vfill % \end{macrocode} % Finally, close off the containing % {\ttfamily{}\textbackslash{}vbox} and other containers.\par % \begin{macrocode} }% end vbox }% end colorbox }% end raisebox }% end encapsulation }% end command % \end{macrocode} % \end{CPKmacro} % That’s it. Any problems, mail me.\par % \iffalse % % \fi % \clearpage % \raggedright % \raggedright\printbibliography\clearpage % \appendix % \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 (\textsc{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:]Any work being distributed under this License.\par % \item[Derived Work:]Any work that under any applicable law is derived from % the Work.\par % \item[Modification:]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:]To apply any procedure that produces a Derived Work % under any applicable law.\par % \item[Distribution:]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 % shared file systems such as Sun's Network File System % (\textsc{nfs}).\par % \item[Compiled Work:]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:]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:]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~\vref{item-distribute} 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~\vref{item-conditions}, 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{item-currmaint}, 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~\vref{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~\vref{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}.). % \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~\vref{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~\vref{item-announce} % or~\vref{item-change}, 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 % \textsc{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{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 \textsc{lppl} or otherwise % give the impression that your work is distributed under the % \textsc{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. % 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}\thinspace, {\ttfamily{}pig.ins}\thinspace, 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 % \textsc{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 \textsc{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 \textsc{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