Rudder

Add a simple syntax for options and agruments to have a complete man page.

# @argument node: node ip or hostname
# @argument [-s]: start the service

This is a bit unclear.
What is the goal of @argument and how will it be used ?

If this is only for documentation, isn't @man sufficient ?

That would allow to display the arguments on the same line:

   server
       commands for rudder server, run with rudder server command

       debug [--truc] <node>
           run a debug cf-serverd intended for a specific node. This command targets a specific node and does not affect the running infrastructure. It uses iptables to redirect the specific node communications to the port the debug server is listening on (5310 by default).

           Use Ctrl+C to stop the debug server.

           Arguments:
           node: node ip or address

But it is not that important, and using asciidoc syntax in the @man is enough for the list of arguments/options in the section.

Applied in changeset rudder-agent|fcf796633456ba8767f43041c3f2a313358b00ab.