From 3c4271b14f74d6096d620575a62cfb6fb83a824b Mon Sep 17 00:00:00 2001 From: Christian Vogelgsang Date: Sat, 2 Mar 2024 19:45:51 +0100 Subject: [PATCH] xdftool: added docs for 'add' option in read/write --- docs/tools/xdftool.rst | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/docs/tools/xdftool.rst b/docs/tools/xdftool.rst index ff04cc09..d71f3e6f 100644 --- a/docs/tools/xdftool.rst +++ b/docs/tools/xdftool.rst @@ -122,7 +122,7 @@ Example:: :: - read [sys_path] + read [] [add] If ```` is a file then the file contents will be read and copied to your hosts file system. If no ```` is given then the Amiga file will @@ -138,6 +138,11 @@ in host's current directory. If ```` is available then the directory will be created in this path. Otherwise the directory will be named as ````. +If the ``add`` option is set and both the input and output parameters are +directories then the contents of the source directory is directly added to +the target directory. Otherwise the source directory is first created below +the target directory. + Example:: > xdftool wb310.adf read c/dir ; copy file 'dir' to host's current dir @@ -146,6 +151,7 @@ Example:: > xdftool wb310.adf read devs ; copy 'devs' dir tree to current dir > xdftool wb310.adf read devs . ; same command > xdftool wb310.adf read devs b ; copy dir tree 'devs' to host dir 'b' + > xdftool wb310.add read c b add ; copy the contents of 'c' also to 'b' dir ``blkdev`` - Show information on the underlying block device @@ -331,7 +337,7 @@ Example:: :: - write [ami_path] + write [] [add] If the given ```` is a file then the contents of the file will be read and stored with the same name in the top-level directory of the image's @@ -344,6 +350,11 @@ contained files will be transferred to the image. If ```` is given and a directory then the host directory will be created there. Otherise the host directory will be renamed to the given name. +If the ``add`` option is set and both the input and output parameters are +directories then the contents of the source directory is directly added to +the target directory. Otherwise the source directory is first created below +the target directory. + Example:: > xdftool empty.adf write README ; the host file 'README' is written to @@ -352,6 +363,8 @@ Example:: > xdftool empty.adf write README c ; write to 'c' directory (if exists) ; or rename to file 'c' > xdftool empty.adf write mydir ; the host directory 'mydir' is written + > xdftool empty.adf write dir1 d ; write 'dir1' as 'd' to image + > xdftool empty.adf write dir2 d add ; add contents of 'dir2' to existing 'd' ``delete`` - Delete a file or directory