[PATCH] Documentation: use command groups
Sascha Hauer
s.hauer at pengutronix.de
Mon Jul 14 01:42:57 PDT 2014
On Fri, Jul 11, 2014 at 08:51:58PM +0200, Jan Luebbe wrote:
> The help definition already contained a group declaration.
> This is now reused for the HTML documentation.
>
> Signed-off-by: Jan Luebbe <jlu at pengutronix.de>
Good idea! Applied, thanks
Sascha
> ---
> Documentation/commands.rst | 86 ++++++++++++++++++++++++++++++++++++++++++-
> Documentation/gen_commands.py | 13 ++++++-
> 2 files changed, 95 insertions(+), 4 deletions(-)
>
> diff --git a/Documentation/commands.rst b/Documentation/commands.rst
> index 55b04f6..0dc9e1b 100644
> --- a/Documentation/commands.rst
> +++ b/Documentation/commands.rst
> @@ -1,9 +1,91 @@
> Command reference
> =================
>
> +Information
> +-----------
> .. toctree::
> + :titlesonly:
> :glob:
> - :maxdepth: 1
>
> - commands/*
> + commands/info/*
> +
> +Booting
> +-------
> +.. toctree::
> + :titlesonly:
> + :glob:
> +
> + commands/boot/*
> +
> +Partitions and Filesystems
> +--------------------------
> +.. toctree::
> + :titlesonly:
> + :glob:
> +
> + commands/part/*
> +
> +Environment
> +-----------
> +.. toctree::
> + :titlesonly:
> + :glob:
> +
> + commands/env/*
> +
> +Files
> +-----
> +.. toctree::
> + :titlesonly:
> + :glob:
> +
> + commands/file/*
> +
> +Shell Scripting
> +---------------
> +.. toctree::
> + :titlesonly:
> + :glob:
> +
> + commands/script/*
> +
> +Console and Framebuffer
> +-----------------------
> +.. toctree::
> + :titlesonly:
> + :glob:
> +
> + commands/console/*
> +
> +Memory
> +------
> +.. toctree::
> + :titlesonly:
> + :glob:
> +
> + commands/mem/*
> +
> +Hardware Manipulation
> +---------------------
> +.. toctree::
> + :titlesonly:
> + :glob:
> +
> + commands/hwmanip/*
> +
> +Miscelleanous
> +-------------
> +.. toctree::
> + :titlesonly:
> + :glob:
> +
> + commands/misc/*
> +
> +Networking
> +----------
> +.. toctree::
> + :titlesonly:
> + :glob:
> +
> + commands/net/*
>
> diff --git a/Documentation/gen_commands.py b/Documentation/gen_commands.py
> index 4e33cca..d3db350 100755
> --- a/Documentation/gen_commands.py
> +++ b/Documentation/gen_commands.py
> @@ -1,5 +1,6 @@
> #!/usr/bin/python
>
> +import errno
> import os
> import re
> import sys
> @@ -76,7 +77,7 @@ def parse_c(name):
> x = CMD_GROUP.match(line)
> if x:
> last = cmd['c_group']
> - last.append(x.group(1).decode("string_escape"))
> + last.append(x.group(1).split('_')[-1].lower())
> continue
> x = CONT.match(line)
> if x:
> @@ -159,6 +160,14 @@ for name in CMDS.keys():
> for name, cmd in CMDS.items():
> #pprint({name: cmd})
> rst = gen_rst(name, cmd)
> - target = os.path.join(sys.argv[2], name+'.rst')
> + subdir = os.path.join(sys.argv[2], cmd['c_group'][0])
> + try:
> + os.makedirs(subdir)
> + except OSError as e:
> + if e.errno == errno.EEXIST and os.path.isdir(subdir):
> + pass
> + else:
> + raise
> + target = os.path.join(subdir, name+'.rst')
> file(target, 'w').write(rst)
>
> --
> 1.9.1
>
>
> _______________________________________________
> barebox mailing list
> barebox at lists.infradead.org
> http://lists.infradead.org/mailman/listinfo/barebox
>
--
Pengutronix e.K. | |
Industrial Linux Solutions | http://www.pengutronix.de/ |
Peiner Str. 6-8, 31137 Hildesheim, Germany | Phone: +49-5121-206917-0 |
Amtsgericht Hildesheim, HRA 2686 | Fax: +49-5121-206917-5555 |
More information about the barebox
mailing list