.\" create-file.1 - manual page for the create-file command
.\" Copyright (C) 2009  Lars Wirzenius
.\"
.\" 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 CREATE-FILE 1
.SH NAME
create-file \- create a file full of zero bytes
.SH SYNOPSIS
.B create-file
.RB [ -h ]
.RB [ --help ]
.RB [ --sparse ]
.RB [ --size =\fISIZE ]
.RI [ filename ]...
.SH DESCRIPTION
.B create-file
creates a file full of zero bytes (0x00, NUL).
.SH OPTIONS
.TP
.BR -h ", " --help
Show a short help message.
.TP
.B --sparse
Create a sparse file, which does not allocate disk blocks.
.TP
.BR --size =\fISIZE
Create a file of
.I SIZE
bytes.
The size may be have a suffix to indicate kilobyte (K, KB), megabyte (M, MB),
or gigabyte (G, GB), or power-of-two multipliers for kibibyte (KiB),
mebibyte (MiB), or gibibyte (GiB). 
All suffixes are case-insensitive.