| 139 | | added to the Face menu, and are not included in this list. |
|---|
| 140 | | |
|---|
| 141 | | You can set this list before loading facemenu.el, or add a face to it before |
|---|
| 142 | | creating that face if you want it to be listed. If you change the |
|---|
| 143 | | variable so as to eliminate faces that have already been added to the menu, |
|---|
| 144 | | call `facemenu-update' to recalculate the menu contents. |
|---|
| 145 | | |
|---|
| 146 | | If this variable is t, all faces will be added to the menu. This |
|---|
| 147 | | is useful for setting temporarily if you want to add faces to the |
|---|
| 148 | | menu when they are created." |
|---|
| | 139 | added to the Face menu, and need not be in this list. |
|---|
| | 140 | |
|---|
| | 141 | This value takes effect when you load facemenu.el. If the |
|---|
| | 142 | list includes symbols which are not defined as faces, they |
|---|
| | 143 | are ignored; however, subsequently defining or creating |
|---|
| | 144 | those faces adds them to the menu then. You can call |
|---|
| | 145 | `facemenu-update' to recalculate the menu contents, such as |
|---|
| | 146 | if you change the value of this variable, |
|---|
| | 147 | |
|---|
| | 148 | If this variable is t, all faces that you apply to text |
|---|
| | 149 | using the face menu commands (even by name), and all faces |
|---|
| | 150 | that you define or create, are added to the menu. You may |
|---|
| | 151 | find it useful to set this variable to t temporarily while |
|---|
| | 152 | you define some faces, so that they will be added. However, |
|---|
| | 153 | if the value is no longer t and you call `facemenu-update', |
|---|
| | 154 | it will remove any faces not explicitly in the list." |
|---|
| 323 | | "Add FACE to the region or next character typed. |
|---|
| 324 | | This adds FACE to the top of the face list; any faces lower on the list that |
|---|
| 325 | | will not show through at all will be removed. |
|---|
| 326 | | |
|---|
| 327 | | Interactively, reads the face name with the minibuffer. |
|---|
| 328 | | |
|---|
| 329 | | If the region is active (normally true except in Transient Mark mode) |
|---|
| 330 | | and there is no prefix argument, this command sets the region to the |
|---|
| 331 | | requested face. |
|---|
| 332 | | |
|---|
| 333 | | Otherwise, this command specifies the face for the next character |
|---|
| 334 | | inserted. Moving point or switching buffers before |
|---|
| 335 | | typing a character to insert cancels the specification." |
|---|
| | 329 | "Apply FACE to the region or next character typed. |
|---|
| | 330 | |
|---|
| | 331 | If the region is active (normally true except in Transient |
|---|
| | 332 | Mark mode) and nonempty, and there is no prefix argument, |
|---|
| | 333 | this command applies FACE to the region. Otherwise, it applies FACE |
|---|
| | 334 | to the faces to use for the next character |
|---|
| | 335 | inserted. (Moving point or switching buffers before typing |
|---|
| | 336 | a character to insert cancels the specification.) |
|---|
| | 337 | |
|---|
| | 338 | If FACE is `default', to \"apply\" it means clearing |
|---|
| | 339 | the list of faces to be used. For any other value of FACE, |
|---|
| | 340 | to \"apply\" it means putting FACE at the front of the list |
|---|
| | 341 | of faces to be used, and removing any faces further |
|---|
| | 342 | along in the list that would be completely overridden by |
|---|
| | 343 | preceding faces (including FACE). |
|---|
| | 344 | |
|---|
| | 345 | This command can also add FACE to the menu of faces, |
|---|
| | 346 | if `facemenu-listed-faces' says to do that." |
|---|
