@@ -76,14 +76,17 @@ Set RUST_LOG environment variable to control logging level.
7676
7777Examples:
7878---------
79+ smart copy: `a2kit cp myimg.woz/program ./program.bas`
7980create DOS image: `a2kit mkdsk -o dos33 -v 254 -t woz2 -d myimg.woz`
8081create ProDOS image: `a2kit mkdsk -o prodos -v disk.new -t woz2 -d myimg.woz`
81- Language line entry: `a2kit verify -t atxt`
82- Language file check: `a2kit get -f myprog.bas | a2kit verify -t atxt`
83- Tokenize to file: `a2kit get -f prog.bas | a2kit tokenize -a 2049 -t atxt > prog.atok
84- Tokenize to image: `a2kit get -f prog.bas | a2kit tokenize -a 2049 -t atxt \\
82+ language line entry: `a2kit verify -t atxt`
83+ language file check: `a2kit get -f myprog.bas | a2kit verify -t atxt`
84+ detokenize from image: `a2kit get -f prog -t atok -d myimg.dsk | a2kit detokenize -t atok
85+ tokenize to file: `a2kit get -f prog.bas | a2kit tokenize -a 2049 -t atxt > prog.atok
86+ tokenize to image: `a2kit get -f prog.bas | a2kit tokenize -a 2049 -t atxt \\
8587 | a2kit put -f prog -t atok -d myimg.dsk`
86- Detokenize from image: `a2kit get -f prog -t atok -d myimg.dsk | a2kit detokenize -t atok" ;
88+ ...or smart copy: `a2kit cp -a 2049 prog.bas myimg.dsk" ;
89+
8790 let img_types = [
8891 "d13" , "do" , "po" , "woz1" , "woz2" , "imd" , "img" , "2mg" , "nib" , "td0" ,
8992 ] ;
@@ -151,8 +154,14 @@ Detokenize from image: `a2kit get -f prog -t atok -d myimg.dsk | a2kit detokeniz
151154
152155 main_cmd = main_cmd. subcommand (
153156 Command :: new ( "cp" )
154- . arg ( Arg :: new ( "paths" ) . num_args ( 2 ..=1000 ) . help ( "sequence of paths, last path is the destination" ) . value_name ( "PATHS" ) . required ( true ) )
155- . arg ( Arg :: new ( "addr" ) . long ( "addr" ) . short ( 'a' ) . help ( "load-address if applicable" ) . value_name ( "ADDRESS" ) . required ( false ) )
157+ . arg ( Arg :: new ( "paths" ) . num_args ( 2 ..=1000 ) . help ( "sequence of paths, last path is the destination" ) . value_name ( "PATHS" ) . required ( true )
158+ . long_help ( "Paths inside the disk image always use the forward slash.
159+ It is OK to have a mixture such as `c:\\ path\\ to\\ disk.img/path/to/file`.
160+ Recursive glob patterns like `disk.img/**` will expand correctly,
161+ but the files will all go to the same target directory." ) )
162+ . arg ( Arg :: new ( "addr" ) . long ( "addr" ) . short ( 'a' ) . help ( "load-address if applicable" ) . value_name ( "ADDRESS" ) . required ( false )
163+ . long_help ( "Specify the load address that is stored with some Apple file types.
164+ This is only needed for host-to-image copies involving Apple file systems" ) )
156165 . arg ( pro_arg ( ) )
157166 . arg ( method_arg ( ) )
158167 . about ( "smart copy that formats for the target" )
0 commit comments