Am 16.11.2011 15:38, schrieb walter harms: > > > 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 >
read: but i guess the comment can be replaced with something more 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 >>>> \\.. >>>> . >> > >
