starpkg(1)						      General Commands Manual							starpkg(1)

NAME

       starpkg - convert a StarPlot data set to StarPlot file format

SYNOPSIS

       starpkg [ --dataset ] data-set [ --dest destination ]
       starpkg --recurse input-dir [ --dest destination ]

DESCRIPTION

       On  the	StarPlot web site are available some packages of data that include both an original data file from NASA, and also a  specification
       file.  These packages are referred to as "data sets", from which starconvert(1) can produce a data file in StarPlot format.   For  ease	of
       use, this should be done via the starpkg shell script.

USAGE

       Assuming  that data-set is a valid StarPlot data set (either in tar.gz format or a directory resulting from uncompressing the tar.gz file),
       the `starpkg --dataset' command converts it to a StarPlot-formatted data file.  Note that the `--dataset' flag is optional, and the name of
       the input data set may be specified without it.	In order to be a valid StarPlot data set, a directory or tar.gz file must contain at least
       a valid specification file whose name ends with `.spec' and a flat text data file named `catalog.dat'.

       If the `--dest' option is omitted, the default location of the output file is the first of the directories /usr/share/starplot, $PWD, $HOME
       in which the user has write permissions.  If `--dest' is omitted or destination is a directory, the name of the output file will by default
       be ${specfilename%.spec}.stars.	For instance, a data set containing gliese.3.spec will produce a file named gliese.3.stars.

       The `starpkg --recurse' form of the command executes the above action for every StarPlot data  set  contained  in  input-dir,  placing  the
       resulting  StarPlot data files to the directory destination.  (If the --dest option is omitted, the default destination directory is chosen
       as above.)  This form of the starpkg command is most useful when a new version of StarPlot has been installed and you  wish  to	regenerate
       all StarPlot data files from data sets using the new starconvert program.

OPTIONS

       --dataset, -s
	      Specify a directory or tar.gz file to use as a StarPlot data set.

       --dest, -d
	      Specify the file or directory in which to output StarPlot-format data files.

       --quiet, -q
	      Print only fatal errors to the terminal.

       --recurse, -r
	      Specify a directory in which to search for StarPlot data sets.

       --starconvert-option option
	      Pass  option  through  to starconvert.  If you wish to pass more than one option (or an option that takes a following argument), you
	      should give this flag multiple times, once for each starconvert option or argument.

       --verbose, -v
	      Print all starconvert output to the terminal.

SEE ALSO

       starplot(1), starconvert(1)

AUTHOR

       Copyright (C) 2000-2002 under the GNU GPL by Kevin B. McCarty <starplot@starplot.org>.  The StarPlot web page is at www.starplot.org.

								     Nov 2002								starpkg(1)