diff options
| author | Paul Eggert | 2015-09-16 16:23:55 -0700 |
|---|---|---|
| committer | Paul Eggert | 2015-09-16 16:26:07 -0700 |
| commit | 032ce1c7d1afb23e6b1265d91c5a97e45de071ce (patch) | |
| tree | dab9ca1e540c23aeb15ee9ef8fdc6b78e1929b6d /src/font.c | |
| parent | 309d39b832ccd72f99cc726090ff03f7e146948d (diff) | |
| download | emacs-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.c | 14 |
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, | |||
| 4068 | FONT is a font name, a font-spec, a font-entity, or a font-object. | 4068 | FONT is a font name, a font-spec, a font-entity, or a font-object. |
| 4069 | The return value is a list of the form | 4069 | The 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 | ||
| 4073 | where FAMILY, HEIGHT, WEIGHT, SLANT, and WIDTH are face attribute values | 4073 | where FAMILY, HEIGHT, WEIGHT, SLANT, and WIDTH are face attribute values |
| 4074 | compatible with `set-face-attribute'. Some of these key-attribute pairs | 4074 | compatible 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 | |||
| 4749 | pixels. | 4749 | pixels. |
| 4750 | 4750 | ||
| 4751 | CAPABILITY is a list whose first element is a symbol representing the | 4751 | CAPABILITY is a list whose first element is a symbol representing the |
| 4752 | font format \(x, opentype, truetype, type1, pcf, or bdf) and the | 4752 | font format (x, opentype, truetype, type1, pcf, or bdf) and the |
| 4753 | remaining elements describe the details of the font capability. | 4753 | remaining elements describe the details of the font capability. |
| 4754 | 4754 | ||
| 4755 | If the font is OpenType font, the form of the list is | 4755 | If the font is OpenType font, the form of the list is |
| 4756 | \(opentype GSUB GPOS) | 4756 | (opentype GSUB GPOS) |
| 4757 | where GSUB shows which "GSUB" features the font supports, and GPOS | 4757 | where GSUB shows which "GSUB" features the font supports, and GPOS |
| 4758 | shows which "GPOS" features the font supports. Both GSUB and GPOS are | 4758 | shows which "GPOS" features the font supports. Both GSUB and GPOS are |
| 4759 | lists of the format: | 4759 | lists of the format: |
| 4760 | \((SCRIPT (LANGSYS FEATURE ...) ...) ...) | 4760 | ((SCRIPT (LANGSYS FEATURE ...) ...) ...) |
| 4761 | 4761 | ||
| 4762 | If the font is not OpenType font, currently the length of the form is | 4762 | If the font is not OpenType font, currently the length of the form is |
| 4763 | one. | 4763 | one. |
| @@ -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, | |||
| 5359 | and REPERTORY is a charset, a char-table, or nil. | 5359 | and REPERTORY is a charset, a char-table, or nil. |
| 5360 | 5360 | ||
| 5361 | If ENCODING and REPERTORY are the same, the element can have the form | 5361 | If ENCODING and REPERTORY are the same, the element can have the form |
| 5362 | \(REGEXP . ENCODING). | 5362 | (REGEXP . ENCODING). |
| 5363 | 5363 | ||
| 5364 | ENCODING is for converting a character to a glyph code of the font. | 5364 | ENCODING is for converting a character to a glyph code of the font. |
| 5365 | If ENCODING is a charset, encoding a character by the charset gives | 5365 | If ENCODING is a charset, encoding a character by the charset gives |