Show
Ignore:
Timestamp:
08/18/06 08:35:31 (2 years ago)
Author:
miyoshi
Message:

Sync up with Emacs CVS HEAD.

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved
  • trunk/man/text.texi

    r4111 r4148  
    20682068 
    20692069  The Faces submenu lists various Emacs faces including @code{bold}, 
    2070 @code{italic}, and @code{underline}.  Selecting one of these adds the 
    2071 chosen face to the region.  @xref{Faces}.  You can also specify a face 
    2072 with these keyboard commands: 
     2070@code{italic}, and @code{underline} (@pxref{Faces}).  These menu items 
     2071operate on the region if it is active and nonempty.  Otherwise, they 
     2072specify to use that face for an immediately following self-inserting 
     2073character.  Instead of the menu, you can use these keyboard commands: 
    20732074 
    20742075@table @kbd 
     
    20762077@findex facemenu-set-default 
    20772078@item M-o d 
    2078 Set the region, or the next inserted character, to the @code{default} face 
    2079 (@code{facemenu-set-default}). 
     2079Remove all @code{face} properties from the region (which includes 
     2080specified colors), or force the following inserted character to have no 
     2081@code{face} property (@code{facemenu-set-default}). 
    20802082@kindex M-o b @r{(Enriched mode)} 
    20812083@findex facemenu-set-bold 
    20822084@item M-o b 
    2083 Set the region, or the next inserted character, to the @code{bold} face 
    2084 (@code{facemenu-set-bold}). 
     2085Add the face @code{bold} to the region or to the following inserted 
     2086character (@code{facemenu-set-bold}). 
    20852087@kindex M-o i @r{(Enriched mode)} 
    20862088@findex facemenu-set-italic 
    20872089@item M-o i 
    2088 Set the region, or the next inserted character, to the @code{italic} face 
    2089 (@code{facemenu-set-italic}). 
     2090Add the face @code{italic} to the region or to the following inserted 
     2091character (@code{facemenu-set-italic}). 
    20902092@kindex M-o l @r{(Enriched mode)} 
    20912093@findex facemenu-set-bold-italic 
    20922094@item M-o l 
    2093 Set the region, or the next inserted character, to the @code{bold-italic} face 
    2094 (@code{facemenu-set-bold-italic}). 
     2095Add the face @code{bold-italic} to the region or to the following 
     2096inserted character (@code{facemenu-set-bold-italic}). 
    20952097@kindex M-o u @r{(Enriched mode)} 
    20962098@findex facemenu-set-underline 
    20972099@item M-o u 
    2098 Set the region, or the next inserted character, to the @code{underline} face 
    2099 (@code{facemenu-set-underline}). 
     2100Add the face @code{underline} to the region or to the following inserted 
     2101character (@code{facemenu-set-underline}). 
    21002102@kindex M-o o @r{(Enriched mode)} 
    21012103@findex facemenu-set-face 
    21022104@item M-o o @var{face} @key{RET} 
    2103 Set the region, or the next inserted character, to the face @var{face} 
    2104 (@code{facemenu-set-face}). 
     2105Add the face @var{face} to the region or to the following inserted 
     2106character (@code{facemenu-set-face}). 
    21052107@end table 
    21062108 
    2107   If you use these commands with a prefix argument---or, in Transient Mark 
    2108 mode, if the region is not active---then these commands specify a face 
    2109 to use for any immediately following self-inserting input. 
    2110 @xref{Transient Mark}.  This applies to both the keyboard commands and 
    2111 the menu commands. 
    2112  
    2113   Specifying the @code{default} face also resets foreground and 
    2114 background color to their defaults.(@pxref{Format Colors}). 
    2115  
    2116   Any self-inserting character you type inherits, by default, the face 
    2117 properties (as well as most other text properties) of the preceding 
    2118 character.  Specifying any face property, including foreground or 
    2119 background color, for your next self-inserting character will prevent 
    2120 it from inheriting any face properties from the preceding character, 
    2121 although it will still inherit other text properties.  Characters 
    2122 inserted by yanking do not inherit text properties
     2109  With a prefix argument, all these commands apply to an immediately 
     2110following self-inserting character, disregarding the region. 
     2111 
     2112  A self-inserting character normally inherits the @code{face} 
     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. 
     2120 
     2121  Strictly speaking, these commands apply only to the first following 
     2122self-inserting character that you type.  But if you insert additional 
     2123characters after it, they will inherit from the first one.  So it 
     2124appears that these commands apply to all of them
    21232125 
    21242126  Enriched mode defines two additional faces: @code{excerpt} and 
     
    21582160  If you specify a color with a prefix argument---or, in Transient 
    21592161Mark mode, if the region is not active---then it applies to any 
    2160 immediately following self-inserting input.  @xref{Transient Mark}. 
    2161 Otherwise, the command applies to the region. 
     2162immediately following self-inserting input.  Otherwise, the command 
     2163applies to the region. 
    21622164 
    21632165  Each color menu contains one additional item: @samp{Other}.  You can use