git: c1c95add8c80 - main - Merge mandoc snapshot 2024-09-22

From: Brooks Davis <brooks_at_FreeBSD.org>
Date: Fri, 06 Dec 2024 20:59:16 UTC
The branch main has been updated by brooks:

URL: https://cgit.FreeBSD.org/src/commit/?id=c1c95add8c80843ba15d784f95c361d795b1f593

commit c1c95add8c80843ba15d784f95c361d795b1f593
Merge: 839fb85336a0 20de55b07cf9
Author:     Brooks Davis <brooks@FreeBSD.org>
AuthorDate: 2024-12-06 20:47:31 +0000
Commit:     Brooks Davis <brooks@FreeBSD.org>
CommitDate: 2024-12-06 20:47:31 +0000

    Merge mandoc snapshot 2024-09-22

 contrib/mandoc/LICENSE                 |   5 +-
 contrib/mandoc/Makefile                |  13 +-
 contrib/mandoc/Makefile.depend         |  89 ++--
 contrib/mandoc/NEWS                    |   4 +-
 contrib/mandoc/TODO                    | 105 +++-
 contrib/mandoc/catman.c                |   4 +-
 contrib/mandoc/cgi.c                   | 121 +++--
 contrib/mandoc/chars.c                 |   5 +-
 contrib/mandoc/compat_strsep.c         |   4 +-
 contrib/mandoc/configure               |  13 +-
 contrib/mandoc/configure.local.example |  14 +-
 contrib/mandoc/dba_read.c              |   4 +-
 contrib/mandoc/demandoc.1              |   5 +-
 contrib/mandoc/demandoc.c              |  13 +-
 contrib/mandoc/eqn.c                   |  28 +-
 contrib/mandoc/eqn_parse.h             |   6 +-
 contrib/mandoc/html.c                  |  17 +-
 contrib/mandoc/html.h                  |   6 +-
 contrib/mandoc/main.c                  |  43 +-
 contrib/mandoc/makewhatis.8            |   8 +-
 contrib/mandoc/man.1                   |   8 +-
 contrib/mandoc/man.7                   |  34 +-
 contrib/mandoc/man.c                   |  43 +-
 contrib/mandoc/man.cgi.8               |  14 +-
 contrib/mandoc/man_html.c              | 112 +++--
 contrib/mandoc/man_macro.c             |  24 +-
 contrib/mandoc/man_term.c              | 108 +++--
 contrib/mandoc/man_validate.c          |  68 +--
 contrib/mandoc/mandoc.1                | 206 +++++---
 contrib/mandoc/mandoc.c                | 394 +--------------
 contrib/mandoc/mandoc.css              |  51 +-
 contrib/mandoc/mandoc.h                |  32 +-
 contrib/mandoc/mandoc_aux.c            |   5 +-
 contrib/mandoc/mandoc_aux.h            |   8 +-
 contrib/mandoc/mandoc_char.7           |  21 +-
 contrib/mandoc/mandoc_dbg.c            | 343 +++++++++++++
 contrib/mandoc/mandoc_dbg.h            |  55 +++
 contrib/mandoc/mandoc_dbg_init.3       | 280 +++++++++++
 contrib/mandoc/mandoc_escape.3         | 172 ++++---
 contrib/mandoc/mandoc_headers.3        |  37 +-
 contrib/mandoc/mandoc_html.3           |   8 +-
 contrib/mandoc/mandoc_msg.c            |  13 +-
 contrib/mandoc/mandocd.8               |   8 +-
 contrib/mandoc/mandocd.c               |  15 +-
 contrib/mandoc/mandocdb.c              |  75 ++-
 contrib/mandoc/manpath.c               |  87 ++--
 contrib/mandoc/mansearch.c             |   6 +-
 contrib/mandoc/mdoc.7                  |  75 +--
 contrib/mandoc/mdoc_html.c             |  81 ++--
 contrib/mandoc/mdoc_macro.c            |  12 +-
 contrib/mandoc/mdoc_man.c              |   4 +-
 contrib/mandoc/mdoc_markdown.c         |   6 +-
 contrib/mandoc/mdoc_state.c            |  53 +-
 contrib/mandoc/mdoc_term.c             |  29 +-
 contrib/mandoc/mdoc_validate.c         |  16 +-
 contrib/mandoc/out.c                   |  39 +-
 contrib/mandoc/out.h                   |   7 +-
 contrib/mandoc/read.c                  |   9 +-
 contrib/mandoc/roff.7                  |  43 +-
 contrib/mandoc/roff.c                  | 858 +++++++++++++++++----------------
 contrib/mandoc/roff.h                  |  27 +-
 contrib/mandoc/roff_escape.c           | 546 +++++++++++++++++++++
 contrib/mandoc/roff_int.h              |   5 +-
 contrib/mandoc/roff_term.c             |   4 +-
 contrib/mandoc/st.c                    |   5 +-
 contrib/mandoc/tag.c                   |  74 ++-
 contrib/mandoc/tbl.7                   |  12 +-
 contrib/mandoc/tbl_html.c              |  15 +-
 contrib/mandoc/tbl_term.c              |  23 +-
 contrib/mandoc/term.c                  | 137 ++++--
 contrib/mandoc/term.h                  |   7 +-
 contrib/mandoc/term_ascii.c            |   9 +-
 contrib/mandoc/term_tab.c              |  24 +-
 contrib/mandoc/tree.c                  |  14 +-
 usr.bin/mandoc/Makefile                |   2 +
 75 files changed, 3215 insertions(+), 1655 deletions(-)

diff --cc contrib/mandoc/Makefile
index 48c4741812b6,000000000000..cd3f16652069
mode 100644,000000..100644
--- a/contrib/mandoc/Makefile
+++ b/contrib/mandoc/Makefile
@@@ -1,609 -1,0 +1,618 @@@
- # $Id: Makefile,v 1.540 2021/09/21 11:04:40 schwarze Exp $
++# $Id: Makefile,v 1.543 2023/10/19 11:45:42 schwarze Exp $
 +#
- # Copyright (c) 2011, 2013-2021 Ingo Schwarze <schwarze@openbsd.org>
++# Copyright (c) 2011, 2013-2022 Ingo Schwarze <schwarze@openbsd.org>
 +# Copyright (c) 2010, 2011, 2012 Kristaps Dzonsons <kristaps@bsd.lv>
 +#
 +# Permission to use, copy, modify, and distribute this software for any
 +# purpose with or without fee is hereby granted, provided that the above
 +# copyright notice and this permission notice appear in all copies.
 +#
 +# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 +# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 +# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
 +# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 +# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 +# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 +# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 +
 +VERSION = 1.14.6
 +
 +# === LIST OF FILES ====================================================
 +
 +TESTSRCS	 = test-attribute.c \
 +		   test-be32toh.c \
 +		   test-cmsg.c \
 +		   test-dirent-namlen.c \
 +		   test-EFTYPE.c \
 +		   test-err.c \
 +		   test-fts.c \
 +		   test-getline.c \
 +		   test-getsubopt.c \
 +		   test-isblank.c \
 +		   test-mkdtemp.c \
 +		   test-mkstemps.c \
 +		   test-nanosleep.c \
 +		   test-noop.c \
 +		   test-ntohl.c \
 +		   test-O_DIRECTORY.c \
 +		   test-ohash.c \
 +		   test-PATH_MAX.c \
 +		   test-pledge.c \
 +		   test-progname.c \
 +		   test-reallocarray.c \
 +		   test-recallocarray.c \
 +		   test-recvmsg.c \
 +		   test-rewb-bsd.c \
 +		   test-rewb-sysv.c \
 +		   test-sandbox_init.c \
 +		   test-strcasestr.c \
 +		   test-stringlist.c \
 +		   test-strlcat.c \
 +		   test-strlcpy.c \
 +		   test-strndup.c \
 +		   test-strptime.c \
 +		   test-strsep.c \
 +		   test-strtonum.c \
 +		   test-vasprintf.c \
 +		   test-wchar.c
 +
 +SRCS		 = arch.c \
 +		   att.c \
 +		   catman.c \
 +		   cgi.c \
 +		   chars.c \
 +		   compat_err.c \
 +		   compat_fts.c \
 +		   compat_getline.c \
 +		   compat_getsubopt.c \
 +		   compat_isblank.c \
 +		   compat_mkdtemp.c \
 +		   compat_mkstemps.c \
 +		   compat_ohash.c \
 +		   compat_progname.c \
 +		   compat_reallocarray.c \
 +		   compat_recallocarray.c \
 +		   compat_strcasestr.c \
 +		   compat_stringlist.c \
 +		   compat_strlcat.c \
 +		   compat_strlcpy.c \
 +		   compat_strndup.c \
 +		   compat_strsep.c \
 +		   compat_strtonum.c \
 +		   compat_vasprintf.c \
 +		   dba.c \
 +		   dba_array.c \
 +		   dba_read.c \
 +		   dba_write.c \
 +		   dbm.c \
 +		   dbm_map.c \
 +		   demandoc.c \
 +		   eqn.c \
 +		   eqn_html.c \
 +		   eqn_term.c \
 +		   html.c \
 +		   lib.c \
 +		   main.c \
 +		   man.c \
 +		   man_html.c \
 +		   man_macro.c \
 +		   man_term.c \
 +		   man_validate.c \
 +		   mandoc.c \
 +		   mandoc_aux.c \
++		   mandoc_dbg.c \
 +		   mandoc_msg.c \
 +		   mandoc_ohash.c \
 +		   mandoc_xr.c \
 +		   mandocd.c \
 +		   mandocdb.c \
 +		   manpath.c \
 +		   mansearch.c \
 +		   mdoc.c \
 +		   mdoc_argv.c \
 +		   mdoc_html.c \
 +		   mdoc_macro.c \
 +		   mdoc_man.c \
 +		   mdoc_markdown.c \
 +		   mdoc_state.c \
 +		   mdoc_term.c \
 +		   mdoc_validate.c \
 +		   msec.c \
 +		   out.c \
 +		   preconv.c \
 +		   read.c \
 +		   roff.c \
++		   roff_escape.c \
 +		   roff_html.c \
 +		   roff_term.c \
 +		   roff_validate.c \
 +		   soelim.c \
 +		   st.c \
 +		   tag.c \
 +		   tbl.c \
 +		   tbl_data.c \
 +		   tbl_html.c \
 +		   tbl_layout.c \
 +		   tbl_opts.c \
 +		   tbl_term.c \
 +		   term.c \
 +		   term_ascii.c \
 +		   term_ps.c \
 +		   term_tab.c \
 +		   term_tag.c \
 +		   tree.c
 +
 +DISTFILES	 = INSTALL \
 +		   LICENSE \
 +		   Makefile \
 +		   Makefile.depend \
 +		   NEWS \
 +		   TODO \
 +		   apropos.1 \
 +		   catman.8 \
 +		   cgi.h.example \
 +		   compat_fts.h \
 +		   compat_ohash.h \
 +		   compat_stringlist.h \
 +		   configure \
 +		   configure.local.example \
 +		   dba.h \
 +		   dba_array.h \
 +		   dba_write.h \
 +		   dbm.h \
 +		   dbm_map.h \
 +		   demandoc.1 \
 +		   eqn.7 \
 +		   eqn.h \
 +		   eqn_parse.h \
 +		   gmdiff \
 +		   html.h \
 +		   lib.in \
 +		   libman.h \
 +		   libmandoc.h \
 +		   libmdoc.h \
 +		   main.h \
 +		   makewhatis.8 \
 +		   man.1 \
 +		   man.7 \
 +		   man.cgi.3 \
 +		   man.cgi.8 \
 +		   man.conf.5 \
 +		   man.h \
 +		   man.options.1 \
 +		   manconf.h \
 +		   mandoc.1 \
 +		   mandoc.3 \
 +		   mandoc.css \
 +		   mandoc.db.5 \
 +		   mandoc.h \
 +		   mandoc_aux.h \
 +		   mandoc_char.7 \
++		   mandoc_dbg.h \
++		   mandoc_dbg_init.3 \
 +		   mandoc_escape.3 \
 +		   mandoc_headers.3 \
 +		   mandoc_html.3 \
 +		   mandoc_malloc.3 \
 +		   mandoc_ohash.h \
 +		   mandoc_parse.h \
 +		   mandoc_xr.h \
 +		   mandocd.8 \
 +		   mansearch.3 \
 +		   mansearch.h \
 +		   mchars_alloc.3 \
 +		   mdoc.7 \
 +		   mdoc.h \
 +		   msec.in \
 +		   out.h \
 +		   predefs.in \
 +		   roff.7 \
 +		   roff.h \
 +		   roff_int.h \
 +		   soelim.1 \
 +		   tag.h \
 +		   tbl.3 \
 +		   tbl.7 \
 +		   tbl.h \
 +		   tbl_int.h \
 +		   tbl_parse.h \
 +		   term.h \
 +		   term_tag.h \
 +		   $(SRCS) \
 +		   $(TESTSRCS)
 +
 +LIBMAN_OBJS	 = man.o \
 +		   man_macro.o \
 +		   man_validate.o
 +
 +LIBMDOC_OBJS	 = att.o \
 +		   lib.o \
 +		   mdoc.o \
 +		   mdoc_argv.o \
 +		   mdoc_macro.o \
 +		   mdoc_state.o \
 +		   mdoc_validate.o \
 +		   st.o
 +
 +LIBROFF_OBJS	 = eqn.o \
 +		   roff.o \
++		   roff_escape.o \
 +		   roff_validate.o \
 +		   tbl.o \
 +		   tbl_data.o \
 +		   tbl_layout.o \
 +		   tbl_opts.o
 +
 +LIBMANDOC_OBJS	 = $(LIBMAN_OBJS) \
 +		   $(LIBMDOC_OBJS) \
 +		   $(LIBROFF_OBJS) \
++		   $(DEBUG_OBJS) \
 +		   arch.o \
 +		   chars.o \
 +		   mandoc.o \
 +		   mandoc_aux.o \
 +		   mandoc_msg.o \
 +		   mandoc_ohash.o \
 +		   mandoc_xr.o \
 +		   msec.o \
 +		   preconv.o \
 +		   read.o \
 +		   tag.o
 +
 +ALL_COBJS	 = compat_err.o \
 +		   compat_fts.o \
 +		   compat_getline.o \
 +		   compat_getsubopt.o \
 +		   compat_isblank.o \
 +		   compat_mkdtemp.o \
 +		   compat_mkstemps.o \
 +		   compat_ohash.o \
 +		   compat_progname.o \
 +		   compat_reallocarray.o \
 +		   compat_recallocarray.o \
 +		   compat_strcasestr.o \
 +		   compat_stringlist.o \
 +		   compat_strlcat.o \
 +		   compat_strlcpy.o \
 +		   compat_strndup.o \
 +		   compat_strsep.o \
 +		   compat_strtonum.o \
 +		   compat_vasprintf.o
 +
 +MANDOC_HTML_OBJS = eqn_html.o \
 +		   html.o \
 +		   man_html.o \
 +		   mdoc_html.o \
 +		   roff_html.o \
 +		   tbl_html.o
 +
 +MANDOC_TERM_OBJS = eqn_term.o \
 +		   man_term.o \
 +		   mdoc_term.o \
 +		   roff_term.o \
 +		   term.o \
 +		   term_ascii.o \
 +		   term_ps.o \
 +		   term_tab.o \
 +		   term_tag.o \
 +		   tbl_term.o
 +
 +DBM_OBJS	 = dbm.o \
 +		   dbm_map.o \
 +		   mansearch.o
 +
 +DBA_OBJS	 = dba.o \
 +		   dba_array.o \
 +		   dba_read.o \
 +		   dba_write.o \
 +		   mandocdb.o
 +
 +MAIN_OBJS	 = $(MANDOC_HTML_OBJS) \
 +		   $(MANDOC_MAN_OBJS) \
 +		   $(MANDOC_TERM_OBJS) \
 +		   $(DBM_OBJS) \
 +		   $(DBA_OBJS) \
 +		   main.o \
 +		   manpath.o \
 +		   mdoc_man.o \
 +		   mdoc_markdown.o \
 +		   out.o \
 +		   tree.o
 +
 +CGI_OBJS	 = $(MANDOC_HTML_OBJS) \
 +		   $(DBM_OBJS) \
 +		   cgi.o \
 +		   out.o
 +
 +MANDOCD_OBJS	 = $(MANDOC_HTML_OBJS) \
 +		   $(MANDOC_TERM_OBJS) \
 +		   mandocd.o \
 +		   out.o
 +
 +DEMANDOC_OBJS	 = demandoc.o
 +
 +WWW_MANS	 = apropos.1.html \
 +		   demandoc.1.html \
 +		   man.1.html \
 +		   man.options.1.html \
 +		   mandoc.1.html \
 +		   soelim.1.html \
 +		   man.cgi.3.html \
 +		   mandoc.3.html \
++		   mandoc_dbg_init.3.html \
 +		   mandoc_escape.3.html \
 +		   mandoc_headers.3.html \
 +		   mandoc_html.3.html \
 +		   mandoc_malloc.3.html \
 +		   mansearch.3.html \
 +		   mchars_alloc.3.html \
 +		   tbl.3.html \
 +		   man.conf.5.html \
 +		   mandoc.db.5.html \
 +		   eqn.7.html \
 +		   man.7.html \
 +		   mandoc_char.7.html \
 +		   mdoc.7.html \
 +		   roff.7.html \
 +		   tbl.7.html \
 +		   catman.8.html \
 +		   makewhatis.8.html \
 +		   man.cgi.8.html \
 +		   mandocd.8.html
 +
 +WWW_INCS	 = eqn.h.html \
 +		   html.h.html \
 +		   man.h.html \
 +		   manconf.h.html \
 +		   mandoc.h.html \
 +		   mandoc_aux.h.html \
 +		   mandoc_parse.h.html \
 +		   mansearch.h.html \
 +		   mdoc.h.html \
 +		   roff.h.html \
 +		   tbl.h.html \
 +		   tbl_int.h.html \
 +		   tbl_parse.h.html
 +
 +# === USER CONFIGURATION ===============================================
 +
 +include Makefile.local
 +
 +# === DEPENDENCY HANDLING ==============================================
 +
 +all: mandoc man demandoc soelim $(BUILD_TARGETS) Makefile.local
 +
 +install: base-install $(INSTALL_TARGETS)
 +
 +www: $(WWW_MANS) $(WWW_INCS)
 +
 +$(WWW_MANS) $(WWW_INCS): mandoc
 +
 +.PHONY: base-install cgi-install install www-install
 +.PHONY: clean distclean depend
 +
 +include Makefile.depend
 +
 +# === TARGETS CONTAINING SHELL COMMANDS ================================
 +
 +distclean: clean
 +	rm -f Makefile.local config.h config.h.old config.log config.log.old
 +
 +clean:
 +	rm -f libmandoc.a $(LIBMANDOC_OBJS) $(ALL_COBJS)
 +	rm -f mandoc man $(MAIN_OBJS)
 +	rm -f man.cgi $(CGI_OBJS)
 +	rm -f mandocd catman catman.o $(MANDOCD_OBJS)
 +	rm -f demandoc $(DEMANDOC_OBJS)
 +	rm -f soelim soelim.o
 +	rm -f $(WWW_MANS) $(WWW_INCS) mandoc*.tar.gz mandoc*.sha256
 +	rm -f Makefile.tmp1 Makefile.tmp2
 +	rm -rf *.dSYM
 +
 +base-install: mandoc demandoc soelim
 +	mkdir -p $(DESTDIR)$(BINDIR)
 +	mkdir -p $(DESTDIR)$(SBINDIR)
 +	mkdir -p $(DESTDIR)$(MANDIR)/man1
 +	mkdir -p $(DESTDIR)$(MANDIR)/man5
 +	mkdir -p $(DESTDIR)$(MANDIR)/man7
 +	mkdir -p $(DESTDIR)$(MANDIR)/man8
++	mkdir -p $(DESTDIR)$(MISCDIR)
 +	$(INSTALL_PROGRAM) mandoc demandoc $(DESTDIR)$(BINDIR)
 +	$(INSTALL_PROGRAM) soelim $(DESTDIR)$(BINDIR)/$(BINM_SOELIM)
 +	cd $(DESTDIR)$(BINDIR) && $(LN) mandoc $(BINM_MAN)
 +	cd $(DESTDIR)$(BINDIR) && $(LN) mandoc $(BINM_APROPOS)
 +	cd $(DESTDIR)$(BINDIR) && $(LN) mandoc $(BINM_WHATIS)
 +	cd $(DESTDIR)$(SBINDIR) && \
 +		$(LN) ${BIN_FROM_SBIN}/mandoc $(BINM_MAKEWHATIS)
 +	$(INSTALL_MAN) mandoc.1 demandoc.1 $(DESTDIR)$(MANDIR)/man1
 +	$(INSTALL_MAN) soelim.1 $(DESTDIR)$(MANDIR)/man1/$(BINM_SOELIM).1
 +	$(INSTALL_MAN) man.1 $(DESTDIR)$(MANDIR)/man1/$(BINM_MAN).1
 +	$(INSTALL_MAN) apropos.1 $(DESTDIR)$(MANDIR)/man1/$(BINM_APROPOS).1
 +	cd $(DESTDIR)$(MANDIR)/man1 && $(LN) $(BINM_APROPOS).1 $(BINM_WHATIS).1
 +	$(INSTALL_MAN) man.conf.5 $(DESTDIR)$(MANDIR)/man5/$(MANM_MANCONF).5
 +	$(INSTALL_MAN) mandoc.db.5 $(DESTDIR)$(MANDIR)/man5
 +	$(INSTALL_MAN) man.7 $(DESTDIR)$(MANDIR)/man7/$(MANM_MAN).7
 +	$(INSTALL_MAN) mdoc.7 $(DESTDIR)$(MANDIR)/man7/$(MANM_MDOC).7
 +	$(INSTALL_MAN) roff.7 $(DESTDIR)$(MANDIR)/man7/$(MANM_ROFF).7
 +	$(INSTALL_MAN) eqn.7 $(DESTDIR)$(MANDIR)/man7/$(MANM_EQN).7
 +	$(INSTALL_MAN) tbl.7 $(DESTDIR)$(MANDIR)/man7/$(MANM_TBL).7
 +	$(INSTALL_MAN) mandoc_char.7 $(DESTDIR)$(MANDIR)/man7
 +	$(INSTALL_MAN) makewhatis.8 \
 +		$(DESTDIR)$(MANDIR)/man8/$(BINM_MAKEWHATIS).8
++	$(INSTALL_DATA) mandoc.css $(DESTDIR)$(MISCDIR)
 +
 +lib-install: libmandoc.a
 +	mkdir -p $(DESTDIR)$(LIBDIR)
 +	mkdir -p $(DESTDIR)$(INCLUDEDIR)
 +	mkdir -p $(DESTDIR)$(MANDIR)/man3
 +	$(INSTALL_LIB) libmandoc.a $(DESTDIR)$(LIBDIR)
 +	$(INSTALL_LIB) eqn.h man.h mandoc.h mandoc_aux.h mandoc_parse.h \
 +		mdoc.h roff.h tbl.h $(DESTDIR)$(INCLUDEDIR)
 +	$(INSTALL_MAN) mandoc.3 mandoc_escape.3 mandoc_malloc.3 \
 +		mansearch.3 mchars_alloc.3 tbl.3 $(DESTDIR)$(MANDIR)/man3
 +
 +cgi-install: man.cgi
 +	mkdir -p $(DESTDIR)$(CGIBINDIR)
 +	mkdir -p $(DESTDIR)$(HTDOCDIR)
 +	$(INSTALL_PROGRAM) man.cgi $(DESTDIR)$(CGIBINDIR)
 +	$(INSTALL_DATA) mandoc.css $(DESTDIR)$(HTDOCDIR)
 +
 +catman-install: mandocd catman
 +	mkdir -p $(DESTDIR)$(SBINDIR)
 +	mkdir -p $(DESTDIR)$(MANDIR)/man8
 +	$(INSTALL_PROGRAM) mandocd $(DESTDIR)$(SBINDIR)
 +	$(INSTALL_PROGRAM) catman $(DESTDIR)$(SBINDIR)/$(BINM_CATMAN)
 +	$(INSTALL_MAN) mandocd.8 $(DESTDIR)$(MANDIR)/man8
 +	$(INSTALL_MAN) catman.8 $(DESTDIR)$(MANDIR)/man8/$(BINM_CATMAN).8
 +
 +uninstall:
 +	rm -f $(DESTDIR)$(BINDIR)/mandoc
 +	rm -f $(DESTDIR)$(BINDIR)/demandoc
 +	rm -f $(DESTDIR)$(BINDIR)/$(BINM_SOELIM)
 +	rm -f $(DESTDIR)$(BINDIR)/$(BINM_MAN)
 +	rm -f $(DESTDIR)$(BINDIR)/$(BINM_APROPOS)
 +	rm -f $(DESTDIR)$(BINDIR)/$(BINM_WHATIS)
 +	rm -f $(DESTDIR)$(SBINDIR)/$(BINM_MAKEWHATIS)
 +	rm -f $(DESTDIR)$(MANDIR)/man1/mandoc.1
 +	rm -f $(DESTDIR)$(MANDIR)/man1/demandoc.1
 +	rm -f $(DESTDIR)$(MANDIR)/man1/$(BINM_SOELIM).1
 +	rm -f $(DESTDIR)$(MANDIR)/man1/$(BINM_MAN).1
 +	rm -f $(DESTDIR)$(MANDIR)/man1/$(BINM_APROPOS).1
 +	rm -f $(DESTDIR)$(MANDIR)/man1/$(BINM_WHATIS).1
 +	rm -f $(DESTDIR)$(MANDIR)/man5/$(MANM_MANCONF).5
 +	rm -f $(DESTDIR)$(MANDIR)/man5/mandoc.db.5
 +	rm -f $(DESTDIR)$(MANDIR)/man7/$(MANM_MAN).7
 +	rm -f $(DESTDIR)$(MANDIR)/man7/$(MANM_MDOC).7
 +	rm -f $(DESTDIR)$(MANDIR)/man7/$(MANM_ROFF).7
 +	rm -f $(DESTDIR)$(MANDIR)/man7/$(MANM_EQN).7
 +	rm -f $(DESTDIR)$(MANDIR)/man7/$(MANM_TBL).7
 +	rm -f $(DESTDIR)$(MANDIR)/man7/mandoc_char.7
 +	rm -f $(DESTDIR)$(MANDIR)/man8/$(BINM_MAKEWHATIS).8
 +	rm -f $(DESTDIR)$(CGIBINDIR)/man.cgi
 +	rm -f $(DESTDIR)$(HTDOCDIR)/mandoc.css
 +	rm -f $(DESTDIR)$(SBINDIR)/mandocd
 +	rm -f $(DESTDIR)$(SBINDIR)/$(BINM_CATMAN)
 +	rm -f $(DESTDIR)$(MANDIR)/man8/mandocd.8
 +	rm -f $(DESTDIR)$(MANDIR)/man8/$(BINM_CATMAN).8
 +	rm -f $(DESTDIR)$(LIBDIR)/libmandoc.a
 +	rm -f $(DESTDIR)$(MANDIR)/man3/mandoc.3
 +	rm -f $(DESTDIR)$(MANDIR)/man3/mandoc_escape.3
 +	rm -f $(DESTDIR)$(MANDIR)/man3/mandoc_malloc.3
 +	rm -f $(DESTDIR)$(MANDIR)/man3/mansearch.3
 +	rm -f $(DESTDIR)$(MANDIR)/man3/mchars_alloc.3
 +	rm -f $(DESTDIR)$(MANDIR)/man3/tbl.3
 +	rm -f $(DESTDIR)$(INCLUDEDIR)/eqn.h
 +	rm -f $(DESTDIR)$(INCLUDEDIR)/man.h
 +	rm -f $(DESTDIR)$(INCLUDEDIR)/mandoc.h
 +	rm -f $(DESTDIR)$(INCLUDEDIR)/mandoc_aux.h
 +	rm -f $(DESTDIR)$(INCLUDEDIR)/mandoc_parse.h
 +	rm -f $(DESTDIR)$(INCLUDEDIR)/mdoc.h
 +	rm -f $(DESTDIR)$(INCLUDEDIR)/roff.h
 +	rm -f $(DESTDIR)$(INCLUDEDIR)/tbl.h
 +	[ ! -e $(DESTDIR)$(INCLUDEDIR) ] || rmdir $(DESTDIR)$(INCLUDEDIR)
 +
 +regress: all
 +	cd regress && ./regress.pl
 +
 +regress-clean:
 +	cd regress && ./regress.pl . clean
 +
 +Makefile.local config.h: configure $(TESTSRCS)
 +	@echo "$@ is out of date; please run ./configure"
 +	@exit 1
 +
 +libmandoc.a: $(MANDOC_COBJS) $(LIBMANDOC_OBJS)
 +	$(AR) rs $@ $(MANDOC_COBJS) $(LIBMANDOC_OBJS)
 +
 +mandoc: $(MAIN_OBJS) libmandoc.a
 +	$(CC) -o $@ $(LDFLAGS) $(MAIN_OBJS) libmandoc.a $(LDADD)
 +
 +man: mandoc
 +	$(LN) mandoc man
 +
 +man.cgi: $(CGI_OBJS) libmandoc.a
 +	$(CC) $(STATIC) -o $@ $(LDFLAGS) $(CGI_OBJS) libmandoc.a $(LDADD)
 +
 +mandocd: $(MANDOCD_OBJS) libmandoc.a
 +	$(CC) -o $@ $(LDFLAGS) $(MANDOCD_OBJS) libmandoc.a $(LDADD)
 +
 +catman: catman.o libmandoc.a
 +	$(CC) -o $@ $(LDFLAGS) catman.o libmandoc.a $(LDADD)
 +
 +demandoc: $(DEMANDOC_OBJS) libmandoc.a
 +	$(CC) -o $@ $(LDFLAGS) $(DEMANDOC_OBJS) libmandoc.a $(LDADD)
 +
 +soelim: $(SOELIM_COBJS) soelim.o
 +	$(CC) -o $@ $(LDFLAGS) $(SOELIM_COBJS) soelim.o
 +
 +# --- maintainer targets ---
 +
 +www-install: www
 +	$(INSTALL_DATA) mandoc.css $(HTDOCDIR)
 +	$(INSTALL_DATA) $(WWW_MANS) $(HTDOCDIR)/man
 +	$(INSTALL_DATA) $(WWW_INCS) $(HTDOCDIR)/includes
 +
 +depend: config.h
 +	./configure -depend
 +	mkdep -f Makefile.tmp1 $(CFLAGS) $(SRCS)
 +	perl -e 'undef $$/; $$_ = <>; s|/usr/include/\S+||g; \
 +		s|\\\n||g; s|  +| |g; s| $$||mg; print;' \
 +		Makefile.tmp1 > Makefile.tmp2
 +	rm Makefile.tmp1
 +	mv Makefile.tmp2 Makefile.depend
 +
 +regress-distclean:
 +	@find regress \
 +		-name '.#*' -o \
 +		-name '*.orig' -o \
 +		-name '*.rej' -o \
 +		-name '*.core' \
 +		-exec rm -i {} \;
 +
 +regress-distcheck:
 +	@find regress ! -type d ! -type f
 +	@find regress -type f \
 +		! -path '*/CVS/*' \
 +		! -name Makefile \
 +		! -name Makefile.inc \
 +		! -name '*.in' \
 +		! -name '*.out_ascii' \
 +		! -name '*.out_utf8' \
 +		! -name '*.out_html' \
 +		! -name '*.out_markdown' \
 +		! -name '*.out_lint' \
 +		! -path regress/regress.pl \
 +		! -path regress/regress.pl.1
 +
 +dist: mandoc-$(VERSION).sha256
 +
 +mandoc-$(VERSION).sha256: mandoc-$(VERSION).tar.gz
 +	sha256 mandoc-$(VERSION).tar.gz > $@
 +
 +mandoc-$(VERSION).tar.gz: $(DISTFILES)
 +	ls regress/*/*/*.mandoc_* && exit 1 || true
 +	mkdir -p .dist/mandoc-$(VERSION)/
 +	$(INSTALL) -m 0644 $(DISTFILES) .dist/mandoc-$(VERSION)
 +	cp -pR regress .dist/mandoc-$(VERSION)
 +	find .dist/mandoc-$(VERSION)/regress \
 +	    -type d -name CVS -print0 | xargs -0 rm -rf
 +	chmod 755 .dist/mandoc-$(VERSION)/configure
 +	( cd .dist/ && tar zcf ../$@ mandoc-$(VERSION) )
 +	rm -rf .dist/
 +
 +dist-install: dist
 +	$(INSTALL_DATA) mandoc-$(VERSION).tar.gz mandoc-$(VERSION).sha256 \
 +	    $(HTDOCDIR)/snapshots
 +
 +# === SUFFIX RULES =====================================================
 +
 +.SUFFIXES:	 .1       .3       .5       .7       .8       .h
 +.SUFFIXES:	 .1.html  .3.html  .5.html  .7.html  .8.html  .h.html
 +
 +.h.h.html:
 +	highlight -I $< > $@
 +
 +.1.1.html .3.3.html .5.5.html .7.7.html .8.8.html:
 +	./mandoc -Thtml -Wwarning,stop \
 +		-O 'style=/mandoc.css,man=/man/%N.%S.html;https://man.openbsd.org/%N.%S,includes=/includes/%I.html' \
 +		$< > $@
diff --cc contrib/mandoc/TODO
index 4135a3eca6c8,970aa936c16c..58d0d6937746
--- a/contrib/mandoc/TODO
+++ b/contrib/mandoc/TODO
@@@ -562,8 -627,14 +627,12 @@@ are mere guesses, and some may be wrong
    reported again by Nicolas Joly Thu, 1 Mar 2012 13:41:26 +0100 via wiz@ 5 Mar
    reported again by Franco Fichtner Fri, 27 Sep 2013 21:02:28 +0200
    reported again by Bruce Evans Fri, 17 Feb 2017 21:22:44 +0100 via bapt@
+   https://reviews.freebsd.org/D35245
+   even groff_mdoc(7) uses this: Nab Sun, 5 Jun 2022 22:16:37 +0200
+   When implementing this, try to avoid breaking existing manuals,
+   or at least fix them: Jan Stary Sun, 5 Jun 2022 22:48:05 +0200
    loc ***  exist ***  algo ***  size **  imp ***
 -  An easy partial fix would be to just skip the first word if it starts
 -  with a dot, including any following white space, when measuring.
 -  loc *  exist *  algo *  size *  imp ***
 +  An easy partial fix has been implemented as skip_leading_dot_word().
  
  - The \& zero-width character counts as output.
    That is, when it is alone on a line between two .Pp,
diff --cc contrib/mandoc/mandoc_dbg.c
index 000000000000,7d5bf3b925df..022ea57a82b5
mode 000000,100644..100644
--- a/contrib/mandoc/mandoc_dbg.c
+++ b/contrib/mandoc/mandoc_dbg.c
@@@ -1,0 -1,342 +1,343 @@@
+ /* $Id: mandoc_dbg.c,v 1.1 2022/04/14 16:43:44 schwarze Exp $ */
+ /*
+  * Copyright (c) 2021, 2022 Ingo Schwarze <schwarze@openbsd.org>
+  *
+  * Permission to use, copy, modify, and distribute this software for any
+  * purpose with or without fee is hereby granted, provided that the above
+  * copyright notice and this permission notice appear in all copies.
+  *
+  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+  */
+ #include "config.h"
+ 
+ #include <sys/types.h>
+ 
+ #if HAVE_ERR
+ #include <err.h>
+ #endif
+ #include <stdarg.h>
+ #include <stddef.h>
+ #include <stdint.h>
+ #include <stdio.h>
+ #include <stdlib.h>
+ #include <string.h>
+ #include <unistd.h>
+ 
+ #if HAVE_OHASH
+ #include <ohash.h>
+ #else
+ #include "compat_ohash.h"
+ #endif
+ 
+ #define DEBUG_NODEF 1
+ #include "mandoc_aux.h"
++#include "mandoc_dbg.h"
+ #include "mandoc.h"
+ 
+ /* Store information about one allocation. */
+ struct dhash_entry {
+ 	const char	*file;
+ 	int		 line;
+ 	const char	*func;
+ 	size_t		 num;
+ 	size_t		 size;
+ 	void		*ptr;
+ };
+ 
+ /* Store information about all allocations. */
+ static struct ohash	  dhash_table;
+ static FILE		 *dhash_fp;
+ static int		  dhash_aflag;
+ static int		  dhash_fflag;
+ static int		  dhash_lflag;
+ static int		  dhash_nflag;
+ static int		  dhash_sflag;
+ 
+ static	void		 *dhash_alloc(size_t, void *);
+ static	void		 *dhash_calloc(size_t, size_t, void *);
+ static	void		  dhash_free(void *, void *);
+ static	unsigned int	  dhash_slot(void *);
+ static	void		  dhash_register(const char *, int, const char *,
+ 				size_t, size_t, void *, const char *);
+ static	void		  dhash_print(struct dhash_entry *);
+ static	void		  dhash_purge(const char *, int, const char *, void *);
+ 
+ 
+ /* *** Debugging wrappers of public API functions. ************************ */
+ 
+ int
+ mandoc_dbg_asprintf(const char *file, int line,
+     char **dest, const char *fmt, ...)
+ {
+ 	va_list	 ap;
+ 	int	 ret;
+ 
+ 	va_start(ap, fmt);
+ 	ret = vasprintf(dest, fmt, ap);
+ 	va_end(ap);
+ 
+ 	if (ret == -1)
+ 		err((int)MANDOCLEVEL_SYSERR, NULL);
+ 
+ 	dhash_register(file, line, "asprintf", 1, strlen(*dest) + 1,
+ 	    *dest, *dest);
+ 
+ 	return ret;
+ }
+ 
+ void *
+ mandoc_dbg_calloc(size_t num, size_t size, const char *file, int line)
+ {
+ 	void *ptr = mandoc_calloc(num, size);
+ 	dhash_register(file, line, "calloc", num, size, ptr, NULL);
+ 	return ptr;
+ }
+ 
+ void *
+ mandoc_dbg_malloc(size_t size, const char *file, int line)
+ {
+ 	void *ptr = mandoc_malloc(size);
+ 	dhash_register(file, line, "malloc", 1, size, ptr, NULL);
+ 	return ptr;
+ }
+ 
+ void *
+ mandoc_dbg_realloc(void *ptr, size_t size, const char *file, int line)
+ {
+ 	dhash_purge(file, line, "realloc", ptr);
+ 	ptr = mandoc_realloc(ptr, size);
+ 	dhash_register(file, line, "realloc", 1, size, ptr, NULL);
+ 	return ptr;
+ }
+ 
+ void *
+ mandoc_dbg_reallocarray(void *ptr, size_t num, size_t size,
+     const char *file, int line)
+ {
+ 	dhash_purge(file, line, "reallocarray", ptr);
+ 	ptr = mandoc_reallocarray(ptr, num, size);
+ 	dhash_register(file, line, "reallocarray", num, size, ptr, NULL);
+ 	return ptr;
+ }
+ 
+ void *
+ mandoc_dbg_recallocarray(void *ptr, size_t oldnum, size_t num, size_t size,
+     const char *file, int line)
+ {
+ 	dhash_purge(file, line, "recallocarray", ptr);
+ 	ptr = mandoc_recallocarray(ptr, oldnum, num, size);
+ 	dhash_register(file, line, "recallocarray", num, size, ptr, NULL);
+ 	return ptr;
+ }
+ 
+ char *
+ mandoc_dbg_strdup(const char *ptr, const char *file, int line)
+ {
+ 	char *p = mandoc_strdup(ptr);
+ 	dhash_register(file, line, "strdup", 1, strlen(p) + 1, p, ptr);
+ 	return p;
+ }
+ 
+ char *
+ mandoc_dbg_strndup(const char *ptr, size_t sz, const char *file, int line)
+ {
+ 	char *p = mandoc_strndup(ptr, sz);
+ 	dhash_register(file, line, "strndup", 1, strlen(p) + 1, p, NULL);
+ 	return p;
+ }
+ 
+ void
+ mandoc_dbg_free(void *ptr, const char *file, int line)
+ {
+ 	dhash_purge(file, line, "free", ptr);
+ 	free(ptr);
+ }
+ 
+ 
+ /* *** Memory allocation callbacks for the debugging table. *************** */
+ 
+ static void *
+ dhash_alloc(size_t sz, void *arg)
+ {
+         return malloc(sz);
+ }
+ 
+ static void *
+ dhash_calloc(size_t n, size_t sz, void *arg)
+ {
+         return calloc(n, sz);
+ }
+ 
+ static void
+ dhash_free(void *p, void *arg)
+ {
+         free(p);
+ }
+ 
+ 
+ /* *** Debugging utility functions. *************************************** */
+ 
+ /* Initialize the debugging table, to be called from the top of main(). */
+ void
+ mandoc_dbg_init(int argc, char *argv[])
+ {
+ 	struct ohash_info	  info;
+ 	char			 *dhash_fn;
+ 	int			  argi;
+ 
+ 	info.alloc = dhash_alloc;
+ 	info.calloc = dhash_calloc;
+ 	info.free = dhash_free;
+ 	info.data = NULL;
+ 	info.key_offset = offsetof(struct dhash_entry, ptr);
+ 	ohash_init(&dhash_table, 18, &info);
+ 
+ 	dhash_fp = stderr;
+ 	if ((dhash_fn = getenv("DEBUG_MEMORY")) == NULL)
+ 		return;
+ 
+ 	dhash_sflag = 1;
+ 	for(;; dhash_fn++) {
+ 		switch (*dhash_fn) {
+ 		case '\0':
+ 			break;
+ 		case 'A':
+ 			dhash_aflag = 1;
+ 			continue;
+ 		case 'F':
+ 			dhash_fflag = 1;
+ 			continue;
+ 		case 'L':
+ 			dhash_lflag = 1;
+ 			continue;
+ 		case 'N':
+ 			dhash_nflag = 1;
+ 			continue;
+ 		case '/':
+ 			if ((dhash_fp = fopen(dhash_fn, "a+e")) == NULL)
+ 				err((int)MANDOCLEVEL_SYSERR, "%s", dhash_fn);
+ 			break;
+ 		default:
+ 			errx((int)MANDOCLEVEL_BADARG,
+ 			    "invalid char '%c' in $DEBUG_MEMORY",
+ 			    *dhash_fn);
+ 		}
+ 		break;
+ 	}
+ 	if (setvbuf(dhash_fp, NULL, _IOLBF, 0) != 0)
+ 		err((int)MANDOCLEVEL_SYSERR, "setvbuf");
+ 
+ 	fprintf(dhash_fp, "P %d", getpid());
+ 	for (argi = 0; argi < argc; argi++)
+ 		fprintf(dhash_fp, " [%s]", argv[argi]);
+ 	fprintf(dhash_fp, "\n");
+ }
+ 
+ void
+ mandoc_dbg_name(const char *name)
+ {
+ 	if (dhash_nflag)
*** 241 LINES SKIPPED ***