curl / Mailing Lists / curl-users / Single Mail

curl-users

Re: documenting command line options

From: Alex Bligh <alex_at_alex.org.uk>
Date: Mon, 14 Nov 2016 00:16:23 +0000

> On 13 Nov 2016, at 22:51, Daniel Stenberg <daniel_at_haxx.se> wrote:
>
> As I was mentioning before, I've been planning to provide a new way to write docs for the command line options and generate the main curl man page from this new method.

Interesting.

1. Out of interest, why is the suffix ".d" when that normally means "directory of things to be included"?

2. How do you get nroff type formatting in? e.g. in https://github.com/curl/curl/blob/master/docs/cmdline-opts/cookie.d how do you make it format '--cookie' in the text as an option rather than just plain text?

Other than that, seems like a great idea.

-- 
Alex Bligh
-------------------------------------------------------------------
List admin: https://cool.haxx.se/list/listinfo/curl-users
FAQ:        https://curl.haxx.se/docs/faq.html
Etiquette:  https://curl.haxx.se/mail/etiquette.html
Received on 2016-11-14