View Issue Details
| ID | Project | Category | View Status | Date Submitted | Last Update |
|---|---|---|---|---|---|
| 0000214 | 1003.1(2008)/Issue 7 | Shell and Utilities | public | 2010-01-15 14:03 | 2013-04-16 13:06 |
| Reporter | Konrad_Schwarz | Assigned To | ajosey | ||
| Priority | normal | Severity | Editorial | Type | Clarification Requested |
| Status | Closed | Resolution | Accepted As Marked | ||
| Name | Konrad Schwarz | ||||
| Organization | Siemens AG | ||||
| User Reference | dot-return | ||||
| Section | http://www.opengroup.org/onlinepubs/9699919799/utilities/V3_chap02.html#dot | ||||
| Page Number | 2341 | ||||
| Line Number | 74026-74031 | ||||
| Interp Status | --- | ||||
| Final Accepted Text | 0000214:0000380 | ||||
| Summary | 0000214: "dot" should mention the effect of `return' | ||||
| Description | The description of "dot" never mentions `return'. | ||||
| Desired Action | Add a new paragraph at the end of DESCRIPTION: The `return' utility shall cause the shell to stop executing the dot script. Or mention `return' explicitly in the SEE ALSO list, despite it being subsumed by the `Special Built-In Utilities' already mentioned there. | ||||
| Tags | tc1-2008 | ||||
|
|
I don't understand why anything needs to be said about the return special built-in utility in the description of the dot special built-in utility. The EXIT STATUS section of the dot utility description already says that the exit status will be the exit status of the last command exeuted in file. And, the description of the return special built-in utility says that it will cause the shell to stop executing the current function or dot script. |
|
|
This change would be purely for the reader's convenience. I agree that the current version of the standard is complete. Is "Editorial"/"Clarification Requested" not the right classification for such a change request? |
|
|
In austin-group-l:archive/latest/13351 Konrad Schwarz says: In POSIX, "return" is defined solely for dot scripts and shell functions. Given its limited scope, I think there is a certain justification for referring to it from those two scopes. And indeed, 2.8.5, "Function Definition Command", does mention the special effect of return: "If the special built-in _return_ is executed in the _compound-command_, the function completes [...]." I also just noticed that the "return" NAME section currently reads "return from a function". This could be extended, e.g., to "return from a function or script". |
|
|
Page 2342 line 74074 add (add a cross reference to return special built-in utility to the See Also list) Page 2356 line 74480 add to the See Also list references to: Section 2.9.5 Function Definition Command dot special built-in Page 2324 line 73400 after the word return add: (a cross-reference to the return special built in utility) p 2355 l74432 add to the end of the line: "or dot script" |
| Date Modified | Username | Field | Change |
|---|---|---|---|
| 2010-01-15 14:03 | Konrad_Schwarz | New Issue | |
| 2010-01-15 14:03 | Konrad_Schwarz | Status | New => Under Review |
| 2010-01-15 14:03 | Konrad_Schwarz | Assigned To | => ajosey |
| 2010-01-15 14:03 | Konrad_Schwarz | Name | => Konrad Schwarz |
| 2010-01-15 14:03 | Konrad_Schwarz | Organization | => Siemens AG |
| 2010-01-15 14:03 | Konrad_Schwarz | User Reference | => dot-return |
| 2010-01-15 14:03 | Konrad_Schwarz | Section | => http://www.opengroup.org/onlinepubs/9699919799/utilities/V3_chap02.html#dot |
| 2010-01-15 14:03 | Konrad_Schwarz | Page Number | => 0 |
| 2010-01-15 14:03 | Konrad_Schwarz | Line Number | => 0 |
| 2010-01-15 19:53 | Don Cragun | Page Number | 0 => 2341 |
| 2010-01-15 19:53 | Don Cragun | Line Number | 0 => 74026-74031 |
| 2010-01-15 19:53 | Don Cragun | Interp Status | => --- |
| 2010-01-15 19:53 | Don Cragun | Note Added: 0000374 | |
| 2010-01-18 08:01 | Konrad_Schwarz | Note Added: 0000376 | |
| 2010-01-21 16:47 | nick | Note Added: 0000379 | |
| 2010-01-21 17:10 | msbrown | Note Added: 0000380 | |
| 2010-01-21 17:10 | msbrown | Status | Under Review => Resolved |
| 2010-01-21 17:10 | msbrown | Resolution | Open => Accepted As Marked |
| 2010-01-21 17:11 | msbrown | Final Accepted Text | => 0000214:0000380 |
| 2010-01-21 17:12 | msbrown | Note Edited: 0000380 | |
| 2010-08-27 12:53 | ajosey | Tag Attached: tc1-2008 | |
| 2013-04-16 13:06 | ajosey | Status | Resolved => Closed |
