usr.bin/gzip/zmore.1

   1 .\"     $NetBSD: zmore.1,v 1.2 2003/12/28 12:43:43 wiz Exp $
   2 .\"     $OpenBSD: zmore.1,v 1.3 2003/06/23 21:00:48 deraadt Exp $
   3 .\"
   4 .\" Copyright (c) 2003 Todd C. Miller <Todd.Miller@courtesan.com>
   5 .\"
   6 .\" Permission to use, copy, modify, and distribute this software for any
   7 .\" purpose with or without fee is hereby granted, provided that the above
   8 .\" copyright notice and this permission notice appear in all copies.
   9 .\"
  10 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  11 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  12 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  13 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  14 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  15 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  16 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  17 .\"
  18 .\" Sponsored in part by the Defense Advanced Research Projects
  19 .\" Agency (DARPA) and Air Force Research Laboratory, Air Force
  20 .\" Materiel Command, USAF, under agreement number F39502-99-1-0512.
  21 .\"
  22 .Dd June 23, 2003
  23 .Dt ZMORE 1
  24 .Os
  25 .Sh NAME
  26 .Nm zmore
  27 .Nd view compressed files on a CRT
  28 .Sh SYNOPSIS
  29 .Nm zmore
  30 .Op Ar flags
  31 .Op Ar file ...
  32 .Sh DESCRIPTION
  33 .Nm
  34 is a filter that allows the viewing of files compressed with Lempel-Ziv
  35 encoding.
  36 Such files generally have a
  37 .Dq Z
  38 or
  39 .Dq gz
  40 extension (both the
  41 .Xr compress 1
  42 and
  43 .Xr gzip 1
  44 formats are supported).
  45 Any
  46 .Ar flags
  47 that are specified are passed to the user's preferred
  48 .Ev PAGER
  49 (which is
  50 .Pa /usr/bin/more
  51 by default).
  52 .Pp
  53 When multiple files are specified,
  54 .Nm
  55 will pause at the end of each file and present the following prompt to the user:
  56 .Bd -literal -offset indent
  57 prev_file (END) - Next: next_file
  58 .Ed
  59 .Pp
  60 Where
  61 .Sy prev_file
  62 is the file that was just displayed and
  63 .Sy next_file
  64 is the next file to be displayed.
  65 The following keys are recognized at the prompt:
  66 .Bl -tag -width "e or q" -offset indent
  67 .It Ic e No or Ic q
  68 quit
  69 .Nm zmore .
  70 .It Ic s
  71 skip the next file (or exit if the next file is the last).
  72 .El
  73 .Pp
  74 If no files are specified,
  75 .Nm
  76 will read from the standard input.
  77 In this mode
  78 .Nm
  79 will assume
  80 .Xr gzip 1
  81 style compression since there is no suffix on which to make a decision.
  82 .Sh ENVIRONMENT
  83 .Bl -tag -width "PAGER"
  84 .It Ev PAGER
  85 Program used to display files.
  86 If unset,
  87 .Pa /usr/bin/more
  88 is used.
  89 .El
  90 .Sh SEE ALSO
  91 .Xr compress 1 ,
  92 .Xr less 1 ,
  93 .Xr more 1