From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Kenichi Handa Newsgroups: gmane.emacs.devel Subject: Re: Compositions documentation Date: Tue, 10 Feb 2009 15:26:08 +0900 Message-ID: References: NNTP-Posting-Host: lo.gmane.org X-Trace: ger.gmane.org 1234247194 17237 80.91.229.12 (10 Feb 2009 06:26:34 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 10 Feb 2009 06:26:34 +0000 (UTC) Cc: emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Feb 10 07:27:49 2009 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1LWm5z-0001pw-QF for ged-emacs-devel@m.gmane.org; Tue, 10 Feb 2009 07:27:48 +0100 Original-Received: from localhost ([127.0.0.1]:36130 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LWm4f-0003Vh-UM for ged-emacs-devel@m.gmane.org; Tue, 10 Feb 2009 01:26:26 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1LWm4X-0003VW-Ex for emacs-devel@gnu.org; Tue, 10 Feb 2009 01:26:17 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1LWm4V-0003V9-BF for emacs-devel@gnu.org; Tue, 10 Feb 2009 01:26:15 -0500 Original-Received: from [199.232.76.173] (port=48235 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LWm4V-0003V5-6E for emacs-devel@gnu.org; Tue, 10 Feb 2009 01:26:15 -0500 Original-Received: from mx1.aist.go.jp ([150.29.246.133]:43001) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1LWm4T-0000CP-0h; Tue, 10 Feb 2009 01:26:13 -0500 Original-Received: from rqsmtp1.aist.go.jp (rqsmtp1.aist.go.jp [150.29.254.115]) by mx1.aist.go.jp with ESMTP id n1A6Q7tT008170; Tue, 10 Feb 2009 15:26:07 +0900 (JST) env-from (handa@m17n.org) Original-Received: from smtp1.aist.go.jp by rqsmtp1.aist.go.jp with ESMTP id n1A6Q6cQ009698; Tue, 10 Feb 2009 15:26:06 +0900 (JST) env-from (handa@m17n.org) Original-Received: by smtp1.aist.go.jp with ESMTP id n1A6Q6nD011745; Tue, 10 Feb 2009 15:26:06 +0900 (JST) env-from (handa@m17n.org) Original-Received: from handa by etlken with local (Exim 4.69) (envelope-from ) id 1LWm4O-0005bk-4q; Tue, 10 Feb 2009 15:26:08 +0900 In-reply-to: (message from Eli Zaretskii on Fri, 06 Feb 2009 17:23:09 +0200) X-detected-operating-system: by monty-python.gnu.org: Solaris 9 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:108926 Archived-At: In article , Eli Zaretskii writes: > I see that the Lisp APIs that deal with compositions > (composition-get-gstring, compose-region, compose-string, > find-composition, etc.) are not documented in the ELisp manual. > Should they be? Or are these APIs so obscure that no one should futz > with them? Compose-region and compose-string are described in etc/NEWS.21 as this: *** The function `compose-region' takes new arguments COMPONENTS and MODIFICATION-FUNC. With COMPONENTS, you can specify not only a composition rule but also characters to be composed. Such characters may differ between buffer and string text. *** The function `compose-string' takes new arguments START, END, COMPONENTS, and MODIFICATION-FUNC. *** The function `compose-string' puts text property `composition' directly on the argument STRING instead of returning a new string. Likewise, the function `decompose-string' just removes text property `composition' from STRING. *** The new function `find-composition' returns information about a composition at a specified position in a buffer or a string. If they are not documented now, perhaps RMS decided that it's not worthwhile. But, I think it is better to document them. On the other hand, composition-get-gstring and the other several new functions in composite.el are only for Emacs internal. --- Kenichi Handa handa@m17n.org