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


Groups > linux.debian.bugs.dist > #1301418

Bug#1134776: Bug #1134776: groff-base: IP mark can directly abut paragraph text in groff 1.24+, breaking several man pages

From Russ Allbery <rra@debian.org>
Newsgroups linux.debian.bugs.dist
Subject Bug#1134776: Bug #1134776: groff-base: IP mark can directly abut paragraph text in groff 1.24+, breaking several man pages
Date 2026-07-11 18:20 +0200
Message-ID <NfIAN-482l-3@gated-at.bofh.it> (permalink)
References (3 earlier) <NeZ0Z-3J02-9@gated-at.bofh.it> <Nf5zr-3Mwg-3@gated-at.bofh.it> <Nfe9H-3RoQ-3@gated-at.bofh.it> <MNeVP-hwLg-5@gated-at.bofh.it> <Nfe9H-3RoQ-3@gated-at.bofh.it>
Organization The Eyrie

Show all headers | View raw


"G. Branden Robinson" <g.branden.robinson@gmail.com> writes:

> Schematically:

> IP
> +-- ordered/enumerated list item (HTML: <OL><LI>)
> +-- unordered/marked list item (HTML: <UL><LI>)

> TP
> +-- definition list item (HTML: <DL><LI>)

[citation needed]

I have not seen any indication that the difference between .TP and .IP has
any semantic meaning in the documentation that I have previously reason.
It's of course possible that I have missed something along the way.

pod2man has used .IP exclusively since Tom Christansen's original version
in the 1990s, so the corpus of man pages that a semantic change to .IP
will break is not small.

> On the bright side, I know of no man(7) generator that is so militant,
> so, with a _little_ adaptation on their part, we can more strongly
> semantically distinguish the purposes of `IP` and `TP`, and potentially
> reap rich rewards in improving the searchability and navigability of
> man(7) documents.

I appreciate why you want to do this, but I'm not particularly enthused
about helping. It seems like a hack. I have been headed in the opposite
direction in general in pod2man from hard-won experience: removing
attempts to guess at the user's meaning by imposing semantics where there
were no semantics in the original input, and accepting the limitations of
the input method.

-- 
Russ Allbery (rra@debian.org)              <https://www.eyrie.org/~eagle/>

Back to linux.debian.bugs.dist | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread


Thread

Bug#1134776: Bug #1134776: groff-base: IP mark can directly abut paragraph text in groff 1.24+, breaking several man pages "G. Branden Robinson" <g.branden.robinson@gmail.com> - 2026-07-09 17:40 +0200
  Bug#1134776: Bug #1134776: groff-base: IP mark can directly abut paragraph text in groff 1.24+, breaking several man pages Guillem Jover <guillem@debian.org> - 2026-07-10 00:40 +0200
    Bug#1134776: Bug #1134776: groff-base: IP mark can directly abut paragraph text in groff 1.24+, breaking several man pages "G. Branden Robinson" <g.branden.robinson@gmail.com> - 2026-07-10 09:50 +0200
      Bug#1134776: Bug #1134776: groff-base: IP mark can directly abut paragraph text in groff 1.24+, breaking several man pages Russ Allbery <rra@debian.org> - 2026-07-11 18:20 +0200
  Bug#1134776: Bug #1134776: groff-base: IP mark can directly abut paragraph text in groff 1.24+, breaking several man pages Russ Allbery <rra@debian.org> - 2026-07-11 18:10 +0200
    Bug#1134776: Bug #1134776: groff-base: IP mark can directly abut paragraph text in groff 1.24+, breaking several man pages Russ Allbery <rra@debian.org> - 2026-07-12 05:20 +0200
      Bug#1134776: Bug #1134776: groff-base: IP mark can directly abut paragraph text in groff 1.24+, breaking several man pages Russ Allbery <eagle@eyrie.org> - 2026-07-12 21:20 +0200
        Bug#1134776: Bug #1134776: groff-base: IP mark can directly abut paragraph text in groff 1.24+, breaking several man pages "G. Branden Robinson" <g.branden.robinson@gmail.com> - 2026-07-12 22:30 +0200
          Bug#1134776: Bug #1134776: groff-base: IP mark can directly abut paragraph text in groff 1.24+, breaking several man pages Russ Allbery <eagle@eyrie.org> - 2026-07-13 01:20 +0200
            Bug#1134776: Bug #1134776: groff-base: IP mark can directly abut paragraph text in groff 1.24+, breaking several man pages "G. Branden Robinson" <g.branden.robinson@gmail.com> - 2026-07-13 13:10 +0200
              Bug#1134776: Bug #1134776: groff-base: IP mark can directly abut paragraph text in groff 1.24+, breaking several man pages Russ Allbery <eagle@eyrie.org> - 2026-07-14 04:50 +0200
                Bug#1134776: Bug #1134776: groff-base: IP mark can directly abut paragraph text in groff 1.24+, breaking several man pages "G. Branden Robinson" <g.branden.robinson@gmail.com> - 2026-07-18 14:50 +0200
        Bug#1134776: Bug #1134776: groff-base: IP mark can directly abut paragraph text in groff 1.24+, breaking several man pages Guillem Jover <guillem@debian.org> - 2026-07-13 04:30 +0200
          Bug#1134776: groff-base: IP mark can directly abut paragraph text in groff 1.24+, breaking several man pages Russ Allbery <eagle@eyrie.org> - 2026-07-20 06:50 +0200

csiph-web