diff options
Diffstat (limited to 'ekdosis.dtx')
-rw-r--r-- | ekdosis.dtx | 654 |
1 files changed, 625 insertions, 29 deletions
diff --git a/ekdosis.dtx b/ekdosis.dtx index 49ce5b9..b9137ef 100644 --- a/ekdosis.dtx +++ b/ekdosis.dtx | |||
@@ -92,33 +92,72 @@ along with this program. If not, see | |||
92 | \usepackage{xcolor} | 92 | \usepackage{xcolor} |
93 | \definecolor{ekdcolor}{RGB}{243,241,235} | 93 | \definecolor{ekdcolor}{RGB}{243,241,235} |
94 | \definecolor{cinnamon}{rgb}{0.82, 0.41, 0.12} | 94 | \definecolor{cinnamon}{rgb}{0.82, 0.41, 0.12} |
95 | \usepackage{hyperxmp} | 95 | \PassOptionsToPackage{bookmarks=true}{hyperref} |
96 | \usepackage{xurl} | 96 | \usepackage{xurl} |
97 | \usepackage[numbered]{hypdoc} | 97 | \usepackage[numbered]{hypdoc} |
98 | \usepackage[loadlang=en]{metastr} | ||
98 | \hypersetup{ | 99 | \hypersetup{ |
99 | unicode=true, | ||
100 | colorlinks, | 100 | colorlinks, |
101 | allcolors=cinnamon, | 101 | allcolors=cinnamon, |
102 | keeppdfinfo, | ||
103 | linktocpage=true, | 102 | linktocpage=true, |
104 | pdfauthor={Robert Alessi}, | 103 | pdftype={Text} |
105 | pdftitle={The ekdosis package}, | 104 | } |
106 | pdfcontactemail={alessi@robertalessi.net}, | ||
107 | pdfcontacturl={http://www.robertalessi.net/ekdosis}, | ||
108 | pdfcopyright={Copyright (C) 2018 Robert Alessi | ||
109 | <alessi@robertalessi.net>. This document is licensed under the | ||
110 | Creative Commons Attribution-ShareAlike 4.0 International | ||
111 | License. To view a copy of this license, visit | ||
112 | http://creativecommons.org/licenses/by-sa/4.0/ or send a letter to | ||
113 | Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.}, | ||
114 | pdflicenseurl={https://creativecommons.org/licenses/by-sa/4.0/legalcode}, | ||
115 | pdfmetalang={en-US}, | ||
116 | pdftype={Text}, | ||
117 | pdfkeywords={Arabic language, arabtex, luatex}} | ||
118 | \usepackage{uri} | 105 | \usepackage{uri} |
119 | \usepackage[lot]{multitoc} | 106 | \usepackage[nospace]{varioref} |
120 | \usepackage{ekdosis} | 107 | \labelformat{section}{sect.~#1} |
121 | \usepackage{arabluatex} | 108 | \usepackage{arabluatex} |
109 | |||
110 | \usepackage{ekdosis} | ||
111 | \metaset{titletext}{% | ||
112 | \metapick[#1]{title}% | ||
113 | \metacompose[#1]{subtitle}{\metaget[sep]{subtitle}}{}{}} | ||
114 | \metaset[print]{titletext}{% | ||
115 | \metatitleline[print]{title}% | ||
116 | \metatitleline[print]{subtitle}% | ||
117 | \metatitleline[print]{author}% | ||
118 | \metatitleline[print]{contactemail}% | ||
119 | \metatitlelinetwo[print]{date}[print]{draft}} | ||
120 | \metaset[skip]{subtitle}{\vspace{1ex}} | ||
121 | \metaset[skip]{author}{\vspace{2ex}} | ||
122 | \metaset[skip]{date}{\vspace{1ex}} | ||
123 | \metaset[style]{title}{\LARGE} | ||
124 | \metaset[style]{author}{\large} | ||
125 | \metaset[sep]{draft}{ -- } | ||
126 | \metasetlang{en-US} | ||
127 | \metaset{title}{ἔκδοσις} | ||
128 | \metaset{date}{\filedate} | ||
129 | \metaset{draft}{\fileversion} | ||
130 | \metaset{subject}{TEI xml compliant critical editions} | ||
131 | \metaset{subtitle}{Typesetting TEI xml Compliant Critical Editions} | ||
132 | \metaset[print]{subtitle}{Typesetting \texttt{TEI xml} Compliant | ||
133 | Critical Editions} | ||
134 | \metaset{author}{Robert Alessi} | ||
135 | \metaset{keywords}{LaTeX, Lua, TEI xml, multilingual critical | ||
136 | editions, alignment, segmentation} | ||
137 | \metaset{contactemail}{alessi@roberalessi.net} | ||
138 | \metaset[print]{contactemail}{\mailto[ekdosis]{alessi@robertalessi.net}} | ||
139 | \metaset{contacturl}{http://www.roberalessi.net} | ||
140 | \metaset{partof}{The ekdosis Package} | ||
141 | \metaset[print]{partof}{The \textsf{ekdosis} Package} | ||
142 | \metaset{copyrightowner}{\metapick[#1]{author}} | ||
143 | \metaset{copyrightdate}{2020} | ||
144 | \metaset{licensemessage}{Permission is granted to copy, distribute | ||
145 | and/or modify this document under the terms of the GNU Free | ||
146 | Documentation License, Version 1.3 or any later version published by | ||
147 | the Free Software Foundation; with no Invariant Sections, no | ||
148 | Front-Cover Texts, and no Back-Cover Texts. A copy of the license | ||
149 | is included in the section entitled ``GNU Free Documentation | ||
150 | License''.} | ||
151 | \metaset{licenseurl}{https://www.gnu.org/licenses/fdl-1.3.html} | ||
152 | \metaset[print]{licenseurl}{% | ||
153 | \url{https://www.gnu.org/licenses/fdl-1.3.html}} | ||
154 | \metaset[cmd]{licenselogo}{\includegraphics[scale=0.75]{#1}} | ||
155 | \metawritepdfinfo | ||
156 | \metawritepdfaux | ||
157 | \metawritepdfpreamble | ||
158 | \metawritepdfcontact | ||
159 | \metawritepdfrights | ||
160 | \usepackage[lot]{multitoc} | ||
122 | \usepackage{relsize} | 161 | \usepackage{relsize} |
123 | \usepackage{units} | 162 | \usepackage{units} |
124 | \usepackage{tikz} | 163 | \usepackage{tikz} |
@@ -195,17 +234,19 @@ along with this program. If not, see | |||
195 | % \GetFileInfo{\jobname.dtx} | 234 | % \GetFileInfo{\jobname.dtx} |
196 | % \DoNotIndex{\newcommand,\newenvironment} | 235 | % \DoNotIndex{\newcommand,\newenvironment} |
197 | % | 236 | % |
198 | % \title{\tcbox[colframe=black, enhanced, tikznode, drop lifted | 237 | % \pdfbookmark[1]{\metaterm{title}}{title} |
199 | % shadow, colback=white, boxrule=.25mm]% | 238 | % \begin{tcolorbox}[ |
200 | % {ἔκδοσις\\ | 239 | % colframe=black, |
201 | % Typesetting \texttt{TEI xml} compliant critical editions\\ | 240 | % enhanced, |
202 | % \fileversion\ --- \filedate}} | 241 | % drop lifted shadow, |
203 | % | 242 | % colback=white, |
204 | % \author{Robert Alessi \\ | 243 | % boxrule=.25mm, |
205 | % \mailto[ekdosis package]{alessi@robertalessi.net}} | 244 | % halign=center, |
206 | % \date{} | 245 | % center |
246 | % ] | ||
247 | % \metapick[print]{titletext} | ||
248 | % \end{tcolorbox} | ||
207 | % | 249 | % |
208 | % \maketitle | ||
209 | % \footnotesize | 250 | % \footnotesize |
210 | % \ekdtableofcontents | 251 | % \ekdtableofcontents |
211 | % \normalsize | 252 | % \normalsize |
@@ -228,6 +269,12 @@ along with this program. If not, see | |||
228 | % terms of the GNU General Public License (GPL) version 3. | 269 | % terms of the GNU General Public License (GPL) version 3. |
229 | % \end{abstract} | 270 | % \end{abstract} |
230 | % | 271 | % |
272 | % \section*{License and disclaimer} | ||
273 | % \addcontentsline{toc}{section}{License and disclamer} | ||
274 | % \subsection*{License applicable to this document} | ||
275 | % \pdfbookmark[2]{Licence applicable to this document}{copyright-doc} | ||
276 | % \metapick[print]{rightstext} (See below \vref{sec:fdl}.) | ||
277 | % | ||
231 | % \section{Introduction} | 278 | % \section{Introduction} |
232 | % \begin{keyfigure}[H]{c={Grid Typesetting}, t={Each square in the grid | 279 | % \begin{keyfigure}[H]{c={Grid Typesetting}, t={Each square in the grid |
233 | % has a side length of \unit[10]{pt}. Therefore, the distance | 280 | % has a side length of \unit[10]{pt}. Therefore, the distance |
@@ -275,7 +322,556 @@ along with this program. If not, see | |||
275 | % at the station yesterday. | 322 | % at the station yesterday. |
276 | % \end{specimen} | 323 | % \end{specimen} |
277 | % \end{alignment} | 324 | % \end{alignment} |
325 | % | ||
326 | % \section{GNU Free Documentation License} | ||
327 | % \label{sec:fdl} | ||
328 | % \textbf{Version 1.3, 3 November 2008} | ||
329 | % | ||
330 | % \begin{center} | ||
331 | % | ||
332 | % Version 1.3, 3 November 2008 | ||
333 | % | ||
334 | % | ||
335 | % Copyright \copyright{} 2000, 2001, 2002, 2007, 2008 Free | ||
336 | % Software Foundation, Inc. | ||
337 | % | ||
338 | % \bigskip | ||
339 | % | ||
340 | % \url{https://fsf.org/} | ||
341 | % | ||
342 | % \bigskip | ||
343 | % | ||
344 | % Everyone is permitted to copy and distribute verbatim copies | ||
345 | % of this license document, but changing it is not allowed. | ||
346 | % \end{center} | ||
347 | % | ||
348 | % | ||
349 | % \needspace{\baselineskip} | ||
350 | % \begin{center} | ||
351 | % {\bf\large Preamble} | ||
352 | % \end{center} | ||
353 | % | ||
354 | % The purpose of this License is to make a manual, textbook, or other | ||
355 | % functional and useful document ``free'' in the sense of freedom: to | ||
356 | % assure everyone the effective freedom to copy and redistribute it, | ||
357 | % with or without modifying it, either commercially or noncommercially. | ||
358 | % Secondarily, this License preserves for the author and publisher a way | ||
359 | % to get credit for their work, while not being considered responsible | ||
360 | % for modifications made by others. | ||
361 | % | ||
362 | % This License is a kind of ``copyleft'', which means that derivative | ||
363 | % works of the document must themselves be free in the same sense. It | ||
364 | % complements the GNU General Public License, which is a copyleft | ||
365 | % license designed for free software. | ||
366 | % | ||
367 | % We have designed this License in order to use it for manuals for free | ||
368 | % software, because free software needs free documentation: a free | ||
369 | % program should come with manuals providing the same freedoms that the | ||
370 | % software does. But this License is not limited to software manuals; | ||
371 | % it can be used for any textual work, regardless of subject matter or | ||
372 | % whether it is published as a printed book. We recommend this License | ||
373 | % principally for works whose purpose is instruction or reference. | ||
374 | % | ||
375 | % | ||
376 | % \needspace{\baselineskip} | ||
377 | % \begin{center} | ||
378 | % {\large\bf 1. APPLICABILITY AND DEFINITIONS\par} | ||
379 | % \end{center} | ||
380 | % | ||
381 | % This License applies to any manual or other work, in any medium, that | ||
382 | % contains a notice placed by the copyright holder saying it can be | ||
383 | % distributed under the terms of this License. Such a notice grants a | ||
384 | % world-wide, royalty-free license, unlimited in duration, to use that | ||
385 | % work under the conditions stated herein. The ``\textbf{Document}'', below, | ||
386 | % refers to any such manual or work. Any member of the public is a | ||
387 | % licensee, and is addressed as ``\textbf{you}''. You accept the license if you | ||
388 | % copy, modify or distribute the work in a way requiring permission | ||
389 | % under copyright law. | ||
390 | % | ||
391 | % A ``\textbf{Modified Version}'' of the Document means any work containing the | ||
392 | % Document or a portion of it, either copied verbatim, or with | ||
393 | % modifications and/or translated into another language. | ||
394 | % | ||
395 | % A ``\textbf{Secondary Section}'' is a named appendix or a front-matter section of | ||
396 | % the Document that deals exclusively with the relationship of the | ||
397 | % publishers or authors of the Document to the Document's overall subject | ||
398 | % (or to related matters) and contains nothing that could fall directly | ||
399 | % within that overall subject. (Thus, if the Document is in part a | ||
400 | % textbook of mathematics, a Secondary Section may not explain any | ||
401 | % mathematics.) The relationship could be a matter of historical | ||
402 | % connection with the subject or with related matters, or of legal, | ||
403 | % commercial, philosophical, ethical or political position regarding | ||
404 | % them. | ||
405 | % | ||
406 | % The ``\textbf{Invariant Sections}'' are certain Secondary Sections whose titles | ||
407 | % are designated, as being those of Invariant Sections, in the notice | ||
408 | % that says that the Document is released under this License. If a | ||
409 | % section does not fit the above definition of Secondary then it is not | ||
410 | % allowed to be designated as Invariant. The Document may contain zero | ||
411 | % Invariant Sections. If the Document does not identify any Invariant | ||
412 | % Sections then there are none. | ||
413 | % | ||
414 | % The ``\textbf{Cover Texts}'' are certain short passages of text that are listed, | ||
415 | % as Front-Cover Texts or Back-Cover Texts, in the notice that says that | ||
416 | % the Document is released under this License. A Front-Cover Text may | ||
417 | % be at most 5 words, and a Back-Cover Text may be at most 25 words. | ||
418 | % | ||
419 | % A ``\textbf{Transparent}'' copy of the Document means a machine-readable copy, | ||
420 | % represented in a format whose specification is available to the | ||
421 | % general public, that is suitable for revising the document | ||
422 | % straightforwardly with generic text editors or (for images composed of | ||
423 | % pixels) generic paint programs or (for drawings) some widely available | ||
424 | % drawing editor, and that is suitable for input to text formatters or | ||
425 | % for automatic translation to a variety of formats suitable for input | ||
426 | % to text formatters. A copy made in an otherwise Transparent file | ||
427 | % format whose markup, or absence of markup, has been arranged to thwart | ||
428 | % or discourage subsequent modification by readers is not Transparent. | ||
429 | % An image format is not Transparent if used for any substantial amount | ||
430 | % of text. A copy that is not ``Transparent'' is called ``\textbf{Opaque}''. | ||
431 | % | ||
432 | % Examples of suitable formats for Transparent copies include plain | ||
433 | % ASCII without markup, Texinfo input format, LaTeX input format, SGML | ||
434 | % or XML using a publicly available DTD, and standard-conforming simple | ||
435 | % HTML, PostScript or PDF designed for human modification. Examples of | ||
436 | % transparent image formats include PNG, XCF and JPG. Opaque formats | ||
437 | % include proprietary formats that can be read and edited only by | ||
438 | % proprietary word processors, SGML or XML for which the DTD and/or | ||
439 | % processing tools are not generally available, and the | ||
440 | % machine-generated HTML, PostScript or PDF produced by some word | ||
441 | % processors for output purposes only. | ||
442 | % | ||
443 | % The ``\textbf{Title Page}'' means, for a printed book, the title page itself, | ||
444 | % plus such following pages as are needed to hold, legibly, the material | ||
445 | % this License requires to appear in the title page. For works in | ||
446 | % formats which do not have any title page as such, ``Title Page'' means | ||
447 | % the text near the most prominent appearance of the work's title, | ||
448 | % preceding the beginning of the body of the text. | ||
449 | % | ||
450 | % The ``\textbf{publisher}'' means any person or entity that distributes | ||
451 | % copies of the Document to the public. | ||
452 | % | ||
453 | % A section ``\textbf{Entitled XYZ}'' means a named subunit of the Document whose | ||
454 | % title either is precisely XYZ or contains XYZ in parentheses following | ||
455 | % text that translates XYZ in another language. (Here XYZ stands for a | ||
456 | % specific section name mentioned below, such as ``\textbf{Acknowledgements}'', | ||
457 | % ``\textbf{Dedications}'', ``\textbf{Endorsements}'', or ``\textbf{History}''.) | ||
458 | % To ``\textbf{Preserve the Title}'' | ||
459 | % of such a section when you modify the Document means that it remains a | ||
460 | % section ``Entitled XYZ'' according to this definition. | ||
461 | % | ||
462 | % The Document may include Warranty Disclaimers next to the notice which | ||
463 | % states that this License applies to the Document. These Warranty | ||
464 | % Disclaimers are considered to be included by reference in this | ||
465 | % License, but only as regards disclaiming warranties: any other | ||
466 | % implication that these Warranty Disclaimers may have is void and has | ||
467 | % no effect on the meaning of this License. | ||
468 | % | ||
469 | % | ||
470 | % \needspace{\baselineskip} | ||
471 | % \begin{center} | ||
472 | % {\large\bf 2. VERBATIM COPYING\par} | ||
473 | % \end{center} | ||
474 | % | ||
475 | % You may copy and distribute the Document in any medium, either | ||
476 | % commercially or noncommercially, provided that this License, the | ||
477 | % copyright notices, and the license notice saying this License applies | ||
478 | % to the Document are reproduced in all copies, and that you add no other | ||
479 | % conditions whatsoever to those of this License. You may not use | ||
480 | % technical measures to obstruct or control the reading or further | ||
481 | % copying of the copies you make or distribute. However, you may accept | ||
482 | % compensation in exchange for copies. If you distribute a large enough | ||
483 | % number of copies you must also follow the conditions in section~3. | ||
484 | % | ||
485 | % You may also lend copies, under the same conditions stated above, and | ||
486 | % you may publicly display copies. | ||
487 | % | ||
488 | % | ||
489 | % \needspace{\baselineskip} | ||
490 | % \begin{center} | ||
491 | % {\large\bf 3. COPYING IN QUANTITY\par} | ||
492 | % \end{center} | ||
493 | % | ||
494 | % | ||
495 | % If you publish printed copies (or copies in media that commonly have | ||
496 | % printed covers) of the Document, numbering more than 100, and the | ||
497 | % Document's license notice requires Cover Texts, you must enclose the | ||
498 | % copies in covers that carry, clearly and legibly, all these Cover | ||
499 | % Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on | ||
500 | % the back cover. Both covers must also clearly and legibly identify | ||
501 | % you as the publisher of these copies. The front cover must present | ||
502 | % the full title with all words of the title equally prominent and | ||
503 | % visible. You may add other material on the covers in addition. | ||
504 | % Copying with changes limited to the covers, as long as they preserve | ||
505 | % the title of the Document and satisfy these conditions, can be treated | ||
506 | % as verbatim copying in other respects. | ||
507 | % | ||
508 | % If the required texts for either cover are too voluminous to fit | ||
509 | % legibly, you should put the first ones listed (as many as fit | ||
510 | % reasonably) on the actual cover, and continue the rest onto adjacent | ||
511 | % pages. | ||
512 | % | ||
513 | % If you publish or distribute Opaque copies of the Document numbering | ||
514 | % more than 100, you must either include a machine-readable Transparent | ||
515 | % copy along with each Opaque copy, or state in or with each Opaque copy | ||
516 | % a computer-network location from which the general network-using | ||
517 | % public has access to download using public-standard network protocols | ||
518 | % a complete Transparent copy of the Document, free of added material. | ||
519 | % If you use the latter option, you must take reasonably prudent steps, | ||
520 | % when you begin distribution of Opaque copies in quantity, to ensure | ||
521 | % that this Transparent copy will remain thus accessible at the stated | ||
522 | % location until at least one year after the last time you distribute an | ||
523 | % Opaque copy (directly or through your agents or retailers) of that | ||
524 | % edition to the public. | ||
525 | % | ||
526 | % It is requested, but not required, that you contact the authors of the | ||
527 | % Document well before redistributing any large number of copies, to give | ||
528 | % them a chance to provide you with an updated version of the Document. | ||
529 | % | ||
530 | % \needspace{\baselineskip} | ||
531 | % \begin{center} | ||
532 | % {\large\bf 4. MODIFICATIONS\par} | ||
533 | % \end{center} | ||
534 | % | ||
535 | % You may copy and distribute a Modified Version of the Document under | ||
536 | % the conditions of sections 2 and 3 above, provided that you release | ||
537 | % the Modified Version under precisely this License, with the Modified | ||
538 | % Version filling the role of the Document, thus licensing distribution | ||
539 | % and modification of the Modified Version to whoever possesses a copy | ||
540 | % of it. In addition, you must do these things in the Modified Version: | ||
541 | % | ||
542 | % \begin{itemize} | ||
543 | % \item[A.] | ||
544 | % Use in the Title Page (and on the covers, if any) a title distinct | ||
545 | % from that of the Document, and from those of previous versions | ||
546 | % (which should, if there were any, be listed in the History section | ||
547 | % of the Document). You may use the same title as a previous version | ||
548 | % if the original publisher of that version gives permission. | ||
549 | % | ||
550 | % \item[B.] | ||
551 | % List on the Title Page, as authors, one or more persons or entities | ||
552 | % responsible for authorship of the modifications in the Modified | ||
553 | % Version, together with at least five of the principal authors of the | ||
554 | % Document (all of its principal authors, if it has fewer than five), | ||
555 | % unless they release you from this requirement. | ||
556 | % | ||
557 | % \item[C.] | ||
558 | % State on the Title page the name of the publisher of the | ||
559 | % Modified Version, as the publisher. | ||
560 | % | ||
561 | % \item[D.] | ||
562 | % Preserve all the copyright notices of the Document. | ||
563 | % | ||
564 | % \item[E.] | ||
565 | % Add an appropriate copyright notice for your modifications | ||
566 | % adjacent to the other copyright notices. | ||
567 | % | ||
568 | % \item[F.] | ||
569 | % Include, immediately after the copyright notices, a license notice | ||
570 | % giving the public permission to use the Modified Version under the | ||
571 | % terms of this License, in the form shown in the Addendum below. | ||
572 | % | ||
573 | % \item[G.] | ||
574 | % Preserve in that license notice the full lists of Invariant Sections | ||
575 | % and required Cover Texts given in the Document's license notice. | ||
576 | % | ||
577 | % \item[H.] | ||
578 | % Include an unaltered copy of this License. | ||
579 | % | ||
580 | % \item[I.] | ||
581 | % Preserve the section Entitled ``History'', Preserve its Title, and add | ||
582 | % to it an item stating at least the title, year, new authors, and | ||
583 | % publisher of the Modified Version as given on the Title Page. If | ||
584 | % there is no section Entitled ``History'' in the Document, create one | ||
585 | % stating the title, year, authors, and publisher of the Document as | ||
586 | % given on its Title Page, then add an item describing the Modified | ||
587 | % Version as stated in the previous sentence. | ||
588 | % | ||
589 | % \item[J.] | ||
590 | % Preserve the network location, if any, given in the Document for | ||
591 | % public access to a Transparent copy of the Document, and likewise | ||
592 | % the network locations given in the Document for previous versions | ||
593 | % it was based on. These may be placed in the ``History'' section. | ||
594 | % You may omit a network location for a work that was published at | ||
595 | % least four years before the Document itself, or if the original | ||
596 | % publisher of the version it refers to gives permission. | ||
597 | % | ||
598 | % \item[K.] | ||
599 | % For any section Entitled ``Acknowledgements'' or ``Dedications'', | ||
600 | % Preserve the Title of the section, and preserve in the section all | ||
601 | % the substance and tone of each of the contributor acknowledgements | ||
602 | % and/or dedications given therein. | ||
603 | % | ||
604 | % \item[L.] | ||
605 | % Preserve all the Invariant Sections of the Document, | ||
606 | % unaltered in their text and in their titles. Section numbers | ||
607 | % or the equivalent are not considered part of the section titles. | ||
608 | % | ||
609 | % \item[M.] | ||
610 | % Delete any section Entitled ``Endorsements''. Such a section | ||
611 | % may not be included in the Modified Version. | ||
612 | % | ||
613 | % \item[N.] | ||
614 | % Do not retitle any existing section to be Entitled ``Endorsements'' | ||
615 | % or to conflict in title with any Invariant Section. | ||
616 | % | ||
617 | % \item[O.] | ||
618 | % Preserve any Warranty Disclaimers. | ||
619 | % \end{itemize} | ||
620 | % | ||
621 | % If the Modified Version includes new front-matter sections or | ||
622 | % appendices that qualify as Secondary Sections and contain no material | ||
623 | % copied from the Document, you may at your option designate some or all | ||
624 | % of these sections as invariant. To do this, add their titles to the | ||
625 | % list of Invariant Sections in the Modified Version's license notice. | ||
626 | % These titles must be distinct from any other section titles. | ||
278 | % | 627 | % |
628 | % You may add a section Entitled ``Endorsements'', provided it contains | ||
629 | % nothing but endorsements of your Modified Version by various | ||
630 | % parties---for example, statements of peer review or that the text has | ||
631 | % been approved by an organization as the authoritative definition of a | ||
632 | % standard. | ||
633 | % | ||
634 | % You may add a passage of up to five words as a Front-Cover Text, and a | ||
635 | % passage of up to 25 words as a Back-Cover Text, to the end of the list | ||
636 | % of Cover Texts in the Modified Version. Only one passage of | ||
637 | % Front-Cover Text and one of Back-Cover Text may be added by (or | ||
638 | % through arrangements made by) any one entity. If the Document already | ||
639 | % includes a cover text for the same cover, previously added by you or | ||
640 | % by arrangement made by the same entity you are acting on behalf of, | ||
641 | % you may not add another; but you may replace the old one, on explicit | ||
642 | % permission from the previous publisher that added the old one. | ||
643 | % | ||
644 | % The author(s) and publisher(s) of the Document do not by this License | ||
645 | % give permission to use their names for publicity for or to assert or | ||
646 | % imply endorsement of any Modified Version. | ||
647 | % | ||
648 | % | ||
649 | % \needspace{\baselineskip} | ||
650 | % \begin{center} | ||
651 | % {\large\bf 5. COMBINING DOCUMENTS\par} | ||
652 | % \end{center} | ||
653 | % | ||
654 | % | ||
655 | % You may combine the Document with other documents released under this | ||
656 | % License, under the terms defined in section~4 above for modified | ||
657 | % versions, provided that you include in the combination all of the | ||
658 | % Invariant Sections of all of the original documents, unmodified, and | ||
659 | % list them all as Invariant Sections of your combined work in its | ||
660 | % license notice, and that you preserve all their Warranty Disclaimers. | ||
661 | % | ||
662 | % The combined work need only contain one copy of this License, and | ||
663 | % multiple identical Invariant Sections may be replaced with a single | ||
664 | % copy. If there are multiple Invariant Sections with the same name but | ||
665 | % different contents, make the title of each such section unique by | ||
666 | % adding at the end of it, in parentheses, the name of the original | ||
667 | % author or publisher of that section if known, or else a unique number. | ||
668 | % Make the same adjustment to the section titles in the list of | ||
669 | % Invariant Sections in the license notice of the combined work. | ||
670 | % | ||
671 | % In the combination, you must combine any sections Entitled ``History'' | ||
672 | % in the various original documents, forming one section Entitled | ||
673 | % ``History''; likewise combine any sections Entitled ``Acknowledgements'', | ||
674 | % and any sections Entitled ``Dedications''. You must delete all sections | ||
675 | % Entitled ``Endorsements''. | ||
676 | % | ||
677 | % \needspace{\baselineskip} | ||
678 | % \begin{center} | ||
679 | % {\large\bf 6. COLLECTIONS OF DOCUMENTS\par} | ||
680 | % \end{center} | ||
681 | % | ||
682 | % You may make a collection consisting of the Document and other documents | ||
683 | % released under this License, and replace the individual copies of this | ||
684 | % License in the various documents with a single copy that is included in | ||
685 | % the collection, provided that you follow the rules of this License for | ||
686 | % verbatim copying of each of the documents in all other respects. | ||
687 | % | ||
688 | % You may extract a single document from such a collection, and distribute | ||
689 | % it individually under this License, provided you insert a copy of this | ||
690 | % License into the extracted document, and follow this License in all | ||
691 | % other respects regarding verbatim copying of that document. | ||
692 | % | ||
693 | % | ||
694 | % \needspace{\baselineskip} | ||
695 | % \begin{center} | ||
696 | % {\large\bf 7. AGGREGATION WITH INDEPENDENT WORKS\par} | ||
697 | % \end{center} | ||
698 | % | ||
699 | % | ||
700 | % A compilation of the Document or its derivatives with other separate | ||
701 | % and independent documents or works, in or on a volume of a storage or | ||
702 | % distribution medium, is called an ``aggregate'' if the copyright | ||
703 | % resulting from the compilation is not used to limit the legal rights | ||
704 | % of the compilation's users beyond what the individual works permit. | ||
705 | % When the Document is included in an aggregate, this License does not | ||
706 | % apply to the other works in the aggregate which are not themselves | ||
707 | % derivative works of the Document. | ||
708 | % | ||
709 | % If the Cover Text requirement of section~3 is applicable to these | ||
710 | % copies of the Document, then if the Document is less than one half of | ||
711 | % the entire aggregate, the Document's Cover Texts may be placed on | ||
712 | % covers that bracket the Document within the aggregate, or the | ||
713 | % electronic equivalent of covers if the Document is in electronic form. | ||
714 | % Otherwise they must appear on printed covers that bracket the whole | ||
715 | % aggregate. | ||
716 | % | ||
717 | % | ||
718 | % \needspace{\baselineskip} | ||
719 | % \begin{center} | ||
720 | % {\large\bf 8. TRANSLATION\par} | ||
721 | % \end{center} | ||
722 | % | ||
723 | % | ||
724 | % Translation is considered a kind of modification, so you may | ||
725 | % distribute translations of the Document under the terms of section~4. | ||
726 | % Replacing Invariant Sections with translations requires special | ||
727 | % permission from their copyright holders, but you may include | ||
728 | % translations of some or all Invariant Sections in addition to the | ||
729 | % original versions of these Invariant Sections. You may include a | ||
730 | % translation of this License, and all the license notices in the | ||
731 | % Document, and any Warranty Disclaimers, provided that you also include | ||
732 | % the original English version of this License and the original versions | ||
733 | % of those notices and disclaimers. In case of a disagreement between | ||
734 | % the translation and the original version of this License or a notice | ||
735 | % or disclaimer, the original version will prevail. | ||
736 | % | ||
737 | % If a section in the Document is Entitled ``Acknowledgements'', | ||
738 | % ``Dedications'', or ``History'', the requirement (section~4) to Preserve | ||
739 | % its Title (section~1) will typically require changing the actual | ||
740 | % title. | ||
741 | % | ||
742 | % | ||
743 | % \needspace{\baselineskip} | ||
744 | % \begin{center} | ||
745 | % {\large\bf 9. TERMINATION\par} | ||
746 | % \end{center} | ||
747 | % | ||
748 | % | ||
749 | % You may not copy, modify, sublicense, or distribute the Document | ||
750 | % except as expressly provided under this License. Any attempt | ||
751 | % otherwise to copy, modify, sublicense, or distribute it is void, and | ||
752 | % will automatically terminate your rights under this License. | ||
753 | % | ||
754 | % However, if you cease all violation of this License, then your license | ||
755 | % from a particular copyright holder is reinstated (a) provisionally, | ||
756 | % unless and until the copyright holder explicitly and finally | ||
757 | % terminates your license, and (b) permanently, if the copyright holder | ||
758 | % fails to notify you of the violation by some reasonable means prior to | ||
759 | % 60 days after the cessation. | ||
760 | % | ||
761 | % Moreover, your license from a particular copyright holder is | ||
762 | % reinstated permanently if the copyright holder notifies you of the | ||
763 | % violation by some reasonable means, this is the first time you have | ||
764 | % received notice of violation of this License (for any work) from that | ||
765 | % copyright holder, and you cure the violation prior to 30 days after | ||
766 | % your receipt of the notice. | ||
767 | % | ||
768 | % Termination of your rights under this section does not terminate the | ||
769 | % licenses of parties who have received copies or rights from you under | ||
770 | % this License. If your rights have been terminated and not permanently | ||
771 | % reinstated, receipt of a copy of some or all of the same material does | ||
772 | % not give you any rights to use it. | ||
773 | % | ||
774 | % | ||
775 | % \needspace{\baselineskip} | ||
776 | % \begin{center} | ||
777 | % {\large\bf 10. FUTURE REVISIONS OF THIS LICENSE\par} | ||
778 | % \end{center} | ||
779 | % | ||
780 | % | ||
781 | % The Free Software Foundation may publish new, revised versions | ||
782 | % of the GNU Free Documentation License from time to time. Such new | ||
783 | % versions will be similar in spirit to the present version, but may | ||
784 | % differ in detail to address new problems or concerns. See | ||
785 | % \url{https://www.gnu.org/licenses/}. | ||
786 | % | ||
787 | % Each version of the License is given a distinguishing version number. | ||
788 | % If the Document specifies that a particular numbered version of this | ||
789 | % License ``or any later version'' applies to it, you have the option of | ||
790 | % following the terms and conditions either of that specified version or | ||
791 | % of any later version that has been published (not as a draft) by the | ||
792 | % Free Software Foundation. If the Document does not specify a version | ||
793 | % number of this License, you may choose any version ever published (not | ||
794 | % as a draft) by the Free Software Foundation. If the Document | ||
795 | % specifies that a proxy can decide which future versions of this | ||
796 | % License can be used, that proxy's public statement of acceptance of a | ||
797 | % version permanently authorizes you to choose that version for the | ||
798 | % Document. | ||
799 | % | ||
800 | % | ||
801 | % \needspace{\baselineskip} | ||
802 | % \begin{center} | ||
803 | % {\large\bf 11. RELICENSING\par} | ||
804 | % \end{center} | ||
805 | % | ||
806 | % | ||
807 | % ``Massive Multiauthor Collaboration Site'' (or ``MMC Site'') means any | ||
808 | % World Wide Web server that publishes copyrightable works and also | ||
809 | % provides prominent facilities for anybody to edit those works. A | ||
810 | % public wiki that anybody can edit is an example of such a server. A | ||
811 | % ``Massive Multiauthor Collaboration'' (or ``MMC'') contained in the | ||
812 | % site means any set of copyrightable works thus published on the MMC | ||
813 | % site. | ||
814 | % | ||
815 | % ``CC-BY-SA'' means the Creative Commons Attribution-Share Alike 3.0 | ||
816 | % license published by Creative Commons Corporation, a not-for-profit | ||
817 | % corporation with a principal place of business in San Francisco, | ||
818 | % California, as well as future copyleft versions of that license | ||
819 | % published by that same organization. | ||
820 | % | ||
821 | % ``Incorporate'' means to publish or republish a Document, in whole or | ||
822 | % in part, as part of another Document. | ||
823 | % | ||
824 | % An MMC is ``eligible for relicensing'' if it is licensed under this | ||
825 | % License, and if all works that were first published under this License | ||
826 | % somewhere other than this MMC, and subsequently incorporated in whole | ||
827 | % or in part into the MMC, (1) had no cover texts or invariant sections, | ||
828 | % and (2) were thus incorporated prior to November 1, 2008. | ||
829 | % | ||
830 | % The operator of an MMC Site may republish an MMC contained in the site | ||
831 | % under CC-BY-SA on the same site at any time before August 1, 2009, | ||
832 | % provided the MMC is eligible for relicensing. | ||
833 | % | ||
834 | % | ||
835 | % \needspace{\baselineskip} | ||
836 | % \begin{center} | ||
837 | % {\large\bf ADDENDUM: How to use this License for your documents\par} | ||
838 | % \end{center} | ||
839 | % | ||
840 | % To use this License in a document you have written, include a copy of | ||
841 | % the License in the document and put the following copyright and | ||
842 | % license notices just after the title page: | ||
843 | % | ||
844 | % \bigskip | ||
845 | % \begin{quote} | ||
846 | % Copyright \copyright{} YEAR YOUR NAME. | ||
847 | % Permission is granted to copy, distribute and/or modify this document | ||
848 | % under the terms of the GNU Free Documentation License, Version 1.3 | ||
849 | % or any later version published by the Free Software Foundation; | ||
850 | % with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. | ||
851 | % A copy of the license is included in the section entitled ``GNU | ||
852 | % Free Documentation License''. | ||
853 | % \end{quote} | ||
854 | % \bigskip | ||
855 | % | ||
856 | % If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, | ||
857 | % replace the ``with \dots\ Texts.''\ line with this: | ||
858 | % | ||
859 | % \bigskip | ||
860 | % \begin{quote} | ||
861 | % with the Invariant Sections being LIST THEIR TITLES, with the | ||
862 | % Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST. | ||
863 | % \end{quote} | ||
864 | % \bigskip | ||
865 | % | ||
866 | % If you have Invariant Sections without Cover Texts, or some other | ||
867 | % combination of the three, merge those two alternatives to suit the | ||
868 | % situation. | ||
869 | % | ||
870 | % If your document contains nontrivial examples of program code, we | ||
871 | % recommend releasing these examples in parallel under your choice of | ||
872 | % free software license, such as the GNU General Public License, | ||
873 | % to permit their use in free software. | ||
874 | % | ||
279 | % \section{Implementation} | 875 | % \section{Implementation} |
280 | % | 876 | % |
281 | % \iffalse | 877 | % \iffalse |