Re: Errors in ncurses man pages

[Helge Kreutzmann]

Hello Thomas,
On Wed, Dec 22, 2021 at 04:15:52PM -0500, Thomas Dickey wrote:
> ----- 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

The paragraph on this web page is also missing the markup, so I'm not
sure what exactly I "left out". Of course, I did not cite the entire
man page, only the relevant paragraph.

Greetings

            Helge

-- 
      Dr. Helge Kreutzmann                     debian@helgefjell.de
           Dipl.-Phys.                   http://www.helgefjell.de/debian.php
        64bit GNU powered                     gpg signed mail preferred
           Help keep free software "libre": http://www.ffii.de/

signature.asc
Description: PGP signature