Project

General

Profile

Actions

Bug #14721

closed

getopt(1) erroneously says scheduled for removal.

Added by Dan Cross 4 months ago. Updated 4 months ago.

Status:
Closed
Priority:
Low
Assignee:
Category:
manpage - manual pages
Start date:
Due date:
% Done:

100%

Estimated time:
Difficulty:
Bite-size
Tags:
Gerrit CR:
External Bug:

Description

getopt(1) includes this paragraph:

       getopt will not be supported in the next major release. For this
       release a conversion tool has been provided, namely, getoptcvt. For
       more information, see getopts(1) and getoptcvt(1).

This dates back to at least Solaris 2.5.1: https://www.freebsd.org/cgi/man.cgi?query=getopt&apropos=0&sektion=0&manpath=SunOS+5.5.1&arch=default&format=html

This came up recently when porting the KVM unit tests to illumos to run under Bhyve (https://marc.info/?l=kvm&m=165295398911648&w=2).

The reality is that there are enough shell scripts in the wild that `getopt` is probably never going to be removed, as imperfect as it may be. That paragraph is 30 years old, and simply inaccurate. It should be removed.

Actions #1

Updated by Electric Monk 4 months ago

  • Gerrit CR set to 2168
Actions #2

Updated by Dan Cross 4 months ago

Testing notes: `git pbchk` is clean, and I diff'ed the nroff'ed output from the new and old man pages and the only differences were the expected bits.

Actions #3

Updated by Dan Cross 4 months ago

Fix integrated.

Actions #4

Updated by Electric Monk 4 months ago

  • Status changed from New to Closed
  • % Done changed from 0 to 100

git commit feea3b2dd6c0c3b59dfb1ab0f992b01906567d90

commit  feea3b2dd6c0c3b59dfb1ab0f992b01906567d90
Author: Dan Cross <cross@oxidecomputer.com>
Date:   2022-06-02T19:26:43.000Z

    14721 getopt(1) erroneously says scheduled for removal.
    Reviewed by: Andy Fiddaman <andy@omnios.org>
    Reviewed by: Peter Tribble <peter.tribble@gmail.com>
    Approved by: Dan McDonald <danmcd@mnx.io>

Actions

Also available in: Atom PDF