Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
humanzip(1)			 User's	Manual			   humanzip(1)

       humanzip, humanunzip - (un)compress text	files in a human readable way

       humanzip	[ options ] [ filename ...  ]
       humanunzip [ options ] [	filename ...  ]

       humanzip	compresses ASCII text files in a human readable	way.  It finds
       common words and	strings	of words,  replaces  them  with	 single	 UTF-8
       characters  and	puts  a	 key at	the top. humanunzip can	restore	zipped
       files to	their original state. humanzip is meant	to  reduce  the	 print
       and  screen  size of files, not to reduce their size in bytes, although
       that generally happens incidentally.  Reduction is typically  on	 order
       of 10%.

       humanzip	replaces each file with	one with the extension .hz appended to
       its name.  humanunzip does the reverse, except that if it  is  given  a
       file whose name does not	end in .hz it will replace it with a file with
       .out appended to	its name.  If given no files, it will read from	 stdin
       and write to stdout.

       You  are	encouraged to manually customize the compressed	output to suit
       your tastes.  As	long as	you follow the pattern,	the result will	 still
       be decompressable by humanunzip.

       humanunzip  will	try to decompress mangled files.  If it	detects	errors
       which might be recoverable, it will still write the  output,  but  keep
       the input.

       humanzip	options	are deliberately similar to those of gzip and bzip2.

       -f     Normally	human(un)zip  will refuse to overwrite existing	files.
	      This option forces it to do so.

       -c     Send output to stdout and	keep input files unchanged.

       -h     Print short help statement.

       -k     Keep input files instead of deleting them.

       -c     Send output to stdout and	keep input files unchanged.  If	 there
	      are  several  input  files to humanzip, the output consists of a
	      sequence of independently	compressed members.  To	obtain	better
	      compression,  concatenate	 all  input  files  before compressing

       --     Treat all	subsequent arguments as	file names, even if they start
	      with dashes.

OPTIONS: humanzip only
       -a     Normally,	 humanzip uses a blacklist of common English words and
	      phrases such as "into" and "to the" which	would probably be  an-
	      noying  to  be  replaced	by symbols.  This option disables this

       -n number
	      Use at most this number of abbreviations.	 humanzip  may	choose
	      to use fewer if it cannot	find enough that are worth doing.

       -l number
	      Look for abbreviations of	at most	this many words.  Setting this
	      too high will cause humanzip to use a very large amount of  mem-
	      ory.   Higher values of this option do not always	result in bet-
	      ter compression (at least, not in	the current version).

       -v     Be verbose.  Outputs information about progress as  it  is  com-

       -q     Be quiet.	 Output	only error messages.

       humanzip	 and humanunzip	each return 0 on sucess, 1 if they get bad ar-
       guments,	and the	number of failed files if any fail.  If	humanunzip en-
       counters	 possibly  recoverable errors in its input, it will count that
       file as a failure for this purpose even if the output turns out	to  be

       The newest version can always be	found at ???

       humanzip's  version number is currently less than 1.  When it becomes 1
       or larger, that means that I promise not	to  change  the	 file  format,
       command	line options or	return values without warning and/or backwards
       compatibility.  Until then, new versions	may break old versions'	 files
       and your	scripts.

       Copyright (C) 2007 Matthew Strait <>.  This is free
       software.  You may redistribute it under	the terms of the  GNU  General
       Public License version 2	<>.	 There
       is NO WARRANTY, to the extent permitted by law.

humanzip 0.5			 January 2007			   humanzip(1)


Want to link to this manual page? Use this URL:

home | help