move to debhelper compat 13, hopefully fixes cross-building
[debian/cpmtools] / mkfs.cpm.1.in
1 .TH MKFS.CPM 1 "@UPDATED@" "CP/M tools" "User commands"
2 .SH NAME \"{{{roff}}}\"{{{
3 mkfs.cpm \- make a CP/M file system
4 .\"}}}
5 .SH SYNOPSIS \"{{{
6 .ad l
7 .B mkfs.cpm
8 .RB [ \-f
9 .IR format ]
10 .RB [ \-b
11 .IR boot ]
12 .RB [ \-L
13 .IR label ]
14 .RB [ \-t ]
15 .RB [ \-u ]
16 .I image
17 .ad b
18 .\"}}}
19 .SH DESCRIPTION \"{{{
20 \fBmkfs.cpm\fP makes a CP/M file system on an image file or device.
21 .\"}}}
22 .SH OPTIONS \"{{{
23 .IP "\fB\-f\fP \fIformat\fP"
24 Use the given CP/M disk \fIformat\fP instead of the default format.
25 .IP "\fB\-b\fP \fIbootblock\fP"
26 Write the contents of the file \fIbootblock\fP to the system tracks
27 instead of filling them with 0xe5.  This option can be used up to four
28 times.  The file contents (typically boot block, CCP, BDOS and BIOS)
29 are written to sequential sectors, padding with 0xe5 if needed.
30 .IP "\fB\-L\fP \fIlabel\fP"
31 Label the file system.  This is only supported by CP/M Plus.
32 .IP "\fB\-t\fP"
33 Create time stamps.
34 .IP "\fB\-u\fP"
35 Show all CP/M file names in upper case.
36 .\"}}}
37 .SH "RETURN VALUE" \"{{{
38 Upon successful completion, exit code 0 is returned.
39 .\"}}}
40 .SH ERRORS \"{{{
41 Any errors are indicated by exit code 1.
42 .\"}}}
43 .SH ENVIRONMENT \"{{{
44 CPMTOOLSFMT     Default format
45 .\"}}}
46 .SH FILES \"{{{
47 @DATADIR@/diskdefs      CP/M disk format definitions
48 .\"}}}
49 .SH AUTHORS \"{{{
50 This program is copyright 1997\(en2021 Michael Haardt
51 <michael@moria.de>.  The Windows port is copyright 2000, 2001, 2011 John Elliott
52 <jce@seasip.demon.co.uk>.
53 .PP
54 This program is free software; you can redistribute it and/or modify
55 it under the terms of the GNU General Public License as published by
56 the Free Software Foundation; either version 3 of the License, or
57 (at your option) any later version.
58 .PP
59 This program is distributed in the hope that it will be useful,
60 but WITHOUT ANY WARRANTY; without even the implied warranty of
61 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
62 GNU General Public License for more details.
63 .PP
64 You should have received a copy of the GNU General Public License along
65 with this program.  If not, write to the Free Software Foundation, Inc.,
66 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
67 .\"}}}
68 .SH "SEE ALSO" \"{{{
69 .IR fsck.cpm (1),
70 .IR cpmls (1),
71 .IR mkfs (1),
72 .IR cpm (5)
73 .\"}}}