annotate etc/enriched.doc @ 14298:6448a36ceaad

(set_frame_menubar): Use safe_run_hooks for Qmenu_bar_update_hook.
author Karl Heuer <kwzh@gnu.org>
date Wed, 24 Jan 1996 23:38:23 +0000
parents 1ea8008d4bd8
children c510bee23510
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
1 Content-Type: text/enriched
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
2 Text-Width: 70
11102
2484f8186e34 New magic number for text/enriched files.
Boris Goldowsky <boris@gnu.org>
parents: 9678
diff changeset
3
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
4 <center><x-bg-color><param>blue</param><x-color><param>white</param><bold><fixed>enriched.el:</fixed></bold></x-color></x-bg-color>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
5
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
6 <x-bg-color><param>blue</param><x-color><param>white</param><bold>WYSIWYG rich text editing for GNU Emacs</bold></x-color></x-bg-color>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
7
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
8
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
9 </center><bold><x-bg-color><param>blue</param><x-color><param>white</param>INTRODUCTION
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
10
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
11 </x-color></x-bg-color>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
12
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
13 </bold><indent>Emacs now has the ability to edit <italic>enriched text</italic>, which is text
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
14 containing faces, colors, indentation, and other properties.
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
15 This document is a quick introduction to some of the new features,
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
16 and is also an example file in the <italic>text/enriched </italic>format.
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
17
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
18
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
19 </indent><x-bg-color><param>blue</param><x-color><param>white</param><bold>INSTALLATION and STARTUP
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
20
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
21 </bold></x-color></x-bg-color>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
22
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
23 <indent>Most of the time, you need not do anything to get these features
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
24 to work. If you visit a file that has been written out in
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
25 <italic>text/enriched</italic> format, it will automatically be decoded, Emacs will
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
26 enter `enriched-mode' while visiting it, and whenever you save it
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
27 it will be saved in the same format it was read in.
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
28
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
29
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
30 If you wish to create a new file, however, you will need to turn
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
31 on enriched-mode yourself:
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
32
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
33
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
34 <fixed><indent>M-x enriched-mode RET</indent></fixed>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
35
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
36
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
37 Or, if you get a <italic>text/enriched </italic>file that Emacs does not
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
38 automatically recognize and decode, you can tell Emacs to decode
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
39 it (which also turns on enriched-mode automatically):
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
40
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
41
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
42 <fixed>M-x format-decode-buffer RET text/enriched RET</fixed>
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
43
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
44
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
45
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
46 </indent><x-bg-color><param>blue</param><x-color><param>white</param><bold><flushleft>WHAT IS ENCODED
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
47
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
48 </flushleft></bold></x-color></x-bg-color><flushleft>
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
49
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
50 </flushleft><indent>Here is the current list of text-properties that are saved; they
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
51 are discussed in more detail below.
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
52 Most of these can be added or changed with the "Text Properties"
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
53 menu, available under the "Edit" item in the menu-bar, or on
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
54 C-mouse-2 (Control + the middle mouse button).
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
55
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
56 <bold>Faces:</bold> default, <bold>bold</bold>, <italic>italic</italic>, <underline>underline</underline>, <fixed>fixed</fixed>, etc.
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
57
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
58 <bold>Colors:</bold> <x-color><param>red</param><x-bg-color><param>DarkSlateGray</param>any</x-bg-color></x-color><x-bg-color><param>DarkSlateGray</param><x-color><param>orange</param>thing</x-color> <x-color><param>yellow</param>your</x-color><x-color><param>green</param> screen</x-color><x-color><param>blue</param> </x-color><x-color><param>light blue</param>can</x-color><x-color><param>violet</param> display...</x-color></x-bg-color>
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
59
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
60 <bold>Newlines:</bold> <indent>Which ones are real ("hard") newlines, and which can be
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
61 changed to fit lines into the ma</indent>rgins.
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
62
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
63 <bold>Margins:</bold> can be indented on the left or right.
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
64
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
65 <bold>Justification </bold><indent>(whether lines should be flush with the left margin,
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
66 the right margin, fully justified, centered, or left alo</indent>ne).
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
67
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
68 <bold>Excerpts: "</bold><excerpt>For quoted material."</excerpt>
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
69
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
70 <bold>Read-only</bold> regions.
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
71
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
72
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
73 </indent><x-bg-color><param>blue</param><x-color><param>white</param><bold>FACES and COLORS
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
74
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
75 </bold></x-color></x-bg-color><bold>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
76
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
77 </bold><indent>You can add faces either with the menu or with <fixed>M-g.</fixed> The face is
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
78 applied to the current region. If you are using
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
79 `transient-mark-mode' and the region is not active, then the face
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
80 applies to whatever you type next. Any face can have colors, but
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
81 faces have no other attributes are put on the color submenus of
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
82 the "Text Properties" menu.
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
83
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
84
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
85 </indent><x-bg-color><param>blue</param><x-color><param>white</param><bold>NEWLINES and PARAGRAPHS
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
86
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
87 </bold></x-color></x-bg-color><bold>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
88
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
89 </bold><indent><italic>Text/enriched</italic> format distinguishes between <underline>hard</underline> and <underline>soft</underline> newlines.
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
90 Hard newlines are used to separate paragraphs, or items in a list,
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
91 or anywhere that must be a line break no matter what the margins
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
92 are. Soft newlines are the ones inserted in order to fit text
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
93 between the margins. The fill and auto-fill functions insert soft
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
94 newlines as necessary, but hard newlines are only inserted by
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
95 direct request, such as using the return key or the <fixed>C-o
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
96 (open-line)</fixed> function.
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
97
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
98
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
99 </indent><x-bg-color><param>blue</param><x-color><param>white</param><bold>INDENTATION
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
100
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
101 </bold></x-color></x-bg-color><bold>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
102
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
103 </bold><indent><indentright>The fill functions also understand margins, which can be set
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
104 for any region of a document. In addition to the menu items,
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
105 which increase or decrease the margins, there are two commands
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
106 for setting the margins absolutely: <fixed>C-c l (set-left-margin)</fixed>
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
107 and <fixed>C-c r (set-right-margin)</fixed>.
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
108 <flushleft>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
109
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
110 </flushleft></indentright><flushleft>You <indent>can change indentation at any point in a</indent></flushleft></indent> <indent><indent><flushleft>paragraph, which
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
111 makes it possible to do interesting things like</flushleft>
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
112 <flushleft>hanging-indents: this paragraph was indented by selecting the
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
113 region from the second word to the end of the paragraph, and
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
114 indenting only that part.<indent>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
115
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
116 </indent></flushleft></indent></indent><flushleft>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
117
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
118 <x-bg-color><param>blue</param><x-color><param>white</param><bold>JUSTIFICATION<indent>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
119
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
120 </indent></bold></x-color></x-bg-color><bold><indent>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
121
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
122 </indent></bold></flushleft><indent><nofill>Several styles of justification are possible, the simplest being <italic>unfilled.
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
123 </italic>This means that your lines will be left as you write them.
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
124 This paragraph is unfilled.
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
125
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
126 The most common (for English) style is <italic>FlushLeft. </italic>This means
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
127 lines are aligned at the left margin but left uneven at the
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
128 right.
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
129
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
130
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
131 </nofill><italic><flushright>FlushRight</flushright></italic><flushright> makes each line flush with the right margin instead.
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
132
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
133
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
134
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
135 </flushright><italic><flushboth>FlushBoth </flushboth></italic><flushboth>regions, which are sometimes called "fully justified"
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
136 are aligned evenly on both edges, so that the text on the page has
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
137 a smooth appearance as in a book or newspaper article.
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
138 Unfortunately this does not look as nice with a fixed-width font
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
139 as it does in a proportionally-spaced printed document; the extra
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
140 spaces that are needed on the screen can make it hard to read. <indentright><indentright><indentright><indentright>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
141
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
142
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
143 </indentright></indentright></indentright></indentright></flushboth><bold><center>Center
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
144
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
145 </center></bold><center>Finally, there is <italic>center </italic>justification.
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
146 The normal center-paragraph key, M-S, can be used to turn on
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
147 center justification in enriched-mode.
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
148
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
149 M-j or the "Text Properties" menu also can be used to change
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
150 justification.
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
151
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
152
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
153
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
154 </center><flushboth>Note that justification can only change at hard newlines, because
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
155 that is the unit over which filling gets done.
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
156
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
157
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
158 </flushboth></indent><x-bg-color><param>blue</param><x-color><param>white</param><bold>EXCERPTS
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
159
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
160 </bold></x-color></x-bg-color>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
161
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
162 <excerpt><indent>This is an example of an excerpt. You can use them for quoted
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
163 parts of other people's email messages and the like. It is just a
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
164 face, which is the same as the `italic' face by default.
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
165 </indent></excerpt>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
166
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
167 <x-bg-color><param>blue</param><x-color><param>white</param><bold>THE FILE FORMAT<indent>
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
168
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
169 </indent></bold></x-color></x-bg-color><indent>
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
170
14020
1ea8008d4bd8 Fix typo.
Karl Heuer <kwzh@gnu.org>
parents: 11267
diff changeset
171 Enriched-mode documents are saved in an extended version of a
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
172 format called <italic>text/enriched</italic>, which is defined as part of the MIME
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
173 standard. This means that your documents are transportable (even
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
174 through email) to many</indent> <indent>other systems. In the future other file
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
175 formats may be supported as well.
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
176
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
177
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
178 Since Emacs adds some non-standard features to the format (colors
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
179
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
180 and read-only regions), not all systems will be able to recreate
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
181 all of the features of your document, but they will get as close
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
182 as possible.
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
183
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
184
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
185 The MIME standard is defined in internet RFC 1521; text/enriched
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
186 is defined in RFC 1563. Details on obtaining these documents via
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
187 FTP or email may be obtained by sending an email message to
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
188 <fixed>rfc-info@isi.edu</fixed> with the message body:
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
189
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
190 <fixed><indent>help: ways_to_get_rfcs
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
191
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
192
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
193 </indent></fixed>See also the newsgroup comp.mail.mime.
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
194
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
195
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
196 </indent><x-bg-color><param>blue</param><x-color><param>white</param><bold>CUSTOMIZATION
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
197
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
198 </bold></x-color></x-bg-color><bold>
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
199
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
200 </bold><indent>-<indent> The <fixed>fixed </fixed>and <excerpt>excerpt </excerpt>faces should be set to your liking.</indent>
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
201
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
202 - <indent>User-preference variables: <fixed>default-justification, enriched-verbose.
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
203 </fixed></indent>- <indent>You can add annotations for your own text properties by making
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
204 additions to <fixed>enriched-annotation-alist</fixed>. Note that the
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
205 standard requires you to name your annotation starting<italic> "x-"
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
206 </italic>(as in <italic>"x-read-only"</italic>). Please send me any such additions that
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
207 you think might be of general interest so that I can include
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
208 them in the distribution.
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
209
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
210
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
211 </indent></indent><x-bg-color><param>blue</param><x-color><param>white</param><bold>TO-DO LIST
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
212
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
213 </bold></x-color></x-bg-color><bold>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
214
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
215 </bold><indent><italic>[Feel free to work on these and send me the results!]</italic>
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
216
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
217 - Be smarter about fixing malformed files.
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
218
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
219 - Make the indentation work more seamlessly and robustly:
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
220
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
221 <indent>+ Create<indent> an aggressive auto-fill function that will keep the
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
222 paragraph properly filled all the time, without slowing
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
223 down editing too much.</indent>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
224
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
225 + Refill after yank.
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
226
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
227 + <indent>Make deleting a newline also delete the indentation
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
228 following it.</indent>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
229
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
230 + Never let point enter indentation??
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
231
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
232 </indent>- Notice and re-fill when window changes widths (optionally).
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
233
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
234 - Deal with the `category' text-property in a smart way.
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
235
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
236 - Interface w/ GNUS, VM, RMAIL. Maybe Info too?
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
237
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
238 -<indent> Support more formats: RTF, HTML...
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
239
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
240
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
241 </indent></indent><x-bg-color><param>blue</param><x-color><param>white</param><bold>Final Notes:
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
242
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
243 </bold></x-color></x-bg-color><bold>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
244
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
245 </bold><indent>This code and documentation is under development.
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
246 </indent>Comments and bug reports are welcome.
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
247
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
248
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
249 <bold><x-color><param>white</param><x-bg-color><param>blue</param>Boris Goldowsky</x-bg-color></x-color><x-color><param>light blue</param> </x-color></bold><x-color><param>light blue</param><fixed><<boris@gnu.ai.mit.edu></fixed></x-color><x-color><param>blue</param>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
250
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
251 </x-color><x-bg-color><param>blue</param><x-color><param>white</param> April 1995 </x-color></x-bg-color><x-color><param>blue</param>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
252
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
253
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
254
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
255
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
256
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
257
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
258
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
259
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
260
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
261
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
262
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
263 </x-color>