~ubuntu-branches/ubuntu/karmic/fastjar/karmic-security

.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.05)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "FASTJAR 1"
.TH FASTJAR 1 "2008-10-16" "0.97" "GNU"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
fastjar \- archive tool for Java archives
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
fastjar \fB\-ctxu\fR [\fB\s-1OPTIONS\s0\fR] [\fIjar-file\fR] [\fImanifest-file\fR] [\fB\-C\fR \fIdir\fR] \fIfiles\fR...
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\f(CW\*(C`fastjar\*(C'\fR is an implementation of Sun's jar utility that comes with
the \s-1JDK\s0, written entirely in C, and runs in a fraction of the time while
being feature compatible.
.PP
If any file is a directory then it is processed recursively.  The
manifest file name and the archive file name needs to be specified in
the same order the \fB\-m\fR and \fB\-f\fR flags are specified.
.SH "OPTIONS"
.IX Header "OPTIONS"
Exactly one of the following actions must be specified:
.IP "\fB\-c\fR" 4
.IX Item "-c"
Create new archive.
.IP "\fB\-t\fR" 4
.IX Item "-t"
List table of contents for archive.
.IP "\fB\-x\fR" 4
.IX Item "-x"
Extract named (or all) files from archive.
.IP "\fB\-u\fR" 4
.IX Item "-u"
Update existing archive.
.PP
The following parameters are optional:
.IP "\fB\-@\fR" 4
.IX Item "-@"
Read the names of the files to add to the archive from stdin.  This
option is supported only in combination with \fB\-c\fR or \fB\-u\fR.
Non standard option added in the \s-1GCC\s0 version.
.IP "\fB\-C\fR \fIdirectory\fR" 4
.IX Item "-C directory"
Change to the \fIdirectory\fR and include the following file.
.IP "\fB\-E\fR" 4
.IX Item "-E"
Prevent fastjar from reading the content of a directory when specifying
one (and instead relying on the provided list of files to populate the
archive with regard to the directory entry). Non standard option added
in the \s-1GCC\s0 version.
.IP "\fB\-M\fR" 4
.IX Item "-M"
Do not create a manifest file for the entries.
.IP "\fB\-i\fR" 4
.IX Item "-i"
Generate an index of the packages in this jar and its Class-Path.
.IP "\fB\-J\fR" 4
.IX Item "-J"
All options starting with \fB\-J\fR are ignored.
.IP "\fB\-0\fR" 4
.IX Item "-0"
Store only; use no \s-1ZIP\s0 compression.
.IP "\fB\-V\fR" 4
.IX Item "-V"
.PD 0
.IP "\fB\-\-version\fR" 4
.IX Item "--version"
.PD
Display version information.
.IP "\fB\-f\fR \fIarchive\fR" 4
.IX Item "-f archive"
Specify archive file name.
.IP "\fB\-m\fR \fImanifest\fR" 4
.IX Item "-m manifest"
Include manifest information from specified \fImanifest\fR file.
.IP "\fB\-v\fR" 4
.IX Item "-v"
Generate verbose output on standard output.
.PP
Parameters of the form \f(CW@option\fR{@}\fI\s-1FILE\s0\fR are considered to be names of files, and
are expanded with the contents of the file.
.PP
All remaining options are considered to be names of files.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIgcj\fR\|(1), \fIgij\fR\|(1), \fIgrepjar\fR\|(1)
and the Info entry for \fIgcj\fR.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (C) 2002, 2007, 2008 Matthias Klose
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the \s-1GNU\s0 General Public License as published by the
Free Software Foundation; either version 2, or (at your option) any
later version. A copy of the license is included in the
man page \fIgfdl\fR\|(7).