NAME

SYNOPSIS

DESCRIPTION

See README for a quick start.
To know what's new in this release, see CHANGES.
The rest of documentation is in doc/index.html (HTML format).

OPTIONS

For options that take a parameter, the option and the parameter must be in separate command-line arguments, i.e. you cannot write -gdoom.

It is not possible to run options together, i.e. you can't use -dv as short for -d -v.

The -- "end-of-options" convention is not supported.

-?, -help, --help

Print usage summary to stdout and exit successfully.

-b string

Run a benchmark on some part of Yadex and exit successfully. See the benchmark() function for further details.

-d, -debug

Debug mode. This option is equivalent to and overrides the debug directive of the configuration file.

-expert

Expert mode. Enforces default choices for certain dialogs. As those default choices are IMHO not all judicious, I don't recommend using this option. Check insert_vertex_split_linedef and insert_vertex_merge_vertices instead. This option is equivalent to and overrides the expert directive of the configuration file.

-f, -config_file file

Use file as the config file instead of the default.

-fc, -fake_cursor

(X11 only) Fake cursor. Currently, this option is a no-op. This option is equivalent to and overrides the fake_cursor directive of the configuration file.

-fn, -font string

(X11 only) Use font string. If no font is specified or if the specified font is not found, Yadex falls back on the default font of the X server. This option is equivalent to and overrides the font directive of the configuration file.

-g, -game string

Set the game to string, which can be one of the following:

•	doom	Doom or Ultimate Doom
•	doom02	Doom alpha 0.2
•	doom04	Doom alpha 0.4
•	doom05	Doom alpha 0.5
•	doom2	Doom II or Final Doom
•	doompr	Doom press release pre-beta
•	heretic	Heretic
•	hexen	Hexen
•	strife	Strife 1.1 and later
•	strife10	Strife 1.0
    

This option is equivalent to and overrides the game directive of the configuration file.

-h, -height integer

(X11 only) Initial height of the window. If the argument is just a number, the height of the window will be that many pixels. If the argument is a number followed by a percent sign (%), it will be that many percent of the width of the screen. The default is 90%. This option is equivalent to and overrides the height directive of the configuration file. See also -w.

-i1, -iwad1 file

The name of the Doom or Ultimate Doom iwad. This option has effect only if the game is doom. This option is equivalent to and overrides the iwad1 directive of the configuration file.

-i2, -iwad2 file

The name of the Doom II or Final Doom iwad. This option has effect only if the game is doom2. This option is equivalent to and overrides the iwad2 directive of the configuration file.

-i3, -iwad3 file

The name of the Heretic iwad. This option has effect only if the game is heretic. This option is equivalent to and overrides the iwad3 directive of the configuration file.

-i4, -iwad4 file

The name of the Hexen iwad. This option has effect only if the game is hexen. This option is equivalent to and overrides the iwad4 directive of the configuration file.

-i5, -iwad5 file

The name of the Strife iwad. This option has effect only if the game is strife. This option is equivalent to and overrides the iwad5 directive of the configuration file.

-i6, -iwad6 file

The name of the Doom alpha 0.2 iwad. This option has effect only if the game is doom02. This option is equivalent to and overrides the iwad6 directive of the configuration file.

-i7, -iwad7 file

The name of the Doom alpha 0.4 iwad. This option has effect only if the game is doom04. This option is equivalent to and overrides the iwad7 directive of the configuration file.

-i8, -iwad8 file

The name of the Doom alpha 0.5 iwad. This option has effect only if the game is doom05. This option is equivalent to and overrides the iwad8 directive of the configuration file.

-i9, -iwad9 file

The name of the Doom press release pre-beta iwad. This option has effect only if the game is doompr. This option is equivalent to and overrides the iwad9 directive of the configuration file.

-i10, -iwad10 file

The name of the Strife 1.0 iwad. This option has effect only if the game is strife10. This option is equivalent to and overrides the iwad10 directive of the configuration file.

-pw, -pwad file

[Deprecated] Load pwad file. This option is useless since pwads can be given as arguments anyway. It's there for backward compatibility only. This option is equivalent to and overrides the pwad directive of the configuration file.

-P, -no_pixmap

(X11 only) Use no pixmap. Makes Yadex more responsive at the cost of a lot of flickering. Off by default. This option is equivalent to and overrides the no_pixmap directive of the configuration file.

-q, -quiet

In theory, quiet mode. In practice, has no effect. This option is equivalent to and overrides the quiet directive of the configuration file.

-qq, -quieter

Quieter. Makes Yadex completely silent (beepless). This option is equivalent to and overrides the quieter directive of the configuration file.

-s0, -select0

Select the 0th object automatically whenever the editing mode is set. This option is equivalent to and overrides the select0 directive of the configuration file.

-sb, -swap_buttons

Swap mouse buttons. Currently, this option is a no-op. This option is equivalent to and overrides the swap_buttons directive of the configuration file.

-td, -text_dot

Debug the DrawScreenText() function. This option is equivalent to and overrides the text_dot directive of the configuration file.

-v, -verbose

Verbose mode. This option is equivalent to and overrides the verbose directive of the configuration file.

--version

Print version information to stdout and exit successfully.

The first line contain three fields, separated by white space, with no other punctuation. The first field is the name of the program ("Yadex"). The second field is the version number ("1.7.0"). The third field is the release date, between parentheses ("(2022-04-08)").

The second line contains a configuration file magic string (not used).

The third line contains the magic string that this version requires at the beginning of game definition files.

-w, -width dimension

(X11 only) Initial width of the window. If the argument is just a number, the width of the window will be that many pixels. If the argument is a number followed by a percent sign (%), it will be that many percent of the width of the screen. The default is 90%. This option is equivalent to and overrides the width directive in the configuration file. See also -h.

-z, -zoom_default integer

Initial zoom factor in percent. The default is 0, which means that the zoom factor is to be adjusted so that the level fills the window. This option is equivalent to and overrides the zoom_default directive of the configuration file.

FILES

./yadex.cfg
~/.yadex/1.7.0/yadex.cfg
~/.yadex/yadex.cfg
/usr/local/etc/yadex.cfg

./game.ygd
~/.yadex/1.7.0/game.ygd
~/.yadex/game.ygd
/usr/local/share/yadex/game.ygd

ENVIRONMENT VARIABLES

DISPLAY

X11 only. The name of the X display that Yadex will try to connect to.

HOME

Used to expand ~ when locating configuration and game definition files.

LINES

If set, Yadex assumes the tty has that many lines instead of 24. The value must be an unsigned, non-zero decimal integer.

TMPDIR

If set, swap files are created there. Otherwise, in /tmp.

YADEX_GAME

Indicates the game to use. Overrides the game parameter in the config file, is overridden by the -g command line option.

APPLICATION RESOURCES

EXIT STATUS

BUGS

If you edit a level from a file that contains several and save it, all the other levels from that file are lost.

And many more. See TODO.

AUTHOR

Contributors:
Andrew J. Apted (http://www.netspace.net.au/~ajapted/)
Matthew W. Miller (zbp+ee+fhozhybp=eryyvzjz)

Yadex is derived from DEU 5.21 that was written by Raphaël Quinet, Brendon Wyber and others.

See the HTML documentation for detailed credits.

LEGAL

Parts copyright Andrew Apted 2000-2001, GNU GPL v2


Parts copyright André Majorel 1997-2003, GNU GPL v2


Parts copyright Matthew W. Miller 2000, GNU GPL v2


Parts written by Raphaël Quinet, public domain


Parts written by Brendon Wyber, public domain

SEE ALSO

LDE

http://interreality.org/~tetron/technology/lde/

PFME

http://www.purplefrog.com/~thoth/purplefrog/editor.html

Why

http://www.hut.fi/~jpakkane/why/

Xwad (part of Dumb)

http://stekt.oulu.fi/~tosi/dumb/dumb.html

Xwadtools

ftp://3darchives.in-span.net/pub/idgames/source/