groff: mdoc.local overrides for Debian GNU/Linux. Append to /etc/groff/mdoc.local

mdoc.local (snippet)

.\" -*-roff-*-

.\" The mdoc \&.Os macro is required to be specified for valid mdoc
.\" pages, but unless the componet being documented is truly specific
.\" to a single operating system, it is recommended that authors omit
.\" the optional argument. That allows for the substitution at render
.\" time for the system current in use.
.\"
.\" For GNU Groff, the values used come from the file:
.\"
.\"     /usr/share/groff/${VERSION}/tmac/mdoc/doc-common
.\"
.\" On Debian systems, that file is provided by the 'groff-base'
.\" package.
.\"
.\" The 'doc-volume-operating-system' string is rendered in the
.\" center heading at the top of the manpage.
.\"
.\" The 'doc-default-operating-system' string is rendered on both
.\" the left and right at the bottom of the manpage.
.\"
.\" In groff, both strings default to "BSD", which yields a heading
.\" that reads:
.\"
.\"     "BSD General Commands Manual"
.\"
.\" even though we are running on Debian GNU/Linux. Similar for the
.\" footer.
.\"
.\" See also:
.\"     * List:       openbsd-misc
.\"       Subject:    Re: mdoc(7) - .Os on other systems
.\"       From:       Ingo Schwarze <schwarze () usta ! de>
.\"       Date:       2014-06-21 18:12:22
.\"       Message-ID: 20140621181222.GB22939 () iris ! usta ! de
.\"       https://marc.info/?l=openbsd-misc&m=140337443904039&w=2
.\"
.\"     * Debian bug #284002: "Problems with the .Os macro in -mdoc"
.\"       https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=284002
.\"
.\"     * Debian bug #176575: "mdoc: .Dt ignores volume name"
.\"       https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=176575
.\"
.\" Yields .e.g, "Debian General Commands Manual"
.ds doc-volume-operating-system Debian
.\"
.\" Renders as-is in manpage footer, left and right sides.
.ds doc-default-operating-system Debian\~GNU/Linux