tools: ynl: move python code to separate sub-directoryMove python code to a separate directory so it can bepackaged as a python module. Updates existing referencesin selftests and docs.Also ren
tools: ynl: move python code to separate sub-directoryMove python code to a separate directory so it can bepackaged as a python module. Updates existing referencesin selftests and docs.Also rename ynl-gen-[c|rst] to ynl_gen_[c|rst], avoiddashes as these prevent easy imports for entrypoints.Signed-off-by: Jan Stancek <[email protected]>Reviewed-by: Donald Hunter <[email protected]>Link: https://patch.msgid.link/a4151bad0e6984e7164d395125ce87fd2e048bf1.1736343575.git.jstancek@redhat.comSigned-off-by: Jakub Kicinski <[email protected]>
show more ...
Documentation: Document each netlink familyThis is a simple script that parses the Netlink YAML spec files(Documentation/netlink/specs/), and generates RST files to be renderedin the Network -> N
Documentation: Document each netlink familyThis is a simple script that parses the Netlink YAML spec files(Documentation/netlink/specs/), and generates RST files to be renderedin the Network -> Netlink Specification documentation page.Create a python script that is invoked during 'make htmldocs', reads theYAML specs input file and generate the correspondent RST file.Create a new Documentation/networking/netlink_spec index page, andreference each Netlink RST file that was processed above in this mainindex.rst file.In case of any exception during the parsing, dump the error and skipthe file.Do not regenerate the RST files if the input files (YAML) were notchanged in-between invocations.Suggested-by: Jakub Kicinski <[email protected]>Signed-off-by: Breno Leitao <[email protected]>----Changelog:V3: * Do not regenerate the RST files if the input files were not changed. In order to do it, a few things changed: - Rely on Makefile more to find what changed, and trigger individual file processing - The script parses file by file now (instead of batches) - Create a new option to generate the index fileV2: * Moved the logic from a sphinx extension to a external script * Adjust some formatting as suggested by Donald Hunter and Jakub * Auto generating all the rsts instead of having stubs * Handling error gracefullyReviewed-by: Jakub Kicinski <[email protected]>Signed-off-by: David S. Miller <[email protected]>