discuss@mandoc.bsd.lv
 help / color / mirror / Atom feed
From: Ingo Schwarze <schwarze@usta.de>
To: discuss@mdocml.bsd.lv
Cc: Thomas Klausner <wiz@NetBSD.org>, Nicolas Joly <njoly@NetBSD.org>
Subject: Re: Sx quoting and Header
Date: Mon, 27 Dec 2010 01:08:50 +0100	[thread overview]
Message-ID: <20101227000850.GN23914@iris.usta.de> (raw)
In-Reply-To: <20101225152204.GY21954@danbala.tuwien.ac.at>

Hi Thomas, hi Nicolas,

Thomas Klausner wrote on Sat, Dec 25, 2010 at 04:22:04PM +0100:

> 2. The header for man pages generated with mandoc doesn't have
> "NetBSD" in the center. Example:
> njoly@petaure [~]> nroff -mandoc /usr/share/man/man4/multicast.4 | head -n 1
> MULTICAST(4)            NetBSD Kernel Interfaces Manual           MULTICAST(4)
> njoly@petaure [~]> mandoc -Tascii /usr/share/man/man4/multicast.4 | head -n 1
> MULTICAST(4)               Kernel Interfaces Manual               MULTICAST(4)
> Not a biggy, but why not leave it as before? :)

The newest groff (1.20.1) puts "BSD" into that place, see the
following line in upstream groff-1.20.1/tmac/doc-common:

  .ds doc-volume-operating-system BSD

When porting groff-1.20.1 to OpenBSD, i had to apply this local patch
to groff:

  -.ds doc-volume-operating-system BSD
  +.ds doc-volume-operating-system OpenBSD

Judging from the line

  .ds doc-volume-operating-system FreeBSD

in

http://cvsweb.netbsd.org/bsdweb.cgi/src/gnu/usr.bin/groff/tmac/mdoc.local?rev=1.1

you basically did the same to NetBSD in 2003.

In mandoc, the way to do this adjustment is to locally customize
the file msec.in.  You can just prepend "NetBSD" to the relevant
strings in that file and commit to the NetBSD repository.
That file is specifically intended for operating system customization.

Yours,
  Ingo
--
 To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv

      parent reply	other threads:[~2010-12-27  0:08 UTC|newest]

Thread overview: 7+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2010-12-25 15:22 Thomas Klausner
2010-12-26 23:30 ` Ingo Schwarze
2010-12-27  0:04   ` Kristaps Dzonsons
2010-12-27  0:36     ` Ingo Schwarze
2010-12-27  8:39       ` Kristaps Dzonsons
     [not found]   ` <20101227132623.GA285025@medusa.sis.pasteur.fr>
2010-12-27 21:57     ` Ingo Schwarze
2010-12-27  0:08 ` Ingo Schwarze [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20101227000850.GN23914@iris.usta.de \
    --to=schwarze@usta.de \
    --cc=discuss@mdocml.bsd.lv \
    --cc=njoly@NetBSD.org \
    --cc=wiz@NetBSD.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).