.TH lepton-archive 1 "December 11, 2018" "Lepton EDA" 1.9.7.20181211

.SH NAME
lepton-archive \- create and extract Lepton EDA design archives

.SH SYNOPSIS
.B lepton-archive 
.RI [ options ] 
.RB [ \-o
.IR output_file ] 
.I file
\&...

.SH DESCRIPTION
.B lepton-archive
creates and extracts Lepton EDA designs from an archive. The two modes of
operation are "archive mode" (archive creation) and "extract mode".
In archive mode it creates a project archive from a bunch of project
files, and in extract mode it extracts the files from the archive and
places them in the local dir.
.PP
Archive mode is the default.

.SH OPTIONS
.TP
.BI \-f\  filename
Optional.  Used in archive mode.  Read files to archive from <filename>
instead of garchiverc.
.TP
.B \-v
Verbose mode.
.TP
.B \-e
Extract the archive specified on the command line.
.TP
.B \-a
Create an archive. This is the default.
.TP
.BI \-o\  outfile
Optional.  Used in archive mode.  Specifies the name of the
output archive file.  The output file extension should be ".tar.gz".
If this flag is not specified, the output file name is
"ProjectArchive.tar.gz".
.TP
.BR \-h ", " \-\-help
Print usage information.
.SH EXAMPLES
To create an archive named MyArchive.tar.gz (the files to store listed in
garchiverc):
.IP
lepton-archive \-o MyArchive.tar.gz
.PP
Verbosely create an archive (archives files listed on cmd line
as well as those listed in garchiverc):
.IP
lepton-archive \-v \-o MyArchive.tar.gz README Schematic1.sch Schematic2.sch Schematic3.sch
.PP
Extract an archive:
.IP
lepton-archive \-e ProjectArchive.tar.gz

.SH AUTHOR
Stuart Brorson <sdb@cloud9.net>

.SH SEE ALSO
.BR lepton-schematic(1)

.SH COPYRIGHT
.nf
Copyright \(co 2012-2017 gEDA Contributors.
License GPLv2+: GNU GPL version 2 or later. Please see the `COPYING'
file included with this program for full details.
.PP
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.