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 453409

Summary: man page alteration for suspend command
Product: Red Hat Enterprise Linux 5 Reporter: Adam Stokes <astokes>
Component: bashAssignee: Roman Rakus <rrakus>
Status: CLOSED ERRATA QA Contact: Ben Levenson <benl>
Severity: low Docs Contact:
Priority: medium    
Version: 5.2CC: tagoh, tao, tsmetana
Target Milestone: rc   
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2009-01-20 21:10:23 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:
Attachments:
Description Flags
man page update none

Description Adam Stokes 2008-06-30 13:30:39 UTC 
Description of Problem:
We tested suspend command.

There is a comment in the manpage of suspend.
suspend [-f]
   The -f option says not to complain if this is a login shell; just suspend
   anyway.

Please see the Japanese_suspend_man.txt in the additional info for JPN man.
The contents in this man page can be understood like "suspend command" works in
any case.
However, when user executes suspend command on login shell during remote
connecting, the error messages is output.

[error message]
# suspend
-bash: suspend: cannot suspend a login shell

The result is different from man page's description.

We hope that manpage of suspend is fixed, because we think man page should be
modified to get higher quality.

We will suggest to correct man page as follows:

[draft manpage of suspend]
The suspend command can not suspend the login shell.
However, when -f option is specified, suspend command can suspend even login shell.


Version-Release number of selected component:

Red Hat Enterprise Linux Server release 5.1 (Tikanga)
Architecture: ia64
Kernel Version: kernel-2.6.18-53.el5
bash-3.1-16.1

Drivers or hardware or architecture dependency:
None.

How reproducible:
Always

Step to Reproduce:
Execute suspend command on login shell during remote connecting.

# suspend
-bash: suspend: cannot suspend a login shell


Actual Results:
Description in man page is different from actual operation.

Expected Results:
Description in man page is same with actual operation.
Comment 1 Adam Stokes 2008-06-30 13:30:39 UTC 
Created attachment 310582 [details]
man page update
Comment 2 Roman Rakus 2008-07-11 13:06:19 UTC 
English version I can easily update, but Japanese version is in man-pages-ja
package. Adding Akira Tagoh to CC, maybe he can update Japanese man page.
Comment 3 Roman Rakus 2008-07-11 13:28:44 UTC 
       suspend [-f]
              Suspend  the execution of this shell until it receives a SIGCONT
              signal. The suspend command can not  suspend  the  login  shell.
              However,  when  -f option is specified, suspend command can sus-
              pend even login shell.  The return status is 0 unless the  shell
              is  a  login  shell and -f is not supplied, or if job control is
              not enabled.


Is this English version ok?
Comment 5 RHEL Program Management 2008-07-11 14:01:12 UTC 
This request was evaluated by Red Hat Product Management for inclusion in a Red
Hat Enterprise Linux maintenance release.  Product Management has requested
further review of this request by Red Hat Engineering, for potential
inclusion in a Red Hat Enterprise Linux Update release for currently deployed
products.  This request is not yet committed for inclusion in an Update
release.
Comment 11 errata-xmlrpc 2009-01-20 21:10:23 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-2009-0116.html