From owner-freebsd-bugs@freebsd.org Mon Mar 19 16:31:26 2018 Return-Path: Delivered-To: freebsd-bugs@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 595EBF59711 for ; Mon, 19 Mar 2018 16:31:26 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mxrelay.ysv.freebsd.org (mxrelay.ysv.freebsd.org [IPv6:2001:1900:2254:206a::19:3]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mxrelay.ysv.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id E37E37823D for ; Mon, 19 Mar 2018 16:31:25 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2001:1900:2254:206a::16:76]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.ysv.freebsd.org (Postfix) with ESMTPS id 4159026755 for ; Mon, 19 Mar 2018 16:31:25 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org ([127.0.1.118]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id w2JGVPJo038808 for ; Mon, 19 Mar 2018 16:31:25 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id w2JGVPhr038807 for freebsd-bugs@FreeBSD.org; Mon, 19 Mar 2018 16:31:25 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: www set sender to bugzilla-noreply@freebsd.org using -f From: bugzilla-noreply@freebsd.org To: freebsd-bugs@FreeBSD.org Subject: [Bug 226731] man command ignores trailing versioning info Date: Mon, 19 Mar 2018 16:31:25 +0000 X-Bugzilla-Reason: AssignedTo X-Bugzilla-Type: new X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Base System X-Bugzilla-Component: bin X-Bugzilla-Version: 10.3-RELEASE X-Bugzilla-Keywords: X-Bugzilla-Severity: Affects Some People X-Bugzilla-Who: freebsd@dreamchaser.org X-Bugzilla-Status: New X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: freebsd-bugs@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: bug_id short_desc product version rep_platform op_sys bug_status bug_severity priority component assigned_to reporter Message-ID: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated MIME-Version: 1.0 X-BeenThere: freebsd-bugs@freebsd.org X-Mailman-Version: 2.1.25 Precedence: list List-Id: Bug reports List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Mar 2018 16:31:26 -0000 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D226731 Bug ID: 226731 Summary: man command ignores trailing versioning info Product: Base System Version: 10.3-RELEASE Hardware: Any OS: Any Status: New Severity: Affects Some People Priority: --- Component: bin Assignee: freebsd-bugs@FreeBSD.org Reporter: freebsd@dreamchaser.org The man command ignores trailing versioning information: ls /usr/local/man/man1/autoconf* autoconf-2.69.1.gz $ man autoconf No manual entry for autoconf $ man autoconf-2 No manual entry for autoconf-2 $ man autoconf-2.69 (works) This forces a user to do directory searches along manpath to find the proper name to use to get the man command to work. There are a number of man pages with this problem, primarily in the man(1) section: /usr/local/man$ find . -print | grep -e "[a-z]*-[-,0-9\.]*.[1-9].gz" | wc 36 36 1009 If man fails to find a match, it would be helpful if it did something like the following: Inform the user, as it does now. Find all man pages which match the pattern (I may have this wrong...): -[-,0-9,\.]*.[1-9].gz Inform the user of these results Do zero or more of the following: Ask the user to enter a new name based on the search results If only one result, ask the user if that's what they wanted Don't just deliver this unannounced, as it might not be the desired page, and would make the single result scroll off the top (it would likely be skipped by a user scanning the output anyway, unless hilighted in color.) If the man command remains unchanged, then the install process for ports=20 should disallow the installation of man pages with versioning information, or at least produce warnings. The make.conf entry "DEVELOPER=3Dyes" should cause this to be checked. In terms of port checking for developers,=20 warnings should also be produced for man pages with major version numbers on the end as well, such as perl5. A naive user might be frustrated=20 when typing "man perl" if nothing appears. Some ports such as gimp and valac provide symlinks to solve the problem; others, like autoconf, are particular problems. If man is not changed, bugs should be filed against at least the following ports (I don't have all that many installed, so I have no idea what the extent of the problem is): autoconf automake aclocal (xorg-macros?) gtk3 (gtk-query-immodules-3.0.1.gz) gstreamer gimp (gimptool-2.0.1.gz) vala (vapigen-0.36.1.gz) --=20 You are receiving this mail because: You are the assignee for the bug.=