mirror of
https://git.code.sf.net/p/quake/quakeforge
synced 2024-11-30 16:10:53 +00:00
98 lines
3.4 KiB
Groff
98 lines
3.4 KiB
Groff
.\" hey, Emacs: -*- nroff -*-
|
|
.\" pak is free software; you can redistribute it and/or modify
|
|
.\" it under the terms of the GNU General Public License as published by
|
|
.\" the Free Software Foundation; either version 2 of the License, or
|
|
.\" (at your option) any later version.
|
|
.\"
|
|
.\" This program is distributed in the hope that it will be useful,
|
|
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
|
.\"
|
|
.\" See the GNU General Public License for more details.
|
|
.\"
|
|
.\" You should have received a copy of the GNU General Public License
|
|
.\" along with this program; see the file COPYING. If not, write to:
|
|
.\"
|
|
.\" Free Software Foundation, Inc.
|
|
.\" 59 Temple Place, Suite 330
|
|
.\" Boston, MA 02111-1307, USA
|
|
.\"
|
|
.\" Some roff macros, for reference:
|
|
.\" .nh disable hyphenation
|
|
.\" .hy enable hyphenation
|
|
.\" .ad l left justify
|
|
.\" .ad b justify to both left and right margins (default)
|
|
.\" .nf disable filling
|
|
.\" .fi enable filling
|
|
.\" .br insert line break
|
|
.\" .sp <n> insert n+1 empty lines
|
|
.\" for manpage-specific macros, see man(7)
|
|
.\"
|
|
.TH PAK 1 "03 May, 2002" QuakeForge "QuakeForge User's Manual"
|
|
.\" Please update the above date whenever this man page is modified.
|
|
.SH NAME
|
|
pak \- The QuakeForge Packfile Tool
|
|
.SH SYNOPSIS
|
|
.B pak
|
|
<\fBcommand\fP> [\fBoptions\fP] \fIARCHIVE\fP \fIFILE\fP...
|
|
.SH DESCRIPTION
|
|
\fBpak\fP is a utility for managing pack (*.pak) archives. The format used is
|
|
compatible with Quake and Quake II. Pak archives are a convenient way to store
|
|
groups of related files. Some engines allow pak archives to be compressed
|
|
internally.
|
|
.SH COMMANDS
|
|
\fBpak\fP accepts the following arguments as a command. Only one command may be
|
|
used at a time.
|
|
.TP
|
|
.B \-c, \-\-create
|
|
Create an archive. Overwrites any contents the archive may have had.
|
|
.TP
|
|
.B \-t, \-\-test
|
|
Test an archive for valid formatting.
|
|
.TP
|
|
.B \-x, \-\-extract
|
|
Extract an archive. Overwrites any files in the current directory with the same
|
|
names as those inside the archive.
|
|
.TP
|
|
.B \-h, \-\-help
|
|
Show summary of options.
|
|
.TP
|
|
.B \-V, \-\-version
|
|
Show the version of pak.
|
|
.SH OPTIONS
|
|
\fBpak\fP takes the following arguments as options.
|
|
.TP
|
|
.B \-f, \-\-file ARCHIVE
|
|
Use ARCHIVE as the archive filename, instead of the first non-option argument.
|
|
This option is provided for compatibility with older versions of \fBpak\fP.
|
|
.TP
|
|
.B \-p, \-\-pad
|
|
Can be useful when creating an archive. File space is padded to a 4\-byte
|
|
boundary, assisting in the speed of loading files from the archive. The file
|
|
data itself is not changed.
|
|
.TP
|
|
.B \-q, \-\-quiet
|
|
Inhibit some of pak's normal output.
|
|
.TP
|
|
.B \-v, \-\-verbose
|
|
Display more output than usual.
|
|
.SH "EXIT STATUS"
|
|
\fBpak\fP returns a zero exit status when it has completed a command
|
|
successfully (without error). Otherwise, it returns a non-zero exit status.
|
|
.SH BUGS
|
|
.PP
|
|
The program does not currently handle compression or decompression. This
|
|
is planned for a future version.
|
|
.PP
|
|
The program does not currently handle extraction of individual files inside an
|
|
archive. This is planned for a future version.
|
|
.PP
|
|
The program cannot modify an archive once it has been created.
|
|
.SH AUTHORS
|
|
Bill Currie (taniwha@quakeforge.net) wrote most of the program.
|
|
.PP
|
|
Jeff Teunissen (deek@quakeforge.net) wrote the command-line interface and the
|
|
documentation.
|
|
.SH "SEE ALSO"
|
|
.BR quakeforge (1),
|
|
.BR qfcc (1)
|