NHDT->ANH, nethack->anethack, nhdat->anhdat
[aNetHack.git] / doc / dlb.txt
blobd198cf504c138c1639ab7d11a95000fd224b95d1
4 DLB(6)                        1993                         DLB(6)
8 NAME
9      dlb - aNetHack data librarian
11 SYNOPSIS
12      dlb { xct } [ vfIC ] arguments...  [ files... ]
14 DESCRIPTION
15      Dlb is a file archiving tool in the spirit  (and  tradition)
16      of  tar  for  aNetHack version 3.1 and higher.  It is used to
17      maintain the archive files from which aNetHack reads  special
18      level files and other read-only information.  Note that like
19      tar the command and option specifiers  are  specified  as  a
20      continuous string and are followed by any arguments required
21      in the same order as the option specifiers.
23      This facility is optional and may be excluded during aNetHack
24      configuration.
26 COMMANDS
27      The x command causes dlb to  extract  the  contents  of  the
28      archive into the current directory.
30      The c command causes dlb to create a new archive from  files
31      in the current directory.
33      The t command lists the files in the archive.
35 OPTIONS AND ARGUMENTS
36      v           verbose output
38      f archive   specify the archive.  Default if f not specified
39      is LIBFILE (usually the anhdat file in the playground).
41      I lfile     specify the file containing the list of files to
42      put in to or extract from the archive if no files are listed
43      on the command line.  Default for  archive  creation  if  no
44      files are listed is LIBLISTFILE.
46      C dir       change directory.  Changes directory before try-
47      ing to read any files (including the archive and the lfile).
49 EXAMPLES
50      Create the default archive from the default file list:
51                  dlb c
53      List the contents of the archive 'foo':
54                  dlb tf foo
56 AUTHOR
57      Kenneth Lorber
63 Oct                      Last change: 28                        1
70 DLB(6)                        1993                         DLB(6)
74 SEE ALSO
75      anethack(6), tar(1)
77 BUGS
78      Not a good tar emulation; - does not mean stdin  or  stdout.
79      Should  include  an  optional compression facility.  Not all
80      read-only files for aNetHack can be read out of  an  archive;
81      examining the source is the only way to know which files can
82      be.
129 Oct                      Last change: 28                        2