From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#3526: 23.0.94; `list-character-sets' display Date: Wed, 17 Jun 2009 07:56:17 -0700 Message-ID: <0F745F1932EF4338B8D737D20FB2B94F@us.oracle.com> References: <8385521F908145EE8D60682CEAB9D7D1@us.oracle.com> <3057BD2C673B48079D31AC58DBF72C08@us.oracle.com> Reply-To: Drew Adams , 3526@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1245252042 6119 80.91.229.12 (17 Jun 2009 15:20:42 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 17 Jun 2009 15:20:42 +0000 (UTC) Cc: 3526@emacsbugs.donarmstrong.com To: "'Kenichi Handa'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Jun 17 17:20:39 2009 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1MGwwE-0001B4-7v for geb-bug-gnu-emacs@m.gmane.org; Wed, 17 Jun 2009 17:20:38 +0200 Original-Received: from localhost ([127.0.0.1]:38470 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MGwwC-0006fH-3e for geb-bug-gnu-emacs@m.gmane.org; Wed, 17 Jun 2009 11:20:32 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MGwtF-00056c-Pi for bug-gnu-emacs@gnu.org; Wed, 17 Jun 2009 11:17:29 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MGwtB-00053m-Hy for bug-gnu-emacs@gnu.org; Wed, 17 Jun 2009 11:17:29 -0400 Original-Received: from [199.232.76.173] (port=48256 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MGwtB-00053R-5x for bug-gnu-emacs@gnu.org; Wed, 17 Jun 2009 11:17:25 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:57347) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MGwtA-0001Ie-EA for bug-gnu-emacs@gnu.org; Wed, 17 Jun 2009 11:17:24 -0400 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n5HFHKjo005634; Wed, 17 Jun 2009 08:17:21 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.14.3/8.14.3/Submit) id n5HF05wO001568; Wed, 17 Jun 2009 08:00:05 -0700 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: "Drew Adams" Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Wed, 17 Jun 2009 15:00:04 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: followup 3526 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by 3526-submit@emacsbugs.donarmstrong.com id=B3526.12452505841308 (code B ref 3526); Wed, 17 Jun 2009 15:00:04 +0000 Original-Received: (at 3526) by emacsbugs.donarmstrong.com; 17 Jun 2009 14:56:24 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-Received: from rgminet12.oracle.com (rcsinet12.oracle.com [148.87.113.124]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n5HEuGto001302 for <3526@emacsbugs.donarmstrong.com>; Wed, 17 Jun 2009 07:56:17 -0700 Original-Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by rgminet12.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n5HEtqDb027874 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 17 Jun 2009 14:55:54 GMT Original-Received: from abhmt008.oracle.com (abhmt008.oracle.com [141.146.116.17]) by acsinet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n5HEvOgC016479; Wed, 17 Jun 2009 14:57:25 GMT Original-Received: from dradamslap1 (/141.144.73.196) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 17 Jun 2009 07:56:05 -0700 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: Thread-Index: AcnvFusiaRtzfD/3SzC343j4TWxl6wAPpPiA X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5579 X-Source-IP: abhmt008.oracle.com [141.146.116.17] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090207.4A390406.0103:SCFSTAT5015188,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) Resent-Date: Wed, 17 Jun 2009 11:17:29 -0400 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:28774 Archived-At: > This is the one-line help in *Character Set List* buffer, > ------------------------------------------------------------ > Character sets for defining another charset or obsolete now > ------------------------------------------------------------ Did you mean "are" instead of "or"? If so, the English (with "are") is correct. If this is a statement about something being obsolete that was previously supported, then it belongs in NEWS, not here. The text here should just help with what is displayed - it should not try to explain why something that was previously explained is no longer explained. (If that's not when this statement means, then I don't know what it is saying.) > and this is the "Charsets" node of mule.texi. > > ------------------------------------------------------------ > @node Charsets > @section Charsets > @cindex charsets > > Emacs defines most of popular character sets (e.g. ascii, > iso-8859-1, cp1250, big5, unicode) as @dfn{charsets} and a few of its > own charsets (e.g. emacs, unicode-bmp, eight-bit). Emacs defines most popular character sets (e.g. ascii, iso-8859-1, cp1250, big5, unicode), as well as a few of its own (e.g. emacs, unicode-bmp, eight-bit), as @dfn{charsets}. [Or better: End the sentence at the comma, and use a separate sentence to say that Emacs refers to character sets as @dfn{charsets}.] > All supported characters All characters supported by Emacs [As opposed to all chars supported by one or more character sets.] > belong to one or more charsets. Usually you don't have to > take care of ``charset'', but knowing about it may help understanding > the behavior of Emacs in some cases. I think something like this is what you want: You generally do not need to pay attention to charsets as you use Emacs. However, it can help to know a little about them. > One example is a font selection. One example is font selection. [or "One example is selecting a font"] > In each language environment, > charsets have different priorities. Emacs, at first, tries to use a > font that matches with charsets of higher priority. Emacs first tries to use a font that matches charsets of higher priority. [But why "first"? I don't see anything that counteracts this. So just "Emacs tries".] > For instance, in a > Japanese language environment, the charset @code{japanese-jisx0208} > has the highest priority (@xref{describe-language-environment}). > So, So > Emacs tries to use a font whose @code{registry} property is > ``JISX0208.1983-0'' > for whose [not for] > characters belonging to that charset. > > Another example is a use of @code{charset} text property. Another example is use of the @code{charset} text property. > When Emacs reads a file encoded in a coding > systems system > that uses escape sequences to switch charsets (e.g. iso-2022-int-1), > the buffer text keep the information of the original charset > by @code{charset} text property. > By using this information, Emacs can write the file with > the same byte sequence as the original. that uses escape sequences to switch charsets (e.g. iso-2022-int-1), text property @code{charset} is attached to the buffer text, to record the charset in which the file is encoded. Emacs uses this information to be able to write the file again using the original byte sequence. > @findex list-charset-chars > @cindex characters in a certain charset > @findex describe-character-set > There are two commands for obtaining information about Emacs > charsets. The command @kbd{M-x list-charset-chars} prompts for a > charset name, and displays all the characters in that character set. charset name and displays all the characters in that character set. > The command @kbd{M-x describe-character-set} prompts for a charset > name and displays information about that charset, including its > internal representation within Emacs. > > @findex list-character-sets > To display a list of all the supported charsets, To display a list of all supported charsets, > type @kbd{M-x list-character-sets}. > The list gives the names of charsets and > additional information to identity each charset (see ISO/IEC's this > page for the detail). The list shows charset names and other identifying ISO/IEC information (see for details). > In the > list, charsets are categorized into two; the normal charsets are > listed first, and the supplementary charsets are listed last. Charsets are listed in two groups: normal and supplementary charsets. > A > charset in the latter category is used for defining another charset > (as a parent or a subset), or was used only in Emacs of the older > versions. A @dfn{supplementary charset} is used to define another charset as its parent or subset. [parent or child? ancestor or descendent? superset or subset? Not sure what's correct here, but parent and subset are not parallel.] Some of the charsets listed as supplementary are obsolete; they were used in Emacs versions prior to version 23. [Is that correct? If so, why not get rid of these here? Why show stuff that is no longer in Emacs?] > To find out which charset a character in the buffer belongs to, To find out which charset a character belongs to, > put point before it and type @kbd{C-u C-x =}. [But this last sentence has nothing to do with `list-character-sets' display, so it should be moved elsewhere (e.g. earlier in the node). You might also want to cross-ref another node that mentions `C-x =' (and vice versa). HTH. Someone else should check that the content makes sense using the edits I suggested. I don't want to mess up the meaning by guessing wrong. Thx - Drew