emacs manual: codepage-setup vs language environ

[Kevin Ryde]

This bug report will be sent to the Free Software Foundation,
not to your local site managers!
Please write in English, because the Emacs maintainers do not have
translators to read other languages for them.

Your bug report will be posted to the bug-gnu-emacs@gnu.org mailing list,
and to the gnu.emacs.bug news group.

In GNU Emacs 21.4.1 (i386-pc-linux-gnu, X toolkit, Xaw3d scroll bars)
 of 2005-03-18 on trouble, modified by Debian
configured using `configure '--build=i386-linux' '--host=i386-linux' 
'--prefix=/usr' '--sharedstatedir=/var/lib' '--libexecdir=/usr/lib' 
'--localstatedir=/var/lib' '--infodir=/usr/share/info' 
'--mandir=/usr/share/man' '--with-pop=yes' '--with-x=yes' 
'--with-x-toolkit=athena' 'CFLAGS=-DDEBIAN -g -O2' 'build_alias=i386-linux' 
'host_alias=i386-linux''
Important settings:
  value of $LC_ALL: en_AU
  value of $LC_COLLATE: nil
  value of $LC_CTYPE: nil
  value of $LC_MESSAGES: nil
  value of $LC_MONETARY: nil
  value of $LC_NUMERIC: nil
  value of $LC_TIME: nil
  value of $LANG: nil
  locale-coding-system: iso-latin-1
  default-enable-multibyte-characters: t

Please describe exactly what actions triggered the bug
and the precise symptoms of the bug:


The "MS-DOS and MULE" node in the emacs manual says

        Since the codepage number also indicates which script you are
        using, Emacs automatically runs `set-language-environment' to
        select the language environment for that script (*note
        Language Environments::).

When I first read that I thought it applied to both the M-x
dos-codepage-setup and M-x codepage-setup commands shown at the start
of that section, whereas if I'm not mistaken it's only the former.

I think that node could be clearer if the description of how codepages
are handled with emacs coding systems (and how you need M-x
codepage-setup) was separated from the bits about what happens in
emacs actually running on DOS.  The coding systems bits would apply to
all systems, if I'm not mistaken.