Usage

Command Line Usage

WoStransform may be invoked from the command line in two forms:

WoStransform --version

This prints the version information.

WoStransform [options] -o output_file input_file ...

This will read one or more input files input_file which are in the format of Web-of-Science database output. It converts each entry in the input file(s) into a corresponding entry which is preformatted to be used in a BibTeX database. All entries from the input file(s) are collected and written into a single output file given by the -o option. This option is required. Other options are optional.

Options:

-v
verbose action; writes a lot of output to stdout

-o output_file
required; the file to which the result is written. If output_file already exists, its contents will be overwritten.

Examples

• WoStransform --version
  

print the version number of WoStransform

• WoStransform -o out.bib ak050202.txt
  

read Web-of-Science data from file ak050202.txt and write corresponding BibTeX output to out.bib

Exit Status

• 0
  successful execution of the program
• 1
  file or argument error

Error Messages

Error messages of WoStransform are mostly self explanatory.

• wrong number of arguments
  not enough arguments are given (e.g., missing input_file)
  
  

• no output file given
  the option -o was not given
  
  

• can't open file name
  input file or output file name could not be opened

Warning Messages

The following warnings may occur:

• file name not in recognized web-of-science format, skipped
  
  Input file named name does not contain a recognized header of a web-of-science file. The contents is ignored. The program starts to read the next input file if given.

• unknown publication type web-of-science-type in line i of file name
  
  The type of the web-of-science entry could not be recognized. The entry is skipped and the program attempts to read the next entry. The unknown type is given, together with the line number and file name, where the type occured. In order to process the offending type WoStransform has to be augmented. In particular, a new class corresponding to this type (and derived from class WoSentry) has to be declared in WoSentry.h with the appropriate strings for storage of the respective information, and member functions have to be defined in WoSentry.h or WoStransform.cc.

---