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=-5.6 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,MENTIONS_GIT_HOSTING, SPF_HELO_NONE,SPF_PASS autolearn=ham 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 27B21C28CBC for ; Sat, 9 May 2020 18:53:48 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id E6051206D5 for ; Sat, 9 May 2020 18:53:47 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="fAPeL3C5" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728005AbgEISxr (ORCPT ); Sat, 9 May 2020 14:53:47 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:58666 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-FAIL-OK-FAIL) by vger.kernel.org with ESMTP id S1727995AbgEISxq (ORCPT ); Sat, 9 May 2020 14:53:46 -0400 Received: from mail-ej1-x643.google.com (mail-ej1-x643.google.com [IPv6:2a00:1450:4864:20::643]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id A0045C061A0C for ; Sat, 9 May 2020 11:53:44 -0700 (PDT) Received: by mail-ej1-x643.google.com with SMTP id n17so4213017ejh.7 for ; Sat, 09 May 2020 11:53:44 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc:content-transfer-encoding; bh=DQVePnsq9b+l1j6tNDEX7OV+XuM32riWkKdeGkxn/Ec=; b=fAPeL3C5mfXFYfMRURNh0tX0d3IISJaegttMHbA1vuj+LYf6sp5yF33TMa701zuPun yY1b7cctZRMSdx2LHjAsVGzAjlWfgNXEYoDIvdSak3+89TaX+Y6FG30gYB8NN+fA/xRR Bt7EQUo1niC+6ZlMmdostjGjqNRruZW1ybMRiFmN5w3VH8uSNnLU6dWOMU3F3ExWU6F+ dukdLbZF8mKHDjLudyHWwHyiavqwTLvHkA5eQO4IxX01Tc3VYLEN/Z4SxnendWclyngS TumvuzNNjmohLHw7gpNPFZMXLI9xYCbgVN6HCoOCML0tjeQx7yaXeltQMCcCrgBOBros JLWQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc:content-transfer-encoding; bh=DQVePnsq9b+l1j6tNDEX7OV+XuM32riWkKdeGkxn/Ec=; b=Xmx87mbBMiq45nm5gvsU5tBiw8sEAe2KtY7gXxns07yAfwFDZ6+fIYRf/Glw4bhACG jvySMAXK29n0Vz3+Ekb2jhcosQNCu12cdhhfVWs1sljxf+p5gDDbBY4H5S3yZf5LeWvq qX5EHNcPkEOv838ouJBjJ+jmTvuOBNqDZbfwMS8TRK7GE05j2sAApR5EOU7t+udV36X8 vpC7lx0tGIwuSkkrTmkJmBZbvdaKJd7a1RNCeDsE650jzoikWgxuEWVyCaeHtGis9ANA IXXKZIZAnPpzZdUgUBYJbNvwJw5UTBERF4Hv3xrRp7IXoWgNfIbS5aNDFSzNsI1yhLIn 46IQ== X-Gm-Message-State: AGi0PuaTn3m/rskfw8TQZAKHv/a7oRIcoV/B6kjZwBKPzxwD+xj4k23I SmDUdj1HabKHQobzkp85p8+uscxDVSHNp8xsg3s= X-Google-Smtp-Source: APiQypKZSe+EVQBfFGq+fJkxNolE1lV4+1tsgrj/i/sBbrk9pQaJo6d0MHzKlFhevwUW/XAAv/BZ5aatoOPrYGPq6wk= X-Received: by 2002:a17:906:8282:: with SMTP id h2mr7399657ejx.250.1589050422767; Sat, 09 May 2020 11:53:42 -0700 (PDT) MIME-Version: 1.0 References: <20200503191335.GB27970@Debian-50-lenny-64-minimal> In-Reply-To: <20200503191335.GB27970@Debian-50-lenny-64-minimal> From: Michael Kerrisk Date: Sat, 9 May 2020 20:53:31 +0200 Message-ID: Subject: Re: Errors in man pages of util-linux To: Helge Kreutzmann Cc: util-linux@vger.kernel.org, =?UTF-8?Q?Mario_Bl=C3=A4ttermann?= , Karel Zak , Michael Kerrisk-manpages Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Sender: util-linux-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: util-linux@vger.kernel.org [CC +=3D Karel] Hello Helge ;-), I think no maintainer wants to deal with a 1000-line mail listing 100+ minor bugs. May I suggest making the maintainer's life a little easier by breaking things up into pieces. For example, one mail per manual page (which would be 43 mails by my count). But maybe Karel has another suggestion on how you could make his life easier. With best regards, Michael On Sun, May 3, 2020 at 9:20 PM Helge Kreutzmann wrot= e: > > Dear util-linux maintainers. > the manpage-l10n project maintains a large number of translations of > man pages both from a large variety of sources (including util-linux) 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: adjtime_config.5 > Issue: Superfluous comma after "is" > > "The format of the adjtime file is, in ASCII." > -- > Man page: adjtime_config.5 > Issue: hwckock =E2=86=92 hwclock > > "The Hardware Clock is usually not very accurate. However, much of its " > "inaccuracy is completely predictable - it gains or loses the same amount= of " > "time every day. This is called systematic drift. The util hwclock keep= s " > "the file /etc/adjtime, that keeps some historical information. For more= " > "details see \"B\" and \"B\" secti= ons " > "from B(8) man page." > -- > Man page: agetty.8 > Issue: agetty =E2=86=92 B > > "Display the current issue file (or other) on the current terminal and ex= it. " > "Use this option to review the current setting, it is not designed for an= y " > "other purpose. Note that output may use some default or incomplete " > "information as proper output depends on terminal and agetty command line= ." > -- > Man page: agetty.8 > Issue: I =E2=86=92 B(5) > > "This section shows examples for the process field of an entry in the I "inittab> file. You'll have to prepend appropriate values for the other = " > "fields. See I for more details." > -- > Man page: agetty.8 > Issue: commandline =E2=86=92 command line > > "Some programs use \"--\" to indicate that the rest of the command line " > "should not be interpreted as options. Use this feature if available by = " > "passing \"--\" before the username gets passed by \\eu." > -- > Man page: agetty.8 > Issue: agetty =E2=86=92 B > > "Since version 2.35 additional locations for issue file and directory are= " > "supported. If the default I does not exist than agetty check= s " > "for I and I, thereafter for I = and " > "I. The directory /etc is expected for host specific " > "configuration, /run is expected for generated stuff and /usr/lib for sta= tic " > "distribution maintained configuration." > -- > Man page: agetty.8 > Issue: If not any configured =E2=86=92 If no configured > > "Insert the IPv4 address of the specified network interface (for example:= " > "\\e4{eth0}). If the I argument is not specified, then select= the " > "first fully configured (UP, non-LOCALBACK, RUNNING) interface. If not a= ny " > "configured interface is found, fall back to the IP address of the machin= e's " > "hostname." > -- > Man page: blkid.8 > Issue: Missing markup from "mount" > > "This option forces B to use udev when used for LABEL or UUID toke= ns " > "in B<--match-token>. The goal is to provide output consistent with anoth= er " > "utils (like mount, etc.) on systems where the same tag is used for mult= iple " > "devices." > -- > Man page: blkzone.8 > Issue: Double full stop > > "Display the number of zones returned in the report or the range of secto= rs " > "reset.." > -- > Man page: chfn.1 > Issue: Missing markup for command name > > "The chfn command is part of the util-linux package and is available from= " > "https://www.kernel.org/pub/linux/utils/util-linux/." > -- > Man page: chsh.1 > Issue: Missing markup for command name > > "The chsh command is part of the util-linux package and is available from= " > "https://www.kernel.org/pub/linux/utils/util-linux/." > -- > Man page: col.1 > Issue: Missing markup for command name > > "The col command is part of the util-linux package and is available from = E<." > "UR https://\\:www.kernel.org\\:/pub\\:/linux\\:/utils\\:/util-linux/> Li= nux " > "Kernel Archive E<.UE .>" > -- > Man page: colcrt.1 > Issue: invisible =E2=86=92 partially invisible > > "Causes all half-lines to be printed, effectively double spacing the outp= ut. " > "Normally, a minimal space output format is used which will suppress empt= y " > "lines. The program never suppresses two consecutive empty lines, howeve= r. " > "The B<-2> option is useful for sending output to the line printer when t= he " > "output contains superscripts and subscripts which would otherwise be " > "invisible." > -- > Man page: colcrt.1 > Issue: B<'-'> =E2=86=92 B<-> > > "Should fold underlines onto blanks even with the B<'-'> option so that a= " > "true underline character would show." > -- > Man page: colrm.1 > Issue: Missing markup for command name > > "The colrm command is part of the util-linux package and is available fro= m E<." > "UR https://\\:www.kernel.org\\:/pub\\:/linux\\:/utils\\:/util-linux/> Li= nux " > "Kernel Archive E<.UE .>" > -- > Man page: column.1 > Issue: Missing markup for command name > > "The column command is part of the util-linux package and is available fr= om " > "https://www.kernel.org/pub/linux/utils/util-linux/." > -- > Man page: column.1 > Issue: Missing markup for command name > > "By default, the column command will merge multiple adjacent delimiters i= nto " > "a single delimiter when using the E<.Fl t> option; this option disables = that " > "behavior. This option is a Debian GNU/Linux extension." > -- > Man page: fdisk.8 > Issue: Why is the full stop at the end in bold? > > "Specify the sector size of the disk. Valid values are 512, 1024, 2048, = and " > "4096. (Recent kernels know the sector size. Use this option only on ol= d " > "kernels or to override the kernel's ideas.) Since util-linux-2.17, B " > "differentiates between logical and physical sector size. This option " > "changes both sector sizes to IB<.>" > -- > Man page: fdisk.8 > Issue: "when create" =E2=86=92 "when creating" > > "Don't erase the begin of the first disk sector when create a new disk " > "label. This feature is supported for GPT and MBR." > -- > Man page: fdisk.8 > Issue: Missing markup of file (names) > > "The I is usually /dev/sda, /dev/sdb or so. A device name refers= to " > "the entire disk. Old systems without libata (a library used inside the = " > "Linux kernel to support ATA host controllers and devices) make a differe= nce " > "between IDE and SCSI disks. In such cases the device name will be /dev/= hd* " > "(IDE) or /dev/sd* (SCSI)." > -- > Man page: fdisk.8 > Issue: Content: Do need to mark partitions with =C2=BBvolume=C2=AB and = =C2=BBvolume > header=C2=AB > > "An IRIX/SGI disklabel can describe 16 partitions, the eleventh of which = " > "should be an entire `volume' partition, while the ninth should be labele= d " > "`volume header'. The volume header will also cover the partition table,= i." > "e., it starts at block zero and extends by default over five cylinders. = The " > "remaining space in the volume header may be used by header directory " > "entries. No partitions may overlap with the volume header. Also do not= " > "change its type or make some filesystem on it, since you will lose the " > "partition table. Use this type of label only when working with Linux on= " > "IRIX/SGI machines or IRIX/SGI disks under Linux." > -- > Man page: fdisk.8 > Issue: Missing markup of fdisk > > "Usually all goes well by default, and there are no problems if Linux is = the " > "only system on the disk. However, if the disk has to be shared with oth= er " > "operating systems, it is often a good idea to let an fdisk from another = " > "operating system make at least one partition. When Linux boots it looks= at " > "the partition table, and tries to deduce what (fake) geometry is require= d " > "for good cooperation with other systems." > -- > Man page: fsck.minix.8 > Issue: Replace \(en with Unicode U+2013 '- > > msgid "/dev/hda[1\\(en63]" > > msgid "/dev/hdb[1\\(en63]" > > msgid "/dev/sda[1\\(en15]" > > msgid "/dev/sdb[1\\(en15]" > -- > Man page: fstrim.8 > Issue: Markup of fstrim > > "Minimum contiguous free range to discard, in bytes. (This value is " > "internally rounded up to a multiple of the filesystem block size.) Free= " > "ranges smaller than this will be ignored and fstrim will adjust the mini= mum " > "if it's smaller than the device's minimum, and report that (fstrim_range= ." > "minlen) back to userspace. By increasing this value, the fstrim operati= on " > "will complete more quickly for filesystems with badly fragmented freespa= ce, " > "although not all blocks will be discarded. The default value is zero, " > "discarding every free block." > -- > Man page: getopt.1 > Issue: Missing comma when enumarating Shells (after sh) > > "Set quoting conventions to those of I. If the B<-s> option is no= t " > "given, the E<.SM BASH> conventions are used. Valid arguments are curren= tly " > "'B' 'B', 'B', and 'B'." > -- > Man page: hardlink.1 > Issue: Markup up of command options missing > > "Among equal files, keep the oldest file (least recent modification time)= . By " > "default, the newest file is kept. If --maximize or --minimize is specifi= ed, " > "the link count has a higher precedence than the time of modification." > > "A regular expression to include files. If the option --exclude has been = " > "given, this option re-includes files which would otherwise be excluded. = If " > "the option is used without --exclude, only files matched by the pattern = are " > "included." > > "B , as of version 0.3 RC1, improperly calculates the amount of= " > "space saved if the option --respect-name is specified. In previous versi= ons, " > "the amount was wrong in almost all other cases as well." > -- > Man page: hardlink.1 > Issue: Markup up of "hardlink" missing > > "B assumes that the trees it operates on do not change during " > "operation. If a tree does change, the result is undefined and potentiall= y " > "dangerous. For example, if a regular file is replaced by a device, hardl= ink " > "may start reading from the device. If a component of a path is replaced = by a " > "symbolic link or file permissions change, security may be compromised. D= o " > "not run hardlink on a changing tree or on a tree controlled by another u= ser." > > "The program hardlink and this manpage have been written by Julian Andres= " > "Klode, and are licensed under the MIT license. See the code of hardlink = for " > "further information." > -- > Man page: hexdump.1 > Issue: When markup is used (B<>), no extra quoting is necessary > > "I. Display the input offset in hexadecimal= , " > "followed by sixteen space-separated, two-column, hexadecimal bytes, foll= owed " > "by the same sixteen bytes in B<%_p> format enclosed in 'B<|>' characters= ." > > "Output characters in the default character set. Non-printing characters= are " > "displayed as a single 'B<\\&.>'." > -- > Man page: hexdump.1 > Issue: Missing closing bracket (for fprintf) > > "The format is required and must be surrounded by double quote (\" \") " > "marks. It is interpreted as a fprintf-style format string (see " > "B(3), with the following exceptions:" > -- > Man page: hexdump.1 > Issue: identical =E2=86=92 almost identical > > "Identical to the B<\\&_a> conversion string except that it is only perfo= rmed " > "once, when all of the input data has been processed." > -- > Man page: hexdump.1 > Issue: Missing mark up for "hexdump" > > "When put at the end of a format specifier, hexdump highlights the respec= tive " > "string with the color specified. Conditions, if present, are evaluated = " > "prior to highlighting." > > "The hexdump command is part of the util-linux package and is available f= rom " > "E<.UR https://\\:www.kernel.org\\:/pub\\:/linux\\:/utils\\:/util-linux/>= " > "Linux Kernel Archive E<.UE .>" > -- > Man page: hexdump.1 > Issue: Mixed markup (B<>) and quoting for conversion characters > > "Further output by such format strings is replaced by an equivalent numbe= r of " > "spaces. An equivalent number of spaces is defined as the number of spac= es " > "output by an B conversion character with the same field width and " > "precision as the original conversion character or conversion string but = with " > "any 'B<\\&+>', \\' \\', 'B<\\&#>' conversion flag characters removed, an= d " > "referencing a NULL string." > -- > Man page: hexdump.1 > Issue: ``|'' =E2=86=92 B<|> > > "E<.Em Canonical hex+ASCII display>. Display the input offset in " > "hexadecimal, followed by sixteen space-separated, two column, hexadecima= l " > "bytes, followed by the same sixteen bytes in %_p format enclosed in ``|'= ' " > "characters." > -- > Man page: hwclock.8 > Issue: Markup up correct? (around option) > > "Use\\ B<--verbose>. The\\ B<\\%--debug\\ >option has been deprecated an= d " > "may be repurposed or removed in a future release." > -- > Man page: hwclock.8 > Issue: Replace comma by full stop > > "Update the Hardware Clock's drift factor in I. It can onl= y be " > "used with B<--set> or B<\\%--systohc>," > -- > Man page: hwclock.8 > Issue: Paragraph hard to read > > "Significantly increased system shutdown times (as of v2.31 when not usin= g B<" > "\\%--update-drift> the RTC is not read)." > -- > Man page: hwclock.8 > Issue: date-time =E2=86=92 date time?? > > msgid "There are two types of date-time clocks:" > -- > Man page: hwclock.8 > Issue: Spaces in and around the final B<> > > "Some Linux distributions attempt to automatically calculate the System C= lock " > "drift with B<\\%adjtimex>'s compare operation. Trying to correct one " > "drifting clock by using another drifting clock as a reference is akin to= a " > "dog trying to catch its own tail. Success may happen eventually, but gr= eat " > "effort and frustration will likely precede it. This automation may yiel= d an " > "improvement over no configuration, but expecting optimum results would b= e in " > "error. A better choice for manual configuration would be B<\\%adjtimex>= 'sB< " > "--log >options." > -- > Man page: hwclock.8 > Issue: Missing Space at beginning of line > > msgid "TheI< System Clock >time must be correct at shutdown!" > -- > Man page: libblkid.3 > Issue: evaluate =E2=86=92 determine? > > "The high-level part of the library supports two methods to evaluate LABE= L/" > "UUID. It reads information directly from a block device or read informa= tion " > "from /dev/disk/by-* udev symlinks. The udev is preferred method by defa= ult." > -- > Man page: libblkid.3 > Issue: Missing markup for command name > > "libblkid is part of the util-linux package since version 2.15 and is " > "available from https://www.kernel.org/pub/linux/utils/util-linux/." > -- > Man page: logger.1 > Issue: Superfluous space before full stop > > "Use datagrams (UDP) only. By default the connection is tried to the sys= log " > "port defined in /etc/services, which is often 514 ." > -- > Man page: logger.1 > Issue: Missing markup of command name > > "Log the PID of the logger process with each line. When the optional " > "argument I is specified, then it is used instead of the logger comma= nd's " > "PID. The use of B<--id=3D$$> (PPID) is recommended in scripts that send= " > "several messages." > > "Write a systemd journal entry. The entry is read from the given I= , " > "when specified, otherwise from standard input. Each line must begin wit= h a " > "field that is accepted by journald; see B(7) fo= r " > "details. The use of a MESSAGE_ID field is generally a good idea, as it = " > "makes finding entries easy. Examples:" > > "Use the specified I. When this option is not specified, the port = " > "defaults to syslog for udp and to syslog-conn for tcp connections." > > "Most receivers accept messages larger than 1KiB over any type of syslog = " > "protocol. As such, the B<--size> option affects logger in all cases (no= t " > "only when B<--rfc5424> was used)." > -- > Man page: logger.1 > Issue: or the journal =E2=86=92 to the journal? > > "Causes everything to be done except for writing the log message to the " > "system log, and removing the connection or the journal. This option can= be " > "used together with B<--stderr> for testing purposes." > -- > Man page: logger.1 > Issue: Missing markup of parameters > > "B currently generates the B standardized element on= ly. " > "RFC 5424 also describes the elements B (with parameters ip, " > "enterpriseId, software and swVersion) and B (with parameters " > "sequenceId, sysUpTime and language). These element IDs may be specified= " > "without the B<@>I suffix." > -- > Man page: logger.1 > Issue: Missing markup file names, command names etc. > > "Print errors about Unix socket connections. The I can be a value = of " > "B, B, or B. When the mode is auto logger will detect if = the " > "init process is systemd, and if so assumption is made /dev/log can be us= ed " > "early at boot. Other init systems lack of /dev/log will not cause error= s " > "that is identical with messaging using B(3) system call. The = " > "B(1) before version 2.26 used openlog, and hence was unable to = " > "detected loss of messages sent to Unix sockets." > -- > Man page: logger.1 > Issue: The =C2=BBto=C2=AB marks a range inside a list. Shouldn't be bold. > > msgid "B< to>" > -- > Man page: logger.1 > Issue: Missing markup for command name > > "The logger command is part of the util-linux package and is available fr= om " > "E<.UR https://\\:www.kernel.org\\:/pub\\:/linux\\:/utils\\:/util-linux/>= " > "Linux Kernel Archive E<.UE .>" > -- > Man page: login.1 > Issue: Missing full stop > > "The default is to check I and if it does not exist t= hen " > "I<~/.hushlogin>" > > "If set, it will be used to define the PATH environment variable when a " > "regular user logs in. The default value is I "\\:/usr\\:/bin>" > -- > Man page: login.1 > Issue: Missing markup for lastlog > > "Highest user ID number for which the lastlog entries should be updated. = As " > "higher user IDs are usually tracked by remote user identity and " > "authentication services there is no need to create a huge sparse lastlog= " > "file for them. No LASTLOG_UID_MAX option present in the configuration m= eans " > "that there is no user ID limit for writing lastlog entries." > -- > Man page: login.1 > Issue: Missing markup for command name > > "A recursive login, as used to be possible in the good old days, no longe= r " > "works; for most purposes B(1) is a satisfactory substitute. Indeed= , " > "for security reasons, login does a vhangup() system call to remove any " > "possible listening processes on the tty. This is to avoid password " > "sniffing. If one uses the command B, then the surrounding shell = gets " > "killed by vhangup() because it's no longer the true owner of the tty. T= his " > "can be avoided by using B in a top-level shell or xterm." > -- > Man page: login.1 > Issue: Missing markup for command name > > "The login command is part of the util-linux package and is available fro= m E<." > "UR https://\\:www.kernel.org\\:/pub\\:/linux\\:/utils\\:/util-linux/> Li= nux " > "Kernel Archive E<.UE .>" > -- > Man page: lscpu.1 > Issue: superfluous quoting around B<> > > "When specifying the I argument, the string of option, equal sign (= =3D), " > "and I must not contain any blanks or other whitespace. Examples: = 'B<-" > "C=3DNAME,ONE-SIZE>' or 'B<--caches=3DNAME,ONE-SIZE>'." > -- > Man page: lslogins.1 > Issue: specify =E2=86=92 specified, than =E2=86=92 then > > "Note that relation between user and group may be invisible for primary g= roup " > "if the user is not explicitly specify as group member (e.g., in /etc/gro= up). " > "If the command lslogins scans for groups than it uses groups database on= ly, " > "and user database with primary GID is not used at all." > -- > Man page: lslogins.1 > Issue: IDS =E2=86=92 IDs > > "Only show data of users with a login specified in I (user names = or " > "user IDS). More than one login may be specified; the list has to be com= ma-" > "separated. The unknown login names are ignored." > -- > Man page: lslogins.1 > Issue: Markup and closing bracket are wrongly interleaved > > msgid "Display information related to login by password (see also B<-afL)= .>" > -- > Man page: lsmem.1 > Issue: output compatible =E2=86=92 output is compatible > > "The default output compatible with original implementation from s390-too= ls, " > "but it's strongly recommended to avoid using default outputs in your " > "scripts. Always explicitly define expected columns by using the B<--out= put> " > "option together with a columns list in environments where a stable outpu= t is " > "required." > -- > Man page: lsmem.1 > Issue: First sentence: Broken? > > "The B command lists a new memory range always when the current me= mory " > "block distinguish from the previous block by some output column. This " > "default behavior is possible to override by the B<--split> option (e.g.,= " > "B). The special word \"none\" may be used to ign= ore " > "all differences between memory blocks and to create as large as possible= " > "continuous ranges. The opposite semantic is B<--all> to list individual= " > "memory blocks." > -- > Man page: lsns.8 > Issue: 2nd sentence broken wording > > "B column, printed when B is specified for B<--type> option, i= s " > "special; it uses multi-line cells. Use the option B<--nowrap> is for " > "switching to \",\" separated single-line representation." > -- > Man page: mkswap.8 > Issue: No such section in swapon.8 > > "Please read notes from B(8) about B " > "(holes, preallocation and copy-on-write issues)." > -- > Man page: mount.8 > Issue: bythe =E2=86=92 by the > > "The same filesystem may be mounted more than once, and in some cases (e.= g., " > "network filesystems) the same filesystem may be mounted on the same " > "mountpoint more times. The mount command does not implement any policy t= o " > "control this behavior. All behavior is controlled by the kernel and it i= s " > "usually specific to the filesystem driver. The exception is B<--all>, in= " > "this case already mounted filesystems are ignored (see B<--all> below fo= r " > "more details)." > -- > Man page: mount.8 > Issue: disables B<--options-source-force> =E2=86=92 enables! > > "Source of default options. I is comma separated list of B, " > "B and B. B disables B and B and " > "disables B<--options-source-force>. Default value is B." > -- > Man page: mount.8 > Issue: The wording is rather unusual english, improve? > > "Note that specify B<-w> on command line forces B command to never= try " > "read-only mount on write-protected devices. The default is try read-only= if " > "the previous mount syscall with read-write flags failed." > -- > Man page: mount.8 > Issue: Does this include other executable like scripts? > > msgid "Permit execution of binaries." > -- > Man page: mount.8 > Issue: maintain =E2=86=92 maintaining > > "The same as B options, but stored permanently in the user space. It= " > "means the options are also available for umount or another operations. = Note " > "that maintain mount options in user space is tricky, because it's necess= ary " > "use libmount based tools and there is no guarantee that the options will= be " > "always available (for example after a move mount operation or in unshare= d " > "namespace)." > -- > Man page: mount.8 > Issue: mount =E2=86=92 B > > "Allow to make a target directory (mountpoint) if it does not exit yet. = The " > "optional argument I specifies the filesystem access mode used for = " > "B(2) in octal notation. The default mode is 0755. This " > "functionality is supported only for root users or when mount executed " > "without suid permissions. The option is also supported as x-mount.mkdir= , " > "this notation is deprecated since v2.30." > -- > Man page: mount.8 > Issue: URL does not allow login (2019-01-29) > > "A remount option which permits online expansion of reiserfs partitions. = " > "Instructs reiserfs to assume that the device has I blocks. This= " > "option is designed for use with devices which are under logical volume " > "management (LVM). There is a special I utility which can be " > "obtained from I." > -- > Man page: mount.8 > Issue: man page is no longer available from the attr project: http://git.= savannah.nongnu.org/cgit/attr.git/tree/man > > msgid "Enable Extended User Attributes. See the B(1) manual page.= " > -- > Man page: mount.8 > Issue: Nowadays it is only called macOS > > "For filesystems created by OpenStep (currently read only). The same " > "filesystem type is also used by Mac OS X." > -- > Man page: nologin.8 > Issue: Missing markup for command name > > "If the file /etc/nologin.txt exists, nologin displays its contents to th= e " > "user instead of the default message." > > "The nologin command is part of the util-linux package and is available f= rom " > "E<.UR https://\\:www.kernel.org\\:/pub\\:/linux\\:/utils\\:/util-linux/>= " > "Linux Kernel Archive E<.UE .>" > -- > Man page: nsenter.1 > Issue: The second sentence is missing a =C2=BBin B(2).=C2=AB? > > "Children will have a set of PID to process mappings separate from the " > "B process For further details, see B(7) and th= e " > "discussion of the B flag in B will fork by defaul= t if " > "changing the PID namespace, so that the new program and its children sha= re " > "the same PID namespace and are visible to each other. If B<--no-fork> i= s " > "used, the new program will be exec'ed without forking." > -- > Man page: raw.8 > Issue: Superfluous space after B<-q> > > msgid "With B<-q> , specify that all bound raw devices should be queried.= " > -- > Man page: rfkill.8 > Issue: B =E2=86=92 BI > > msgid "B|B [...]" > > msgid "B|B [...]" > -- > Man page: rtcwake.8 > Issue: to terminal =E2=86=92 the terminal > > "The suspend setup may be interrupted by active hardware; for example " > "wireless USB input devices that continue to send events for some fractio= n of " > "a second after the return key is pressed. B tries to avoid thi= s " > "problem and it waits to terminal to settle down before entering a system= " > "sleep." > -- > Man page: runuser.1 > Issue: Markup missing and copy =E2=86=92 sync? > > "Create pseudo-terminal for the session. The independent terminal provide= s " > "better security as user does not share terminal with the original sessio= n. " > "This allow to avoid TIOCSTI ioctl terminal injection and another securit= y " > "attacks against terminal file descriptors. The all session is also possi= ble " > "to move to background (e.g., \"runuser --pty -u username -- command &\")= . " > "If the pseudo-terminal is enabled then runuser command works as a proxy = " > "between the sessions (copy stdin and stdout)." > -- > Man page: script.1 > Issue: B =E2=86=92 B(1) > > "B