| blob | 049a41b6d103557b834c4b24d0981d8d539747e8 |
1 .\" Automatically generated by Pod::Man v1.34, Pod::Parser v1.13
2 .\"
3 .\" Standard preamble:
4 .\" ========================================================================
5 .de Sh \" Subsection heading
6 .br
7 .if t .Sp
8 .ne 5
9 .PP
10 \fB\\$1\fR
11 .PP
12 ..
13 .de Sp \" Vertical space (when we can't use .PP)
14 .if t .sp .5v
15 .if n .sp
16 ..
17 .de Vb \" Begin verbatim text
18 .ft CW
19 .nf
20 .ne \\$1
21 ..
22 .de Ve \" End verbatim text
23 .ft R
24 .fi
25 ..
26 .\" Set up some character translations and predefined strings. \*(-- will
27 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
28 .\" double quote, and \*(R" will give a right double quote. | will give a
29 .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to
30 .\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C'
31 .\" expand to `' in nroff, nothing in troff, for use with C<>.
32 .tr \(*W-|\(bv\*(Tr
33 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
34 .ie n \{\
35 . ds -- \(*W-
36 . ds PI pi
37 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
38 . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
39 . ds L" ""
40 . ds R" ""
41 . ds C` ""
42 . ds C' ""
43 'br\}
44 .el\{\
45 . ds -- \|\(em\|
46 . ds PI \(*p
47 . ds L" ``
48 . ds R" ''
49 'br\}
50 .\"
51 .\" If the F register is turned on, we'll generate index entries on stderr for
52 .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
53 .\" entries marked with X<> in POD. Of course, you'll have to process the
54 .\" output yourself in some meaningful fashion.
55 .if \nF \{\
56 . de IX
57 . tm Index:\\$1\t\\n%\t"\\$2"
58 ..
59 . nr % 0
60 . rr F
61 .\}
62 .\"
63 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
64 .\" way too many mistakes in technical documents.
65 .hy 0
66 .if n .na
67 .\"
68 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
69 .\" Fear. Run. Save yourself. No user-serviceable parts.
70 . \" fudge factors for nroff and troff
71 .if n \{\
72 . ds #H 0
73 . ds #V .8m
74 . ds #F .3m
75 . ds #[ \f1
76 . ds #] \fP
77 .\}
78 .if t \{\
79 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
80 . ds #V .6m
81 . ds #F 0
82 . ds #[ \&
83 . ds #] \&
84 .\}
85 . \" simple accents for nroff and troff
86 .if n \{\
87 . ds ' \&
88 . ds ` \&
89 . ds ^ \&
90 . ds , \&
91 . ds ~ ~
92 . ds /
93 .\}
94 .if t \{\
95 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
96 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
97 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
98 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
99 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
100 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
101 .\}
102 . \" troff and (daisy-wheel) nroff accents
103 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
104 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
105 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
106 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
107 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
108 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
109 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
110 .ds ae a\h'-(\w'a'u*4/10)'e
111 .ds Ae A\h'-(\w'A'u*4/10)'E
112 . \" corrections for vroff
113 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
114 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
115 . \" for low resolution devices (crt and lpr)
116 .if \n(.H>23 .if \n(.V>19 \
117 \{\
118 . ds : e
119 . ds 8 ss
120 . ds o a
121 . ds d- d\h'-1'\(ga
122 . ds D- D\h'-1'\(hy
123 . ds th \o'bp'
124 . ds Th \o'LP'
125 . ds ae ae
126 . ds Ae AE
127 .\}
128 .rm #[ #] #H #V #F C
129 .\" ========================================================================
130 .\"
131 .IX Title "JAR 1"
132 .TH JAR 1 "2004-09-06" "gcc-3.4.2" "GNU"
133 .SH "NAME"
134 jar \- archive tool for Java archives
135 .SH "SYNOPSIS"
136 .IX Header "SYNOPSIS"
137 jar \fB\-ctxu\fR [\fB\s-1OPTIONS\s0\fR] [\fIjar-file\fR] [\fImanifest-file\fR] [\fB\-C\fR \fIdir\fR] \fIfiles\fR...
138 .SH "DESCRIPTION"
139 .IX Header "DESCRIPTION"
140 \&\f(CW\*(C`fastjar\*(C'\fR is an implementation of Sun's jar utility that comes with
141 the \s-1JDK\s0, written entirely in C, and runs in a fraction of the time while
142 being feature compatible.
143 .PP
144 If any file is a directory then it is processed recursively. The
145 manifest file name and the archive file name needs to be specified in
146 the same order the \fB\-m\fR and \fB\-f\fR flags are specified.
147 .SH "OPTIONS"
148 .IX Header "OPTIONS"
149 Exactly one of the following actions must be specified:
150 .IP "\fB\-c\fR" 4
151 .IX Item "-c"
152 Create new archive.
153 .IP "\fB\-t\fR" 4
154 .IX Item "-t"
155 List table of contents for archive.
156 .IP "\fB\-x\fR" 4
157 .IX Item "-x"
158 Extract named (or all) files from archive.
159 .IP "\fB\-u\fR" 4
160 .IX Item "-u"
161 Update existing archive. This option is disabled due to bugs (currently
162 fails with exit status 1 and does nothing).
163 .PP
164 The following parameters are optional:
165 .IP "\fB\-@\fR" 4
166 .IX Item "-@"
167 Read the names of the files to add to the archive from stdin. This
168 option is supported only in combination with \fB\-c\fR or \fB\-u\fR.
169 Non standard option added in the \s-1GCC\s0 version.
170 .IP "\fB\-C\fR \fIdirectory\fR" 4
171 .IX Item "-C directory"
172 Change to the \fIdirectory\fR and include the following file.
173 .IP "\fB\-E\fR" 4
174 .IX Item "-E"
175 Prevent fastjar from reading the content of a directory when specifying
176 one (and instead relying on the provided list of files to populate the
177 archive with regard to the directory entry). Non standard option added
178 in the \s-1GCC\s0 version.
179 .IP "\fB\-M\fR" 4
180 .IX Item "-M"
181 Do not create a manifest file for the entries.
182 .IP "\fB\-0\fR" 4
183 .IX Item "-0"
184 Store only; use no \s-1ZIP\s0 compression.
185 .IP "\fB\-V\fR" 4
186 .IX Item "-V"
187 .PD 0
188 .IP "\fB\-\-version\fR" 4
189 .IX Item "--version"
190 .PD
191 Display version information.
192 .IP "\fB\-f\fR \fIarchive\fR" 4
193 .IX Item "-f archive"
194 Specify archive file name.
195 .IP "\fB\-m\fR \fImanifest\fR" 4
196 .IX Item "-m manifest"
197 Include manifest information from specified \fImanifest\fR file.
198 .IP "\fB\-v\fR" 4
199 .IX Item "-v"
200 Generate verbose output on standard output.
201 .PP
202 All remaining options are considered to be names of files.
203 .SH "SEE ALSO"
204 .IX Header "SEE ALSO"
205 \&\fIgcj\fR\|(1), \fIgij\fR\|(1), \fIgrepjar\fR\|(1)
206 and the Info entry for \fIgcj\fR.
207 .SH "COPYRIGHT"
208 .IX Header "COPYRIGHT"
209 Copyright (C) 2002 Matthias Klose
210 .PP
211 Permission is granted to copy, distribute and/or modify this document
212 under the terms of the \s-1GNU\s0 General Public License as published by the
213 Free Software Foundation; either version 2, or (at your option) any
214 later version. A copy of the license is included in the
215 man page \fIgpl\fR\|(7).