IZ2841: submit(1) man page reports that qrsh does not support -display option

[mpospisil]

[Imported from gridengine issuezilla ​http://gridengine.sunsource.net/issues/show_bug.cgi?id=2841]

        Issue #:      2841             Platform:     All      Reporter: mpospisil (mpospisil)
       Component:     gridengine          OS:        All
     Subcomponent:    man              Version:      6.0         CC:    None defined
        Status:       NEW              Priority:     P3
      Resolution:                     Issue type:    DEFECT
                                   Target milestone: ---
      Assigned to:    mpospisil (mpospisil)
      QA Contact:     andreas
          URL:
       * Summary:     submit(1) man page reports that qrsh does not support -display option
   Status whiteboard:
      Attachments:

     Issue 2841 blocks:
   Votes for issue 2841:


   Opened: Wed Dec 17 11:14:00 -0700 2008 
------------------------


The help output from the qrsh command includes the -display option as being
supported, yet in the submit(1) man page, it is written that the -display option
is only supported by qsh.

>qrsh -help
GE 6.2
usage: qrsh [options]
   [-ac context_list]                       add context variable(s)
   [-A account_string]                      account string in accounting record
   [-b y[es]|n[o]]                          handle command as binary
   [-clear]                                 skip previous definitions for job
   [-cwd]                                   use current working directory
   [-dc simple_context_list]                delete context variable(s)
   [-display display]                       set display to display interactive job

However the output of the man page states the following:
...
-display display_specifier
          Available for qsh only.

          Directs xterm(1) to use display_specifier in  order  to
          contact  the  X  server.   The display_specifier has to
          contain the hostname part of  the  display  name  (e.g.
          myhost:1). Local display names (e.g. :0) cannot be used
          in grid environments.  Values  set  with  the  -display
          option  overwrite settings from the submission environ-
          ment and from -v command line options.

   ------- Additional comments from reuti Wed Dec 17 11:39:50 -0700 2008 -------
But AFAICS it's *not* supported, so the -help is wrong, not the man page.

   ------- Additional comments from reuti Wed Dec 17 11:42:21 -0700 2008 -------
Okay, it depends whether it's an interactive or non-interactive qrsh. So both are wrong or right. This
should be mentioned in addition.

[Dave Love <d.love@…>]

In [3955/sge]:

(The changeset message doesn't reference this ticket)