curl / Mailing Lists / curl-library / Single Mail


Re: Combining related man pages

From: Philip Prindeville <>
Date: Sun, 29 Apr 2018 13:26:50 -0600

> On Apr 23, 2018, at 3:20 PM, Daniel Stenberg <> wrote:
> On Mon, 23 Apr 2018, Philip Prindeville wrote:
>> I was just looking at the contents of docs/libcurl/opts as I work on PR #2495, and was wondering why options like CURLINFO_FILETIME and CURLINFO_FILETIME_T don’t share the same page, since they’re just different versions of the same thing?
> There are a few reasons:
> 1. I find it clearer and more straight-forward to only document a single function on that single page. Clearer for the reader that is.
> 2. It was very easy to do.
> 3. Our infrastrcture on the web site (that generates the contents) and tests etc presume this one to one mapping in several places, so it has also been a matter of going with the least resistance or least amount of extra work.
> None of them are very strong or says we can't change how things are going forward.

Got it done.

Should I add cross-references “SEE ALSO” to the man pages?

Otherwise, the PR should be ready to go…


Received on 2018-04-29