summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/natbib/bibentry.dtx
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/natbib/bibentry.dtx')
-rw-r--r--Master/texmf-dist/source/latex/natbib/bibentry.dtx33
1 files changed, 26 insertions, 7 deletions
diff --git a/Master/texmf-dist/source/latex/natbib/bibentry.dtx b/Master/texmf-dist/source/latex/natbib/bibentry.dtx
index fc477968a4c..cbf396d4b68 100644
--- a/Master/texmf-dist/source/latex/natbib/bibentry.dtx
+++ b/Master/texmf-dist/source/latex/natbib/bibentry.dtx
@@ -5,12 +5,12 @@
{BIBENTRY.DTX}
%========================================================================
%</dtx>
-%% Copyright 1997-1999 Patrick W Daly
-%% Max-Planck-Institut f\"ur Aeronomie
+%% Copyright 1997-2007 Patrick W Daly
+%% Max-Planck-Institut f\"ur Sonnensystemforschung
%% Max-Planck-Str. 2
%% D-37191 Katlenburg-Lindau
%% Germany
-%% E-mail: daly@linmpi.mpg.de
+%% E-mail: daly@mps.mpg.de
%
% This program can be redistributed and/or modified under the terms
% of the LaTeX Project Public License Distributed from CTAN
@@ -42,15 +42,16 @@
% *** The DATE, VERSION, and other INFO
%\fi
%\ProvidesFile{bibentry}
- [2000/06/20 1.4 (PWD)]
+ [2007/10/30 1.5 (PWD)]
% \changes{1.0}{1997 Jun 13}{Initial version}
% \changes{1.1}{1997 Nov 11}{Refine for use with \cs{bibliography}}
% \changes{1.1a}{1998 Mar 2}{Fix bug by using \cs{ifx} instead of \cs{if}}
% \changes{1.2}{1999 Feb 23}{Update copyright notice}
% \changes{1.3}{1999 Aug 26}{Works with \texttt{url} package}
% \changes{1.4}{2000 Jun 20}{Add \texttt{hyperref} compatibility}
+% \changes{1.5}{2007 Oct 30}{Add \cs{doi} definition}
%
-% \CheckSum{126}
+% \CheckSum{135}
% \CharacterTable
% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
@@ -272,8 +273,8 @@ End of documentation driver file.
% This package must be used with \btx, not with a hand-written
% \texttt{thebibliography} environment.
%
-% Strictly speaking, there must be a \texttt{.bbl} file; whether this is
-% generated by \btx\ or by hand is unimportant.
+% More precisely, there must be a \texttt{.bbl} file external to the \LaTeX\
+% file; whether this is written by hand or by \btx\ is unimportant.
%
% \DescribeMacro{\nobibliography}
% The bibliography entries are stored with the command
@@ -311,6 +312,11 @@ End of documentation driver file.
% \item \LaTeX\ the file twice.
% \end{enumerate}
%
+% \noindent
+% \textbf{Note:} it is highly recommended to make use of the \texttt{url}
+% package, which will nicely format both url and doi addresses; in particular,
+% they will break at convenient locations without a hyphen.
+%
% \section{Caveats}
%
% The entries in the \texttt{.bbl} must be of the form
@@ -528,6 +534,19 @@ End of documentation driver file.
{You have used \string\nobibliography* \MessageBreak
without a following \string\bibliography.\MessageBreak
You may not be able to run BibTeX}\fi}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\doi}
+% \changes{1.5}{2007 Oct 30}{Add macro}
+% The |\doi| command is used in the modern \texttt{.bst} files, and is in fact
+% defined inside the |thebibliography| environment for these styles. However,
+% that means, it is undefined outside where |\bibentry| is used. So it is
+% necessary to provide a definition globally.
+% \begin{macrocode}
+\AtBeginDocument{\@ifpackageloaded{url}
+ {\providecommand{\doi}{doi: \begingroup \urlstyle{rm}\Url}}
+ {\providecommand{\doi}[1]{doi: #1}}}
%</package>
% \end{macrocode}
% \end{macro}