Bug 578289 - less online help is incorrect for the descriptions of some options
Summary: less online help is incorrect for the descriptions of some options
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Red Hat Enterprise Linux 5
Classification: Red Hat
Component: less
Version: 5.5
Hardware: All
OS: Linux
medium
medium
Target Milestone: rc
: ---
Assignee: Nikola Pajkovsky
QA Contact: Petr Šplíchal
URL:
Whiteboard:
Depends On:
Blocks: 650762
TreeView+ depends on / blocked
 
Reported: 2010-03-30 19:13 UTC by Jeff Bastian
Modified: 2018-10-27 13:58 UTC (History)
6 users (show)

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.
Clone Of:
: 644858 650762 (view as bug list)
Environment:
Last Closed: 2010-10-27 16:24:44 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)
patch to update online help (4.38 KB, patch)
2010-03-30 19:55 UTC, Jeff Bastian
no flags Details | Diff


Links
System ID Private Priority Status Summary Last Updated
Red Hat Product Errata RHBA-2010:0805 0 normal SHIPPED_LIVE less bug fix update 2010-10-27 16:24:40 UTC

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


Note You need to log in before you can comment on or make changes to this bug.