Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > gnu.groff.bug > #1888

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

Path csiph.com!goblin3!goblin1!goblin.stu.neva.ru!usenet.stanford.edu!not-for-mail
From Ingo Schwarze <INVALID.NOREPLY@gnu.org>
Newsgroups gnu.groff.bug
Subject [bug #58653] Please add back in the mdoc(7) manual
Date Thu, 25 Jun 2020 15:08:08 -0400 (EDT)
Lines 41
Approved bug-groff@gnu.org
Message-ID <mailman.441.1593112089.2574.bug-groff@gnu.org> (permalink)
References <20200624-221331.sv200595.64640@savannah.gnu.org> <20200624-225141.sv97361.96482@savannah.gnu.org> <20200625-071246.sv200595.41215@savannah.gnu.org> <20200625-114948.sv97361.64018@savannah.gnu.org> <20200625-152422.sv200595.61706@savannah.gnu.org> <20200625-175106.sv97361.55505@savannah.gnu.org> <20200625-183547.sv200595.90095@savannah.gnu.org> <20200625-190808.sv97361.29894@savannah.gnu.org>
NNTP-Posting-Host lists.gnu.org
Mime-Version 1.0
Content-Type text/plain;charset=UTF-8
X-Trace usenet.stanford.edu 1593112089 2922 209.51.188.17 (25 Jun 2020 19:08:09 GMT)
X-Complaints-To action@cs.stanford.edu
To Ingo Schwarze <schwarze@usta.de>, <savannah.gnu.org@wongs.net>, bug-groff@gnu.org
Envelope-to bug-groff@gnu.org
X-PHP-Originating-Script 1001:sendmail.php
X-Savane-Server savannah.gnu.org:443 [209.51.188.72]
X-Savane-Project groff
X-Savane-Tracker bugs
X-Savane-Item-ID 58653
User-Agent Mozilla/5.0 (X11; OpenBSD amd64; rv:77.0) Gecko/20100101 Firefox/77.0
X-Apparently-From 87.173.117.25 (Savane authenticated user schwarze)
In-Reply-To <20200625-183547.sv200595.90095@savannah.gnu.org>
X-BeenThere bug-groff@gnu.org
X-Mailman-Version 2.1.23
Precedence list
List-Id "Bug reports for the GNU version of nroff, troff et al" <bug-groff.gnu.org>
List-Unsubscribe <https://lists.gnu.org/mailman/options/bug-groff>, <mailto:bug-groff-request@gnu.org?subject=unsubscribe>
List-Archive <https://lists.gnu.org/archive/html/bug-groff>
List-Post <mailto:bug-groff@gnu.org>
List-Help <mailto:bug-groff-request@gnu.org?subject=help>
List-Subscribe <https://lists.gnu.org/mailman/listinfo/bug-groff>, <mailto:bug-groff-request@gnu.org?subject=subscribe>
X-Mailman-Original-Message-ID <20200625-190808.sv97361.29894@savannah.gnu.org>
X-Mailman-Original-References <20200624-221331.sv200595.64640@savannah.gnu.org> <20200624-225141.sv97361.96482@savannah.gnu.org> <20200625-071246.sv200595.41215@savannah.gnu.org> <20200625-114948.sv97361.64018@savannah.gnu.org> <20200625-152422.sv200595.61706@savannah.gnu.org> <20200625-175106.sv97361.55505@savannah.gnu.org> <20200625-183547.sv200595.90095@savannah.gnu.org>
Xref csiph.com gnu.groff.bug:1888

Show key headers only | View raw


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/

Back to gnu.groff.bug | Previous | Next | Find similar | Unroll thread


Thread

[bug #58653] Please add back in the mdoc(7) manual Ingo Schwarze <INVALID.NOREPLY@gnu.org> - 2020-06-25 15:08 -0400

csiph-web