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        ^?ALLDOCS This facility is optional and may be excluded during  NetHack
  20        configuration.   ^:  ^?DLB This facility is optional but is included in
  21        this NetHack configuration.  ^:  This  facility  is  optional  and  was
  22        excluded from this NetHack configuration.  ^.  ^.
  23
  24 COMMANDS
  25        The  x  command  causes dlb to extract the contents of the archive into
  26        the current directory.
  27
  28        The c command causes dlb to create a new archive from files in the cur-
  29        rent directory.
  30
  31        The t command lists the files in the archive.
  32
  33 OPTIONS AND ARGUMENTS
  34        v           verbose output
  35
  36        f archive   specify the archive.  Default if f not specified is LIBFILE
  37        (usually the nhdat file in the playground).
  38
  39        I lfile     specify the file containing the list of files to put in  to
  40        or extract from the archive if no files are listed on the command line.
  41        Default for archive creation if no files are listed is LIBLISTFILE.
  42
  43        C dir       change directory.  Changes directory before trying to  read
  44        any files (including the archive and the lfile).
  45
  46 EXAMPLES
  47        Create the default archive from the default file list:
  48                    dlb c
  49
  50        List the contents of the archive 'foo':
  51                    dlb tf foo
  52
  53 AUTHOR
  54        Kenneth Lorber
  55
  56 SEE ALSO
  57        nethack(6), tar(1)
  58
  59 BUGS
  60        Not  a  good  tar  emulation;  - does not mean stdin or stdout.  Should
  61        include an optional compression facility.  Not all read-only files  for
  62        NetHack can be read out of an archive; examining the source is the only
  63        way to know which files can be.
  64
  65 COPYRIGHT
  66        This file is  Copyright  (C)  Kenneth  Lorber  and  was  last  modified
  67        2018/04/25  (version  NetHack-3.6.0:1.7).  NetHack may be freely redis-
  68        tributed.  See license for details.
  69
  70
  71
  72 NETHACK                           25 May 2015                           DLB(6)