Package: ncurses-doc Version: 6.5-2 Severity: minor Tags: patch Dear Maintainer,
* What led up to the situation? Checking for defects with [test-][g|n]roff -mandoc -t -K utf8 -ww -b -z <man page> [test-groff is a script in the repository for "groff"] * What was the outcome of this action? Output from "test-groff -b -mandoc -dAD=l -rF0 -rHY=0 -K utf8 -t -ww -z ": <stdin>:189: warning: table row does not fit on page 1 * What outcome did you expect instead? No output (warnings). -.- Remarks and a patch are in the attachments. -- System Information: Debian Release: trixie/sid APT prefers testing APT policy: (500, 'testing') Architecture: amd64 (x86_64) Kernel: Linux 6.7.12-amd64 (SMP w/2 CPU threads; PREEMPT) Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), LANGUAGE not set Shell: /bin/sh linked to /usr/bin/dash Init: sysvinit (via /sbin/init) -- no debconf information
Any program (person), that produces man pages, should check its content for defects by using groff -mandoc -t -ww -b -z [ -K utf8 | k ] <man page> The same goes for man pages that are used as an input. For a style guide use mandoc -T lint -.- So any generator should check its products with the above mentioned 'groff' and additionally with 'nroff ...'. This is just a simple quality control measure. The generator may have to be corrected to get a better man page, the source file may, and any additional file may. -.- The difference between the formatted outputs can be seen with: nroff -mandoc <file1> > <out1> nroff -mandoc <file2> > <out2> diff -u <out1> <out2> and for groff, using "printf '%s\n%s\n' '.kern 0' '.ss 12 0' | groff -mandoc -Z - " instead of "nroff -mandoc" 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) -.-. Split lines longer than 80 characters into two or more lines. Appropriate break points are the end of a sentence and a subordinate clause; after punctuation marks. addch.3ncurses: line 69 length 84 \fBint mvwaddch(WINDOW *\fIwin\fP, int \fIy\fP, int \fIx\fP, const chtype \fIch\fP); -.- Output from "test-groff -b -mandoc -dAD=l -rF0 -rHY=0 -K utf8 -t -ww -z ": <stdin>:189: warning: table row does not fit on page 1
--- addch.3ncurses 2024-06-06 14:52:28.132433463 +0000 +++ addch.3ncurses.new 2024-06-07 13:33:53.344240516 +0000 @@ -66,7 +66,8 @@ add a \fIcurses\fP character to a window \fBint addch(const chtype \fIch\fP); \fBint waddch(WINDOW *\fIwin\fP, const chtype \fIch\fP); \fBint mvaddch(int \fIy\fP, int \fIx\fP, const chtype \fIch\fP); -\fBint mvwaddch(WINDOW *\fIwin\fP, int \fIy\fP, int \fIx\fP, const chtype \fIch\fP); +\fBint mvwaddch(WINDOW *\fIwin\fP, int \fIy\fP, int \fIx\fP, const chtype \ +\fIch\fP); .PP \fBint echochar(const chtype \fIch\fP); \fBint wechochar(WINDOW *\fIwin\fP, const chtype \fIch\fP); @@ -181,7 +182,8 @@ string capability, and the characters in it may appear on the screen if the terminal's database entry incorrectly advertises ACS support. The name \*(``ACS\*('' originates in the Alternate Character Set feature -of the DEC VT100 terminal. +of the DEC VT100 \%terminal. +.ne 6v .PP .TS Lb Lb Lb Lb