• Breno Leitao's avatar
    Documentation: Document each netlink family · f061c9f7
    Breno Leitao authored
    
    
    This is a simple script that parses the Netlink YAML spec files
    (Documentation/netlink/specs/), and generates RST files to be rendered
    in the Network -> Netlink Specification documentation page.
    
    Create a python script that is invoked during 'make htmldocs', reads the
    YAML specs input file and generate the correspondent RST file.
    
    Create a new Documentation/networking/netlink_spec index page, and
    reference each Netlink RST file that was processed above in this main
    index.rst file.
    
    In case of any exception during the parsing, dump the error and skip
    the file.
    
    Do not regenerate the RST files if the input files (YAML) were not
    changed in-between invocations.
    Suggested-by: default avatarJakub Kicinski <kuba@kernel.org>
    Signed-off-by: default avatarBreno Leitao <leitao@debian.org>
    
    ----
    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...
    f061c9f7
ynl-gen-rst.py 11.2 KB