Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.
For bugs related to Red Hat Enterprise Linux 5 product line. The current stable release is 5.10. For Red Hat Enterprise Linux 6 and above, please visit Red Hat JIRA https://issues.redhat.com/secure/CreateIssue!default.jspa?pid=12332745 to report new issues.

Bug 578289

Summary: less online help is incorrect for the descriptions of some options
Product: Red Hat Enterprise Linux 5 Reporter: Jeff Bastian <jbastian>
Component: lessAssignee: Nikola Pajkovsky <npajkovs>
Status: CLOSED ERRATA QA Contact: Petr Šplíchal <psplicha>
Severity: medium Docs Contact:
Priority: medium    
Version: 5.5CC: dhoward, fnadge, ohudlick, ovasik, psplicha, syeghiay
Target Milestone: rcKeywords: Patch, Regression
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Previously, the less --help contained incorrect descriptions of some options. With this update, all options are described correctly.
Story Points: ---
Clone Of:
: 644858 650762 (view as bug list) Environment:
Last Closed: 2010-10-27 16:24:44 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 650762    
Attachments:
Description Flags
patch to update online help none

Description Jeff Bastian 2010-03-30 19:13:28 UTC
Description of problem:
Some options described in 'less --help' are misleading, for example:
  -n  -N  ....  --line-numbers  --LINE-NUMBERS
                  Don't use line numbers.

The lower-case -n and --line-numbers does suppress line numbers as described, however, the upper-case -N and --LINE-NUMBERS enables the line-numbers.  This should be split into multiple lines:
  -n  ........  --line-numbers
                  Don't use line numbers.
  -N  ........  --LINE-NUMBERS
                  Use line numbers.

Also, the upper-case -C and --CLEAR-SCREEN are missing from 'less --help'.  

These options were correctly described in RHEL 5.4's less.


Version-Release number of selected component (if applicable):
less-436-2.el5

How reproducible:
every time

Steps to Reproduce:
1. less --help
2. look for -N and --LINE-NUMBER
3. look for -C and --CLEAR-SCREEN
  
Actual results:
-N and --LINE-NUMBER are described as "Don't use line numbers."
-C and --CLEAR-SCREEN are not described

Expected results:
-N and --LINE-NUMBER are described as "Use line numbers."
-C and --CLEAR-SCREEN are defined with -c and -clear-screen

Additional info:
The less(1) man page describes both options correctly:
       -c or --clear-screen
              Causes  full  screen  repaints  to  be painted from the top line
              down.  By default, full screen repaints are  done  by  scrolling
              from the bottom of the screen.

       -C or --CLEAR-SCREEN
              Same as -c, for compatibility with older versions of less.

       ...

       -n or --line-numbers
              Suppresses line numbers.  The default (to use line numbers)  may
              cause  less  to run more slowly in some cases, especially with a
              very large input file.  Suppressing line  numbers  with  the  -n
              option  will  avoid this problem.  Using line numbers means: the
              line number will be displayed in the verbose prompt and in the =
              command,  and the v command will pass the current line number to
              the editor (see also  the  discussion  of  LESSEDIT  in  PROMPTS
              below).

       -N or --LINE-NUMBERS
              Causes  a  line  number to be displayed at the beginning of each
              line in the display.

Comment 2 Jeff Bastian 2010-03-30 19:55:18 UTC
Created attachment 403586 [details]
patch to update online help

Comment 9 Florian Nadge 2010-10-18 17:10:15 UTC
    Technical note added. If any revisions are required, please edit the "Technical Notes" field
    accordingly. All revisions will be proofread by the Engineering Content Services team.
    
    New Contents:
Previously, the less --help contained incorrect descriptions of some options. With this update, all options are described correctly.

Comment 13 errata-xmlrpc 2010-10-27 16:24:44 UTC
An advisory has been issued which should help the problem
described in this bug report. This report is therefore being
closed with a resolution of ERRATA. For more information
on therefore solution and/or where to find the updated files,
please follow the link below. You may reopen this bug report
if the solution does not work for you.

http://rhn.redhat.com/errata/RHBA-2010-0805.html