.\" Copyright 2011 Lars Wirzenius <liw@liw.fi>
.\" 
.\" This program is free software: you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation, either version 3 of the License, or
.\" (at your option) any later version.
.\" 
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\" 
.\" You should have received a copy of the GNU General Public License
.\" along with this program.  If not, see <http://www.gnu.org/licenses/>.
.\"
.TH HUMANIFY 1
.SH NAME
humanify \- format bit- and byte-sizes into human-readable form
.SH SYNOPSIS
.B humanify
.RB [ \-\-binary ]
.RI [ size ...]
.SH DESCRIPTION
.B humanify
formats in human-readable form data sizes (number of bits or bytes).
For example,
it can turn
.I 1234
into
.I "1 kB"
or
.IR "1 KiB" .
Sizes are given on the command line,
or one-per line in the standard input.
Sizes are rounded to the nearest integer.
.SH OPTIONS
.TP
.BR \-\-binary
Use 2-based prefixes (from IEC),
rather than 10-based ones (from ISO).
In other words, "kibibyte" instead of "kilobyte".
.TP
.BR \-\-bits
Inputs give number of bits, instead of bytes.