Files
nethack/doc/dlb.txt
PatR 5bf8b3de6b doc/{dlb,makedefs,nethack,recover}.txt update
Rebuild doc/*.txt (other than Guidebook) with 'nroff -man -c -Tascii'
rather than just 'nroff -man' to prevent it generating non-ASCII
characters for hyphen, aprostrophe, single and double quotes, long
dash, possibly others.  Also preprocess with '--grep-define ALLDOCS'
so that a few parts of the text don't end up being specific to the
local configuration.

The next time they're rebuilt they'll probably be subject to the
ping-pong effect of inserting padding spaces for justification
(alternating right-to-left vs left-to-right as intended but starting
with different parity so lots of gratuitous changes) since my quite
old version of groff triggers that for Guidebook.txt.
2023-11-23 17:24:33 -08:00

71 lines
2.3 KiB
Plaintext

DLB(6) DLB(6)
NAME
dlb - NetHack data librarian
SYNOPSIS
dlb { xct } [ vfIC ] arguments... [ files... ]
DESCRIPTION
Dlb is a file archiving tool in the spirit (and tradition) of tar for
NetHack version 3.1 and higher. It is used to maintain the archive
files from which NetHack reads special level files and other read-only
information. Note that like tar the command and option specifiers are
specified as a continuous string and are followed by any arguments
required in the same order as the option specifiers.
This facility is optional and may be excluded during NetHack configura-
tion.
COMMANDS
The x command causes dlb to extract the contents of the archive into
the current directory.
The c command causes dlb to create a new archive from files in the cur-
rent directory.
The t command lists the files in the archive.
OPTIONS AND ARGUMENTS
v verbose output
f archive specify the archive. Default if f not specified is LIBFILE
(usually the nhdat file in the playground).
I lfile specify the file containing the list of files to put in to
or extract from the archive if no files are listed on the command line.
Default for archive creation if no files are listed is LIBLISTFILE.
C dir change directory. Changes directory before trying to read
any files (including the archive and the lfile).
EXAMPLES
Create the default archive from the default file list:
dlb c
List the contents of the archive 'foo':
dlb tf foo
AUTHOR
Kenneth Lorber
SEE ALSO
nethack(6), tar(1)
BUGS
Not a good tar emulation; - does not mean stdin or stdout. Should
include an optional compression facility. Not all read-only files for
NetHack can be read out of an archive; examining the source is the only
way to know which files can be.
COPYRIGHT
This file is Copyright (C) Kenneth Lorber, 2022 for version
NetHack-3.7:1.12. NetHack may be freely redistributed. See license
for details.
NETHACK 8 February 2022 DLB(6)