summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/bibtex/urlbst/urlbst.html
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/bibtex/urlbst/urlbst.html')
-rw-r--r--Master/texmf-dist/doc/bibtex/urlbst/urlbst.html143
1 files changed, 97 insertions, 46 deletions
diff --git a/Master/texmf-dist/doc/bibtex/urlbst/urlbst.html b/Master/texmf-dist/doc/bibtex/urlbst/urlbst.html
index c057564bd63..1edeadcf3a0 100644
--- a/Master/texmf-dist/doc/bibtex/urlbst/urlbst.html
+++ b/Master/texmf-dist/doc/bibtex/urlbst/urlbst.html
@@ -4,8 +4,7 @@
<head>
<title>Urlbst</title>
<link href="http://nxg.me.uk/" rev="author"/>
-<link type="text/css" rel="stylesheet"
- href="http://nxg.me.uk/style/base.css"/>
+<link type="text/css" rel="stylesheet" href="/style/base.css"/>
</head>
<body>
@@ -18,9 +17,11 @@ basic support for <code>eprint</code>, <code>doi</code> and <code>pubmed</code>
hypertex/hyperref support.</p>
<p>The Persistent URL for this page is
-<code>http://purl.org/nxg/dist/urlbst</code>.</p>
+<code>http://purl.org/nxg/dist/urlbst</code>.
+The code (and bugparade) is on
+<a href='https://bitbucket.org/nxg/urlbst/'>bitbucket.org</a>.</p>
-<p>Version 0.7, 2011 July 20.</p>
+<p>Version 0.8, 2019 July 1.</p>
</div>
<p>Contents</p>
@@ -28,8 +29,9 @@ hypertex/hyperref support.</p>
<li><a href='#usage'>Usage</a></li>
<li><a href='#example'>For example...</a></li>
<li><a href='#download'>Download and installation</a></li>
+<li><a href='#licences'>Licences</a></li>
<li><a href='#information'>Further Information</a></li>
-<li><a href='#history'>Version history</a></li>
+<li><a href='#history'>Version history, and release notes</a></li>
</ul>
<p>The standard BibTeX styles have no explicit support for the web, in
@@ -70,9 +72,9 @@ by <code>--noeprint</code>, <code>--nodoi</code> and
<li><code>url</code> and <code>lastchecked</code>, to associate a URL with
a reference, along with the date at which the URL was last checked
to exist;</li>
-<li><code>doi</code>, for a reference's <a href='http://doi.org'>DOI</a>;</li>
+<li><code>doi</code>, for a reference's <a href='https://doi.org'>DOI</a>;</li>
<li><code>eprint</code>, for an <a href='http://arxiv.org'>arXiv</a> eprint reference; and</li>
-<li><code>pubmed</code> for a reference's
+<li><code>pubmed</code> for a reference's
<a href='http://pubmed.gov'>PubMed</a> identifier (PMID).</li>
</ul>
@@ -186,10 +188,10 @@ FAQ</a>.</p>
<h2><a name='download'>Download and installation</a></h2>
<p>Download the file as a
-<a href="urlbst-0.7.tar.gz" >tarball</a>
+<a href="urlbst-0.8.tar.gz" >tarball</a>
or
-<a href="urlbst-0.7.zip" >zip file</a>
-and unpack it. Or you can clone the source repository at
+<a href="urlbst-0.8.zip" >zip file</a>
+and unpack it. Or you can clone the source repository at
<a href='http://bitbucket.org/nxg/urlbst/'>bitbucket.org</a>.</p>
<p>To install, you should simply copy the distributed
@@ -201,11 +203,11 @@ your privileges and tastes).</p>
<code>.bst</code> files, then you'll need to copy these to somewhere
in the BibTeX search path. Type <kbd>kpsepath bst</kbd> on Unix to
find out the list of places BibTeX searches, and pick either one of
-the user-local locations, or a system-wide one. If you're installing
+the user-local locations, or a system-wide one. If you're installing
in a system-wide location, you'll need admin privileges, obviously,
and you will probably need to use <code>texhash</code>,
<code>mktexlsr</code> or its equivalent, to update LaTeX's filename
-cache. For further hints here, see
+cache. For further hints here, see
the TeX FAQ entries on <a
href='http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages'
>installing a package</a> and <a
@@ -289,16 +291,41 @@ is distributed as a PDF file, but if you want to regenerate it, use</p>
% latex urlbst
</pre>
+<h2><a name='licences'>Licences</a></h2>
+
+<!-- this text copied from the README.md -->
+<p>The copyright and licence position for the modified <code>.bst</code> files seems
+slightly muddy to me. On the grounds that any licence is better than
+no licence, I therefore assert that the <em>modifications</em> which the
+<code>urlbst</code> program makes to these files are copyright 2002-03, 2005-12, 2014, 2019,
+Norman Gray, and that these modifications are available for
+distribution under the terms of the LaTeX Project Public Licence.</p>
+
+<p>The original <code>.bst</code> files are copyright Howard Trickey and Oren
+Patashnik, with a set of permissions, in text at the top of the files,
+which state that "Unlimited copying and redistribution of this file
+are permitted as long as it is unmodified" (see the files for the
+complete text). The distribution terms above therefore appear to be
+compatible with -- in the sense of being morally equivalent to --
+these terms in the <code>.bst</code> file. If anyone disagrees with
+the logic here, I'd be very happy to discuss that.</p>
+
+<p>The <code>urlbst</code> script itself is distributed under the GPL, version 2.0.</p>
+
+<p>See the files <code>LICENCE-lppl.txt</code> and <code>LICENCE-gpl-2.0.txt</code> in the
+distribution, for the relevant licence text.</p>
+
+
<h2><a name='information'>Further Information and acknowledgements</a></h2>
-<p><code>urlbst</code> is archived on CTAN at <a
-href="http://www.tex.ac.uk/tex-archive/biblio/bibtex/contrib/urlbst/"
-><code>biblio/bibtex/contrib/urlbst/</code></a>, and discussed in the
+<p><code>urlbst</code> is archived <a
+href='https://ctan.org/pkg/urlbst'
+>on CTAN</a>, and discussed in the
<a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=citeURL" >TeX
FAQ</a>.</p>
-<p>The source code for the package is maintained at
-<a href='http://bitbucket.org/nxg/urlbst/'>bitbucket.org</a>,
+<p>The source code for the package is maintained at
+<a href='http://bitbucket.org/nxg/urlbst/'>bitbucket.org</a>,
which also includes an issue tracker, where you can report bugs (or
just mail me).</p>
@@ -306,16 +333,39 @@ just mail me).</p>
>home page of urlbst</a> might possibly have more recent versions than the
one you're looking at now.</p>
-<p>Thanks are due to many people for suggestions and requests,
-and to 'ijvm' for code contributions.</p>
-<p>Copyright 2002-11, Norman Gray. Released under the terms of the GNU
-General Public Licence.</p>
+<h2><a name='history'>Acknowledgements, and release notes</a></h2>
+
+<!-- include:release-notes.html -->
+<div xmlns='http://www.w3.org/1999/xhtml'>
+
+<p>Thanks are due to many people for suggestions and requests:
+to Jason Eisner for suggesting the <code>--inlinelinks</code> option;
+to ‘ijvm’ for code contributions in the <code>urlbst</code> script;
+to Paweł Widera for the suggestion to use <code>\path</code> 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.</p>
-<h2><a name='history'>Version history</a></h2>
<dl>
-<dt><strong>0.7, </strong></dt>
-<dd>Add --nodoi, --noeprints and --nopubmed options (which defaulted
+<dt><strong>0.8, 2019 July 1</strong></dt>
+<dd><ul>
+<li>The presence of a preexisting <code>format.doi</code>,
+<code>format.eprint</code> or <code>format.pubmed</code> function is
+now detected, and warned about. The resulting <code>.bst</code> file
+might still require some manual editing.
+Resolves <a href='https://bitbucket.org/nxg/urlbst/issue/8'>issue 8</a>.</li>
+<li>Clarified licences (I hope).</li>
+<li>Adjust format of DOI resolver.
+Resolves <a href='https://bitbucket.org/nxg/urlbst/issue/11'>issue 11</a>,
+thanks to
+<a href='https://bitbucket.org/nxg/urlbst/pull-requests/1/'
+>code contributed by Katrin Leinweber</a>.</li>
+</ul>
+</dd>
+
+<dt>0.7, 2011 July 20</dt>
+<dd>Add <code>--nodoi</code>, <code>--noeprints</code> and <code>--nopubmed</code> options (which defaulted
on, and couldn't otherwise be turned off)</dd>
<dt>0.7b1, 2011 March 17</dt>
@@ -338,35 +388,34 @@ such as aip.sty).</dd>
<dt>0.6-1, 2008 June 16</dt>
<dd>Fixed some broken links to the various citation standards
-(I think in this context this should probably <em>not</em> be happening, yes?).
+(I think in this context this should probably <em>not</em> be happening, yes?).
The distributed <code>*url.bst</code> no longer have the
<code>--inlinelinks</code> option turned on by default.</dd>
<dt><strong>0.6, 2007 March 26</strong></dt>
-<dd><p>Added the option <code>--inlinelinks</code>, which adds inline hyperlinks
+<dd><ul>
+<li>Added the option <code>--inlinelinks</code>, 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.</p>
-<p>Incorporate hyperref bugfixes from Pawe&#x0142; Widera.</p>
-<dl>
-<dt>0.6b3</dt>
-<dd>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.</dd>
-
-<dt>0.6b2</dt>
-<dd>Reworked <code>inlinelinks</code> support; should now be more
-robust. Incorporate hyperref bugfixes from Pawe&#x0142; Widera.</dd>
-
-<dt>0.6b1</dt>
-<dd>Added the option <code>inlinelinks</code>, which adds inline hyperlinks
+on-screen. Thanks to Jason Eisner for the suggestion, and much testing.</li>
+
+<li>Incorporate hyperref bugfixes from Paweł Widera.</li>
+
+<li>Further reworkings of the inlinelinks support, so that it's now
+fired by a <code>format.title</code> (or <code>format.btitle</code>) line, with a fallback in
+<code>fin.entry</code>. This should be more robust, and allows me to delete some
+of the previous version's gymnastics.</li>
+
+<li>Reworked <code>inlinelinks</code> support; should now be more
+robust. Incorporate hyperref bugfixes from Paweł Widera.</li>
+
+<li>Added the option <code>inlinelinks</code>, 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.</dd>
-</dl>
+on-screen.</li>
+</ul>
</dd>
<dt>0.5.2, 2006 September 6</dt>
@@ -389,7 +438,7 @@ bibliographies.</dd>
Now uses <code>./configure</code> (optionally). Assorted reorganisation.</dd>
<dt><strong>0.3, 2003 June 4</strong></dt>
-<dd>Added --eprint, --hypertex and --hyperref options.</dd>
+<dd>Added <code>--eprint</code>, <code>--hypertex</code> and <code>--hyperref</code> options.</dd>
<dt><strong>0.2, 2002 October 23</strong></dt>
<dd>The `editor' field is now supported in the webpage entry type. Basic
@@ -397,14 +446,16 @@ documentation added.</dd>
<dt><strong>0.1, 2002 April</strong></dt>
<dd>Initial version</dd>
-
</dl>
+</div>
+<p>Copyright 2002-03, 2005-12, 2014, 2019, Norman Gray. Released under the terms of the GNU
+General Public Licence.</p>
<div class="signature">
<a href="http://nxg.me.uk"
>Norman Gray</a><br/>
-2011 July 20
+2019 July 1
</div>
</body>