starpkg man page on DragonFly
[printable version]
starpkg(1) 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 star‐
convert(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/local/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 con‐
taining 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 result‐
ing 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 starcon‐
vert option or argument.
--verbose, -v
Print all starconvert output to the terminal.
SEE ALSO
starplot(1), starconvert(1)
AUTHOR
Copyright © 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)
[top]
List of man pages available for DragonFly
Copyright (c) for man pages and the logo by the respective OS vendor.
For those who want to learn more, the polarhome community provides shell access and support.
[legal]
[privacy]
[GNU]
[policy]
[cookies]
[netiquette]
[sponsors]
[FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
|
Vote for polarhome
|