summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/bibtex/urlbst/urlbst.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/bibtex/urlbst/urlbst.tex')
-rw-r--r--Master/texmf-dist/doc/bibtex/urlbst/urlbst.tex134
1 files changed, 125 insertions, 9 deletions
diff --git a/Master/texmf-dist/doc/bibtex/urlbst/urlbst.tex b/Master/texmf-dist/doc/bibtex/urlbst/urlbst.tex
index 4cbf3910dd2..7743ce05641 100644
--- a/Master/texmf-dist/doc/bibtex/urlbst/urlbst.tex
+++ b/Master/texmf-dist/doc/bibtex/urlbst/urlbst.tex
@@ -2,7 +2,7 @@
\title{The \texttt{urlbst} package}
\author{Norman Gray\\\texttt{<http://nxg.me.uk>}}
-\date{Version 0.7, 2011 July 20}
+\date{Version 0.8, 2019 July 1}
%\usepackage{times}
\usepackage{url}
@@ -52,7 +52,7 @@ The added fields are:
a reference, along with the date at which the URL was last checked
to exist;
\item \btfield{doi}, for a reference's DOI
- (see \url{http://doi.org});
+ (see \url{https://doi.org});
\item \btfield{eprint}, for an arXiv eprint reference
(see \url{http://arxiv.org}); and
\item \btfield{pubmed} for a reference's PubMed identifier
@@ -62,7 +62,7 @@ The added fields are:
Usage is simple:
\begin{verbatim}
% urlbst [--eprint] [--doi] [--pubmed]
- [--nohyperlinks] [--inlinelinks] [--hypertex] [--hyperref]
+ [--nohyperlinks] [--inlinelinks] [--hypertex] [--hyperref]
[input-file [output-file]]
\end{verbatim}
where the |input-file| is an existing |.bst| file, and
@@ -134,7 +134,7 @@ output, however, then the script encloses the |\url| command in an
appropriate Hyper\TeX\ special.
When the style file generates a link for DOIs, it does so by
-prepending the string \texttt{http://dx.doi.org/} to the DOI. This is
+prepending the string \texttt{https://doi.org/} to the DOI. This is
generally reasonable, but some DOIs have characters in them which are
illegal in URLs, with the result that the resulting
\texttt{dx.doi.org} URL doesn't work. The only real way of resolving
@@ -228,7 +228,7 @@ not appear to materially disagree.
ISO-690~\cite{url:iso690} is a formal standard for this stuff. Walker
and Taylor's \emph{Columbia Guide to Online Style}~\cite{walker06}
provides extensive coverage (but is only available on dead trees).
-There are two style guides associated with the APA, namely
+There are two style guides associated with the APA, namely
the published APA style
guide~\cite{apastyle} (a paper-only publication, so should be
ignored by all, if there's any justice in the world), and what appears
@@ -271,10 +271,126 @@ generated bibliographies.
See also the URL entry in the UK \TeX\ FAQ~\cite{texfaq}, and
references therein.
-\textbf{Acknowledgements:} Thanks to Jason Eisner for suggesting
-the |--inlinelinks| option, to Pawe\l{} Widera for the
-suggestion to use |\path| when formatting DOIs and to Michael Giffin
-for the suggestion to include PubMed URLs.
+%% \textbf{Acknowledgements:} Thanks
+%% to Jason Eisner for suggesting the |--inlinelinks| option;
+%% to `ijvm' for code contributions in the |urlbst| script;
+%% to Pawe\l{} Widera for the suggestion to use |\path| when formatting DOIs;
+%% to Michael Giffin for the suggestion to include PubMed URLs;
+%% to Katrin Leinweber for the pull request which fixed the format of DOI
+%% references.
+
+\section{Acknowledgements, and release notes}
+
+%%% include:release-notes.tex
+
+
+Thanks are due to many people for suggestions and requests:
+to Jason Eisner for suggesting the |--inlinelinks| option;
+to ‘ijvm’ for code contributions in the |urlbst| script;
+to Paweł Widera for the suggestion to use |\path| when formatting DOIs;
+to Michael Giffin for the suggestion to include PubMed URLs;
+to Katrin Leinweber for the pull request which fixed the format of DOI
+references.
+
+\begin{description}
+\item[\textbf{0.8, 2019 July 1}]\relax
+\begin{itemize}
+\item The presence of a preexisting |format.doi|,
+|format.eprint| or |format.pubmed| function is
+now detected, and warned about. The resulting |.bst| file
+might still require some manual editing.
+Resolves issue 8\footnote{\url{https://bitbucket.org/nxg/urlbst/issue/8}}.
+\item Clarified licences (I hope).
+\item Adjust format of DOI resolver.
+Resolves issue 11\footnote{\url{https://bitbucket.org/nxg/urlbst/issue/11}},
+thanks to
+code contributed by Katrin Leinweber\footnote{\url{https://bitbucket.org/nxg/urlbst/pull-requests/1/}}.
+\end{itemize}
+
+
+\item[0.7, 2011 July 20]\relax
+Add |--nodoi|, |--noeprints| and |--nopubmed| options (which defaulted
+on, and couldn't otherwise be turned off)
+
+\item[0.7b1, 2011 March 17]\relax
+Allow parameterisation of literal strings, with option |--literal|.
+
+\item[0.6-5, 2011 March 8]\relax
+Adjust support for inline links (should now work for arXiv, DOI and Pubmed)
+
+\item[0.6-4, 2009 April 28]\relax
+Work around BibTeX linebreaking bug (thanks to Andras Salamon for the bug report).
+
+\item[0.6-3, 2009 April 19]\relax
+Fix inline link generation (thanks to Eric Chamberland for the bug report).
+
+\item[0.6-2, 2008 November 17]\relax
+We now turn on inlinelinks when we spot format.vol.num.pages,
+which means we include links for those styles which don't include a
+title in the citation (common for articles in physical science styles,
+such as aip.sty).
+
+\item[0.6-1, 2008 June 16]\relax
+Fixed some broken links to the various citation standards
+(I think in this context this should probably \emph{not} be happening, yes?).
+The distributed |*url.bst| no longer have the
+|--inlinelinks| option turned on by default.
+
+\item[\textbf{0.6, 2007 March 26}]\relax
+\begin{itemize}
+\item Added the option |--inlinelinks|, which adds inline hyperlinks
+to any bibliography entries which have URLs, but does so inline, rather
+than printing the URL explicitly in the bibliography. This is (primarily)
+useful if you're preparing a version of a document which will be read
+on-screen. Thanks to Jason Eisner for the suggestion, and much testing.
+
+\item Incorporate hyperref bugfixes from Paweł Widera.
+
+\item Further reworkings of the inlinelinks support, so that it's now
+fired by a |format.title| (or |format.btitle|) line, with a fallback in
+|fin.entry|. This should be more robust, and allows me to delete some
+of the previous version's gymnastics.
+
+\item Reworked |inlinelinks| support; should now be more
+robust. Incorporate hyperref bugfixes from Paweł Widera.
+
+\item Added the option |inlinelinks|, which adds inline hyperlinks
+to any bibliography entries which have URLs, but does so inline, rather
+than printing the URL explicitly in the bibliography. This is (only)
+useful if you're preparing a version of a document which will be read
+on-screen.
+\end{itemize}
+
+
+\item[0.5.2, 2006 September 6]\relax
+Another set of documentation-only changes, hopefully clarifying
+installation.
+
+\item[0.5.1, 2006 January 10]\relax
+No functionality changes. Documentation and webpage changes only,
+hopefully clarifying usage and configuration
+
+\item[\textbf{0.5, 2005 June 3}]\relax
+Added support for Digital Object Identifiers (DOI) fields in
+bibliographies.
+
+\item[0.4-1, 2005 April 12]\relax
+Documentation improvements -- there are now examples in the help text!
+
+\item[\textbf{0.4, 2004 December 1}]\relax
+Bug fixes: now compatible with mla.bst and friends.
+Now uses |./configure| (optionally). Assorted reorganisation.
+
+\item[\textbf{0.3, 2003 June 4}]\relax
+Added |--eprint|, |--hypertex| and |--hyperref| options.
+
+\item[\textbf{0.2, 2002 October 23}]\relax
+The `editor' field is now supported in the webpage entry type. Basic
+documentation added.
+
+\item[\textbf{0.1, 2002 April}]\relax
+Initial version
+\end{description}
\bibliography{urlbst}
\bibliographystyle{plainurl}