| 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 |