From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-2.2 required=3.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED,USER_AGENT_SANE_1 autolearn=no autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id B8F24C433DF for ; Sat, 16 May 2020 15:55:16 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 8B7F42053B for ; Sat, 16 May 2020 15:55:16 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726229AbgEPPzQ (ORCPT ); Sat, 16 May 2020 11:55:16 -0400 Received: from luckmann.name ([213.239.213.133]:34993 "EHLO static.213-239-213-133.clients.your-server.de" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726228AbgEPPzP (ORCPT ); Sat, 16 May 2020 11:55:15 -0400 X-Greylist: delayed 300 seconds by postgrey-1.27 at vger.kernel.org; Sat, 16 May 2020 11:55:13 EDT Received: from localhost (localhost [127.0.0.1]) (uid 502) by static.213-239-213-133.clients.your-server.de with local id 0000000000E56134.000000005EC00BB3.00003990; Sat, 16 May 2020 17:50:11 +0200 Date: Sat, 16 May 2020 17:50:11 +0200 From: Helge Kreutzmann To: linux-nfs@vger.kernel.org Subject: Errors in nfs man pages Message-ID: <20200516155011.GA14433@Debian-50-lenny-64-minimal> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="=_luckmann.name-14736-1589644211-0001-2" Content-Disposition: inline X-Public-Key-URL: http://www.helgefjell.de/data/debian_neu.asc X-homepage: http://www.helgefjell.de/debian User-Agent: Mutt/1.10.1 (2018-07-13) Sender: linux-nfs-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-nfs@vger.kernel.org This is a MIME-formatted message. If you see this text it means that your E-mail software does not support MIME-formatted messages. --=_luckmann.name-14736-1589644211-0001-2 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Dear nfs maintainers. the manpage-l10n project maintains a large number of translations of man pages both from a large variety of sources (including nfs) as well for a large variety of target languages. During their work translators notice different possible issues in the original (english) man pages. Sometiems 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 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: blkmapd.8 Issue: Markup of "device-mapper" "The topology typically consists of a hierarchy of volumes built by stripin= g, " "slicing, and concatenating the simple volumes. The B daemon uses= " "the device-mapper driver to construct logical devices that reflect the " "server topology, and passes these devices to the kernel for use by the pNF= S " "block layout client." -- Man page: blkmapd.8 Issue: Markup of "syslogd" "Runs B in the foreground and sends output to stderr (as opposed t= o " "syslogd)" -- Man page: exportfs.8 Issue: B =E2=86=92 B(5) "The I argument specifies a local directory to export, along wi= th " "the client or clients who are permitted to access it. See B f= or " "a description of supported options and access list formats." -- Man page: nfs.5 Issue: Typo: kernel_soruce "Enable/Disables the cache of (read-only) data pages to the local disk usin= g " "the FS-Cache facility. See cachefilesd(8) and Ekernel_soruceE/" "Documentation/filesystems/caching for detail on how to configure the FS-" "Cache facility. Default value is nofsc." -- Man page: nfs.conf.5 Issue: Typo: Comma at the end (instead of full stop) "Recognized values: B, B, B, B, B, B, B, B, B, B, B, B, " "B, B," -- Man page: nfsd.7 Issue: back-slash vs. backslash, should be consistent "Each line of the file contains a path name, a client name, and a number of= " "options in parentheses. Any space, tab, newline or back-slash character i= n " "the path name or client name will be replaced by a backslash followed by t= he " "octal ASCII code for that character." -- Man page: nfsd.7 Issue: thread currently =E2=86=92 threads currently "This file represents the number of B thread currently running. " "Reading it will show the number of threads. Writing an ASCII decimal numb= er " "will cause the number of threads to be changed (increased or decreased as " "necessary) to achieve that number." -- Man page: nfsd.7 Issue: The first sentence is somewhat logical, however, is this really the = intended meaning of this file? "This is a somewhat unusual file in that what is read from it depends on wh= at " "was just written to it. It provides a transactional interface where a " "program can open the file, write a request, and read a response. If two " "separate programs open, write, and read at the same time, their requests " "will not be mixed up." -- Man page: nfsd.7 Issue: can be display =E2=86=92 can be displayed "The directory B in the B filesystem contains a numb= er " "of files and directories. The files contain statistics that can be displa= y " "using the I program. The directories contain information about " "various caches that the NFS server maintains to keep track of access " "permissions that different clients have for different filesystems. The " "caches are:" -- Man page: nfsd.7 Issue 1: select(2) or poll(2) =E2=86=92 B