Earlier, I wrote:

> OK.  I'll submit a patch later this week to update the manual with
> information taken from this email thread.  Hopefully that will help
> clarify the behavior for others in the future.

Please find the promised patch attached.  It's still this week, isn't
it? :-)

As a Guile newbie, I found the behavior related to multiple values to be
very confusing at first.  I've tried to explain things in a way that is
accurate, easy for a newbie to understand, and points the curious reader
to appropriate resources for further reading.  Hopefully, this small
contribution will help to clarify the behavior for future Guile newbies.

For reference, this patch is follow-up to the following email thread:

https://lists.gnu.org/archive/html/guile-user/2017-06/msg00043.html

-- 
Chris