summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-09-29 22:03:44 +0000
committerKarl Berry <karl@freefriends.org>2013-09-29 22:03:44 +0000
commit303218b0303fec41aa7b526a0aaeac6ecf159ee7 (patch)
tree25715d510bc16f6a16f315ad86f6cc4d2d42f628 /Master/texmf-dist/doc
parente34404d907f07371cbf5e7c2589aadba1bd02a74 (diff)
teubner (29sep13)
git-svn-id: svn://tug.org/texlive/trunk@31794 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/teubner/README10
-rw-r--r--Master/texmf-dist/doc/latex/teubner/teubner-doc.pdfbin368768 -> 368870 bytes
-rw-r--r--Master/texmf-dist/doc/latex/teubner/teubner-doc.tex8
-rw-r--r--Master/texmf-dist/doc/latex/teubner/teubner.pdfbin632421 -> 632427 bytes
-rw-r--r--Master/texmf-dist/doc/latex/teubner/teubner.txt85
5 files changed, 55 insertions, 48 deletions
diff --git a/Master/texmf-dist/doc/latex/teubner/README b/Master/texmf-dist/doc/latex/teubner/README
index 84a6b90bcc3..30a15089958 100644
--- a/Master/texmf-dist/doc/latex/teubner/README
+++ b/Master/texmf-dist/doc/latex/teubner/README
@@ -1,13 +1,15 @@
-This accompanies the teubner bundle version 3.4 dated September 2012.
+This accompanies the teubner bundle version 3.4a dated September 2013.
-Copyright 2010-2012 Claudio Beccari
+Copyright 2010-2013 Claudio Beccari
The bundle contains the files
README this file
teubner.txt a more descriptive file
-teubner.dtx the selfextracting documented TeX source file
+teubner.dtx the self extracting documented TeX source file
teubner-doc.tex an extended documentation file
+teubner.pdf general and technical documentation
+teubner-doc.pdf specific documentation with examples
The bundle is distributed under the LPPL license version 1.3c or any later version.
@@ -19,7 +21,7 @@ means for typesetting their documents that usually contain very specific notatio
This new version allows the typesetter to use both "italic" shapes: the Olga-like
and the Lipsian-like ones; it contains extended accent macros that avoid the kerning
problems that arise with the ligature mechanism embedded in the LGR encoded default
-CBgreek fonts; is compatible with the use of different scalable Latin Type~1 fonts;
+CBfonts; it is compatible with the use of different scalable Latin Type~1 fonts;
contains new designs for the horizontally stretchable markers, et cetera.
Running pdflatex on the dtx file produces both the documentation and the extraction
diff --git a/Master/texmf-dist/doc/latex/teubner/teubner-doc.pdf b/Master/texmf-dist/doc/latex/teubner/teubner-doc.pdf
index d561c2cfba3..4b8739c4244 100644
--- a/Master/texmf-dist/doc/latex/teubner/teubner-doc.pdf
+++ b/Master/texmf-dist/doc/latex/teubner/teubner-doc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/teubner/teubner-doc.tex b/Master/texmf-dist/doc/latex/teubner/teubner-doc.tex
index e61885dec51..12579b6c78f 100644
--- a/Master/texmf-dist/doc/latex/teubner/teubner-doc.tex
+++ b/Master/texmf-dist/doc/latex/teubner/teubner-doc.tex
@@ -44,8 +44,8 @@
\title{\texttt{teubner.sty}%
\thanks{This paper documents \texttt{teubner.sty} version \fileversion\ of \filedate.}\\
An extension to the \textsf{greek} option\\ of the \babel\ package}
-\author{Claudio Beccari}
-\date{Turin, May 2013}% <---- this is the date of the teubenr-doc document!
+\author{Claudio Beccari\thanks{\texttt{claudio dot beccari at gmail dot com}}}
+\date{Turin, April 2013}% <---- this is the date of the teubenr-doc document!
\def\comando#1{\expandafter\texttt\expandafter{\string#1}}
\def\ARG#1{\texttt{\char123}$\langle$\textit{#1}$\rangle$\texttt{\char125}}
\def\Arg#1{$\langle$\textit{#1}$\rangle$}
@@ -219,7 +219,7 @@ right after the \verb|\usepackage| command with which you call that package.
Example: suppose you want to use the regular Fourier fonts to replace the default roman normal serifed fonts; then you should load the package \texttt{fourier} \emph{after} the \texttt{teubner} extension and specify:
\begin{verbatim}
\usepackage{fourier}
-\Lipsiandtrue
+\Lipsiantrue
\ifFamily{futs}{cmr}
\end{verbatim}
You can see that the family name \texttt{futs}, corresponding to the regular Fourier font family, has been matched to the CB Greek \texttt{cmr} font family; the name \texttt{futs} has been deduced by reading the \texttt{fourier.sty} file from which one can see that the family declaration for the regular Fourier font family is \texttt{futs}. This sort of coding does not take place with all fonts: if the Iwona fonts had to be chosen, for example, then the font family name would coincide with the font name, making it difficult to distinguish between the \emph{font name} and the \emph{font family name}.
@@ -379,7 +379,7 @@ For this reason two mechanisms are implemented in this package:
\item the extended accent macros suggested by Günter Milde have been adapted to this package in order to have accent macros that help fetching the accented character in the font table, and
\item the character names have been defined with macros that access directly their own glyphs.
\end{enumerate}
-The first solution has been described in the previous section and the extended accent macros are shown in table~\ref{t:accenti}. At the expense of one slash, these macros create a chain of commands that deeply exploit the \LaTeXe\ kernel commands and allow to fetch directly each accented character; notice that there is no need to treat the \verb+|+ sign this way, because its postfixed position does not break the kerning mechanism. The spirit macros \verb+\>+ and \verb+\<+ work also with the consonant `r' to produce \textLipsias{\>r, \<r}. The extended accent macros work correctly also with capital letters (where, in all caps, accents should not be typeset, except the dieresis, while in normal initial capitalizing the upper diacritics must be written at the left of the initial letter); for example\footnote{In the capitalized word the spirit and accent at the left of A imply a hiatus between the A and the \textDidot{u}; in the all caps word this hiatus is marked with the ``dialytika'' (dieresis) over the \textDidot{U}. This is an unusual example, but it shows also why the \texttt{\string\uppercase} and the \texttt{\string\MakeUppercase} require some attention in polutoniko Greek.} \textDidot{\>'Aulos, A\"ULOS} was typeset with \verb+\>'Aulos, A\"ULOS+. Notice also that the initial capital vowel has a spirit and possibly an accent, or is not preceded by anything, since the possible spirit with or without accent falls on the second element of a descending diphthong: \textDidot{a\>ut'os}, \textDidot{A\>ut'os}, and \textDidot{AUTOS}; \textDidot{e\>'inai}, \textDidot{E\>'inai}, \textDidot{EINAI}. If you really want to show an example of how accents should \emph{not} be used in all caps words, you can type \textDidot{A\>UT\A{O}S} but you have to
+The first solution has been described in the previous section and the extended accent macros are shown in table~\ref{t:accenti}. At the expense of one slash, these macros create a chain of commands that deeply exploit the \LaTeXe\ kernel commands and allow to fetch directly each accented character; notice that there is no need to treat the \verb+|+ sign this way, because its postfixed position does not break the kerning mechanism. The spirit macros \verb+\>+ and \verb+\<+ work also with the consonant `r' to produce \textLipsias{\>r, \<r}. The extended accent macros work correctly also with capital letters (where, in all caps, accents should not be typeset, except the dieresis, while in normal initial capitalizing the upper diacritics must be written at the left of the initial letter); for example\footnote{In the capitalized word the spirit and accent at the left of A imply a hiatus between the A and the \textDidot{u}; in the all caps word this hiatus is marked with the ``dialytika'' (dieresis) over the \textDidot{U}. This is an unusual example, but it shows also why the \texttt{\string\uppercase} and the \texttt{\string\MakeUppercase} require some attention in polutoniko Greek.} \textDidot{\>'Aulos, A\"ULOS} was typeset with \verb+\>'Aulos, A\"ULOS+. Notice also that the initial capital vowel has a spirit and possibly an accent, or is not preceded by anything, since the possible spirit with or without accent falls on the second element of a descending diphthong: \textDidot{a\>ut'os}, \textDidot{A\>ut'os}, and \textDidot{AUTOS}; \textDidot{e\>'inai}, \textDidot{E\>'inai}, \textDidot{EINAI}. If you really want to show an examle of how accents should \emph{not} be used in all caps words, you can type \textDidot{A\>UT\A{O}S} but you have to use the macros of
table~\ref{t:accentmacros} as such: \verb+A\>UT\A{O}S+.
Another solution is available if the \emph{GlyphNames} option is specified to the \texttt{tenbner} package: a set of macros has been defined such that it is
diff --git a/Master/texmf-dist/doc/latex/teubner/teubner.pdf b/Master/texmf-dist/doc/latex/teubner/teubner.pdf
index f6aa73d68d1..405559dcb19 100644
--- a/Master/texmf-dist/doc/latex/teubner/teubner.pdf
+++ b/Master/texmf-dist/doc/latex/teubner/teubner.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/teubner/teubner.txt b/Master/texmf-dist/doc/latex/teubner/teubner.txt
index f99f4a084c6..d3732df0c1e 100644
--- a/Master/texmf-dist/doc/latex/teubner/teubner.txt
+++ b/Master/texmf-dist/doc/latex/teubner/teubner.txt
@@ -1,8 +1,8 @@
- THE TEUBNER PACKAGE VERSION 3.4 OF SEPTEMBER 2012
+ THE TEUBNER PACKAGE VERSION 3.4a OF SEPTEMBER 2013
EXTENSION FOR PHILOLOGICAL TYPESETTING
-Copyright 2001-2004-2012 Claudio Beccari
+Copyright 2001-2004-2013 Claudio Beccari
The programs contained in this bundle can be distributed and/or modified
under the terms of the LaTeX Project Public License (LPPL), version 1.3c
@@ -20,20 +20,21 @@ teubner-doc.tex documentation file
By running pdflatex on teubner.dtx in addition to the documentation file
teubner.pdf, the byproduct files teubner.sty, teubnertx.sty, LGRaccents-
glyphs.def are generated; teubner-doc.pdf must be generated by running
-pdflatex on the source file teubner-doc.tex file.
+pdflatex on the source file teubner-doc.tex file. The two mentioned .pdf
+ files are already contained in the bundle
File teubner-doc.pdf is the documentation file that shows what can be
done with this extension package and displays several examples.
Version 3.x of the teubner package contains many new enhancements, among
which it's worth noting the new extended accent macros (that avoid
-kerning problems that show up using the ligature mechanism) and the new
-macros that allow to use the LGR encoded CBgreek fonts in conjunction
-with other PostScript scalable fonts; the compatibility with the Times
-eXtended and the Palatino eXtended fonts, accessible through the
-packages txfonts and pxfonts, are already built in; the compatibility
-with the Latin Modern fonts was already available with version 2.x of
-the teubner package.
+kerning problems that might show up using the ligature mechanism) and
+the new macros that allow to use the LGR encoded CBgreek fonts in
+conjunction with other PostScript scalable fonts; the compatibility
+with the Times eXtended and the Palatino eXtended fonts, accessible
+through the packages txfonts and pxfonts, are already built in; the
+compatibility with the Latin Modern fonts was already available with
+version 2.x of the teubner package.
While this package was upgraded and uploaded to CTAN, Antonis Tsolomitis
uploaded the package txfontsb which adds the possibility of using nice
@@ -44,11 +45,11 @@ shape resembles the Lipsian one; they come in both the medium and the
bold series and match the TX latin fonts pretty well.
Although Tsolomitis' fonts satisfy very well the everyday typesetting
-necessities of the Greek users and blend well also with the TX math fonts,
-they do not satisfy the requirements of the teubner package. This is why
-the processing of the teubner.dtx file generates also file teubnertx.sty
-that is being input at begin document time if the user specified the TX
-fonts by calling the txfonts package.
+necessities of the Greek users and blend well also with the TX math
+fonts, they do not satisfy the requirements of the teubner package. This
+is why the processing of the teubner.dtx file generates also file the
+teubnertx.sty that is being input at begin document time if the user
+specified the TX fonts by calling the txfonts package.
In order to use this extension package with LaTeX you have to
install it. May be the very installation of your (recent) TeX system
@@ -56,7 +57,8 @@ distribution already provided for it; may be your TeX system is
configured to load missing packages on the fly. In any case you can
check and possibly run your Package Manager (with MiKTeX follow the path
Programs|MiKTeX Settings|Packages; with TeXlive and MacTeX (if their
-installation configuration was not the default complete one) run tlmgr).
+installation configuration was not the default complete one) run tlmgr).
+
If you feel more comfortable to do everything by yourself and/or want to
make a personal installation, run teubner.dtx through pdflatex; the
generated files are teubner.sty and LGRaccents-glyphs.def, besides the
@@ -76,15 +78,15 @@ teubner.pdf that you get by running pdflatex directly on teubner.dtx.
For what concerns fonts, they should already be installed with a recent
TeX system distribution; this means that there are already all the files
-TeX-the-program needs in order to do its work; there is one point, though,
-that requires full attention; the default basic TeX system installation
-loads only the PostScript fonts in size 10pt; all other sizes are are
-obtained by reducing or enlarging that single size. A complete TeX system
-installation does not exhibit this limitation. There are also non standard
-scalable Type 1 fonts, such for example, the Fourier ones, that come only
-in one size, the 10pt one; for these fonts it is not strictly necessary
-todo the same with the sizes of the CB Greek ones, but if you prefer you
-can.
+TeX-the-program n eeds in order to do its work; there is one point,
+though, that requires full attention; the default basic TeX system
+installation loads only the PostScript fonts in size 10pt; all other
+sizes are are obtained by reducing or enlarging that single size.
+A complete TeX system installation does not exhibit this limitation.
+There are also non standard scalable Type 1 fonts, such for example, the
+Fourier ones, that come only in one size, the 10pt one; for these fonts
+it is not strictly necessary todo the same with the sizes of the CBfonts,
+but if you prefer you can.
In any case the teubner package copes with this situation if you specify
the "10pt" option when calling this package, but if you want to have
@@ -95,25 +97,25 @@ come with your TeX system distribution; it's not difficult, but it
requires to be very careful at every step. Remember, though, that your
Package Manager can do all the work for you.
-It's important to control that you have the latest CBgreek fonts; even
-if you got them pre-installed with your TeX system distribution, may be
-they are not the latest version. The full collection has been redone in
-the year 2007, and partially upgraded in the year 2010; the reduced
-collection is a subset of the full one. Earlier distributions, dated at
-least 2002, might be compatible; if you notice something strange with the
-CBgreek fonts, verify if your fonts are up to date.
+It's important to control that you have the latest CBfonts; even if you
+got them pre-installed with your TeX system distribution, may be they
+are not the latest version. The full collection has been redone in
+the year 2007, and partially upgraded in 2010; the reduced collection is
+a subset of the full one. Earlier distributions, dated at least 2002,
+might be compatible; if you notice something strange with the CBfonts,
+verify if your fonts are up to date.
Another question you might ask yourself: is my TeX system complete and
up to date? The fact you installed a TeX system and you did not have the
-CB fonts may be an index that you still have the babel package locked at
+CBfonts may be an index that you still have the babel package locked at
a version number earlier than 3.7. I suggest you to upgrade your TeX
system to the most up to date one you can find on CTAN.
-Connected to this point there is the question of the updated metric files
-related to the Lipsian fonts; if your TeX system distribution has been
-updated to what is available on CTAN by May 2010, your distribution
+Connected to this point there is the question of the updated metric
+files related to the Lipsian fonts; if your TeX system distribution has
+been updated to what is available on CTAN by May 2010, your distribution
already contains the updated tfm files. Otherwise, please, update your
-CBgreek fonts.
+CBfonts.
After all these steps are done, you are ready to use your teubner
extensions; it will not be easy at the beginning, because there are
@@ -134,9 +136,9 @@ possible things that may happen to anybody using a computer.
I will not write down any strong disclaimer sentence in capital letters,
because it should be absolutely evident that I did something I consider
useful, but is up to you to decide to use it and face the consequences
-(... which nevertheless I hope they are what you expected).
+(... which, nevertheless, I hope they are what you expected).
-If you find this package of some utility and you find some errors and/or
+If you find this package of some utility but you find some errors and/or
some glitches, please write me by e-mail (see below). If you'd like me
to realize some other commands, please send me by e-mail your request
together with a scanned image containing the visual result you'd like to
@@ -146,8 +148,11 @@ you use LaTeX, you know what are its pros and cons.
Happy philological LaTeXing!
-Claudio Beccari Turin, 17 of September 2012
+Claudio Beccari Turin, 29 of September 2013
Former Professor of Electronics
Politecnico di Torino, Italy
claudio dot beccari at gmail dot com
+PS: I underline my former professorship in electronics, in order to
+stress the point that I am not a philologist, therefore beware: this
+work might be simply "trash" to the eyes of a real philologist! \ No newline at end of file