Bug 192251

Summary: Several section 9 manpages incorrectly reference evh not evhand when describing struct moduledata_t
Product: Documentation Reporter: Enji Cooper <ngie>
Component: Books & ArticlesAssignee: Enji Cooper <ngie>
Status: Closed Not A Bug    
Severity: Affects Some People    
Priority: ---    
Version: Latest   
Hardware: Any   
OS: Any   

Description Enji Cooper freebsd_committer freebsd_triage 2014-07-29 19:53:14 UTC
A number of manpages reference the evh member of moduledata_t, but the field in the structure has been evhand since its initial introduction in r25537 (see http://svnweb.freebsd.org/base/head/sys/sys/module.h?view=markup&pathrev=25537 ). The references should be fixed to state evhand so that the structure could be initialized in a C99+ way with the right parameters.

$ grep -r evh /usr/src/share/man/ | sed -e 's,/usr/src/share/man/,,'
man9/DEV_MODULE.9:.Fn DEV_MODULE "name" "modeventhand_t evh" "void *arg"
man9/DEV_MODULE.9:.Fa evh
man9/DRIVER_MODULE.9:.Fn DRIVER_MODULE name busname "driver_t driver" "devclass_t devclass" "modeventhand_t evh" "void *arg"
man9/DRIVER_MODULE.9:.Fn DRIVER_MODULE_ORDERED name busname "driver_t driver" "devclass_t devclass" "modeventhand_t evh" "void *arg" "int order"
man9/DRIVER_MODULE.9:.Fn EARLY_DRIVER_MODULE name busname "driver_t driver" "devclass_t devclass" "modeventhand_t evh" "void *arg" "enum sysinit_elem_order order" "int pass"
man9/DRIVER_MODULE.9:.Fn EARLY_DRIVER_MODULE_ORDERED name busname "driver_t driver" "devclass_t devclass" "modeventhand_t evh" "void *arg" "enum sysinit_elem_order order" "int pass"
man9/DRIVER_MODULE.9:.Fa evh
man9/SYSCALL_MODULE.9:.Fn SYSCALL_MODULE name "int *offset" "struct sysent *new_sysent" "modeventhand_t evh" "void *arg"
man9/SYSCALL_MODULE.9:.It Fa evh
man9/SYSCALL_MODULE.9:.Fa evh
Comment 1 Enji Cooper freebsd_committer freebsd_triage 2015-02-05 11:10:07 UTC
I did some more poking around and while my original claim is correct, the items documented are actually macros that use evh instead of evhand in the macro parameters. So while it's confusing, it's not actually a bug...

Closing.