From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Kenichi Handa Newsgroups: gmane.emacs.bugs Subject: bug#3564: 23.0.94; compose-region doc string Date: Mon, 15 Jun 2009 15:43:02 +0900 Message-ID: References: Reply-To: Kenichi Handa , 3564@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org X-Trace: ger.gmane.org 1245049065 20348 80.91.229.12 (15 Jun 2009 06:57:45 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 15 Jun 2009 06:57:45 +0000 (UTC) To: Drew Adams , 3564@emacsbugs.donarmstrong.com Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jun 15 08:57:41 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 1MG68S-00073u-DX for geb-bug-gnu-emacs@m.gmane.org; Mon, 15 Jun 2009 08:57:41 +0200 Original-Received: from localhost ([127.0.0.1]:52047 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MG68R-00088D-Tr for geb-bug-gnu-emacs@m.gmane.org; Mon, 15 Jun 2009 02:57:39 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MG68N-00086t-EZ for bug-gnu-emacs@gnu.org; Mon, 15 Jun 2009 02:57:35 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MG68I-00085k-L0 for bug-gnu-emacs@gnu.org; Mon, 15 Jun 2009 02:57:34 -0400 Original-Received: from [199.232.76.173] (port=47294 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MG68I-00085h-Eb for bug-gnu-emacs@gnu.org; Mon, 15 Jun 2009 02:57:30 -0400 Original-Received: from mx20.gnu.org ([199.232.41.8]:29964) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MG68H-0001d3-OA for bug-gnu-emacs@gnu.org; Mon, 15 Jun 2009 02:57:29 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]) by mx20.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1MG68G-0007Nv-L3 for bug-gnu-emacs@gnu.org; Mon, 15 Jun 2009 02:57:28 -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 n5F6vK3M002769; Sun, 14 Jun 2009 23:57:20 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.14.3/8.14.3/Submit) id n5F6o4DW001531; Sun, 14 Jun 2009 23:50:04 -0700 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: Kenichi Handa Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Mon, 15 Jun 2009 06:50:04 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: followup 3564 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by 3564-submit@emacsbugs.donarmstrong.com id=B3564.1245048189803 (code B ref 3564); Mon, 15 Jun 2009 06:50:04 +0000 Original-Received: (at 3564) by emacsbugs.donarmstrong.com; 15 Jun 2009 06:43:09 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-Received: from mx1.aist.go.jp (mx1.aist.go.jp [150.29.246.133]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n5F6h4bQ000798 for <3564@emacsbugs.donarmstrong.com>; Sun, 14 Jun 2009 23:43:06 -0700 Original-Received: from rqsmtp1.aist.go.jp (rqsmtp1.aist.go.jp [150.29.254.115]) by mx1.aist.go.jp with ESMTP id n5F6h2vI007959; Mon, 15 Jun 2009 15:43:02 +0900 (JST) env-from (handa@m17n.org) Original-Received: from smtp3.aist.go.jp by rqsmtp1.aist.go.jp with ESMTP id n5F6h2BI006376; Mon, 15 Jun 2009 15:43:02 +0900 (JST) env-from (handa@m17n.org) Original-Received: by smtp3.aist.go.jp with ESMTP id n5F6h20S016025; Mon, 15 Jun 2009 15:43:02 +0900 (JST) env-from (handa@m17n.org) Original-Received: from handa by etlken with local (Exim 4.69) (envelope-from ) id 1MG5uI-0003m1-9A; Mon, 15 Jun 2009 15:43:02 +0900 In-reply-to: (drew.adams@oracle.com) X-Detected-Operating-System: by mx20.gnu.org: GNU/Linux 2.6 (newer, 2) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) Resent-Date: Mon, 15 Jun 2009 02:57:34 -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:28709 Archived-At: In article , "Drew Adams" writes: > 1. Typo: "stricking" -> "striking". > 2. Please add an explanation of what "overstriking" and "stacking" > mean. How about this change? --- composite.el.~1.47.~ 2009-06-08 20:48:58.000000000 +0900 +++ composite.el 2009-06-15 15:39:21.000000000 +0900 @@ -185,8 +185,17 @@ (defun compose-region (start end &optional components modification-func) "Compose characters in the current region. -Characters are composed relatively, i.e. composed by overstricking or -stacking depending on ascent, descent and other properties. +Characters are composed relatively, i.e. composed by overstriking +or stacking depending on ascent, descent and other metrics values +of glyphs. + +For instance, if the region has three characters \"XYZ\", X is +regarded as BASE glyph, and Y is displayed: + (1) above BASE if Y's descent is not positive, + (2) below BASE if Y's ascent is not positive, + (3) over BASE (at the same position of BASE) otherwise. +and Z is displayed with the same rule while regarding the whole +XY glyphs as BASE. When called from a program, expects these four arguments. --- Kenichi Handa handa@m17n.org