path: root/contrib/groff/src/roff/nroff
diff options
authorMitchell Horne <mhorne@FreeBSD.org>2022-10-07 22:25:12 +0000
committerMitchell Horne <mhorne@FreeBSD.org>2022-10-07 22:26:41 +0000
commit34aac98e3511d90df9209204df6772935a2b7617 (patch)
tree483450112bcc6e76370f1a88090d348e963223d4 /contrib/groff/src/roff/nroff
parentaf390486010e8fc78c4d715e751cd1175d0752c7 (diff)
EVENTHANDLER(9): drop the list of event handlersHEADmain
Maintaining a comprehensive list of event handlers in this man page is a futile endeavor. It is entirely detached from the source code, and therefore requires that anyone adding/removing an event handler have prior knowledge of the list. Many do not, so it will naturally become stale (and is). This is demonstrated by the fact that there are currently 88 instances of EVENTHANDLER_DECLARE() in the source tree, but the list contains 66 items. Many of the descriptions do not offer much detail that could not be gleaned from the handler name alone. It is a more effective strategy to document the purpose/details of the event handler in a comment alongside its declaration. Reviewed by: markj MFC after: 1 week Sponsored by: The FreeBSD Foundation Differential Revision: https://reviews.freebsd.org/D36895
Diffstat (limited to 'contrib/groff/src/roff/nroff')
0 files changed, 0 insertions, 0 deletions