Commit 29fbe62e authored by Iustin Pop's avatar Iustin Pop

Convert man page highlighting to standard RST

Instead of using the sphinx-specific highlight extension, which is not
parsed by Pandoc, let's switch to the standard RST directive, which
will be picked up and will result in slightly nicer man pages when
converted to HTML (in man output it remains the same).

Note that I've converted only some of the examples (the one that
actually had shell scripts); the ones that show command lines
(e.g. starting with '#') I didn't convert, as they don't look nice
(and Pandoc/Kate highlighting doesn't have the equivalent of our
shell-example lexer we use in sphinx).
Signed-off-by: default avatarIustin Pop <iustin@google.com>
Reviewed-by: default avatarHelga Velroyen <helgav@google.com>
parent e1ff0de1
......@@ -86,11 +86,15 @@ The exist status of the command will be zero, unless it was aborted in some way
EXAMPLE
-------
Run a command on a list of hosts::
Run a command on a list of hosts:
.. code-block:: Bash
listrunner -l logdir -c "uname -a" -h host1,host2,host3
Upload a script, some auxiliary files and run the script::
Upload a script, some auxiliary files and run the script:
.. code-block:: Bash
listrunner -l logdir -x runme.sh \
-a seed.dat -a golden.dat \
......@@ -100,7 +104,7 @@ Upload a script, some auxiliary files and run the script::
SEE ALSO
--------
dsh(1), cssh(1)
**dsh**(1), **cssh**(1)
.. vim: set textwidth=72 :
.. Local Variables:
......
......@@ -223,10 +223,10 @@ Currently (API version 20), only one parameter is supported:
environment, and output diagnostic messages in case the validation
fails.
.. highlight:: sh
For the ``dhcp`` parameter given as example above, a verification
script could be::
script could be:
.. code-block:: Bash
#!/bin/sh
......@@ -340,7 +340,9 @@ Version 4 to 5
The rename script has been added. If you don't want to do any
changes on the instances after a rename, you can migrate the OS
definition to version 5 by creating the rename script simply as::
definition to version 5 by creating the rename script simply as:
.. code-block:: Bash
#!/bin/sh
......
......@@ -79,7 +79,9 @@ re-activated).
In some cases, it's even desirable to reset the watcher state, for
example after maintenance actions, or when you want to simulate the
reboot of all nodes, so in this case, you can remove all state files::
reboot of all nodes, so in this case, you can remove all state files:
.. code-block:: Bash
rm -f @LOCALSTATEDIR@/lib/ganeti/watcher.*.data
rm -f @LOCALSTATEDIR@/lib/ganeti/watcher.*.instance-status
......
......@@ -566,7 +566,9 @@ cpu\_mask
the colon-separated list _must_ equal the number of VCPUs of the
instance.
Example::
Example:
.. code-block:: Bash
# Map the entire instance to CPUs 0-2
gnt-instance modify -H cpu_mask=0-2 my-inst
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment