aboutsummaryrefslogtreecommitdiffstats
path: root/src/font.c
diff options
context:
space:
mode:
authorPaul Eggert2015-09-16 16:23:55 -0700
committerPaul Eggert2015-09-16 16:26:07 -0700
commit032ce1c7d1afb23e6b1265d91c5a97e45de071ce (patch)
treedab9ca1e540c23aeb15ee9ef8fdc6b78e1929b6d /src/font.c
parent309d39b832ccd72f99cc726090ff03f7e146948d (diff)
downloademacs-032ce1c7d1afb23e6b1265d91c5a97e45de071ce.tar.gz
emacs-032ce1c7d1afb23e6b1265d91c5a97e45de071ce.zip
Omit unnecessary \ before paren in C docstrings
Although \( is needed in docstrings in Elisp code, it is not needed in docstrings in C code, since C function definitiions do not start with a parenthesis. The backslashes made the docstrings a bit harder to read and to format in columns. Also, some C docstrings had ( in column 1 and this did not appear to be causing any problems. So, simplify C docstrings by replacing \( with ( and \) with ).
Diffstat (limited to 'src/font.c')
-rw-r--r--src/font.c14
1 files changed, 7 insertions, 7 deletions
diff --git a/src/font.c b/src/font.c
index 8e06532ac0a..ce144e78a08 100644
--- a/src/font.c
+++ b/src/font.c
@@ -4068,7 +4068,7 @@ DEFUN ("font-face-attributes", Ffont_face_attributes, Sfont_face_attributes, 1,
4068FONT is a font name, a font-spec, a font-entity, or a font-object. 4068FONT is a font name, a font-spec, a font-entity, or a font-object.
4069The return value is a list of the form 4069The return value is a list of the form
4070 4070
4071\(:family FAMILY :height HEIGHT :weight WEIGHT :slant SLANT :width WIDTH) 4071(:family FAMILY :height HEIGHT :weight WEIGHT :slant SLANT :width WIDTH)
4072 4072
4073where FAMILY, HEIGHT, WEIGHT, SLANT, and WIDTH are face attribute values 4073where FAMILY, HEIGHT, WEIGHT, SLANT, and WIDTH are face attribute values
4074compatible with `set-face-attribute'. Some of these key-attribute pairs 4074compatible with `set-face-attribute'. Some of these key-attribute pairs
@@ -4749,15 +4749,15 @@ ASCENT, DESCENT, SPACE-WIDTH, AVERAGE-WIDTH are metrics of the font in
4749pixels. 4749pixels.
4750 4750
4751CAPABILITY is a list whose first element is a symbol representing the 4751CAPABILITY is a list whose first element is a symbol representing the
4752font format \(x, opentype, truetype, type1, pcf, or bdf) and the 4752font format (x, opentype, truetype, type1, pcf, or bdf) and the
4753remaining elements describe the details of the font capability. 4753remaining elements describe the details of the font capability.
4754 4754
4755If the font is OpenType font, the form of the list is 4755If the font is OpenType font, the form of the list is
4756 \(opentype GSUB GPOS) 4756 (opentype GSUB GPOS)
4757where GSUB shows which "GSUB" features the font supports, and GPOS 4757where GSUB shows which "GSUB" features the font supports, and GPOS
4758shows which "GPOS" features the font supports. Both GSUB and GPOS are 4758shows which "GPOS" features the font supports. Both GSUB and GPOS are
4759lists of the format: 4759lists of the format:
4760 \((SCRIPT (LANGSYS FEATURE ...) ...) ...) 4760 ((SCRIPT (LANGSYS FEATURE ...) ...) ...)
4761 4761
4762If the font is not OpenType font, currently the length of the form is 4762If the font is not OpenType font, currently the length of the form is
4763one. 4763one.
@@ -5043,11 +5043,11 @@ where
5043 as follows: 5043 as follows:
5044 5044
5045 If the font is OpenType font, the form of the list is 5045 If the font is OpenType font, the form of the list is
5046 \(opentype GSUB GPOS) 5046 (opentype GSUB GPOS)
5047 where GSUB shows which "GSUB" features the font supports, and GPOS 5047 where GSUB shows which "GSUB" features the font supports, and GPOS
5048 shows which "GPOS" features the font supports. Both GSUB and GPOS are 5048 shows which "GPOS" features the font supports. Both GSUB and GPOS are
5049 lists of the form: 5049 lists of the form:
5050 \((SCRIPT (LANGSYS FEATURE ...) ...) ...) 5050 ((SCRIPT (LANGSYS FEATURE ...) ...) ...)
5051 5051
5052 where 5052 where
5053 SCRIPT is a symbol representing OpenType script tag. 5053 SCRIPT is a symbol representing OpenType script tag.
@@ -5359,7 +5359,7 @@ where ENCODING is a charset or a char-table,
5359and REPERTORY is a charset, a char-table, or nil. 5359and REPERTORY is a charset, a char-table, or nil.
5360 5360
5361If ENCODING and REPERTORY are the same, the element can have the form 5361If ENCODING and REPERTORY are the same, the element can have the form
5362\(REGEXP . ENCODING). 5362(REGEXP . ENCODING).
5363 5363
5364ENCODING is for converting a character to a glyph code of the font. 5364ENCODING is for converting a character to a glyph code of the font.
5365If ENCODING is a charset, encoding a character by the charset gives 5365If ENCODING is a charset, encoding a character by the charset gives