aboutsummaryrefslogtreecommitdiffstats
path: root/man/text.texi
diff options
context:
space:
mode:
Diffstat (limited to 'man/text.texi')
-rw-r--r--man/text.texi64
1 files changed, 33 insertions, 31 deletions
diff --git a/man/text.texi b/man/text.texi
index 3a166174fda..b764a83d8db 100644
--- a/man/text.texi
+++ b/man/text.texi
@@ -2067,59 +2067,61 @@ Display a list of all the defined colors (@code{list-colors-display}).
2067@subsection Faces in Formatted Text 2067@subsection Faces in Formatted Text
2068 2068
2069 The Faces submenu lists various Emacs faces including @code{bold}, 2069 The Faces submenu lists various Emacs faces including @code{bold},
2070@code{italic}, and @code{underline}. Selecting one of these adds the 2070@code{italic}, and @code{underline} (@pxref{Faces}). These menu items
2071chosen face to the region. @xref{Faces}. You can also specify a face 2071operate on the region if it is active and nonempty. Otherwise, they
2072with these keyboard commands: 2072specify to use that face for an immediately following self-inserting
2073character. Instead of the menu, you can use these keyboard commands:
2073 2074
2074@table @kbd 2075@table @kbd
2075@kindex M-o d @r{(Enriched mode)} 2076@kindex M-o d @r{(Enriched mode)}
2076@findex facemenu-set-default 2077@findex facemenu-set-default
2077@item M-o d 2078@item M-o d
2078Set the region, or the next inserted character, to the @code{default} face 2079Remove all @code{face} properties from the region (which includes
2079(@code{facemenu-set-default}). 2080specified colors), or force the following inserted character to have no
2081@code{face} property (@code{facemenu-set-default}).
2080@kindex M-o b @r{(Enriched mode)} 2082@kindex M-o b @r{(Enriched mode)}
2081@findex facemenu-set-bold 2083@findex facemenu-set-bold
2082@item M-o b 2084@item M-o b
2083Set the region, or the next inserted character, to the @code{bold} face 2085Add the face @code{bold} to the region or to the following inserted
2084(@code{facemenu-set-bold}). 2086character (@code{facemenu-set-bold}).
2085@kindex M-o i @r{(Enriched mode)} 2087@kindex M-o i @r{(Enriched mode)}
2086@findex facemenu-set-italic 2088@findex facemenu-set-italic
2087@item M-o i 2089@item M-o i
2088Set the region, or the next inserted character, to the @code{italic} face 2090Add the face @code{italic} to the region or to the following inserted
2089(@code{facemenu-set-italic}). 2091character (@code{facemenu-set-italic}).
2090@kindex M-o l @r{(Enriched mode)} 2092@kindex M-o l @r{(Enriched mode)}
2091@findex facemenu-set-bold-italic 2093@findex facemenu-set-bold-italic
2092@item M-o l 2094@item M-o l
2093Set the region, or the next inserted character, to the @code{bold-italic} face 2095Add the face @code{bold-italic} to the region or to the following
2094(@code{facemenu-set-bold-italic}). 2096inserted character (@code{facemenu-set-bold-italic}).
2095@kindex M-o u @r{(Enriched mode)} 2097@kindex M-o u @r{(Enriched mode)}
2096@findex facemenu-set-underline 2098@findex facemenu-set-underline
2097@item M-o u 2099@item M-o u
2098Set the region, or the next inserted character, to the @code{underline} face 2100Add the face @code{underline} to the region or to the following inserted
2099(@code{facemenu-set-underline}). 2101character (@code{facemenu-set-underline}).
2100@kindex M-o o @r{(Enriched mode)} 2102@kindex M-o o @r{(Enriched mode)}
2101@findex facemenu-set-face 2103@findex facemenu-set-face
2102@item M-o o @var{face} @key{RET} 2104@item M-o o @var{face} @key{RET}
2103Set the region, or the next inserted character, to the face @var{face} 2105Add the face @var{face} to the region or to the following inserted
2104(@code{facemenu-set-face}). 2106character (@code{facemenu-set-face}).
2105@end table 2107@end table
2106 2108
2107 If you use these commands with a prefix argument---or, in Transient Mark 2109 With a prefix argument, all these commands apply to an immediately
2108mode, if the region is not active---then these commands specify a face 2110following self-inserting character, disregarding the region.
2109to use for any immediately following self-inserting input.
2110@xref{Transient Mark}. This applies to both the keyboard commands and
2111the menu commands.
2112 2111
2113 Specifying the @code{default} face also resets foreground and 2112 A self-inserting character normally inherits the @code{face}
2114background color to their defaults.(@pxref{Format Colors}). 2113property (and most other text properties) from the preceding character
2114in the buffer. If you use the above commands to specify face for the
2115next self-inserting character, or the next section's commands to
2116specify a foreground or background color for it, then it does not
2117inherit the @code{face} property from the preceding character; instead
2118it uses whatever you specified. It will still inherit other text
2119properties, though.
2115 2120
2116 Any self-inserting character you type inherits, by default, the face 2121 Strictly speaking, these commands apply only to the first following
2117properties (as well as most other text properties) of the preceding 2122self-inserting character that you type. But if you insert additional
2118character. Specifying any face property, including foreground or 2123characters after it, they will inherit from the first one. So it
2119background color, for your next self-inserting character will prevent 2124appears that these commands apply to all of them.
2120it from inheriting any face properties from the preceding character,
2121although it will still inherit other text properties. Characters
2122inserted by yanking do not inherit text properties.
2123 2125
2124 Enriched mode defines two additional faces: @code{excerpt} and 2126 Enriched mode defines two additional faces: @code{excerpt} and
2125@code{fixed}. These correspond to codes used in the text/enriched file 2127@code{fixed}. These correspond to codes used in the text/enriched file
@@ -2157,8 +2159,8 @@ colors that you have used in Enriched mode in the current Emacs session.
2157 2159
2158 If you specify a color with a prefix argument---or, in Transient 2160 If you specify a color with a prefix argument---or, in Transient
2159Mark mode, if the region is not active---then it applies to any 2161Mark mode, if the region is not active---then it applies to any
2160immediately following self-inserting input. @xref{Transient Mark}. 2162immediately following self-inserting input. Otherwise, the command
2161Otherwise, the command applies to the region. 2163applies to the region.
2162 2164
2163 Each color menu contains one additional item: @samp{Other}. You can use 2165 Each color menu contains one additional item: @samp{Other}. You can use
2164this item to specify a color that is not listed in the menu; it reads 2166this item to specify a color that is not listed in the menu; it reads