X-Git-Url: http://git.annexia.org/?a=blobdiff_plain;f=fish%2Fguestfish.pod;h=d24567240512e3131dd410795cb7ae50d5d6eb4c;hb=d8140d5689e49d926e5e1a53ec685088dec19a6d;hp=77bf0ca31af8bbdd22d7d1906f575c65f74729e0;hpb=87fb6d852db04d0d707e6587d4579d1cf2bd05ef;p=libguestfs.git diff --git a/fish/guestfish.pod b/fish/guestfish.pod index 77bf0ca..d245672 100644 --- a/fish/guestfish.pod +++ b/fish/guestfish.pod @@ -482,7 +482,7 @@ write. To open a disk image read-only you have to do I<-a image --ro>. This matters: If you accidentally open a live VM disk image writable then you will cause irreversible disk corruption. -By libguestfs 1.12 we intend to change the default the other way. +In a future libguestfs we intend to change the default the other way. Disk images will be opened read-only. You will have to either specify I, I, I, or change the configuration file C in order to get @@ -518,6 +518,64 @@ must be escaped with a backslash. command "/bin/echo 'foo bar'" command "/bin/echo \'foo\'" +=head2 ESCAPE SEQUENCES IN DOUBLE QUOTED ARGUMENTS + +In double-quoted arguments (only) use backslash to insert special +characters: + +=over 4 + +=item C<\a> + +Alert (bell) character. + +=item C<\b> + +Backspace character. + +=item C<\f> + +Form feed character. + +=item C<\n> + +Newline character. + +=item C<\r> + +Carriage return character. + +=item C<\t> + +Horizontal tab character. + +=item C<\v> + +Vertical tab character. + +=item C<\"> + +A literal double quote character. + +=item C<\ooo> + +A character with octal value I. There must be precisely 3 octal +digits (unlike C). + +=item C<\xhh> + +A character with hex value I. There must be precisely 2 hex +digits. + +In the current implementation C<\000> and C<\x00> cannot be used +in strings. + +=item C<\\> + +A literal backslash character. + +=back + =head1 OPTIONAL ARGUMENTS Some commands take optional arguments. These arguments appear in this @@ -1023,6 +1081,11 @@ guestfish returns 0 if the commands completed without error, or The C command uses C<$EDITOR> as the editor. If not set, it uses C. +=item GUESTFISH_DISPLAY_IMAGE + +The C command uses C<$GUESTFISH_DISPLAY_IMAGE> to +display images. If not set, it uses L. + =item GUESTFISH_PID Used with the I<--remote> option to specify the remote guestfish @@ -1169,6 +1232,7 @@ L, L, L, L, +L, L. =head1 AUTHORS