doc/dlb.txt

   1 DLB(6)                           Games Manual                           DLB(6)
   2
   3
   4
   5 NAME
   6        dlb - NetHack data librarian
   7
   8 SYNOPSIS
   9        dlb { xct } [ vfIC ] arguments...  [ files...  ]
  10
  11 DESCRIPTION
  12        Dlb  is  a file archiving tool in the spirit (and tradition) of tar for
  13        NetHack version 3.1 and higher.  It is used  to  maintain  the  archive
  14        files  from which NetHack reads special level files and other read-only
  15        information.  Note that like tar the command and option specifiers  are
  16        specified  as  a  continuous  string  and are followed by any arguments
  17        required in the same order as the option specifiers.
  18
  19        This facility is optional and may be excluded during NetHack configura-
  20        tion.
  21
  22 COMMANDS
  23        The  x  command  causes dlb to extract the contents of the archive into
  24        the current directory.
  25
  26        The c command causes dlb to create a new archive from files in the cur-
  27        rent directory.
  28
  29        The t command lists the files in the archive.
  30
  31 OPTIONS AND ARGUMENTS
  32        v           verbose output
  33
  34        f archive   specify the archive.  Default if f not specified is LIBFILE
  35        (usually the nhdat file in the playground).
  36
  37        I lfile     specify the file containing the list of files to put in  to
  38        or extract from the archive if no files are listed on the command line.
  39        Default for archive creation if no files are listed is LIBLISTFILE.
  40
  41        C dir       change directory.  Changes directory before trying to  read
  42        any files (including the archive and the lfile).
  43
  44 EXAMPLES
  45        Create the default archive from the default file list:
  46                    dlb c
  47
  48        List the contents of the archive 'foo':
  49                    dlb tf foo
  50
  51 AUTHOR
  52        Kenneth Lorber
  53
  54 SEE ALSO
  55        nethack(6), tar(1)
  56
  57 BUGS
  58        Not  a  good  tar  emulation;  - does not mean stdin or stdout.  Should
  59        include an optional compression facility.  Not all read-only files  for
  60        NetHack can be read out of an archive; examining the source is the only
  61        way to know which files can be.
  62
  63 COPYRIGHT
  64        This file is Copyright (C) Kenneth Lorber, 2024 for  version  keni-git-
  65        set:1.13.   NetHack  may  be  freely  redistributed.   See  license for
  66        details.
  67
  68
  69
  70 NETHACK                        25 December 2024                         DLB(6)