#1071107 elf_begin.3: fix a table and lines in the SYNOPSIS

Package:
libelf-dev
Source:
libelf-dev
Description:
libelf1 development libraries and header files
Submitter:
Bjarni Ingi Gislason
Date:
2024-05-14 13:03:04 UTC
Severity:
normal
Tags:
#1071107#5
Date:
2024-05-14 13:00:42 UTC
From:
To:
Dear Maintainer,

   * What led up to the situation?

  Warnings from 'groff -ww -b ...'

-.-

The difference between the formatted outputs can be seen with:

  nroff -man <file1> > <out1>
  nroff -man <file2> > <out2>
  diff -u <out1> <out2>

and for groff, using

"printf '%s\n%s\n' '.kern 0' '.ss 12 0' | groff -man -Z - "

instead of "nroff -man"

  Add the option "-t", if the file contains a table.

  Read the output of "diff -u" with "less -R" or similar.

-.-.

  If "man" (man-db) is used to check the manual for warnings,
the following must be set:

  The option "-warnings=w"

  The environmental variable:

export MAN_KEEP_STDERR=yes (or any non-empty value)

  or

  (produce only warnings):

export MANROFFOPT="-ww -z"

export MAN_KEEP_STDERR=yes (or any non-empty value)

-.-.

Output from "mandoc -T lint elf_begin.3":

mandoc: elf_begin.3:13:2: STYLE: fill mode already enabled, skipping: fi
mandoc: elf_begin.3:25:2: ERROR: data block open at end of tbl: TE

-.-.

Output from "test-groff -b -mandoc -dAD=l -rF0 -rHY=0 -t -w w -z -rCHECKSTYLE=0":
tbl:<stdin>:35: error: end of data in middle of text block
tbl:<stdin>:35: error: giving up on this table region
an.tmac:<stdin>:35: warning: tbl preprocessor failed, or it or soelim was not run; table(s) likely not rendered (TE macro called with TW register undefined)

-.-

  The patch is in the attachment.