Ulf Magnusson 91384ef01e scripts: genrest: Support splitting symbol documentation up by path ... Add a --modules flag to genrest.py for generating separate index pages for symbols defined within certain paths. Passing --modules Shell🐚subsys/shell Storage:storage:subsys/storage will generate these index pages, instead of a single index.rst file: - index-shell.rst: Lists the symbols defined in subsys/shell - index-storage.rst: Lists the symbols defined in subsys/storage - index-main.rst: Lists all symbols that are not in subsys/shell or subsys/storage - index-all.rst: Lists all symbols - index.rst: Contains links to the other index pages The string before the first ':' ('Shell' and 'Storage' above) is used when generating the title of the index page. 'Shell' gives 'Shell Configuration Options', for example. The title for index-main.rst can be set by passing '--non-module-title <title>'. It defaults to "Zephyr". By default, paths in symbol information pages that are within modules are shown as '<title>/<path relative to module>'. This can be disabled by passing --keep-module-paths. --keep-module-paths would make sense for the example above, but stripping the path to the module is nice when dealing with modules defined outside the Zephyr repository. If a symbol is defined in multiple modules (or both in a module and outside all modules), it will appear on multiple index pages. This commit also simplifies how genrest.py is called a bit, making the Kconfig filename optional (default: Kconfig). Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>		2019-10-10 15:36:11 +02:00
..
extract_content.py
fix_tex.py
genrest.py	scripts: genrest: Support splitting symbol documentation up by path	2019-10-10 15:36:11 +02:00
restore_modification_times.py