doc/dlb.6

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