Am 16.11.2011 12:40, schrieb Ingo Schwarze:
> Hi Walter,
>
>> Basicly it seems ok for me, ntl some (non roff note).
>> * Sun Release 4.0 Why ?
>
> That's a comment, and my patch doesn't touch it.
> I guess whoever put it there wanted to provide an example
> how the fourth argument might look like.
>
jup sorry my bad,
but i guess the comment that be replaced with something meaningfull
>> The names differ from what i see in the man page.
>> e.g.: Sec 4 Special files
>
> Cannot reproduce; and indeed, tmac/doc-common in the official
> groff CVS repo has:
>
> .ds doc-volume-ds-4 Kernel Interfaces Manual
>
> Maybe "Special files" is specific to your operating system
> or even the particular page you are looking at (you mentioned
> neither unless i missed it).
>
>> Should that be in sync also ?
>
> As far as i can see, it is.
>
> Y
just for curiosity this is in my man page:
.....
0 Header files (usually found in /usr/include)
1 Executable programs or shell commands
2 System calls (functions provided by the kernel)
3 Library calls (functions within program libraries)
4 Special files (usually found in /dev)
5 File formats and conventions eg /etc/passwd
6 Games
7 Miscellaneous (including macro packages and conven-
tions), e.g. man(7), groff(7)
8 System administration commands (usually only for root)
9 Kernel routines [Non standard]
....
HISTORY
.....
31st March 2001 - present day: Colin Watson <cjwat...@debian.org> is
now developing and maintaining man-db.
re,
wh
> Ingo
>
>
>>> ----- Forwarded message from Ingo Schwarze <schwa...@usta.de> -----
>>>
>>> From: Ingo Schwarze <schwa...@usta.de>
>>> Date: Tue, 1 Nov 2011 19:43:27 +0100
>>> To: groff@gnu.org
>>> Subject: [Groff] let man print volume headers like mdoc
>>>
>>> Hi,
>>>
>>> When the mdoc(7) .Dt macro is called without a third argument,
>>> the page header uses the default volume name associated with
>>> the second (section number) .Dt argument, controlled by the
>>> doc-volume-ds-N strings in tmac/doc-common.
>>>
>>> On the other hand, when the corresponding man(7) .TH macro is
>>> called without a fifth argument, the volume name in the page
>>> header is left blank.
>>>
>>> Yuri Pankov (of IllumOS) suggested to make the two more similar
>>> by letting man(7) fill in the default volume name as well.
>>> I like the idea - reducing gratuitious differences between
>>> mdoc(7) and man(7) seems good to me - and would like to
>>> implement the change in mandoc(1).
>>>
>>> However, keeping groff(1) and mandoc(1) in sync is even more
>>> important than synching mdoc(7) and man(7), so i'm asking for
>>> your opinion first, whether you would accept the following patch,
>>> or a variant of it.
>>>
>>> I think the strings are so short that there is no problem
>>> with having them both in doc-common and an-old.tmac;
>>> on the other hand, if you disagree, i could move them to
>>> their own file and include them from both places, but
>>> i fear the code will be uglier, whereas this looks quite nice.
>>>
>>> Yours,
>>> Ingo
>>>
>>>
>>> --- tmac/an-old.tmac.orig Fri Dec 31 08:33:09 2010
>>> +++ tmac/an-old.tmac Sun Oct 30 22:37:29 2011
>>> @@ -145,7 +145,17 @@
>>> . ie (\\n[.$] > 3) .ds an-extra2 "\\$4\"
>>> . el .ds an-extra2 \"Sun Release 4.0
>>> . ie (\\n[.$] > 4) .ds an-extra3 "\\$5\"
>>> -. el .ds an-extra3 \"System Programmer's Manual
>>> +. el .ie '\\$2'1' .ds an-extra3 General Commands Manual
>>> +. el .ie '\\$2'2' .ds an-extra3 System Calls Manual
>>> +. el .ie '\\$2'3' .ds an-extra3 Library Functions Manual
>>> +. el .ie '\\$2'3p' .ds an-extra3 Perl Programmers Reference Guide
>>> +. el .ie '\\$2'4' .ds an-extra3 Kernel Interfaces Manual
>>> +. el .ie '\\$2'5' .ds an-extra3 File Formats Manual
>>> +. el .ie '\\$2'6' .ds an-extra3 Games Manual
>>> +. el .ie '\\$2'7' .ds an-extra3 Miscellaneous Information Manual
>>> +. el .ie '\\$2'8' .ds an-extra3 System Manager's Manual
>>> +. el .ie '\\$2'9' .ds an-extra3 Kernel Developer's Manual
>>> +. el .ds an-extra3
>>> . ds an-init
>>> \\..
>>> .
>
