[src/tls-maxphys]: src/external/bsd/liblzf/usr.bin/lzf Take wiz's suggestion.

[tls <tls%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/6b9a97562e3f
branches:  tls-maxphys
changeset: 852916:6b9a97562e3f
user:      tls <tls%NetBSD.org@localhost>
date:      Sun Sep 16 22:08:18 2012 +0000

description:
Take wiz's suggestion.

diffstat:

 external/bsd/liblzf/usr.bin/lzf/lzf.1 |  150 ++++++++++++++++++++++++++++++++++
 1 files changed, 150 insertions(+), 0 deletions(-)

diffs (154 lines):

diff -r 8c7087098c6e -r 6b9a97562e3f external/bsd/liblzf/usr.bin/lzf/lzf.1
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/external/bsd/liblzf/usr.bin/lzf/lzf.1     Sun Sep 16 22:08:18 2012 +0000
@@ -0,0 +1,150 @@
+.\"    $NetBSD: lzf.1,v 1.3.4.2 2012/09/16 22:08:18 tls Exp $
+.\"
+.\" Copyright (c) 2012 The NetBSD Foundation, inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to the NetBSD Foundation
+.\" by Thor Lancelot Simon.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"        This product includes software developed by the NetBSD
+.\"        Foundation, Inc. and its contributors.
+.\" 4. Neither the name of The NetBSD Foundation nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd September 16, 2012
+.Dt LZF 1
+.Os
+.Sh NAME
+.Nm lzf
+.Nd compress and uncompress files using LZF algorithm
+.Sh SYNOPSIS
+.Nm
+.Op Fl bcdfhv
+.Ar file
+.Oo
+.Ar file Oo ...
+.Oc
+.Oc
+.Nm unlzf
+.Ar file
+.Oo
+.Ar file Oo ...
+.Oc
+.Oc
+.Nm lzfcat
+.Ar file
+.Oo
+.Ar file Oo ...
+.Oc
+.Oc
+.Sh DESCRIPTION
+.Nm
+is a simple program to compress or uncompress files using LZF
+(sometimes known as "Lempel-Ziv Fast") coding.
+LZF is extremely fast, about 75% of the performance of
+.Xr memcpy 3
+for many inputs, while offering a moderate compression ratio,
+usually between 1.5:1 and 2:1.
+.Pp
+When compressing, it removes each input file and replaces it with an
+output file with the suffix
+.Dq Pa .lzf
+appended.
+When uncompressing, it removes each input file and replaces it with
+an output file with the suffix
+.Dq Pa .lzf
+removed.
+If no files are specified as arguments, standard input and standard
+output are used as input and output respectively.
+.Pp
+If invoked as
+.Nm lzf ,
+the default mode of operation is to compress.
+If invoked as
+.Nm unlzf ,
+the default mode of operation is to uncompress.
+If invoked as
+.Nm lzfcat ,
+the default mode of operation is to uncompress to standard output.
+.Sh OPTIONS
+The following options are available:
+.Bl -tag -width width
+.It Fl b
+This option selects a compression blocksize.
+Small compression block sizes give poor compression and slow
+operation; the default of 64KiB is strongly recommended.
+Block sizes larger than 64KiB are silently reduced to 64KiB in
+order to not produce output incompatible with other versions of
+.Nm .
+.It Fl c
+This option selects compression.
+.It Fl d
+This option selects decompression.
+.It Fl f
+This option forces overwrite of preexisting output files, if any.
+.It Fl h
+This option prints command usage.
+.It Fl v
+This option prints compression statistics for each file processed.
+.El
+.Sh SEE ALSO
+.Xr bzip2 1 ,
+.Xr compress 1 ,
+.Xr gzip 1 ,
+.Xr xz 1
+.Sh HISTORY
+The
+.Nm
+program was first included with version 0.1 of Marc Lehmann's LZF library.
+It was rewritten for version 2.0 of the library to offer the current
+syntax, which is mostly compatible with other compression utilities such
+as
+.Xr gzip 1 .
+The
+.Nm
+program first appeared in
+.Nx 7.0 .
+.Sh AUTHORS
+The
+.Nm
+program was written by
+.An Stefan Traby Aq stefan%hello-penguin.com@localhost .
+.Sh BUGS
+Some versions of
+.Nm
+install a program named
+.Dq Pa lzcat
+instead of
+.Nm lzfcat .
+Because the
+.Pq lzcat
+name is also used by
+.Xr xz 1 ,
+in
+.Nx
+the name
+.Nm lzfcat
+is used instead.