[pcre-dev] [Bug 1218] pcre manpages are missing "Last change…

Top Page

Reply to this message
Author: April Chin
Date:  
To: pcre-dev
Subject: [pcre-dev] [Bug 1218] pcre manpages are missing "Last change:" date
------- You are receiving this mail because: -------
You are on the CC list for the bug.

http://bugs.exim.org/show_bug.cgi?id=1218




--- Comment #2 from April Chin <april.chin@???> 2012-03-15 23:25:52 ---
On 3/15/2012 9:11 AM, Philip Hazel wrote:
> ------- You are receiving this mail because: -------
> You reported the bug.
>
> http://bugs.exim.org/show_bug.cgi?id=1218
>
>
>
>
> --- Comment #1 from Philip Hazel<ph10@???> 2012-03-15 16:11:08 ---
> On Wed, 14 Mar 2012, April Chin wrote:
>
>> For example, the pcre-config(1) manpage (in pcre 8.30) has this section
>>
>> REVISION
>>
>>       Last updated: 01 January 2012

>>
>> but its footer has an empty Last change date (manpage for pcre installed
>> on Solaris 11, aka SunOS 5.11):
>>
>> SunOS 5.11                Last change:                          2
> Is that a SunOS thing? On Gentoo Linux the footer contains just
> PCRE-CONFIG(1) at the right hand side.


Yes, it looks like the SunOS/Solaris man macros put
"SunOS 5.11" in the left side of the page footer.

I don't know how the page footers I see in Solaris differ from other OSs,
but I have seen other freeware manpages (perl, gmake, GNU gettext, git)
put a date in
the 3rd argument of the .TH line and also sometimes a name of the package
and version in the 4th argument.
>> The revision date should be added to the .TH line, which currently looks like:
>>
>> .TH PCRE-CONFIG 1
>>
>> along with perhaps the string "PCRE<version #>":
>>
>> .TH PCRE-CONFIG 1 "01 January 2012" "PCRE 8.30"
>>
>> so the page footers would then list the last change date and pcre version:
>>
>> PCRE 8.30         Last change: 01 January 2012                  2
> I will experiment on Linux and see if that works or breaks things or
> whatever.

Sounds good--thanks!

--April


--
Configure bugmail: http://bugs.exim.org/userprefs.cgi?tab=email