summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/bibtex/tamethebeast/ttb_en.sec3.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2009-10-11 23:17:13 +0000
committerKarl Berry <karl@freefriends.org>2009-10-11 23:17:13 +0000
commit09b9f326659d969748705afa8711a913db0d06a7 (patch)
tree4a217a979d86370b4486139e25f67298a4992fd2 /Master/texmf-dist/doc/bibtex/tamethebeast/ttb_en.sec3.tex
parent80e52f52c3f2467f9ea527db9c2a534bfc3cb6cf (diff)
tamethebeast 1.4 (11oct09)
git-svn-id: svn://tug.org/texlive/trunk@15782 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/bibtex/tamethebeast/ttb_en.sec3.tex')
-rw-r--r--Master/texmf-dist/doc/bibtex/tamethebeast/ttb_en.sec3.tex60
1 files changed, 29 insertions, 31 deletions
diff --git a/Master/texmf-dist/doc/bibtex/tamethebeast/ttb_en.sec3.tex b/Master/texmf-dist/doc/bibtex/tamethebeast/ttb_en.sec3.tex
index d1459a7616a..7c295710b18 100644
--- a/Master/texmf-dist/doc/bibtex/tamethebeast/ttb_en.sec3.tex
+++ b/Master/texmf-dist/doc/bibtex/tamethebeast/ttb_en.sec3.tex
@@ -71,8 +71,8 @@ outermost braces can be replaced by parentheses:
the ``argument'' of a ``command'' starting with an \texttt\at{} is
considered as a comment. This gives an easy way to comment a given
entry: just remove the initial \texttt\at.
- As usual when a language allows comments: Don't hesitate to use
- them, so that you have a clean, ordered, and easy-to-maintain
+ As usual when a language allows comments, don't hesitate to use
+ them so that you have a clean, ordered, and easy-to-maintain
database. Conversely, anything starting with an \texttt\at{} is
considered as being a new entry\footnote{There is a special entry
type named \ent{comment}. The main use of such an
@@ -88,7 +88,7 @@ initial~\texttt{\at}.}.
\texttt{Example} and \texttt{example}.
In the same way, if you cite both \texttt{example} and
- \texttt{Example}, \bt will complain. Indeed, it would have to
+ \texttt{Example}, \bt will complain. Indeed, it~would have to
include the same entry twice, which probably is not what you want;
@@ -139,22 +139,18 @@ used for the \LaTeX Companion:
}
\end{verbatimtab}
It gives complementary information about the book\footnote{Filling
- both \nichp{title} and \nichp{booktitle} for a book may be of real
- interest, as we will see in the section dedicated to cross
- references (see section~\ref{crossref} for some more details).},
-for
- instance the fact that it is available in your local library.
-You really
- should not hesitate to use auxiliary, personal fields, giving them
- explicit names in order to be sure that no bibliography style
-will
- use them incidentally\footnote{You'll ask ``Is it really
- useful?''. First of all, it is not that long to add those
- informations each time you add a new entry, and it is much longer
-to
- add a field to several entries. Moreover, we'll see later how to
- design bibliography styles, and you'll be able to write styles
- that take those new fields into account.}.
+both \nichp{title} and \nichp{booktitle} for a book may be of real
+interest, as we will see in the section dedicated to cross references
+(see section~\ref{crossref} for some more details).}, for instance the
+fact that it is available in your local library. You really should
+not hesitate to use auxiliary, personal fields, giving them explicit
+names in order to be sure that no bibliography style will use them
+incidentally\footnote{You'll ask ``Is it really useful?''. First of
+all, it doesn't take long to add those informations each time you add a
+new entry; it~takes much longer to add a field to several
+entries. Moreover, we'll see later how to design bibliography styles,
+and you'll be able to write styles that take those new fields into
+account.}.
\mysection{The \protect\nient{string} and \protect\nient{preamble}
@@ -180,7 +176,7 @@ to define a shortcut for this publisher. Thus we write:
\end{verbatimtab}
This does not only spare some time, but most importantly, it ensures that
-you won't misspell it, and helps you maintain an homogeneous database.
+you won't misspell it, and helps you maintain a homogeneous database.
I find this really interesting for author names, so that you're sure
to always write them correctly (or always incorrectly, but it would
be easy to detect and correct a global mistake anyway).
@@ -459,7 +455,7 @@ It is a common error to separate names with commas instead of ``\texttt{and}''.}
\hline
\verb+De La Fontaine, Jean+ & \verb+Jean+ & \verb++ & \verb+De La Fontaine+ \\
\hline
-\verb+De la Fontaine, Jean+ & \verb+Jean+ & \verb+De la+ & \verb+fontaine+ \\
+\verb+De la Fontaine, Jean+ & \verb+Jean+ & \verb+De la+ & \verb+Fontaine+ \\
\hline
\verb+de La Fontaine, Jean+ & \verb+Jean+ & \verb+de+ & \verb+La Fontaine+ \\
\hline
@@ -485,11 +481,13 @@ I think it's a good place for coming back to abbreviations: You probably agree
that names are something not that easy to enter, and are
error-prone. I personally advise defining an abbreviation for each
author. You'll then concatenate them with \verb+``and''+ using
-\verb+#+\index{bibtex}{\#@\texttt{\#}(concatenation)}\index{bibtex}{concatenation@concatenation (\texttt{\#})}.
+\verb+#+\index{bibtex}{\#@\texttt{\#}(concatenation)}\index{bibtex}{concatenation@concatenation (\texttt{\#})} (actually, even \verb+``and''+ will be defined as an abbreviation).
For instance, I always include a \ext{bib} file containing the
following lines:
\begin{verbatimtab}
+@string{and = "and"}
+...
@string{goossens = "Goossens, Michel"}
@string{mittelbach = "Mittelbach, Franck"}
@string{samarin = "Samarin, Alexander"}
@@ -499,12 +497,12 @@ another one containing:
@string{AW = "Addison-Wesley"}
\end{verbatimtab}
and my main bibliographic file contains\footnote{This is not quite
- true, since \texttt{September} still depends on the language, and I
- prefer using \texttt{9} and letting the style file translate that
+ true, since \texttt{December} still depends on the language, and I
+ prefer using \texttt{12} and letting the style file translate that
into the corresponding month in the correct language.}:
\begin{verbatimtab}
@book{companion,
- author = goossens #" and "# mittelbach #" and "# samarin,
+ author = goossens # and # mittelbach # and # samarin,
title = "The {{\LaTeX}} {C}ompanion",
booktitle = "The {{\LaTeX}} {C}ompanion",
year = 1993,
@@ -670,12 +668,12 @@ it.}. But the first character here is
You'd probably prefer \texttt{[DLC]} or \texttt{[Cru]}. The second solution
would then be
\begin{verbatimtab}
- author = {\uppercase{d}}e {\uppercase{l}}a Cruz, Maria.
+ author = "{\uppercase{d}}e {\uppercase{l}}a Cruz, Maria"
\end{verbatimtab}
The label would be \verb+{\uppercase{d}}{\uppercase{l}}C+, which is correct.
Another (easier) proposal would be
\begin{verbatimtab}
- author = {D}e {L}a Cruz, Maria.
+ author = "{D}e {L}a Cruz, Maria"
\end{verbatimtab}
This also solves the problem, because \bt only considers characters at level~0 when
determining which part a word belongs to, but takes all letters into account
@@ -688,22 +686,22 @@ This is precisely the reverse problem, but the solution will be different.
Assume you cite a paper by the famous Spanish scientist
\emph{Juan de la Cierva y Codorn\'\i u}. The basic ideas are
\begin{verbatimtab}
- author = de la Cierva {\lowercase{Y}} Codorn{\'\i}u, Juan
+ author = "de la Cierva {\lowercase{Y}} Codorn{\'\i}u, Juan"
\end{verbatimtab}
or
\begin{verbatimtab}
- author = de la Cierva {y} Codorn{\'\i}u, Juan
+ author = "de la Cierva {y} Codorn{\'\i}u, Juan"
\end{verbatimtab}
However, these solutions yields labels such as \verb+CYC+ or \verb+CyC+, where
we would prefer \verb+CC+.
Several solutions are possible:
\begin{verbatimtab}
- author = de la Cierva{ }y Cordon{\'\i}u, Juan
+ author = "de la Cierva{ }y Cordon{\'\i}u, Juan"
\end{verbatimtab}
or
\begin{verbatimtab}
- author = de la {Cierva y} Cordon{\'\i}u, Juan
+ author = "de la {Cierva y} Cordon{\'\i}u, Juan"
\end{verbatimtab}
Both solutions work: In the first case, \bt won't see the space, and
considers that the \verb+y+ belongs to the previous word. In the second case,