convert git-submodule doc to synopsis style

 * convert commands to synopsis style
 * use _<placeholder>_ for arguments
 * minor formatting fixes

Signed-off-by: Jean-Noël Avila <jn.avila@free.fr>

Author: jnavila