move to debhelper compat 13, hopefully fixes cross-building

[debian/cpmtools] / cpmcp.1

diff --git a/cpmcp.1 b/cpmcp.1
index 310f339c9f1cd11add8abf7aac71c776bc5cbd03..87d0eb74b0273ebe9b52235601b2b3e6986519d8 100644 (file)
--- a/cpmcp.1
+++ b/cpmcp.1
@@ -1,4 +1,4 @@
-.TH CPMCP 1 "March 30, 2010" "CP/M tools" "User commands"
+.TH CPMCP 1 "October 10, 2022" "CP/M tools" "User commands"
 .SH NAME \"{{{roff}}}\"{{{
 cpmcp \- copy files from and to CP/M disks
 .\"}}}
@@ -10,6 +10,7 @@ cpmcp \- copy files from and to CP/M disks
 .RB [ \-p ]
 .RB [ \-t ]
 .I image
+.RB [ \-u ]
 \fIuser\fP\fB:\fP\fIfile\fP \fIfile\fP
 .br
 .B cpmcp
@@ -18,6 +19,7 @@ cpmcp \- copy files from and to CP/M disks
 .RB [ \-p ]
 .RB [ \-t ]
 .I image
+.RB [ \-u ]
 \fIuser\fP\fB:\fP\fIfile\fP ... \fIdirectory\fP
 .br
 .B cpmcp
@@ -26,6 +28,7 @@ cpmcp \- copy files from and to CP/M disks
 .RB [ \-p ]
 .RB [ \-t ]
 .I image
+.RB [ \-u ]
 \fIfile\fP \fIuser\fP\fB:\fP\fIfile\fP
 .br
 .B cpmcp
@@ -34,6 +37,7 @@ cpmcp \- copy files from and to CP/M disks
 .RB [ \-p ]
 .RB [ \-t ]
 .I image
+.RB [ \-u ]
 \fIfile\fP ... \fIuser\fP\fB:\fP
 .ad b
 .\"}}}
@@ -48,15 +52,25 @@ You can use \fB*\fP and \fB?\fP in CP/M file names, which have the same
 meaning in
 .IR sh (1)
 file name patterns.
+.PP
+On CP/M, the slash is a legal file name character.  When copying such files
+to the host, it is translated to a comma.  Filenames with a comma have that
+translated back to a slash on CP/M.  That is no restriction, because a comma
+is not a legal CP/M filename character.
 .\"}}}
 .SH OPTIONS \"{{{
 .IP "\fB\-f\fP \fIformat\fP"
 Use the given CP/M disk \fIformat\fP instead of the default format.
+.IP "\fB\-T\fP \fIlibdsk-type\fP"
+libdsk driver type, e.g. \fBtele\fP for Teledisk images or \fBraw\fP for raw images 
+(requires building cpmtools with support for libdsk).
 .IP \fB\-p\fP
 Preserve time stamps when copying files from CP/M to UNIX (not
 implemented for copying the other way so far).
 .IP \fB\-t\fP
 Convert text files between CP/M and UNIX conventions.
+.IP "\fB\-u\fP"
+Show all CP/M file names in upper case.
 .\"}}}
 .SH "RETURN VALUE" \"{{{
 Upon successful completion, exit code 0 is returned.
@@ -64,12 +78,15 @@ Upon successful completion, exit code 0 is returned.
 .SH ERRORS \"{{{
 Any errors are indicated by exit code 1.
 .\"}}}
+.SH ENVIRONMENT \"{{{
+CPMTOOLSFMT     Default format
+.\"}}}
 .SH FILES \"{{{
 ${prefix}/share/diskdefs       CP/M disk format definitions
 .\"}}}
 .SH AUTHORS \"{{{
-This program is copyright 1997\(en2010 Michael Haardt
-<michael@moria.de>.  The Windows port is copyright 2000, 2001 John Elliott
+This program is copyright 1997\(en2021 Michael Haardt
+<michael@moria.de>.  The Windows port is copyright 2000, 2001, 2011 John Elliott
 <jce@seasip.demon.co.uk>.
 .PP
 This program is free software; you can redistribute it and/or modify