On Mon, 16 Jun 2014, Dan Fandrich wrote:

Since the new format encourages more verbosity, I suggest adding a RETURN VALUE section, which will be mind-numbingly repetitive for most options, but should subtly encourage people to actually check the return value. Also, a DEFAULT VALUE section may make sense as well, since these are all options and will all have a default value of some sort.

A good idea - added now. I've also created a 'template.3' file now for creating new option man pages to make sure most fields get added at once.

At some point, a filecheck: makefile target would make sense to verify that all options have a man page.

I like that idea too!

--

 / daniel.haxx.se
-------------------------------------------------------------------
List admin: http://cool.haxx.se/list/listinfo/curl-library
Etiquette:  http://curl.haxx.se/mail/etiquette.html

Reply via email to