Debian Codegraph @

texmf-dist/source/latex/edfnotes/edfnotes.tex

raw
1 \ProvidesFile{edfnotes.tex}[2011/02/22 documenting edfnotes.sty (UL)]
2 \title{\textsf{edfnotes.sty}\\---\\Critical Annotations to Footnote
3 Lines\thanks{This document describes version
4 \textcolor{blue}{\UseVersionOf{edfnotes.sty}}
5 of \textsf{edfnotes.sty} as of \UseDateOf{edfnotes.sty}.}}
6 % \listfiles
7 { \RequirePackage{makedoc}[2010/12/20] \ProcessLineMessage{}
8 \MakeJobDoc{19}{\SectionLevelThreeParseInput} %% 2010/12/16
9 }
10 \documentclass{article}%% TODO paper dimensions!?
11 \input{makedoc.cfg} %% shared formatting settings
12 % \providecommand*{\strong}{\textbf} %% 2010/12/15
13 %% 2011/01/01:
14 \newcommand*{\setoffbox}{\\[\smallskipamount]}
15 \newcommand*{\SOB}{} \let\SOB\setoffbox %% or let |...| redefine ...
16 \ReadPackageInfos{edfnotes}
17 \usepackage{color}
18 \makeatletter \@beginparpenalty\@lowpenalty \makeatother
19 \sloppy
20 \begin{document}
21 \maketitle
22 \begin{abstract}\noindent
23 'edfnotes.sty' extends
24 \CtanPkgRef{ednotes}{ednotes.sty}\urlpkgfoot{ednotes} %% 2011/02/16
25 so that you can refer even to \emph{footnotes}
26 of the edited work by line numbers,
27 %% 2011/01/01:
28 building on the accompanying 'fnlineno' package in the
29 \ctanpkgref{lineno} bundle.\urlpkgfoot{lineno}
30 %% rm. 2011/02/09:
31 % %% 2011/01/08:
32 % While version v0.1 of 'ednotes'
33 % just aimed at not loosing annotations to footnotes
34 % and v0.2 aimed at printing annotations to main text
35 % earlier than annotations to footnotes,
36 % v0.3 aims at starting an annotation to a footnote
37 % on the same page where the annotated passages starts.
38 % %% 2011/01/19:
39 % v0.4 introduced `\clearfootnoteannotations'.
40 % v0.5 fixes a basic mistake from v0.2 and aims at
41 % more transparent code, including a re-implementation
42 % of 'ednotes'' core macro.
43 % v0.6 re-implements v0.2 in the sense that, when
44 % lemmas move among pages, the annotations needn't wander
45 % to the end of the edition as often as with v0.2 through v0.5.
46 'ednotes.sty' has addressed ``scholarly" critical editions
47 of (hand-written) manuscripts.
48 %% 2011/02/10:
49 'edfnotes' additionally supports critical editions of
50 (printed) \emph{works with footnotes.}
51 The package was developed for an edition of
52 \Wikienref{Bernard Bolzano}'s
53 \textit{Paradoxien des Unendlichen} by Prof.\ Dr.\ Dr.\ Christian
54 Tapp---a work with some very long footnotes.
55
56 %% moved etc. 2011/02/14:
57 As to \emph{implementation},
58 %% added 2011/02/22:
59 'edfnotes' modifies 'ednotes'' annotation commands
60 and label-test mechanism so that the latter does not break
61 and the former place critical notes on the pages and
62 in the order as one naturally expects (not so easy with footnotes).
63 Certain core parts of 'ednotes' have been re-implemented entirely,
64 this may later migrate into 'ednotes' itself.
65 It had been hoped that 'edfnotes' could build on the
66 \ctanpkgref{bigfoot} package.\urlfoot{CtanPkgRef}{bigfoot}
67 This might have improved (automatic) page breaking and placement
68 of original footnotes and critical annotations
69 (whereas at present, some page breaks need manual trial-and-error
70 solutions).
71 However, analysis of 'lineno' and 'ednotes' for extending them,
72 as well as many unexpected difficulties,
73 exhausted project resources too early.
74 David Kastrup's `\MakeSorted'
75 (or `\MakeSortedPerPage', actually from
76 \ctanpkgref{perpage})\urlpkgfoot{perpage}
77 has here been implemented
78 by `\insert'ing annotations to footnotes at the last main text line of
79 a page only, hooking into 'lineno''s numbering mechanism---a
80 nice (``leight-weight"---?) alternative to David Kastrup's approach.
81 \par\smallskip\noindent
82 \strong{Keywords:}\quad critical editions; footnotes
83 \end{abstract}
84 \newpage
85 \tableofcontents
86
87 \section{Usage and Features}
88 \subsection{Package File Header (Legalize)}
89 \input{edfnotes.doc}
90 \section{Example} %% 2011/02/14
91 The file `PdUsample.pdf'
92 % (belonging to documentation, `docint/' directory) %% rm. 2011/02/16
93 shows results with a very long
94 (original, edited) footnote in
95 \Wikienref{Bernard Bolzano}'s
96 \textit{Paradoxien des Unendlichen},
97 with critical annotations by Christian Tapp.
98 \end{document}
99
100 VERSION HISTORY
101
102 2010/12/31 very first
103 2011/01/01 \SOB
104 2011/01/03 \newpage
105 2011/01/07 \strong
106 2011/01/08 for v0.3; `\jobname' replaced by `edfnotes'
107 2011/01/16 changed page breaking
108 2011/01/19 for v0.5
109 2011/02/02 for v0.6
110 2011/02/09 for public presentation
111 2011/02/10 abstract changed/extended; example PdUsample.pdf;
112 wiki link for Bolzano
113 2011/02/16 link to ednotes bundle, rm. `docint/'
114 2011/02/22 clarification in abstract