bug-groff
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[bug #58653] Please add back in the mdoc(7) manual


From: Ingo Schwarze
Subject: [bug #58653] Please add back in the mdoc(7) manual
Date: Thu, 25 Jun 2020 15:08:08 -0400 (EDT)
User-agent: Mozilla/5.0 (X11; OpenBSD amd64; rv:77.0) Gecko/20100101 Firefox/77.0

Follow-up Comment #7, bug #58653 (project groff):

> I had thought you were linking to the mdoc documentation that comes with
BSD.

mandoc is portable software.  It is included and used by default in these
systems (chronological order by first official use): OpenBSD, NetBSD, Illumos,
Void Linux, FreeBSD, Alpine Linux.  Official packages exist for Debian,
Gentoo, and Fedora, among others; on Fedora, making it the default manual page
viewer is an officially supported option.  I just used the OpenBSD link out of
habit and because it's the most carefully maintained manual page server
carrying it.  These are quite similar:

  https://mandoc.bsd.lv/man/mdoc.7.html
  https://man.bsd.lv/mdoc.7
  https://manpages.debian.org/buster/mandoc/mandoc_mdoc.7.en.html
  https://man.voidlinux.org/man7/mdoc.7
  https://www.freebsd.org/cgi/man.cgi?query=mdoc

> I do think it is unfortunate that people who use groff
> on non-BSD systems are left poorer, without even
> a pointer to better documentation.

I wouldn't say either is absolutely better, it's mostly the same content in
somewhat different style.  But your idea of adding pointers to each other in
the SEE ALSO sections on both sides sounds good, so people can more easily
find both and pick one according to which style they prefer.  Let's see
whether i can get those two links in on both sides.


    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?58653>

_______________________________________________
  Message sent via Savannah
  https://savannah.gnu.org/




reply via email to

[Prev in Thread] Current Thread [Next in Thread]