Libguestfs - Feb 2018 - [PATCH] fish: add a small doc note about -- for args (RHBZ#1536603)

This will hint what to do when any argument of a command starts with a
dash.
---
 fish/guestfish.pod | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/fish/guestfish.pod b/fish/guestfish.pod
index ad98e975e..bbf43aad5 100644
--- a/fish/guestfish.pod
+++ b/fish/guestfish.pod
@@ -458,6 +458,13 @@ command that gives an error causes the whole shell to exit.
In
 interactive mode (with a prompt) if a command fails, you can continue
 to enter commands.
 
+Note that arguments of the commands will be considered as guestfish
+options if they start with a dash (C<->): you can always separate the
+guestfish options and the rest of the commands (with their arguments)
+using a double dash (C<-->).  For example:
+
+ guestfish -- disk_create overlay.qcow2 qcow2 -1 backingfile:image.img
+
 =head1 USING launch (OR run)
 
 As with L<guestfs(3)>, you must first configure your guest by adding
-- 
2.14.3

On Wed, Feb 07, 2018 at 05:34:50PM +0100, Pino Toscano
wrote:
> This will hint what to do when any argument of a command starts with a
> dash.
> ---
>  fish/guestfish.pod | 7 +++++++
>  1 file changed, 7 insertions(+)
> 
> diff --git a/fish/guestfish.pod b/fish/guestfish.pod
> index ad98e975e..bbf43aad5 100644
> --- a/fish/guestfish.pod
> +++ b/fish/guestfish.pod
> @@ -458,6 +458,13 @@ command that gives an error causes the whole shell to
exit.  In
>  interactive mode (with a prompt) if a command fails, you can continue
>  to enter commands.
>  
> +Note that arguments of the commands will be considered as guestfish
> +options if they start with a dash (C<->): you can always separate
the
> +guestfish options and the rest of the commands (with their arguments)
> +using a double dash (C<-->).  For example:
> +
> + guestfish -- disk_create overlay.qcow2 qcow2 -1 backingfile:image.img
> +
>  =head1 USING launch (OR run)
>  
>  As with L<guestfs(3)>, you must first configure your guest by adding
ACK.

Rich.

-- 
Richard Jones, Virtualization Group, Red Hat http://people.redhat.com/~rjones
Read my programming and virtualization blog: http://rwmj.wordpress.com
virt-top is 'top' for virtual machines.  Tiny program with many
powerful monitoring features, net stats, disk stats, logging, etc.
http://people.redhat.com/~rjones/virt-top