kqueue(9): add EXAMPLES section

[meka_tilda.center]

Summary

While researching kernel side of kqueue, I had hard time figuring out what needs to be done to add support for kqueue, so I wrote down info I figured while reading cuse implementation of kqueue and trying to add kqueue to sound(4).

[ziaee]

This is awesome! Initial thoughts, my laptops broken X.X

share/man/man9/kqueue.9

421

You don't need an initial Pp

423

New sentences have to start on a new line

[meka_tilda.center]

New sentences on new lines

[kib]

This text does not fit the concise and reference style of usual man pages.

I suggest you to instead either convert it to the article in the doc/ repository, or (the location I prefer) to a section in the developers handbook. It really fits there, and probably would be worth expanding to give complete driver module.

[christos]

In D53244#1217992, @kib wrote:

This text does not fit the concise and reference style of usual man pages.

I suggest you to instead either convert it to the article in the doc/ repository, or (the location I prefer) to a section in the developers handbook. It really fits there, and probably would be worth expanding to give complete driver module.

Seconding this.

[markj]

In D53244#1217992, @kib wrote:

This text does not fit the concise and reference style of usual man pages.

I suggest you to instead either convert it to the article in the doc/ repository, or (the location I prefer) to a section in the developers handbook. It really fits there, and probably would be worth expanding to give complete driver module.

A complementary option would be to add a complete example kernel module to share/examples/kld. The man page can point to it.