diff options
author | Karl Berry <karl@freefriends.org> | 2006-01-09 00:49:07 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2006-01-09 00:49:07 +0000 |
commit | 007f67a693e4d031fd3d792df8e4d5f43e2cb2e7 (patch) | |
tree | 90d17e00e572ecb1e24764b6f29c80e098b08d29 /Master/texmf-dist/doc/latex/ednotes | |
parent | 950209b26f70aa87ed07c54f82a95b6f03b7c3a0 (diff) |
doc/latex
git-svn-id: svn://tug.org/texlive/trunk@84 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/ednotes')
-rw-r--r-- | Master/texmf-dist/doc/latex/ednotes/CHANGES.txt | 245 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/ednotes/README.txt | 231 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/ednotes/README4U.txt | 210 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/ednotes/ednotes.pdf | bin | 0 -> 225393 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/ednotes/ednotes.tex | 103 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/ednotes/ednotugb.pdf | bin | 0 -> 261453 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/ednotes/emathtst.tex | 53 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/ednotes/visible.txt | 101 |
8 files changed, 943 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/ednotes/CHANGES.txt b/Master/texmf-dist/doc/latex/ednotes/CHANGES.txt new file mode 100644 index 00000000000..bff37c00e29 --- /dev/null +++ b/Master/texmf-dist/doc/latex/ednotes/CHANGES.txt @@ -0,0 +1,245 @@ +CHANGES for UNDERLYING lineno.sty v4.4 2005/10/27: + +1. Proper effective line depth at end of paragraphs. + The spacing bug was quite obvious in two-column mode + when a paragraph end was at a column bottom. + +2. Another bug concerning two-column mode that had been + introduced in v4.22 has been removed again. + +3. Support for \addvspace introduced more and more bugs + in versions of v4.32 and v4.33. The reasons seem to + be clear now, v4.4 should be stable, and the series + of bug reports seems to have stopped. + + +CHANGES for UNDERLYING lineno.sty v4.32 2005/10/17: + (see lineno.pdf ...) + +1. Support for \addvspace + (a math display or a list meets a heading -- or the like). + +2. Clearly explained former option `displaymath' and its change + to a default. + + +CHANGES for ednotes.sty v1.2 and UNDERLYing lineno.sty v4.31 +2005/10/01: + +1. ednotes.sty offers \PrecedeLevelWith for visually identifying + apparatuses (think of pages where only one of them appears) + or for controlling the shape of one or another + apparatus paragraph (maybe depending on apparatus). + (Requires manyfoot.sty v1.9!) + +2. lineno.sty offers \modulolinenumbers* and a package option + `modulo*' for printing first line number after interrupting + editor's text, regardless of the modulo. + +3. To prevent lemma code from working in the apparatus + (`fol...', e.g.), ednotes.sty now offers \notinnote + (replacing \notthislemma, now without `undefined c...'). + +4. Improved lineno.sty's explanation of \firstlinenumber and + package options. + +5. Supplied some hash mark doublings in advice for customizing + ednotes.sty . + + +CHANGES for UNDERLYing lineno.sty v4.3 2005/04/28--05/16: + +1. Re-implemented modulo mode -- disabling certain users' tricks + see lineno.pdf sec. 5.5, also for a still supported + substituting trick. + +2. Option `displaymath' (proper numbering at paragraphs + containing math displays) becomes default. + +3. Compatibility with hyperref now indeed (at least much more). + +4. Documentation tidied up. + +5. Restored "global" version of numbering lines of a \parbox or + minipage or ..., explained in documentation (lineno.pdf/dvi + subsec. 7.2). + +6. Additional internal improvements that perhaps hardly are + observable (no more spurious linenumbers in math displays + from vertical mode; \flushbuttom with `twocolomnuns' and + `switch' etc.; some compatibity with packages that use + \holdinginserts; \linelabel in headings etc.). + + +CHANGES for UNDERLYing lineno.sty v4.2 2005/04/26: + +1. Re-enabled package option `displaymath' (needed rearrangement + after lineno.pdf sec. 5). + +2. New package option `addpageno' for adding page numbers to + line number references -- see sec. 6.1 of lineno.pdf. + +3. Improved support for \includeonly (and improved lineno.pdf + sec. 5.3, p. 27). + +4. Please note problems with \marginpar, figures, and tables + which tameflts.sty deals with -- see ...: + +5. Improved compatibility with other packages that change \output + (tameflts.sty, e.g., for saving footnotes against \marginpar + and floats), added advice on this matter -- see lineno.pdf + sec. 2.3, pp. 7, 14f. + + +CHANGE OF EDNOTES BUNDLE 2005/04/09 + +Due to my (ul) misconception of `nccfoots', unwanted footnote +marks could occur. This is corrected with v1.12 . (Earlier +today a package ennccptc.sty appeared, please remove it in case +you have used it.) + + +CHANGES OF EDNOTES BUNDLE 2005/03/08 + +This update is mainly concerned with +1. the number of possible notes, +2. page break oscillations, +3. `array' and similar mathematical environments, and with +4. a hopefully helpful error message; also with +5. amendments of documentation. + +Namely: + +1. Reimplementation of `ednotes.sty' with version v1.1, vital + for huge editions ("commercial"/"professional" applications): + "compression" of note placement data, a single control string + instead of three per note stores them. So you can now make + three times as many notes as before, regarding the memory + compartment for multiletter control strings. -- One user + exhausted this by 10.000 notes on 450 pages (recent MiKTeX + installation). Now he can go on ... (These note placement + data are needed for references in the apparatus.) + + WARNINGs: + + (a) If you have customized or used \repeatref and/or + \linewithpage, please read what the section on `customizing' + of `ednotes.sty' tells concerning v1.1 (changes were + required). + + (b) In case you really use option `countoccurrences' of + `ednotes.sty', edcntwd0.sty needs to be updated to v0.31. + +2. A checking function has been added for finding startings + of page break oscillations. These typically must be fixed + for getting correct references to lemmas in the apparatus. + + WARNING: You may recently have noticed `lblchng1.sty' and + what it tells about page break oscillations. With ednotes.sty + v1.1, `lblchng1.sty' v0.2 is no longer quite correct, please + notice v0.32 (if the problem interests or tortures you). + +3. The `edtable' option of `ednotes.sty' now supports math + environments like `array'. This requires updating edtable.sty + to v1.3. (The claim in previous versions of `edtable.sty' on + this support simply was wrong, sorry.) For how to make use of + this support, we urge you to read the usage instructions in + `edtable.sty' (v1.3). These have been extended very much, + structured more clearly, and supplied with examples. + +4. \linelabel now complains when appearing outside line + numbering mode. This may be useful when you have forgotten to + switch into line numbering mode and wonder why all notes + refer to line 1. If you don't know about \linelabel: Each + note uses it internally, therefore you may profit. + +5. The subsection on `edtable' in `lineno.sty/tex/pdf' and its + final list of user commands in lineno.sty/tex/pdf were not + quite correct or complete -- corrected or somewhat improved. + `ednotugb.pdf', which derives from a TUGboat article on the + subject, now briefly refers to the memory problem of 1. above + and amends the description of `edtable'. + + +CHANGES OF EDNOTES BUNDLE 2005/01/20 + +1. Thanks to Alexander Rozhenko, you now can download most +recent "unpacked" versions of manyfoot.sty and nccfoots.sty +-- no more generating procedure. + +2. The README.txt addresses indexing with line numbers. + +3. The original TUGboat article `tb77lueck.pdf' has been +corrected and updated -- resulting in `ednotugb.pdf'. + +4. `ednotes.sty' and `ednotugb.pdf' refer to the `ellipsis' +package concerning spacing with the ellipsis dots. + + +CHANGES OF EDNOTES BUNDLE 2004/10/26 + +You may find a file README4U.txt that is more detailed than the +present one and that just addresses changes from 2004/08/23 to +2004/10/19, especially for earlier users.] + + +CHANGES OF EDNOTES BUNDLE 2004/10/19 + +1. Module files are now handled by new ednotes.sty options +`edtable', `longtable', `nolongtablepatch', `edmacpara', +`countoccurrences', and `mathnotes' (+ `perpage', new module) +--so they are no longer loaded by explicit \usepackage. + +-> UPDATE RECOMMENDATION: + + To support these package options, the following packages + were changed, at least concerning instructions. + + edcntwd0.sty + ednotes.sty + ednmath0.sty + edtable.sty + lineno.sty + mfparptc.sty + mfparxsp.sty + + So we recommend that you download these from + + [CTAN]/macros/latex/contrib/ednotes + + and overwrite the earlier versions with them! + -- And be sure to have manyfoot.sty v1.7! + (See README.txt for how to obtain it.) + + (mfparxsp.sty may even be deleted, see inside or + previous change described below. Using new option `perpage', + moreover, may require downloading and installing perpage.sty) + +lineno.sty climbs to version 4.1, ednotes.sty to 1.0. + +2. lineno.tex/pdf has been updated accordingly. A new interim +version of a TUGboat article (tb77lueck.pdf, same ednotes +directory) describes the bundle as it appears now. The final +version of the article will be exhibited at the TUGboat web site. + + +CHANGES OF EDNOTES BUNDLE 2004/09/21 + +1. With lineno.sty version 4.00 (CTAN folder +/macros/latex/contrib/lineno), linenox0.sty, linenox1.sty, and +lnopatch.sty are obsolete. Don't load them any more! lineno.sty +should produce a reminder for changing your related \usepackage +commands. For a slight change of \firstlinenumber, see +lineno.sty/tex/pdf. + +2. With manyfoot.sty version 1.7 (CTAN folder +/macros/latex/contrib/ncctools), mfparxsp.sty is obsolete. +Please replace \MFparaxbuffer by \ExtraParaSkip and don't load +mfparxsp.sty any more. For your earlier documents, we offer a +new version of mfparxsp.sty which just reminds you of the +change and ("for this time") redirects your \MFparaxbuffer to +Alex Rozhenko's \ExtraParaSkip. You may delete it right now--or +when you are sure that you won't anymore compile a .tex +containing \MFparaxbuffer and \usepackage{mfparaxbuffer}. + + diff --git a/Master/texmf-dist/doc/latex/ednotes/README.txt b/Master/texmf-dist/doc/latex/ednotes/README.txt new file mode 100644 index 00000000000..ba63715211e --- /dev/null +++ b/Master/texmf-dist/doc/latex/ednotes/README.txt @@ -0,0 +1,231 @@ +====================+=====+=======++=======+=====+==================== + + FIRST INSTRUCTIONS + for + EDNOTES + Distribution April 2005 + (this file April 26, 2005) + + Uwe Lueck, dir. Christian Tapp + Munich/Goettingen, Germany + http://www.contact-ednotes.sty.de.vu + +====================+=====+=======++=======+=====+==================== + +CONTENTs of the present file: + + Purpose -- recent changes -- RIGHTS -- installing `ednotes' -- + learning about `ednotes' -- standalone packages -- contact us -- + newsletter -- glossary + +PURPOSE of the macros: + + Here are macros for typesetting CRITICAL EDITIONS with LaTeX. + Packages `lineno' by Stephan I. B"ottcher, `manyfoot' by Alexander + I. Rozhenko, and `longtable' by David Carlisle are enhanced and + combined. -- For a few first informations, you may have a look at + http://ednotes.sty.de.vu. + +** RECENT CHANGES: ** + + If you have used `ednotes' earlier than September 2004, we urge you + to read the `CHANGES' file in the `ednotes' directory, especially + concerning the changes of September/October 2004. `ednotes', + `lineno', and `manyfoot' have been changed at one time and interact + differently than before. Some files have been removed, and former + extension packages are now automatically loaded on `ednotes' package + options. + +RIGHTs: + + For COPYRIGHTs as well as conditions of use (NO WARRANTY), + MODIFYING, and (RE)DISTRIBUTION, please see inside the files + mentioned in the present `README' file, as well as + `README-lineno.txt' and `README-ncctools.txt'. Usually, the LaTeX + Project Public License applies, a recent version of which can be + found on + + http://www.latex-project.org/lppl.txt + + Any REDISTRIBUTION of `ednotes.sty' must contain the present + `README' file. + + If you DISTRIBUTE `manyfoot.sty' and `nccfoots.sty', they must be + accompanied by `manyfoot.dtx', `nccfoots.dtx', and + `README-ncctools.txt'. + +INSTALLATION of `ednotes': + + For enabling yourself to make use of all the options that + `ednotes' provides, download + + edcntwd0.sty + ednmath0.sty + ednotes.sty + edtable.sty + lineno.sty + ltabptch.sty + manyfoot.sty + mfparptc.sty + nccfoots.sty + perpage.sty + vplref.sty + + from + + http://www.ctan.org/tex-archive/macros/latex/contrib/ednotes + + (e.g., cf. `CTAN' in the glossary). Note that clicking on + "entire directory" suffices. + + Moreover, you may need + + longtable.sty + + from the LaTeX Tools Bundle -- you should have it already with your + LaTeX distribution. + + You then have to make the .sty files listed above "visible" + (see the glossary below) to (La)TeX when it runs your job. + + (You may find out through reading documentations that it partially + depends on your intentions which .sty files actually must be there. + E.g., `ednotes.sty' works already when it is accompanied by + `lineno.sty', `manyfoot.sty', and `nccfoots.sty'.) + +USAGE of `ednotes': + + We recommend not to load (by \usepackage) .sty files other than + `ednotes.sty' (except for "standalone uses" as explained below). + They are handled through `ednotes' package options as explained + in the documentation. + + Sorry, the "user guide" and documentation for `ednotes' is, at + present, scattered over the listed .sty files and over the listed + CTAN folders. Here is just a guide through files and folders to + increase your knowledge step by step: + + 0. Oh, recently some of these explanations have been collected + in ednotes.pdf -- .txt input with .pdf output. + + 1. An overview of `ednotes' has appeared in TUGboat vol. 24. + no. 2; the above `ednotes' directory of CTAN contains an + updated .pdf version `ednotugb.pdf' of it. It demonstrates + through some examples what output certain commands produce. + It also compares `ednotes' with two other (La)TeX packages + for critical edition typesetting. + + 2. Next (or even first) we recommend reading the explanations at + the beginning of `ednotes.sty'. + + 3. You may find references to .sty files from the `ednotes' and + the `lineno' folder for reading about additional details of + usage. + + 4. `lineno.sty' provides commands and options that are very useful + to know for creating critical editions by `ednotes'. You can + read about these commands and options in `lineno.sty'. + Moreover, the explanations from `lineno.sty' can be printed + through `lineno.tex' or `lineno.pdf' obtainable from the above + `ednotes' directory. You find there as well an attempt at a + user's guide for `lineno' -- `ulineno.tex' and `ulineno.pdf'. + The latter is not quite up to date, but it may be helpful + though. -- When you use `ednotes', don't believe what the + `lineno' documentation tells about, e.g., + + \usepackage[edtable]{lineno} + + (such statements address usage of `lineno' without `ednotes'). + Many package options of `ednotes.sty' are just passed to + `lineno.sty', so the `lineno' documentation is `ednotes' + documentation in this respect. + + 5. `manyfoot' is another essential module for making `ednotes' + work, though you may hardly need to know about it, `ednotes' + is a kind of user interface for `manyfoot'. However, you may + inform yourself about offers of `manyfoot' for certain fine + points of critical edition typesetting through `manyfoot.dtx' + or `manyfoot.pdf' -- which you find in + + http://www.ctan.org/tex-archive/macros/latex/contrib/ncctools + + (e.g., cf. `CTAN' in the glossary). There are `nccfoots.dtx' + and `nccfoots.pdf' as well. Indeed you may find functions of + `manyfoot' useful just for your commentary passages. + + 6. `perpage.sty' is mentioned here mainly to allow use of + `manyfoot's `perpage' option. It contains brief explanations. + + 7. `longtable', of course, is explained in `longtable.dtx' and + various guides for LaTeX. + + 8. We have prepared something for listing line numbers for index + terms. We don't take the time to integrate it here -- please + contact us (see below) if you are interested. + +Standalone files: + + Some of the listed .sty files which are our work may be useful + without using `ednotes': + + 1. Whenever you use `manyfoot', you can load `mfparptc.sty' after + `manyfoot.sty' just to modify the behaviour of `manyfoot' in + the way that is explained in `mfparptc.sty'. + + Moreover, there is a file `mfparxsp.sty', made for the + possibility that some `manyfoot' user has used an earlier + version of `mfparxsp.sty' which has become obsolete. + + 2. For extending lineno.sty by packages from here, see + + http://www.ctan.org/tex-archive/macros/latex/contrib/lineno + + (e.g., cf. `CTAN' in the glossary). + + 3. `ltabptch.sty', a patch for `longtable', can be used whenever + `longtable' is used. + + 4. An additional file `lblchng1.sty' deals with page break + oscillations, by code as well as by explanations and + discussion. It can be used entirely independently from + any of the packages mentioned before. + +Contact us: + + We would be happy about your suggestions and (in a way) about your + bug reports. Since documentation is so poor at present, please feel + free to ask us for help if needed. Please contact us via + + http://www.contact-ednotes.sty.de.vu + + (Note: in TeX terms, the names in the file heading are `L\"uck' + and `G\"ottingen.) + +Newsletter: + + E.g., you may ask us to take your e-mail address into a mailing + list for reporting `ednotes' changes. + +Lucky typesetting! + +______________________________________________________________________ + +GLOSSARY: + +* `CTAN' + abbreviates `Comprehensive TeX Archive Network', cf., e.g., + + http://www.ctan.org + + and read about "mirrors" there. You will understand that you + may replace `www.ctan.org/tex-archive' by `www.dante.de/CTAN' + (e.g.) in the above-mentioned URL. (But dante doesn't offer + the "entire directory" function.) + + +* visible to (La)TeX + + -- see the file `visible.txt' in the above `ednotes' directory. + +[END of README.txt]___________________________________________________ + diff --git a/Master/texmf-dist/doc/latex/ednotes/README4U.txt b/Master/texmf-dist/doc/latex/ednotes/README4U.txt new file mode 100644 index 00000000000..83899ba870d --- /dev/null +++ b/Master/texmf-dist/doc/latex/ednotes/README4U.txt @@ -0,0 +1,210 @@ +README4U: + +****************************************************************** +*** *** +*** Changes from ednotes.sty v0.64 to v1.0 *** +*** *** +*** (Uwe Lueck, 2004/10/21) *** +*** *** +****************************************************************** + + + +* SUMMARY: * + + Since August 2004, the number of bundle files has been reduced. + Many of the remaining files have changed, some essentially, + others with respect to usage instructions. We explain how to + update your Ednotes installation accordingly. Optional + "patches", enhancements etc. that earlier had to be called by + loading separate files explicitly (mandatory arguments of + \usepackage) are now called by ednotes.sty package options + (optional arguments in \usepackage[<opt>]{ednotes}). New PDF + documentations/instructions have appeared. + + +* Contents of this file: * + + LN/MF_edn.zip -- ednotes/lineno/manyfoot/further changes -- + updating procedure -- new documentations + + + +* Some files you may have received: * + + You may have received (by e-mail from us, e.g.) a distribution + containing files + + LN_edn.zip + MF_edn.zip + + They serve two purposes: + + 1. They contain the files README and CHANGES that reside in the + CTAN directories `[...]/lineno' and `[...]/ncctools' (from + which manyfoot.sty stems). In order to avoid that README and + CHANGES files overwrite each other, unzip them into separate + directories, and into another one than the README file (for + ednotes.sty) that you should have received as a plain text + file. + + 2. LEGAL, IMPORTANT: + + The files README, manyfoot.dtx, and nccfoots.dtx contained in + MF_edn.zip are, by their copyright holder Alexander Rozhenko, + demanded to ACCOMPANY any (re)DISTRIBUTION of manyfoot.sty + and nccfoots.sty! + + +* ednotes.sty changes: * + + 1. ednotes.sty version 1.0 has new package options `edtable', + `longtable', `nolongtablepatch', `edmacpara', + `countoccurrences', and `mathnotes' for handling "patch" or + enhancement etc. files. None of these files should be loaded + through the mandatory argument of \usepackage any more. E.g., + instead of \usepackage{edtable}, you now type + + \usepackage[edtable,<further options>]{ednotes} . + + (So -- one advantage aimed at -- you must no longer worry + about the correct order of loading extension packages.) + + 2. The above-mentioned option `nolongtablepatch' changes earlier + behaviour with respect to our longtable.sty patch file + ltabptch.sty, in avoiding an error message that otherwise + appears when ltabptch.sty is not present. This is convenient + when you deliberately want to avoid the patch. The error + message ensures that vertical spacing around a "longtable" + does not depend on the local TeX installation -- e.g., when + you send your source to a journal. + + 3. ednotes.sty has a new option `perpage' for making use of the + manyfoot.sty option `perpage' -- just see the Manyfoot + documentation for what it does. It requires perpage.sty, + which is available from [CTAN]/macros/latex/contrib/misc. + + +* lineno.sty changes: * + + 1. The new version 4.1 of lineno.sty makes former extension + files linenox0.sty, linenox1.sty, and lnopatch.sty obsolete. + Don't load them any more! (We have installed a reminder for + the case that you don't obey this rule.) + + 2. \firstlinenumber has slightly changed from its earlier + behaviour given by lnopatch.sty. See lineno.sty/tex/pdf. + + +* manyfoot.sty changes: * + + The new version 1.7 of manyfoot.sty provides a command + \ExtraParaSkip to replace our earlier \MFparaxbuffer. + (See the new ednotes.sty documentation to recall + \MFparaxbuffer -- search for `\ExtraParaSkip', e.g.) + This makes former extension file mfparxsp.sty obsolete. + Please replace \MFparaxbuffer by \ExtraParaSkip and don't + load mfparxsp.sty any more! For your earlier documents that + contain \usepackage{mfparxsp}, we offer a new version of + mfparxsp.sty which just reminds you of the change and + ("for this time") redirects your \MFparaxbuffer to + \ExtraParaSkip. You may as well just delete your copy of + mfparxsp.sty, if you are sure, e.g., that you won't anymore + compile a .tex containing \MFparaxbuffer and + \usepackage{mfparaxbuffer}. + + +* Further corresponding changes: * + + Extension files that still are used -- now required by the new + ednotes.sty package options -- have been changed at least with + respect to explanations that they contain. + + +* UPDATING: * + + 1. (Mandatory:) overwrite your copies of + + edcntwd0.sty + ednmath0.sty + ednotes.sty + edtable.sty + lineno.sty + manyfoot.sty + mfparptc.sty + + with the new versions. + + 2. Overwrite + + mfparxsp.sty + + by our new "reminder" version, or just remove it from TeX's + searching scope -- as you like, recall `manyfoot.sty changes' + avove. + + 3. You may remove (from TeX's searching scope) linenox0.sty, + linenox1.sty, lnopatch.sty -- but they won't harm otherwise; + you will get an error message if you load one of them + inadvertently. + + +* New documentation/instructions: * + + 1. An article on ednotes.sty is appearing in TUGboat vol. 24. + It describes the main commands and functions of Ednotes. + Moreover, it compares Ednotes to EDMAC and LEDMAC, two other + TeX macro packages for critical edition typesetting. + We provide a version of the article very near to the final + one as + + tb77lueck.pdf . + + (it is definitively not the final version.) + + 2. The README for ednotes.sty has been rewritten very much and + may yield new insights. Detailed explanations addressing + non-TeXperts have been added. + + 3. lineno.tex has been updated according to the changes of + lineno.sty, of course. A pdflatex outcome + + lineno.pdf + + is available ([CTAN]/macros/latex/contrib/lineno/lineno.pdf). + + A pdflatex outcome + + ulineno.pdf + + of the user's guide ulineno.tex is available as well. + It only deals with lineno.sty version 3.1, but will though + be helpful (I think). + + Recall that lineno.sty offers many commands to control the + style of the marginal line numbers, so its documentation is + an essential contribution to ednotes.sty documentation. + + 4. Version 1.7 of manyfoot.sty is generated from the + corresponding version of + + manyfoot.dtx + + which is the TeX source for the documentation of + manyfoot.sty. Recently, the pdflatex output + + manyfoot.pdf + + has been added to CTAN directory ncctools. These two files + may be less essential for ednotes.sty users than + (u)lineno.tex/pdf. However, manyfoot.sty offers features + that you may find interesting: (i) customize rules between + footnote layers; (ii) \SplitNote (for paragraphed footnotes + at page breaks). (For nccfoots.sty, which manyfoot.sty + requires, there are nccfoots.dtx/pdf as well.) + + +Good Luck! + + +[End of README4U] diff --git a/Master/texmf-dist/doc/latex/ednotes/ednotes.pdf b/Master/texmf-dist/doc/latex/ednotes/ednotes.pdf Binary files differnew file mode 100644 index 00000000000..0f45a151303 --- /dev/null +++ b/Master/texmf-dist/doc/latex/ednotes/ednotes.pdf diff --git a/Master/texmf-dist/doc/latex/ednotes/ednotes.tex b/Master/texmf-dist/doc/latex/ednotes/ednotes.tex new file mode 100644 index 00000000000..2914977b9eb --- /dev/null +++ b/Master/texmf-dist/doc/latex/ednotes/ednotes.tex @@ -0,0 +1,103 @@ +%% Ednotes.tex -- +\title{\LARGE \bf \textit{ednotes.sty} \\ + for critical editions with \LaTeX \\[1ex] + \normalfont \Large + Lazy \texttt{ASCII}$\to$\texttt{PDF} listings} +\author{Uwe L\"uck}%%%\thanks{advised by Christian Tapp.}} +\documentclass[10pt]{article} +\usepackage{verbatim} +\pagestyle{headings} +\newcommand*{\cs}[1]{$\backslash$\texttt{#1}} +\newcommand*{\lcurl}[1]{\[\texttt{CTAN:/macros/latex/contrib/#1}\]} +\begin{document} +\maketitle +\section*{Preface} + +\texttt{ednotes[.sty]} is a macro package or bundle of +macro files for critical editions---typed +by U.\,L.\footnote{$\dots$ originally under the direction of +Christian Tapp at a research project granted by the +Deutsche Forschungsgemeinschaft (DFG).} +It is little more than a user interface for combining +Stephan~I.\ B\"ottcher's \texttt{lineno.sty} and +Alexander~I.~Rozhenko's \texttt{manyfoot}. + +Nowadays, \texttt{PDF} files are very wanted for +documentation of \TeX\ macro files. +Well, +% such files +% do exist for the underlying \texttt{lineno.sty}--- +% \lcurl{lineno.pdf} +% (plus a supplementary \texttt{lnosuppl.pdf} there)---and +% as +% \lcurl{manyfoot.pdf} +% plus +% \lcurl{nccfoots.pdf} +% for the underlying \texttt{manyfoot.sty}\,. +% +% $\dots$ well, +sorry, a documentation of this kind doesn't exist +at present for \texttt{ednotes} $\dots$---I am just offering +some ersatz \texttt{PDF} documentation: listings of the +\texttt{.sty} files belonging to the \texttt{ednotes} bundle, +structured and navigatable through a table of contents. + +For making use of the options that \texttt{ednotes.sty} +provides, it is vital to know the underlying +\texttt{lineno.sty}---and its documentation. +\texttt{ednotes} just passes \texttt{lineno} commands and +options to the latter. So please notice +\lcurl{lineno/lineno.pdf} +as well as (if you need it) +\lcurl{lineno/lnosuppl.pdf\,.} +In the same directory, there are other macro files that +\texttt{ednotes.sty} may need and whose documentation may +be contained in \texttt{lnosuppl.pdf} (in the same +pseudo-\texttt{PDF}-style as present). + +% Sorry, I haven't had the time for making a proper \texttt{PDF} +% documentation for the present \texttt{ednotes} bundle. +% What I am offering is nothing but a somewhat structured listing +% of the additional \texttt{.txt} and \texttt{.sty} files, +% deriving from the \texttt{verbatim} package and its +% \cs{verbatiminput} command. I hope that the high quality +% (scalable) output is worth it. + +Please don't overlook that \lcurl{lineno/ednotugb.pdf} contains +a (printable) \emph{overview} on the facilities of +\texttt{ednotes}, as well as a comparison with Peter Wilson's +alternative \texttt{ledmac}. + +% \clearpage +\tableofcontents + +\section{The \texttt{.txt} files} +\subsection{\texttt{README.txt}} +\verbatiminput{README.txt} +\subsection{\texttt{CHANGES.txt}} +\verbatiminput{CHANGES.txt} +\subsection{Advice for installation: \texttt{visible.txt}} +These are some very down-to-earth advices for +real \TeX-newbies. +\verbatiminput{visible.txt} +\section{The main file: \texttt{ednotes.sty}} +\verbatiminput{ednotes.sty} +\section{Supplementary macro files} +\subsection{Tracking page break oscillations: + \texttt{lblchng1.sty}} +\verbatiminput{lblchng1.sty} +\subsection{A lemma repeated in a line: \texttt{edcntwd0.sty}} +\verbatiminput{edcntwd0.sty} +\subsection{Some \texttt{para}-footnote hack: \texttt{mfparptc.sty}} +This deals with a problem that still needs much thinking \dots +\par +\verbatiminput{mfparptc.sty} +\subsection{A reminder of obsoleteness: \texttt{mfparxsp.sty}} +This file just tells that some earlier facility dealing with +vertical spacing has been superseded by \texttt{manyfoot}'s +more recent \cs{ExtraParaSkip}\,. +\verbatiminput{mfparxsp.sty} + +\end{document} + +end of Ednotes.tex diff --git a/Master/texmf-dist/doc/latex/ednotes/ednotugb.pdf b/Master/texmf-dist/doc/latex/ednotes/ednotugb.pdf Binary files differnew file mode 100644 index 00000000000..666e0581245 --- /dev/null +++ b/Master/texmf-dist/doc/latex/ednotes/ednotugb.pdf diff --git a/Master/texmf-dist/doc/latex/ednotes/emathtst.tex b/Master/texmf-dist/doc/latex/ednotes/emathtst.tex new file mode 100644 index 00000000000..527d3602955 --- /dev/null +++ b/Master/texmf-dist/doc/latex/ednotes/emathtst.tex @@ -0,0 +1,53 @@ +%% EMathTst.tex for demonstrating EdnMath0.sty. +%% Uwe L"uck, http://www.contact-ednotes.sty.de.vu, 2005/01/16. +\documentclass[12pt]{article} +\def\Anote#1#2{#1} \let\<\relax \let\>\relax +% \usepackage{ednotes} +\usepackage[mathrefs]{lineno} + +\begin{document} + +\begin{linenumbers} +% \begin{NoNotesToMath} +\linenumberdisplaymath +\noindent +\texttt{\string\ \unskip linelabel} and +\texttt{\string\ \unskip Anote} in math mode? +\begin{linenomath} +$$ +% \begin{displaymath} +% \begin{equation} +x=\Anote{z}{$Z$} +% {\makeatletter \typeout{\meaning\@EN@lemmatag}} +\linelabel{Hm} +% \end{equation} +% \end{displaymath} +$$ +\end{linenomath} +% \end{NoNotesToMath} +$a=\Anote{x\<y\>z}{$b$} +% {\makeatletter \typeout{\meaning\@EN@lemmatag}} +\linelabel{Hmm} +$. +Why not? +\begin{NoNotesToMath} +Line No.~\ref{Hm}. +\Anote{No \<math\> here.}{Went wrong earlier.} +% {\makeatletter \typeout{\meaning\@EN@lemmatag}} +\end{NoNotesToMath} +Line No.~\ref{Hmm}. +\end{linenumbers} + +% \tracingonline=1 +% \showboxdepth=1 +% \showboxbreadth=30 +% \showlists + +% % These really get lost: +% \linenumbers +% \mbox{\Anote{Boxed}{where?}.\linelabel{Hu}} +% Line No.~\ref{Hu}. + +\end{document} + + diff --git a/Master/texmf-dist/doc/latex/ednotes/visible.txt b/Master/texmf-dist/doc/latex/ednotes/visible.txt new file mode 100644 index 00000000000..9bd75a7e881 --- /dev/null +++ b/Master/texmf-dist/doc/latex/ednotes/visible.txt @@ -0,0 +1,101 @@ +VISIBLE -- Advice for placing new LaTeX files. + +Author: Uwe L"uck, http://www.contact-ednotes.sty.de.vu, +2004/10/18; +aided by Karl Berry. + +--derived from a TUGboat (vol. 24) article on Ednotes. + + + +* The problem: * + +E.g., a user downloads a LaTeX file from CTAN. Or: often there +is a pair of a .dtx and an .ins file for producing a .sty file. +("Run LaTeX on the .ins file ..." This may be difficult enough, +but we assume now that the user manages this.) Typically the +user is told to put the (.sty) file to a folder "where LaTeX +can find it", or "visible to TeX". Indeed, the user cannot use +the file otherwise. However, some users have had no idea how to +arrange things so that (La)TeX finds the file. + +Unfortunately, the procedure for this is somewhat non-trivial +indeed. It depends very much on the user's LaTeX installation, +so it is difficult to indicate a procedure that helps everyone. + + +* Principles for solutions: * + +Technically, the searching agent is the TeX program, not LaTeX +--we choose our wordings accordingly here. LaTeX is rather a +kind of input ("format") to the TeX program. (If this doesn't +make sense to you, don't worry about it.) + +I think of three kinds of approaches: + +1. Put the file into the folder where the files you are editing +are (call them "job files" here). This is easy; but if the user +wants to use the file for another project pursued in a different +folder, the approach would require another copy of the file--or +a link! Therefore, it has been common to place macro (.sty) or +similar files in folders that TeX searches independent of the +folder containing the job files. + +2. Put the file into a folder that TeX has searched so far. + +3. Put the file anywhere (or into an extra folder newly created +with care)--and extend the set of folders that TeX searches +accordingly. The TeX installation ("shell") usually offers a +facility for this--which unfortunately is not always known to +the user. + + +* Advices from TeX Users Groups: * + +I recommend to study the following web pages. The first two of +them deal with installation more generally and give some hints +that I consider worth to remind of. + + http://tug.ctan.org/installationadvice + + http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages + +These prefer approach 3 of the above, especially the TDS +standard of arranging folders, see + + http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds + +The narrower subject matter is concerned at + + http://{www.tex.ac.uk/cgi-bin/texfaq2html?label=wherefiles + + +* Easy tricks that I prefer: * + +I must confess that I have never worked with the shells that are +chosen as examples on these web pages. Moreover, some Windows +users may find the examples little helpful. So my personal hints +use approach 2 of the above. + +o Typically, the file is from CTAN folder + /tex-archive/macros/latex/contrib/, and you find a folder + .../latex/contrib/ in the installation at your workplace. + Then the latter should be a good guess for placing the new + file. + +o You may find a folder .../texinput/ (or TeXinput!?) which + should be another good guess. + +o Search your installation for files with the same file name + extension (usually `.sty'), try their folder. + +(Updates are a special case of the last idea, of course.) + + +Ok, if all this doesn't help, you may ask at comp.text.tex +or your local TeX guru. + + +Good luck! + + |