Bug 80871

Summary: terminfo(5) man page source corrupted
Product: Documentation Reporter: Warren Block <wblock>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Warren Block 2005-05-11 01:50:01 UTC
Man page source for terminfo(5) (/usr/share/man/man5/terminfo.5.gz) is corrupt.  Looks to be 
missing table formatting elements like T{ starting around line 155 in the boolean capabilities 
table.

Fix: 

Fix the formatting.
How-To-Repeat: 
man 5 terminfo

/usr/bin/tbl will produce errors before the man page is displayed:

/usr/bin/tbl:<standard input>:155: excess data entry `-' discarded
/usr/bin/tbl:<standard input>:155: excess data entry `-' discarded
/usr/bin/tbl:<standard input>:155: excess data entry `YB-G-' discarded
/usr/bin/tbl:<standard input>:155: excess data entry `cub1 wraps from column 0 to last column' discarded
/usr/bin/tbl:<standard input>:157: excess data entry `-' discarded
/usr/bin/tbl:<standard input>:157: excess data entry `-' discarded
/usr/bin/tbl:<standard input>:157: excess data entry `YBCGE' discarded
/usr/bin/tbl:<standard input>:157: excess data entry `terminal has automatic margins' discarded
/usr/bin/tbl:<standard input>:159: excess data entry `-' discarded
/usr/bin/tbl:<standard input>:159: excess data entry `-' discarded
...
Comment 1 Giorgos Keramidas freebsd_committer freebsd_triage 2005-05-11 10:49:02 UTC
On 2005-05-10 18:48, Warren Block <wblock@wonkity.com> wrote:
> Man page source for terminfo(5) (/usr/share/man/man5/terminfo.5.gz) is
> corrupt.  Looks to be missing table formatting elements like T{
> starting around line 155 in the boolean capabilities table.

The following diff fixes most of the table related warnings of
terminfo.5, but the file is still on the vendor branch, so I won't
commit anything to it until I get approval from Peter, who seems to
have done most of the commits in the area.

Peter, does this look ok?  Should we commit it or is it better to send a
notice to Tom Dickey instead, to see if this is already fixed in his
source tree?

%%%
Index: contrib/ncurses/man/terminfo.tail
===================================================================
RCS file: /home/ncvs/src/contrib/ncurses/man/terminfo.tail,v
retrieving revision 1.1.1.4
diff -u -r1.1.1.4 terminfo.tail
--- contrib/ncurses/man/terminfo.tail	21 May 2002 05:27:40 -0000	1.1.1.4
+++ contrib/ncurses/man/terminfo.tail	11 May 2005 09:41:58 -0000
@@ -1079,8 +1079,8 @@
 .PP
 .TS H
 center expand;
-c l l c
-c l l c
+c l l c c l
+c l l c c l
 lw28 lw6 lw2 lw20.
 .\".TH
 \fBGlyph	ACS	Ascii	VT100\fR
%%%

Note: In nroff mode, the terminal width is too short to fit the table
and there are still far too many annoying warnings about lines that
cannot be broken:

orion:/tmp/ti$ nroff -man terminfo.5 >/dev/null
terminfo.5:185: warning [p 2, 8.5i]: can't break line
terminfo.5:209: warning [p 3, 1.3i]: can't break line
terminfo.5:470: warning [p 6, 5.2i]: can't break line
terminfo.5:482: warning [p 6, 7.0i]: can't break line
terminfo.5:736: warning [p 9, 10.3i]: can't break line
terminfo.5:748: warning [p 10, 0.7i]: can't break line
terminfo.5:750: warning [p 10, 1.0i]: can't break line
terminfo.5:752: warning [p 10, 1.3i]: can't break line
terminfo.5:770: warning [p 10, 3.7i]: can't break line
terminfo.5:772: warning [p 10, 4.0i]: can't break line
terminfo.5:790: warning [p 10, 6.3i]: can't break line
terminfo.5:804: warning [p 10, 8.2i]: can't break line
terminfo.5:812: warning [p 10, 9.2i]: can't break line
terminfo.5:814: warning [p 10, 9.5i]: can't break line
terminfo.5:828: warning [p 11, 0.2i]: can't break line
terminfo.5:1072: warning [p 14, 3.8i]: can't break line
terminfo.5:1078: warning [p 14, 4.8i]: can't break line
terminfo.5:1080: warning [p 14, 5.2i]: can't break line
terminfo.5:1084: warning [p 14, 5.8i]: can't break line
terminfo.5:1094: warning [p 14, 7.3i]: can't break line
terminfo.5:1098: warning [p 14, 8.0i]: can't break line
terminfo.5:1100: warning [p 14, 8.3i]: can't break line
terminfo.5:1118: warning [p 15, 0.2i]: can't break line
orion:/tmp/ti$
Comment 2 Warren Block 2005-05-14 00:13:13 UTC
Thomas Dickey's updated man/MKterminfo.sh from ncurses 5.4 fixes the problem (sed search and 
replace strings) and builds the terminfo(5) man page correctly.

ftp://invisible-island.net/ncurses/ncurses-5.4.tar.gz
Comment 3 dfilter service freebsd_committer freebsd_triage 2006-10-14 20:51:07 UTC
ru          2006-10-14 19:50:57 UTC

  FreeBSD src repository

  Modified files:        (Branch: NCURSES)
    contrib/ncurses/man  MKterminfo.sh 
  Log:
  Fix from upstream: unbreak generation of the terminfo.5 manpage.
  
  PR:             docs/46709, docs/56981, docs/80871
  MFC after:      3 days
  Obtained from:  ftp://invisible-island.net/ncurses/ncurses-5.5.tar.gz
  
  Revision  Changes    Path
  1.1.1.4   +15 -12    src/contrib/ncurses/man/MKterminfo.sh
_______________________________________________
cvs-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/cvs-all
To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
Comment 4 ru freebsd_committer freebsd_triage 2006-10-14 20:51:50 UTC
State Changed
From-To: open->closed

Duplicate of PR docs/46709.