Re: emacs-26 8f18d12: Improve documentation of decoding into a unibyte buffer

[Robert Pluim <rpluim@gmail.com>]

>>>>> On Tue, 28 May 2019 05:36:42 +0300, Eli Zaretskii <eliz@gnu.org> said:

    >> From: Richard Stallman <rms@gnu.org>
    >> Cc: rpluim@gmail.com, emacs-devel@gnu.org
    >> Date: Mon, 27 May 2019 16:17:31 -0400
    >> 
    >> > > Having trawled through the elisp manual, for the life of me itʼs not
    >> > > clear which coding system I should use. 'raw-text'? 'us-ascii'?
    >> > > Something Else?
    >> 
    >> > You should use utf-8-emacs-unix.
    >> 
    >> Have we got clear documentation of how raw-text and utf-8-emacs-unix differ
    >> and when to use each one?
    >> 
    >> Does the Emacs Lisp manual refer to that documention from the places
    >> it would be useful to do so?

    Eli> We have these two documented.  I'm not the right person to say whether
    Eli> it's clear enough, people should free to complain about unclear
    Eli> aspects and missing references.

Itʼs clear enough to me now. The only thing that trips me up is this
kind of phrase (from (info "(elisp)Coding System Basics")

    When you use ‘raw-text’ to encode multibyte text, it does perform
    one character code conversion: it converts eight-bit characters to
    their single-byte external representation.

because I always forget that eight-bit characters have a multi-byte
representation in the emacs-internal coding system.

Robert