README for INSPEC version 0.01, 31 Jan. 2001

CHANGES
01/31/2001: first release version 0.01

PREREQUISITES

Perl 5.000 or later

libwww-perl (LWP::Simple package). This package has some prerequisits and all of them are availible on CPAN.

Text::ParseWords package Should come with Perl

INSPEC service through AXIOM corp. visit http://axiom.iop.org/ to see if your institution has a subscription.

Only works with BibTeX databases.. so far.

INSTALLATION

This module is written entirely in Perl. There's nothing to build, and installation should be as simple as

perl Makefile.PL
make
make install

To install this module by hand, simply copy retriever.pm and bibtex.pm to the \perl\lib\INSPEC directory.

You must make one small change to getCite.pl:

open getCite.pl with an editor and find the following line $INSPEC::Retriever::AXIOM_code = "ARKAN" ; # ...

You must change "ARKAN" to the code for your institution. To find your insitutions code, visit http://axiom.iop.org/ and hit the Access Axiom -> Standard Service link. Look at the URL in your browser. At the U of A the URL looks like: http://axiom.iop.org/S/ARKAN/search . Your's will not contain ARKAN but some other code. Replace ARKAN with whatever your code is in the getcite.pl line above and save getcite.pl. You are all set.

USAGE

This is a command line tool. To add a reference to your database you need to know three pieces of information:

The CODEN or ISSN for the journal
The volume number
The starting page number

A CODEN is designation assigned to a periodical title by the Chemical Abstracts Service. Each CODEN consists of four mnemonic letters and a fifth letter, A, B, C, or D. The sixth character, a check character, is alphabetic or numeric. To find the CODEN of the journal you are interested in you can check the journal or search for it through AXIOM.

To add Physical Review Letters (CODEN=PRLTAO), Volume 83 Page 2989 to your bibtex file called mybib.bib. You would type the following

getcite PRLTAO 83 2989 --b mybib.bib

CONTACTING THE AUTHOR

The best way to reach me is by email to <vlabella@uark.edu> You will find additional contact information at http://www.uark.edu/misc/vlabella

COPYRIGHT

Copyright (C) 2001 Vincent LaBella.
All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

WARRANTY

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.