Document the LIBGUESTFS_MEMSIZE environment variable.

[libguestfs.git] / guestfish.pod

diff --git a/guestfish.pod b/guestfish.pod
index 26312fe..974a903 100644 (file)
--- a/guestfish.pod
+++ b/guestfish.pod
@@ -319,19 +319,10 @@ If you prefix a command with a I<-> character, then that command will
 not cause guestfish to exit, even if that (one) command returns an
 error.
 
-=head1 COMMANDS
-
-=head2 help
-
- help
- help cmd
+=head1 GUESTFISH COMMANDS
 
-Without any parameter, this lists all commands.  With a C<cmd>
-parameter, this displays detailed help for a command.
-
-=head2 quit | exit
-
-This exits guestfish.  You can also use C<^D> key.
+The commands in this section are guestfish convenience commands, in
+other words, they are not part of the L<guestfs(3)> API.
 
 =head2 alloc | allocate
 
@@ -384,6 +375,23 @@ editors.
 NOTE: This will not work reliably for large files
 (> 2 MB) or binary files containing \0 bytes.
 
+=head2 glob
+
+ glob command args...
+
+Expand wildcards in any paths in the args list, and run C<command>
+repeatedly on each matching path.
+
+See section WILDCARDS AND GLOBBING.
+
+=head2 help
+
+ help
+ help cmd
+
+Without any parameter, this lists all commands.  With a C<cmd>
+parameter, this displays detailed help for a command.
+
 =head2 lcd
 
  lcd directory
@@ -393,14 +401,25 @@ itself.
 
 Note that C<!cd> won't do what you might expect.
 
-=head2 glob
+=head2 more | less
 
- glob command args...
+ more filename
 
-Expand wildcards in any paths in the args list, and run C<command>
-repeatedly on each matching path.
+ less filename
 
-See section WILDCARDS AND GLOBBING.
+This is used to view a file.
+
+The default viewer is C<$PAGER>.  However if you use the alternate
+command C<less> you will get the C<less> command specifically.
+
+NOTE: This will not work reliably for large files
+(> 2 MB) or binary files containing \0 bytes.
+
+=head2 quit | exit
+
+This exits guestfish.  You can also use C<^D> key.
+
+=head1 COMMANDS
 
 @ACTIONS@
 
@@ -428,6 +447,13 @@ used.
 
 Pass additional options to the guest kernel.
 
+=item LIBGUESTFS_MEMSIZE
+
+Set the memory allocated to the qemu process, in megabytes.  For
+example:
+
+ LIBGUESTFS_MEMSIZE=700
+
 =item HOME
 
 If compiled with GNU readline support, then the command history