Re: Errors in ncurses man pages

[Thomas Dickey]

----- Original Message -----
| From: "Helge Kreutzmann" <debian@helgefjell.de>
| To: "Ncurses Mailing List" <bug-ncurses@gnu.org>
| Sent: Wednesday, December 22, 2021 4:50:41 AM
| Subject: Errors in ncurses man pages

| Dear ncurses maintainer,
| the manpage-l10n project maintains a large number of translations of
| man pages both from a large variety of sources (including ncurses) as
| well for a large variety of target languages.
| 
| During their work translators notice different possible issues in the
| original (english) man pages. Sometimes this is a straightforward
| typo, sometimes a hard to read sentence, sometimes this is a
| convention not held up and sometimes we simply do not understand the
| original.
| 
| We use several distributions as sources and update regularly (at
| least every 2 month). This means we are fairly recent (some
| distributions like archlinux also update frequently) but might miss
| the latest upstream version once in a while, so the error might be
| already fixed. We apologize and ask you to close the issue immediately
| if this should be the case, but given the huge volume of projects and
| the very limited number of volunteers we are not able to double check
| each and every issue.
| 
| Secondly we translators see the manpages in the neutral po format,
| i.e. converted and harmonized, but not the original source (be it man,
| groff, xml or other). So we cannot provide a true patch (where
| possible), but only an approximation which you need to convert into
| your source format.
| 
| Finally the issues I'm reporting have accumulated over time and are
| not always discovered by me, so sometimes my description of the
| problem my be a bit limited - do not hesitate to ask so we can clarify
| them.
| 
| I'm now reporting the errors for your project. If future reports
| should use another channel, please let me know.
| 
| Man page: clear.1
| Issue: xterm → B<xterm>(1)
| 
| "In June 1999, xterm provided an extension to the standard control sequence "
| "for clearing the screen.  Rather than clearing just the visible part of the "
| "screen using"

You left something out.  See formatted page

https://invisible-island.net/ncurses/man/clear.1.html

-- 
Thomas E. Dickey <dickey@invisible-island.net>
http://invisible-island.net
ftp://ftp.invisible-island.net