From: Richard W.M. Jones <rjones@redhat.com>
Date: Fri, 12 Aug 2011 10:08:57 +0000 (+0100)
Subject: fish: Document that remote run in cmd substitution context hangs.
X-Git-Tag: 1.10.8~3
X-Git-Url: http://git.annexia.org/?a=commitdiff_plain;h=7f35002e2301478b602e6d6c890508c25e153d71;p=libguestfs.git

fish: Document that remote run in cmd substitution context hangs.

This documents bug 592910.
(cherry picked from commit 6cabc1cd02e181063596b48df55c3f6db51a6bb9)
---

diff --git a/fish/guestfish.pod b/fish/guestfish.pod
index 94deb9c..21680c7 100644
--- a/fish/guestfish.pod
+++ b/fish/guestfish.pod
@@ -913,6 +913,17 @@ user ID of the process, and C<$PID> is the process ID of the server.
 
 Guestfish client and server versions must match exactly.
 
+=head2 REMOTE CONTROL RUN COMMAND HANGING
+
+Using the C<run> (or C<launch>) command remotely in a command
+substitution context hangs, ie. don't do (note the backquotes):
+
+ a=`guestfish --remote run`
+
+Since the C<run> command produces no output on stdout, this is not
+useful anyway.  For further information see
+L<https://bugzilla.redhat.com/show_bug.cgi?id=592910>.
+
 =head1 PREPARED DISK IMAGES
 
 Use the I<-N type> or I<--new type> parameter to select one of a set