summaryrefslogtreecommitdiff
path: root/games/oblige/oblige.6
blob: 2748279bc1571e647a9baad8d97e6ca28ed9e931 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
.\" Man page generated from reStructuredText.
.
.TH OBLIGE 6 "2017-12-21" "7.70" "SlackBuilds.org"
.SH NAME
oblige \- random level generator for Doom and Doom II
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.\" RST source for oblige(6) man page. Convert with:
.
.\" rst2man.py oblige.rst > oblige.6
.
.\" rst2man.py comes from the SBo development/docutils package.
.
.SH SYNOPSIS
.sp
oblige [\fI\-options\fP] [\fIkey=value\fP \fI\&...\fP]
.SH DESCRIPTION
.sp
\fBoblige\fP creates a patch WAD file for use with Doom or Doom II,
containing one or more randomly\-generated levels. The generated WAD
files are ready to play (no separate node\-building pass is needed).
.sp
Normally, \fBoblige\fP is controlled by its GUI, but it can be used
noninteractively (see the \fB\-b\fP option below).
.SH OPTIONS
.INDENT 0.0
.TP
.BI \-\-home \ <dir>
Home directory, where \fBoblige\fP looks for its config file, and creates
temporary files. Default is \fI~/.oblige\fP\&.
.TP
.BI \-\-install \ <dir>
Installation directory, where \fBoblige\fP looks for lua scripts and other
data. Default is \fI/usr/share/oblige\fP\&.
.TP
.BI \-\-config \ <file>
Config file to use. Default is \fI~/.oblige/CONFIG.txt\fP in GUI mode, none in
\fB\-\-batch\fP mode.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-batch, \fB\-b\fP \fI<output>\fP
Batch mode (no GUI). Uses built\-in default config (never reads the
normal config file used by the GUI), but the \fB\-\-load\fP option can be
used to override the defaults. \fIoutput\fP will be a PWAD file and will
be overwritten without prompting if it exists.
.TP
.B \-\-load, \fB\-l\fP \fI<file>\fP
Load settings from a file. This is in the same format as
\fI~/.oblige/CONFIG.txt\fP, and any settings in the loaded file will override
the ones there. In \fB\-\-batch\fP mode, "\fB\-\-load ~/.oblige/CONFIG.txt\fP"
will generate levels according to the settings configured by the GUI.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-keep\fP,\fB  \-k
Keep random seed from loaded settings. Normally the seed stored in the
config file is ignored, and a new seed is generated.
.TP
.B \-\-debug\fP,\fB  \-d
Enable verbose debugging messages in log.
.TP
.B \-\-terminal\fP,\fB  \-t
Print log messages to stdout (rather than \fI~/.oblige/LOGS.txt\fP). Disabled
by default, unless in \fB\-\-batch\fP mode.
.TP
.B \-\-help\fP,\fB  \-h
Show built\-in help message.
.UNINDENT
.INDENT 0.0
.TP
.B \fBkey=value\fP
Override setting from CONFIG.txt. May be given multiple times.
.UNINDENT
.\" other sections we might want, uncomment as needed.
.
.\" FILES
.
.\" =====
.
.\" ENVIRONMENT
.
.\" ===========
.
.\" EXIT STATUS
.
.\" ===========
.
.\" BUGS
.
.\" ====
.
.\" EXAMPLES
.
.\" ========
.
.SH COPYRIGHT
.sp
See the file /usr/doc/oblige\-7.70/GPL.txt for license information.
.SH AUTHORS
.sp
\fBoblige\fP is (c) 2006\-2017 by Andrew Apted.
.sp
This man page written for the SlackBuilds.org project
by B. Watson, and is licensed under the WTFPL.
.SH SEE ALSO
.sp
\fIoblige\-legacy4(6)\fP, an older version of \fBoblige\fP with a simpler
level\-generation algorithm and support for other games including Heretic,
Hexen, and Quake.
.sp
The \fBoblige\fP home page: \fI\%http://oblige.sourceforge.net\fP
.\" Generated by docutils manpage writer.
.