Tuning docs about listing/showing kws and their docs

Author: pekkaklarck

README.rst

@@ -243,50 +243,24 @@ using ``stop`` argument on the command line or by using the
 ``stop_remote_server`` function programmatically. Testing and stopping should
 work also with other Robot Framework remote server implementations.
 
-Listing keywords and documentation available in server
-------------------------------------------------------
+Listing keywords and viewing documentation
+------------------------------------------
 
-Using the built-in Libdoc tool you can ``list`` the Keywords available in server::
+Using the built-in Libdoc__ tool you can list the keywords available on the server::
 
     $ python -m robot.libdoc Remote::http://127.0.0.1:8270 list 
     Count Items In Directory
     Stop Remote Server
     Strings Should Be Equal
 
-If you want to ``show`` the library/resource documentation use Libdoc like this::
+It is also possible to show the documentation on the command line by using
+argument ``show``. HTML documentation can be created by providing name of
+an output file::
 
-    $ python -m robot.libdoc Remote::http://127.0.0.1:8270 show
-    Remote
-    ======
-    Scope:            test suite
-    Named arguments:  supported
-    
-    Example library to be used with Robot Framework's remote server.
-    
-    This documentation is visible in docs generated by `Libdoc`.
-    
-    Count Items In Directory
-    ------------------------
-    Arguments:  [path]
-    
-    Returns the number of items in the directory specified by `path`.
-    
-    Stop Remote Server
-    ------------------
-    Arguments:  []
-    
-    Stop the remote server unless stopping is disabled.
-    
-    Return ``True/False`` depending was server stopped or not.
-    
-    Strings Should Be Equal
-    -----------------------
-    Arguments:  [str1, str2]
-    
-    
-For more information run `python -m robot.libdoc --help` and for even more
-details see the User Guide.
+    $ python -m robot.libdoc Remote::http://127.0.0.1:8270 MyLibrary.html
+    /path/to/MyLibrary.html
     
+__ http://robotframework.org/robotframework/#built-in-tools
 
 Example
 -------