summaryrefslogtreecommitdiff
path: root/biblio/bibtex/utils/bibweb/INSTALL
diff options
context:
space:
mode:
Diffstat (limited to 'biblio/bibtex/utils/bibweb/INSTALL')
-rw-r--r--biblio/bibtex/utils/bibweb/INSTALL89
1 files changed, 89 insertions, 0 deletions
diff --git a/biblio/bibtex/utils/bibweb/INSTALL b/biblio/bibtex/utils/bibweb/INSTALL
new file mode 100644
index 0000000000..cd777b7454
--- /dev/null
+++ b/biblio/bibtex/utils/bibweb/INSTALL
@@ -0,0 +1,89 @@
+
+These instructions may be a bit out of date. You should really read
+the documentation in bibweb.dvi or bibweb.info or bibweb.texi or
+bibweb.html (same documentation, different formats).
+
+-------------------
+
+Before you even think about installing bibweb, you need to make sure
+that you can use MathSciNet from your machine. If not, you're out of
+luck.
+
+To install bibweb, you need to do two things:
+
+1. (optional) Get a copy of the program 'wget' from your favorite GNU
+site. Some choices of ftp sites are:
+
+ftp://ftp.hawaii.edu/mirrors/gnu
+ftp://ftp.digex.net/pub/gnu
+ftp://wuarchive.wustl.edu/systems/gnu
+ftp://ftp.cs.columbia.edu/archives/gnu/prep
+ftp://uiarchive.cso.uiuc.edu/pub/gnu
+ftp://gatekeeper.dec.com/pub/GNU
+ftp://labrea.stanford.edu/gnu
+ftp://ftp.uu.net/archive/systems/gnu
+ftp://prep.ai.mit.edu/pub/gnu (the main GNU site, but use a mirror instead)
+
+Once you've retrieved it, install it. (When I did this, I just
+followed the wget installation instructions, and it worked without a
+hitch.)
+
+See Note 1 for a description of wget.
+
+If you have lynx and you want to skip step 1, you can; bibweb will use
+lynx if it can't find wget. wget is faster than lynx, though.
+
+
+2. Put bibweb somewhere in your path. For instance, you might put
+it in $HOME/bin, as long as that is in your path (and if it isn't,
+look at your .cshrc (or equivalent) file). Make sure its permissions
+are set to "executable" (i.e., do 'chmod ugo+x bibweb'). Also find
+out where perl lives on your computer, and put its path on the first
+line of bibweb. On my machine, for instance, I might use
+
+ #!/usr/local/bin/perl5
+
+instead of '#!/usr/local/bin/perl'.
+
+bibweb works a bit better with version 5 of perl than with version
+4. I haven't even tested it with earlier versions.
+
+See Note 2 for a brief description of bibweb.
+
+3. There is no third thing. You're ready to go.
+
+----------------
+
+Notes:
+
+1. wget is a "utility to retrieve files from the World Wide Web", to
+quote the man page. In other words, it lets you browse the web
+without actually wasting time, which sort of defeats the purpose. If
+you run
+
+ wget http://e-math.ams.org/
+
+then wget retrieves the AMS home page and saves it in your directory.
+(I'm not quite sure why you would want to retrieve this page, but
+anyway...) A slightly more useful example:
+
+ wget http://www.gnus.org/gnus.tar.gz
+
+downloads the most recent beta version of the gnus package (which is a
+news and mail reader for Emacs).
+
+wget is GNU software, so it's freely distributable.
+
+
+2. bibweb is a perl script that scans the output from a bibtex run,
+figures out authors, titles, and so forth, then queries MathSciNet
+using wget (via some arcane URL).
+
+I wrote bibweb, and it is distributed under the GNU General Public
+License. Hence it's freely distributable. See the file 'COPYING' for
+details.
+
+----------------
+
+John H. Palmieri
+palmieri@math.washington.edu