[Top] [Contents] [Index] [ ? ]

Bibweb Manual

Bibweb is a perl script written by John Palmieri (in consultation with Bill Dwyer).

This is version 0.50, November 2003, of the Bibweb manual. Bug reports and suggestions for new features should go to `palmieri@math.washington.edu'.

This is the first version of this manual; it is done (except for the indices).

1. Introduction  Overview, quick instructions
2. How to  More detailed instructions
3. Installation  How to install

How to

2.1 LaTeX file  What your LaTeX file should look like
2.2 Invoking bibweb  What bibweb does

LaTeX file

2.1.1 Bibliography command  What the \bibliography command should look like
2.1.2 Citations  Formats for citations

Invoking bibweb

2.2.1 Basic operation  Quick instructions
2.2.2 Options  Options for running bibweb


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

1. Introduction

Bibweb is a utility for automatically retrieving bibliographical information from the American Mathematical Society's MathSciNet search engine (available at http://www.ams.org/mathscinet). (In particular, in order to use bibweb, you must have access to MathSciNet, which means that you or your institution has at some point shelled out some quantity of money to the AMS. Anyway...)

If you're too lazy to go to the library or use a web browser to find out bibliographical information for that ground-breaking paper you're writing, then bibweb is the program for you. It is intended for use with BibTeX (which means with LaTeX), and you have to write citations in a particular format, but that's about all there is to it.

Briefly: once you've installed bibweb, if you are editing a file called `bozo.tex', then you need to insert the following line:

 
  \bibliography{bozo}

If you are also using the BibTeX file `junk.bib', then you should use the following line:

 
  \bibliography{junk,bozo}

When you want to cite a paper whose bibliographical information you are lacking, say "Periodic phenomena in the Adams-Novikov spectral sequence" by H. R. Miller, D. C. Ravenel, and W. S. Wilson, then you give LaTeX the command

 
  \cite{miller-ravenel-wilson-periodic}

or

 
  \cite{miller-ravenel-wilson-novikov}

or

 
  \cite{miller-ravenel-wilson}

or

 
  \cite{miller-ravenel;adams-spectral}

When you run this through LaTeX, it won't find the citation (by assumption); BibTeX won't find a citation either. When you run bibweb, though, by typing

 
  bibweb bozo

at the shell prompt, then it takes your citation and queries MathSciNet. If it finds a match, it writes the bibliographic information, in BibTeX format, to the file `bozo.bib'.

Bibweb also lets you search for just a single citation, it lets you specify the names of the input (TeX) and output (BibTeX) files separately, and has other options. See section 2.2.2 Options, for details.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

2. How to

In this section, we give detailed instructions for how to use bibweb.

2.1 LaTeX file  What your LaTeX file should look like
2.2 Invoking bibweb  What bibweb does


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

2.1 LaTeX file

In this section, we describe how to write your LaTeX file so that it will produce output suitable for bibweb.

2.1.1 Bibliography command  What the \bibliography command should look like
2.1.2 Citations  Formats for citations


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

2.1.1 Bibliography command

You need to decide where you want to put the bibliographic information that bibweb will give you; this should be a file ending in `.bib'. Suppose you decide to use a file called `jimbob.bib' (which may or may not exist at this point). Then you need the following line in your LaTeX file:

 
  \bibliography{jimbob}

As indicated above, if you already have some other BibTeX files lying around, and you also want to use these (say they're called `manny.bib', `moe.bib', and `jack.bib'), then you should instead use the following line:

 
  \bibliography{manny,moe,jack,jimbob}


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

2.1.2 Citations

There are two different formats for citations that bibweb knows how to handle, and it handles them in different ways.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

2.2 Invoking bibweb

2.2.1 Basic operation  Quick instructions
2.2.2 Options  Options for running bibweb


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

2.2.1 Basic operation

In this section, we give the basic instructions for running bibweb, as well as a brief description of what bibweb does.

 
  bibweb file

will run bibweb on file. For example, to run bibweb on the file `elvis', you type

 
  bibweb elvis

Then bibweb will run BibTeX on `elvis' and read through the list of missing citations. For each such citation, it searches MathSciNet, and writes its results to the file `elvis.bib'. Once it has done this, it runs BibTeX again, to make use of any new citations.

If bibweb can't find the file `elvis.aux' (which it wants to pass to BibTeX), it prints an error message and stops. If it can't write to `elvis.bib', it should also print an error message and stop.

By "searches MathSciNet", I mean that it fires up a web browser that goes to the MathSciNet site, gives it the appropriate query, gets the response, and then quits. In recent versions of bibweb --- versions 0.50 and later -- it uses a web browser incorporated into perl. (Older versions used a program like `lynx' or `wget' for web browsing.)

By "its results", I mean the following:

Finally, note that if you give the citation

 
  \cite{serre}

and run bibweb, then run bibweb again, it will not query MathSciNet again; instead it will tell you something like "You've searched for `serre' before".


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

2.2.2 Options

bibweb can be run with several different options.

`-i file'
`--input=file'
Run BibTeX on file.

`-o file'
`--output=file'
Write output to file (after appending `.bib' to file, if necessary).

`--std'
Write output to STDOUT (the screen, ordinarily).

`-c citation'
`--cite=citation'
Look up only citation. In this case, the output is written to the screen, unless you also use the `-o' option.

`-m num'
`--max=num'
Return at most num matches to each citation. Actually, num is rounded up according to the options available at MathSciNet: num will be rounded up to one of: 5, 10, 20, 50, 100, 1000.

`-e site'
`--emath=site'
Search MathSciNet at the web site site. The default value is read from the environment variable MATHSCINET_SITE; if this variable hasn't been set, the default is `www.ams.org'. Some other good choices are `ams.rice.edu', `ams.mathematik.uni-bielefeld.de', `ams.mpim-bonn.mpg.de', `ams.u-strasbg.fr', and `ams.impa.br'---see the MathSciNet homepage for more information. If you choose a value for site that's not from this list, bibweb prints a warning, but goes ahead and tries to use it anyway. You can use a bit of shorthand for site: `ams' stands for `www.ams.org'; `rice' stands for `ams.rice.edu'; `bielefeld' stands for `ams.mathematik.uni-bielefeld.de'; `bonn' stands for `ams.mpim-bonn.mpg.de'; `strasbg' stands for `ams.u-strasbg.fr'; and `impa' stands for `ams.impa.br'.

`-sep char'
Use char to delimit fields in long citation format, instead of semicolon (;)

`-lax'
Use `%' to comment lines in BibTeX. The default behavior is to use `@comment' as the comment character -- this is officially supported by BibTeX, while `%' is not (although it seems to work).

`-b'
`--bibtex'
Produce output in bibtex format (the default).

`-d'
`--dvi'
Produce output in dvi format.

`-p'
`--postscript'
Produce output in postscript format.

`-pdf'
Produce output in pdf format.

`-t'
`--text'
Produce output in text format.

`-h'
`--help'
Print a short help message, and then quit.

For example, any of the following commands

 
  bibweb -i test -o a -m 10
  bibweb test -o a -m 10
  bibweb -o a -m 10 test
  bibweb --output=a --max=10 test

has bibweb read the file `text.aux' and write output to `a.bib', returning at most 10 matches for each citation.

The command

 
  bibweb --std -m 10 test

reads `test.aux' and writes the output to the screen (or whatever you have STDOUT set to). The command

 
  bibweb --emath=ams.rice.edu bozo

reads `bozo.aux', writes to `bozo.bib', and uses ams.rice.edu for the MathSciNet search, as do the commands

 
  bibweb --emath=rice bozo
  bibweb -e rice bozo
  bibweb bozo -e rice

The command

 
  bibweb --emath=quack bozo

uses `quack' for the MathSciNet search. In this case, bibweb will give a warning (since `quack' is not one of the recognized MathSciNet sites), and will produce no usable results (it will be fast, though).

If you run the command

 
  bibweb -m 23 -c 'serre'

then bibweb will tell you that it is rounding 23 up to 50, and then it will look for all articles with `serre' as the author. In this case, it will tell you that there were more than 50 matches found. I suppose if you typed

 
  bibweb -m 1000 -c 'serre'

then you would get all of Serre's papers listed on your screen. This might take a while. You could instead run

 
  bibweb -m 1000 -c 'serre' -o serre.bib

and then the output would be stored in the file `serre.bib'.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

3. Installation

This is complicated: put the file `bibweb' in your path and make sure it's executable.

That's it.

Actually, bibweb seems to require at least version 5.003 of perl, so if you have an older version, you may have to upgrade.

And of course, to use bibweb at all, you need to have a subscription to MathSciNet.


[Top] [Contents] [Index] [ ? ]

Table of Contents


[Top] [Contents] [Index] [ ? ]

Short Table of Contents

1. Introduction
2. How to
3. Installation

[Top] [Contents] [Index] [ ? ]

About this document

This document was generated by John Palmieri on December, 3 2003 using texi2html

The buttons in the navigation panels have the following meaning:

Button Name Go to From 1.2.3 go to
[ < ] Back previous section in reading order 1.2.2
[ > ] Forward next section in reading order 1.2.4
[ << ] FastBack previous or up-and-previous section 1.1
[ Up ] Up up section 1.2
[ >> ] FastForward next or up-and-next section 1.3
[Top] Top cover (top) of document  
[Contents] Contents table of contents  
[Index] Index concept index  
[ ? ] About this page  

where the Example assumes that the current position is at Subsubsection One-Two-Three of a document of the following structure:

This document was generated by John Palmieri on December, 3 2003 using texi2html