guile-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Incorrect documentation for system, system*, and/or waitpid?


From: Chris Marusich
Subject: Re: Incorrect documentation for system, system*, and/or waitpid?
Date: Sun, 14 Oct 2018 13:22:02 -0700
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/26.1 (gnu/linux)

Hi Mark,

Thank you for the reply!

Mark H Weaver <address@hidden> writes:

>> I see.  Then what's the intended use of status:exit-val?  I've read its
>> documentation and viewed its source a few times, and it seems like this
>> procedure basically behaves like the identity function.
>
> I'm not sure where you got that idea, but it's definitely not the
> identity function.

I didn't realize that additional information was encoded in the integer
status value.  That explains why I was confused.

>> I'm having trouble thinking of a case where one would use
>> status:exit-val instead of simply using the integer status value
>> directly.
>
> There's one case where you can use the integer status value directly:
> you can check if it's zero, and if it is, that indicates that the
> program exited normally with zero exit value.
>
> If the status value is non-zero, and you want to know more information
> about what happened, then you must use the status:* procedures.

This makes sense now.

> [...] I wonder if it would be enough to simply change "process status
> code" to "integer status value" [...].

I agree.  I've attached a new patch that makes the change.  It also adds
a cross-reference that I think is helpful.  How does it look?

-- 
Chris

Attachment: 0001-Clarify-the-manual-s-Processes-section.patch
Description: Text Data

Attachment: signature.asc
Description: PGP signature


reply via email to

[Prev in Thread] Current Thread [Next in Thread]