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 Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 967EBC4332F for ; Tue, 18 Oct 2022 20:19:51 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230118AbiJRUTt (ORCPT ); Tue, 18 Oct 2022 16:19:49 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:49638 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230077AbiJRUTl (ORCPT ); Tue, 18 Oct 2022 16:19:41 -0400 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 092E1B7C9 for ; Tue, 18 Oct 2022 13:19:38 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id 382F7616FD for ; Tue, 18 Oct 2022 20:19:37 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPS id 9D013C4347C for ; Tue, 18 Oct 2022 20:19:36 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1666124376; bh=lDXchm9prztb6Q3Pc3C0/8JKNnczrajTPeQmQYKJWFs=; h=From:To:Subject:Date:In-Reply-To:References:From; b=L0LeleOVk/3J4zmvtcA8UbfBEBV78hGkkFDphQvHr8S/gK7pr++hWLp1fbYKl8UoL ZNrNGHsz6v4ZSiMJu8f/0XWVY4rbvvYl30Mp5tjXoNEyE5oByH/B6xSUZbc7rTXPCS 4P92ThEcsTBZd8FNPUkIDKorin6BkEw7QIKtImIUoJHJ/ON+DoaiTs/qE/FFmB//re GKhKPH7GnZyrSbpH64Dj9+VM470GJaLl60e7zg1DYFHRuw2ifDnuCQr6FJJDYz3has hApbOVRQGVq+7R1nKXv35iYSJl7Ceq6Xd9OnXdFkxBYwC2CZXCJedL/H2wbsr5mRmJ OGa61+jtZZOkw== Received: by aws-us-west-2-korg-bugzilla-1.web.codeaurora.org (Postfix, from userid 48) id 88CEDC05FD6; Tue, 18 Oct 2022 20:19:36 +0000 (UTC) From: bugzilla-daemon@kernel.org To: linux-man@vger.kernel.org Subject: [Bug 216603] Environment variable MANLESS is described wrong in man(1) Date: Tue, 18 Oct 2022 20:19:36 +0000 X-Bugzilla-Reason: None X-Bugzilla-Type: changed X-Bugzilla-Watch-Reason: AssignedTo documentation_man-pages@kernel-bugs.osdl.org X-Bugzilla-Product: Documentation X-Bugzilla-Component: man-pages X-Bugzilla-Version: unspecified X-Bugzilla-Keywords: X-Bugzilla-Severity: normal X-Bugzilla-Who: karttu@gmail.com X-Bugzilla-Status: NEW X-Bugzilla-Resolution: X-Bugzilla-Priority: P1 X-Bugzilla-Assigned-To: documentation_man-pages@kernel-bugs.osdl.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: Message-ID: In-Reply-To: References: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugzilla.kernel.org/ Auto-Submitted: auto-generated MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-man@vger.kernel.org https://bugzilla.kernel.org/show_bug.cgi?id=3D216603 --- Comment #2 from karttu@gmail.com --- Hi Alex, and Colin, I've never reported any man page bugs before and I basically searched "reporting man page bugs" and ended up at Reporting man-pages bugs (kernel.org) . But of course man(1) is an exception :/ Found the issue reporting from GitLab, so it will be there. Best Regards, - Arttu On Tue, 18 Oct 2022 at 23:05, Alejandro Colomar wrote: > Hi Arttu, > > On 10/18/22 21:55, bugzilla-daemon@kernel.org wrote: > > https://bugzilla.kernel.org/show_bug.cgi?id=3D216603 > > > > Bug ID: 216603 > > Summary: Environment variable MANLESS is described wrong in > > man(1) > > Product: Documentation > > Version: unspecified > > Hardware: All > > OS: Linux > > Status: NEW > > Severity: normal > > Priority: P1 > > Component: man-pages > > Assignee: documentation_man-pages@kernel-bugs.osdl.org > > Reporter: karttu+bugzilla@gmail.com > > Regression: No > > > > In an example for setting MANLESS environment variable, man(1) claims: > > > > For example, if you want to set the prompt string unconditionally > > to "my prompt string", set $MANLESS to '-Psmy prompt string'. > > > > However, this is not not correct as man uses the entire MANLESS variable > > as a prompt for less. I'll demonstrate: > > > > $ MANLESS=3D'-Ps(prompt)' man man > > > > $ cat /proc/$(pgrep -P $(pgrep -f "man man"))/environ | > > tr '\0' '\n' | grep "^LESS=3D" > > > > LESS=3D-ix8RmPm-Ps(prompt)$PM-Ps(prompt)$ > > > > As seen, man(1) defines -Pm and -PM prompts using the MANLESS variable > as is. > > The same applies to the command line option -r: > > > > $ man -r'-Ps(prompt)' man > > > > $ cat /proc/$(pgrep -P $(pgrep -f "man .* man"))/environ | > > tr '\0' '\n' | grep "^LESS=3D" > > > > LESS=3D-ix8RmPm-Ps(prompt)$PM-Ps(prompt)$ > > > > Option -r does not make the same claim, but it says: > > > > By default man sets the -ix8 options. > > > > Which also is a bit outdated as we can see it sets -ix8R. > > > > So in summary, at least the '-Ps' part should be removed from the MANLE= SS > > description example. Furthermore, option -r description could elaborate > on > > how LESS variable is formed (-ix8RmPm$PM$= ). > > > > Note: Dollar sign in less prompt definition is an end-of-string marker. > > > > The man(1) page is part of the man-db project, not the Linux man-pages. > Colin is the maintainer of man-db, so I CCd him. > > Their website is: > > > > However, I'm curious about the resolution, so if you report it again in > the man-db bug tracker (I guess that's their gitlab? don't remember), > please CC me. :) > > Cheers, > > Alex > > -- > > --=20 You may reply to this email to add a comment. You are receiving this mail because: You are watching the assignee of the bug.=