move to debhelper compat 13, hopefully fixes cross-building
[debian/cpmtools] / cpmls.1.in
1 .TH CPMLS 1 "@UPDATED@" "CP/M tools" "User commands"
2 .SH NAME \"{{{roff}}}\"{{{
3 cpmls \- list sorted contents of directory
4 .\"}}}
5 .SH SYNOPSIS \"{{{
6 .ad l
7 .B cpmls
8 .RB [ \-f
9 .IR format ]
10 .RB [ \-T
11 .IR libdsk-type ]
12 .RB [ \-d | \-D | \-F | \-A | \-l [ \-c ][ \-i ]]
13 .RB [ \-u ]
14 .I image
15 .RI [ file-pattern "...]"
16 .ad b
17 .\"}}}
18 .SH DESCRIPTION \"{{{
19 \fBCpmls\fP lists the sorted contents of the directory.
20 .\"}}}
21 .SH OPTIONS \"{{{
22 .IP "\fB\-f\fP \fIformat\fP"
23 Use the given CP/M disk \fIformat\fP instead of the default format.
24 .IP "\fB\-T\fP \fIlibdsk-type\fP"
25 libdsk driver type, e.g. \fBtele\fP for Teledisk images or \fBraw\fP for raw images
26 (requires building cpmtools with support for libdsk).
27 .IP \fB\-d\fP
28 Old CP/M 2.2 dir output.
29 .IP \fB\-D\fP
30 P2DOS 2.3 ddir-like output.
31 .IP \fB\-F\fp
32 CP/M 3.x dir output.
33 .IP \fB\-A\fp
34 E2fs lsattr-like output.
35 .IP \fB\-l\fP
36 Long UNIX-style directory listing including size, time stamp and user number.
37 .IP \fB\-c\fP
38 Output the creation time, not the modification time.
39 .IP \fB\-i\fP
40 Print index number of each file.
41 .IP "\fB\-u\fP"
42 Show all CP/M file names in upper case.
43 .\"}}}
44 .SH "RETURN VALUE" \"{{{
45 Upon successful completion, exit code 0 is returned.
46 .\"}}}
47 .SH ERRORS \"{{{
48 Any errors are indicated by exit code 1.
49 .\"}}}
50 .SH ENVIRONMENT \"{{{
51 CPMTOOLSFMT     Default format
52 .\"}}}
53 .SH FILES \"{{{
54 @DATADIR@/diskdefs      CP/M disk format definitions
55 .\"}}}
56 .SH AUTHORS \"{{{
57 This program is copyright 1997\(en2021 Michael Haardt
58 <michael@moria.de>.  The Windows port is copyright 2000, 2001, 2011 John Elliott
59 <jce@seasip.demon.co.uk>.
60 .PP
61 This program is free software; you can redistribute it and/or modify
62 it under the terms of the GNU General Public License as published by
63 the Free Software Foundation; either version 3 of the License, or
64 (at your option) any later version.
65 .PP
66 This program is distributed in the hope that it will be useful,
67 but WITHOUT ANY WARRANTY; without even the implied warranty of
68 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
69 GNU General Public License for more details.
70 .PP
71 You should have received a copy of the GNU General Public License along
72 with this program.  If not, write to the Free Software Foundation, Inc.,
73 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
74 .\"}}}
75 .SH "SEE ALSO" \"{{{
76 .IR cpmcp (1),
77 .IR cpm (5)
78 .\"}}}