must_free_canvas isn't used when AUTOMAP_DIRECT_RENDER is defined (whoops)
[btb/d2x.git] / utilities / mvlextract.1
1 .\"                                      Hey, EMACS: -*- nroff -*-
2 .\" First parameter, NAME, should be all caps
3 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
4 .\" other parameters are allowed: see man(7), man(1)
5 .TH MVLEXTRACT 1 "July 10, 2003"
6 .\" Please adjust this date whenever revising the manpage.
7 .\"
8 .\" Some roff macros, for reference:
9 .\" .nh        disable hyphenation
10 .\" .hy        enable hyphenation
11 .\" .ad l      left justify
12 .\" .ad b      justify to both left and right margins
13 .\" .nf        disable filling
14 .\" .fi        enable filling
15 .\" .br        insert line break
16 .\" .sp <n>    insert n+1 empty lines
17 .\" for manpage-specific macros, see man(7)
18 .SH NAME
19 mvlextract \- Extracts all MVE (movie) files from the given MVL archive into the
20 current directory.
21 .SH SYNOPSIS
22 .B mvlextract
23 .RI [ options ]
24 .RI mvlfile
25 .RI [ filename ]
26 .br
27 .SH DESCRIPTION
28 This manual page documents briefly the
29 .B mvlextract
30 command.
31 This manual page was written for the Debian distribution
32 because the original program does not have a manual page.
33 .PP
34 .B mvlextract
35 is an utility to extract MVE movie files, like that found in the
36 DESCENT II videogame and played by the D2X package, archived in a MVL file,
37 i.e. a file with a .mvl extension. It supports all MVL files around, so if
38 you find one that doesn't work, please report this as a bug.
39
40 You'll find some MVL files as part of the Descent II Registered datafiles.
41 .SH OPTIONS
42 A summary of options is included below.  These command-line options do
43 not appear to be documented elsewhere, so the only authoritive source is
44 the source code itself.
45 .TP
46 .B v
47 Don't extract, print a listing of all MVE files to stdout.
48 .SH SEE ALSO
49 .BR mvlcreate (1),
50 .BR mveplayer (1).
51 .SH AUTHOR
52 The command was first created by Josh Cogliati in 1999, then modified by
53 Bradley Bell in 2002 for use with the D2X package.
54
55 This manual page was written by Paolo Ulivi <pulivi@libero.it>,
56 for the Debian GNU/Linux system (but may be used by others).