Re: Redux: linking in mdoc(7)?

[Kristaps Dzonsons <kristaps@bsd.lv>]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512

Folks,

Let's please focus on mdoc(7) and mandoc(1).  I'm only interested in
groff(1) insofar as it's able to cope easily with any mdoc(7) additions.

- From what I understand from mdocmx(7), `Mx' is an indexer.  This
sounds relevant for a text processor, but indexes aren't part of the
manpage tradition.  I don't see what problem `Mx' solves--I don't know
of any manpages having or in need of an index.  Most importantly,
here's no mandoc(1) `Mx' patch.  So not only do I not understand the
problem that's being solved, I don't know how you plan on solving it
with mandoc(1).

`Ix' exists for a concrete reason: allowing mdoc(7) to be compatible
with the existing (and many) Texinfo and DocBook documents, both of
which allow and use intra-document linking.  `Ix' implements these
constructs using the mechanism already in place in mdoc(7): `Sx'.  (I
added an `Lkx' to allow `Sx' to arbitrary names.  It should probably
have another name.)

The `Ix' concept benefits mdoc(7) a lot: with it and texinfo2mdoc(1),
real, existing, and useful manuals can be remapped into mdoc(7).
Think GSL, CVS, GCC, GMP, etc.  Not in theory, and not after a
monumental patch.  The patch exists, texinfo2mdoc(1) can do the work
already.  (docbook2mdoc(1) needs to be patched...)

I'm yet to hear anybody nay-say the idea or the implementation: I just
don't have a tmac patch that disregards the `Ix' for groff(1) to float
by the groff list.

Best,

Kristaps
-----BEGIN PGP SIGNATURE-----
Comment: GPGTools - https://gpgtools.org

iQIcBAEBCgAGBQJVQrWPAAoJEMT2SUY9XBESLGIQALST5vOpQMhbvsOK+jiYlq2s
EilHGxzXpyeL1EuaSSdH8ZvXJW2FivVaAYYvh3/J9VJCFRCaEOXO+oiIM5aygLur
evSvCPGrzeHsB1Tz0Yui7sp0O9MGQTFrPzxvvX4c64P1dx2mNrawN2iOUWYrNKk2
omklYG4YJUCIuTQFRDjG1ASOGcMWkleFj7VHjH4dWCOEfwV22BzQ6C3UR3BwSTXG
j8DpOKjO6jEvPxDpThAgRx+bnvMdF8uKK3CVKNBqyRqUUHTNuc68bMqYDIYsah96
5FGpS7uuQ02W0rjSkFhgMOazJO1Z/T8Y7Tj1obbb103+G+Bo/iOjkhXPYp/DH+Zj
1Czjfu7D5q7XrADQFB9GJEp8CHMMyMj+4RXCJOxJqoiAkfsZsTc//NDvdBX2fk3e
dn4jAAV5bts3HFTrYpXtOFdb4TgFteNiXgrCy1GJEtHwmcWIMZTvejP9uyZ2F21w
//8ofWulCNZKGJLS6PLpazqF+G8MhmYJoGL16v6EObzMQMjDXU1t85sjTVU1PTAN
Q2pK/8r+gGMmaSLkUQ4lJPgvxbHRuVY4VktsPFBwfzEVFRRsNZjfCXbkDDGw/xD2
mXT46nXmlPYJ8i0RK3bVrUXKMHIOmpVvKG5JnU7lhwVLAIVGw0fRGLnU3gzKEOd/
xQoHr/iWUX8/Sb2Vf+a5
=xkx5
-----END PGP SIGNATURE-----
--
 To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv