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 <bro...@freebsd.org>
AuthorDate: 2024-12-06 20:47:31 +0000
Commit:     Brooks Davis <bro...@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 <schwa...@openbsd.org>
++# Copyright (c) 2011, 2013-2022 Ingo Schwarze <schwa...@openbsd.org>
 +# Copyright (c) 2010, 2011, 2012 Kristaps Dzonsons <krist...@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 <schwa...@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 ***

Reply via email to