Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

ExitStatus: print "exit status: {}" rather than "exit code: {}" on unix #83462

Merged
merged 1 commit into from
Mar 27, 2021

Commits on Mar 25, 2021

  1. ExitStatus: print "exit status: {}" rather than "exit code: {}"

    Proper Unix terminology is "exit status" (vs "wait status").  "exit
    code" is imprecise on Unix and therefore unclear.  (As far as I can
    tell, "exit code" is correct terminology on Windows.)
    
    This new wording is unfortunately inconsistent with the identifier
    names in the Rust stdlib.
    
    It is the identifier names that are wrong, as discussed at length in eg
      https://doc.rust-lang.org/nightly/std/process/struct.ExitStatus.html
      https://doc.rust-lang.org/nightly/std/os/unix/process/trait.ExitStatusExt.html
    
    Unfortunately for API stability reasons it would be a lot of work, and
    a lot of disruption, to change the names in the stdlib (eg to rename
    `std::process::ExitStatus` to `std::process::ChildStatus` or
    something), but we should fix the message output.  Many (probably
    most) readers of these messages about exit statuses will be users and
    system administrators, not programmers, who won't even know that Rust
    has this wrong terminology.
    
    So I think the right thing is to fix the documentation (as I have
    already done) and, now, the terminology in the implementation.
    
    This is a user-visible change to the behaviour of all Rust programs
    which run Unix subprocesses.  Hopefully no-one is matching against the
    exit status string, except perhaps in tests.
    
    Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
    ijackson committed Mar 25, 2021
    Configuration menu
    Copy the full SHA
    11e40ce View commit details
    Browse the repository at this point in the history