# HG changeset patch # User Kenichi Handa # Date 1245112398 0 # Node ID 850fd8c37942f2cea16672a11e7c9d366a1cbdaf # Parent 45564d023acc20474d082830a06a34b90fca2e45 (compose-region): Improve the docstring. diff -r 45564d023acc -r 850fd8c37942 lisp/composite.el --- a/lisp/composite.el Mon Jun 15 21:36:44 2009 +0000 +++ b/lisp/composite.el Tue Jun 16 00:33:18 2009 +0000 @@ -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 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 value is not positive + (2) below BASE if Y's ascent value is not positive + (3) on BASE (i.e. at the BASE position) 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.