From: "J. Lewis Muir" <jlmuir@imca-cat.org>
To: tech@mandoc.bsd.lv
Subject: mdoc(7) for technical docs beyond man pages?
Date: Thu, 27 Oct 2022 20:44:09 -0500 [thread overview]
Message-ID: <20221028014409.uivgey3ghktcmsez@mail.imca-cat.org> (raw)
Hello!
(I tried subscribing to the discuss@ mailing list twice over the past
few weeks thinking that it would be the better place to post this
message, but I was never approved by the gatekeepers, so posting here
instead.)
Is mdoc(7) intended for all technical documentation, or just man pages?
I came across the article "docbook2mdoc-1.0.0 released" from 2019
https://undeadly.org/cgi?action=article&sid=20190419101505
and was surprised to read this paragraph:
DocBook intends to provide authors of technical documentation, in
particular about computer software, with a system of semantic markup.
So far, that's an excellent idea. It's exactly the same goal which
the mdoc(7) language pursues, too.
Up until now, I had thought that mdoc(7) was intended for man pages
only, but the above article seems to suggest not. For example, would
it be within the intended purpose to write large technical documents in
mdoc(7) such as the NetBSD Guide
https://netbsd.org/docs/guide/en/index.html
the PostgreSQL Documentation
https://www.postgresql.org/docs/current/index.html
(both of which are written in DocBook), or Practical UNIX Manuals: mdoc
https://manpages.bsd.lv/mdoc.html
(which is written in HTML)? If so, are there tools for generating such
documentation from mdoc(7)?
Thank you!
Lewis
--
To unsubscribe send an email to tech+unsubscribe@mandoc.bsd.lv
reply other threads:[~2022-10-28 1:44 UTC|newest]
Thread overview: [no followups] expand[flat|nested] mbox.gz Atom feed
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=20221028014409.uivgey3ghktcmsez@mail.imca-cat.org \
--to=jlmuir@imca-cat.org \
--cc=tech@mandoc.bsd.lv \
/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).