[kronosnet/kronosnet] 652e35: man: Tidy manpages (#215)

Branch: refs/heads/stable1-proposed Home: https://github.com/kronosnet/kronosnet Commit: 652e355252adf6d248123d564c607c338e899f98 https://github.com/kronosnet/kronosnet/commit/652e355252adf6d248123d564c607… Author: Chrissie Caulfield <ccaulfie(a)redhat.com> Date: 2019-04-30 (Tue, 30 Apr 2019) Changed paths: M libknet/libknet.h M libnozzle/libnozzle.h M man/doxyxml.c Log Message: ----------- man: Tidy manpages (#215) * man: Tidy manpages for libnozzle doxygen works in mysterious ways, adding a blank line before @brief makes the lines following that much tidier. So now instead of nozzle_close nozzle - pointer to the nozzle struct to destroy we get: nozzle_close nozzle - pointer to the nozzle struct to destroy * doxyxml: Cope with pointers-to-pointers passed as params Double pointers showed as ' * *name' when they should be ' **name'. Also tidy STRUCTURES display so that they are not indented too much, * man: Similar @brief fixes for libknet.h * doxyxml: Tidy descriptions of functions as parameters If a complex function pointer was passed as a parameter then doxyxml tryied to line up all the other parameters with it - making a mess by having lots of blank space between the type and the name. Now we enforce a maximum type length (a line-ish) so that shorter tyopes will line up OK and the really long ones will be left to their own devices. Commit: 4ff309b82bbd11300e761ecdcafde596115fc7f7 https://github.com/kronosnet/kronosnet/commit/4ff309b82bbd11300e761ecdcafde… Author: Christine Caulfield <ccaulfie(a)redhat.com> Date: 2019-04-30 (Tue, 30 Apr 2019) Changed paths: M libknet/libknet.h Log Message: ----------- man: Tidy more man pages Followup to previous 'tidy' Commit: 73e1b520482cef7ced995423aa3f6f53d16b66c4 https://github.com/kronosnet/kronosnet/commit/73e1b520482cef7ced995423aa3f6… Author: Fabio M. Di Nitto <fdinitto(a)redhat.com> Date: 2019-04-30 (Tue, 30 Apr 2019) Changed paths: M libknet/libknet.h Log Message: ----------- [man] fix knet_host_set_policy parameters order Signed-off-by: Fabio M. Di Nitto <fdinitto(a)redhat.com> Commit: 8b73fbca799114ed579acb73ce0bbcdf45b1f171 https://github.com/kronosnet/kronosnet/commit/8b73fbca799114ed579acb73ce0bb… Author: Fabio M. Di Nitto <fdinitto(a)redhat.com> Date: 2019-04-30 (Tue, 30 Apr 2019) Changed paths: M man/api-to-man-page-coverage Log Message: ----------- [tests] add man page check to verify doxy header order and definitions Signed-off-by: Fabio M. Di Nitto <fdinitto(a)redhat.com> Compare: https://github.com/kronosnet/kronosnet/compare/acb5adb7f3ea...8b73fbca7991