annotate etc/enriched.doc @ 73113:14833ad68ac0

(Fsingle_key_description): Fix the last change.
author Kenichi Handa <handa@m17n.org>
date Mon, 25 Sep 2006 04:38:18 +0000
parents 3681678d3d86
children 0259a1711394
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
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
9 </center><bold><x-bg-color><param>blue</param><x-color><param>white</param>INTRODUCTION</x-color></x-bg-color></bold>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
10
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
11
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
12
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
13 <indent>Emacs now has the ability to edit <italic>enriched text</italic>, which is text
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
14 containing faces, colors, indentation, and other properties. This
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
15 document is a quick introduction to some of the new features, and
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
16 is also an example file in the <italic>text/enriched </italic>format.</indent>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
17
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
18
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
19 <x-bg-color><param>blue</param><x-color><param>white</param><bold>INSTALLATION and STARTUP</bold></x-color></x-bg-color>
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
20
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
21
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
22 <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
23 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
24 <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
25 enter `enriched-mode' while visiting it, and whenever you save it
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
26 it will be saved in the same format it was read in.
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
27
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
28 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
29 on enriched-mode yourself:
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
30
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
31
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
32 <fixed><indent>M-x enriched-mode RET</indent></fixed>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
33
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
34
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
35 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
36 automatically recognize and decode, you can tell Emacs to decode
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
37 it (which also turns on enriched-mode automatically):
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
38
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
39
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
40 <fixed><indent>M-x format-decode-buffer RET text/enriched RET</indent></fixed></indent>
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
41
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
42
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
43
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
44 <x-bg-color><param>blue</param><x-color><param>white</param><bold>WHAT IS ENCODED</bold></x-color></x-bg-color>
11267
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
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
47 <indent>Here is the current list of text-properties that are saved; they
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
48 are discussed in more detail below. Most of these can be added or
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
49 changed with the "Text Properties" menu, available under the
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
50 "Edit" item in the menu-bar, or on C-mouse-2 (Control + the middle
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
51 mouse button).
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
52
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
53 <bold>Faces:</bold> <indent>default, <bold>bold</bold>, <italic>italic</italic>, <underline>underline</underline>, etc.</indent>
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
54
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
55 <bold>Colors:</bold> <x-color><param>red</param><x-bg-color><param>DarkSlateGray</param><indent>any</indent></x-bg-color></x-color><x-bg-color><param>DarkSlateGray</param><indent><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></indent></x-bg-color>
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
56
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
57 <bold>Newlines:</bold> <indent>Which ones are real ("hard") newlines, and which can be
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
58 changed to fit lines into the margins.</indent>
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
59
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
60 <bold>Margins:</bold> <indent>can be indented on the left or right.</indent>
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
61
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
62 <bold>Justification</bold> <indent>(whether lines should be flush with the left margin,
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
63 the right margin, fully justified, centered, or left alone).</indent>
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
64
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
65 <bold>Excerpts:</bold><indent> <excerpt>"For quoted material."</excerpt></indent>
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
66
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
67 <bold>Read-only</bold> regions.
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
68
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
69 </indent>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
70
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
71 <x-bg-color><param>blue</param><x-color><param>white</param><bold>FACES and COLORS</bold></x-color></x-bg-color>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
72
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
73
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
74 <indent>You can add faces either with the menu or with <fixed>M-g.</fixed> The face is
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
75 applied to the current region. If you are using
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
76 `transient-mark-mode' and the region is not active, then the face
42944
07abc8d4c648 Reword face color location blurb.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 33381
diff changeset
77 applies to whatever you type next. Any face can have colors. If
07abc8d4c648 Reword face color location blurb.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 33381
diff changeset
78 this is its lone attribute, the face is put on the color submenus
07abc8d4c648 Reword face color location blurb.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 33381
diff changeset
79 of the "Text Properties" menu.</indent>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
80
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
81
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
82 <x-bg-color><param>blue</param><x-color><param>white</param><bold>NEWLINES and PARAGRAPHS</bold></x-color></x-bg-color>
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
83
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
84
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
85 <italic><indent>Text/enriched</indent></italic><indent> format distinguishes between <underline>hard</underline> and <underline>soft</underline> newlines.
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
86 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
87 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
88 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
89 between the margins. The fill and auto-fill functions insert soft
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
90 newlines as necessary, but hard newlines are only inserted by
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
91 direct request, such as using the return key or the <fixed>C-o
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
92 (open-line)</fixed> function.</indent>
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
93
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
94
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
95 <x-bg-color><param>blue</param><x-color><param>white</param><bold>INDENTATION</bold></x-color></x-bg-color>
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
96
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
97
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
98 <indent>The fill functions also understand margins, which can be set for
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
99 any region of a document. In addition to the menu items, which
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
100 increase or decrease the margins, there are two commands for
57319
0201b31364c4 Update for new bindings of `set-left-margin' and `set-right-margin'.
Luc Teirlinck <teirllm@auburn.edu>
parents: 57240
diff changeset
101 setting the margins absolutely: <fixed>C-c [ (set-left-margin)</fixed> and <fixed>C-c
0201b31364c4 Update for new bindings of `set-left-margin' and `set-right-margin'.
Luc Teirlinck <teirllm@auburn.edu>
parents: 57240
diff changeset
102 ] (set-right-margin)</fixed>.
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
103
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
104
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
105 You <indent>can change indentation at any point in a paragraph, which
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
106 makes it possible to do interesting things like
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
107 hanging-indents: this paragraph was indented by selecting the
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
108 region from the second word to the end of the paragraph, and
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
109 indenting only that part.</indent></indent>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
110
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
111
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
112 <x-bg-color><param>blue</param><x-color><param>white</param><bold>JUSTIFICATION</bold></x-color></x-bg-color>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
113
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
114
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
115
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
116 <indent><nofill>Several styles of justification are possible, the simplest being <italic>unfilled.
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
117 </italic>This means that your lines will be left as you write them.
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
118 This paragraph is unfilled.</nofill>
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
119
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
120
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
121 <flushleft>The most common (for English) style is <italic>FlushLeft. </italic>This means
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
122 lines are aligned at the left margin but left uneven at the right.</flushleft>
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
123
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
124
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
125 <flushright> <italic>FlushRight</italic> makes each line flush with the right margin instead.
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
126 This paragraph is FlushRight.</flushright>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
127
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
128
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
129
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
130 <flushboth><italic>FlushBoth </italic>regions, which are sometimes called "fully justified"
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
131 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
132 a smooth appearance as in a book or newspaper article.
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
133 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
134 as it does in a proportionally-spaced printed document; the extra
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
135 spaces that are needed on the screen can make it hard to read. </flushboth>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
136
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
137 <center>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
138
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
139 <bold>Center</bold>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
140
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
141 Finally, there is <italic>center </italic>justification. The normal
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
142 center-paragraph key, M-S, can be used to turn on center
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
143 justification in enriched-mode.
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
144
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
145 M-j or the "Text Properties" menu also can be used to change
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
146 justification.
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
147
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
148
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
149
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
150 </center><flushboth>Note that justification can only change at hard newlines, because
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
151 that is the unit over which filling gets done. </flushboth></indent>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
152
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
153
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
154 <x-bg-color><param>blue</param><x-color><param>white</param><bold>EXCERPTS</bold></x-color></x-bg-color>
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
155
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
156
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
157 <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
158 parts of other people's email messages and the like. It is just a
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
159 face, which is the same as the `italic' face by default.</indent></excerpt>
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
160
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
161
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
162 <x-bg-color><param>blue</param><x-color><param>white</param><bold>THE FILE FORMAT</bold></x-color></x-bg-color>
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
163
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
164
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
165 <indent>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
166 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
167 standard. This means that your documents are transportable (even
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
168 through email) to many other systems. In the future other file
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
169 formats may be supported as well.
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
170
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
171
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
172 Since Emacs adds some non-standard features to the format (colors
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
173 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
174 all of the features of your document, but they will get as close
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
175 as possible.
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
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
178 The MIME standard is defined in </indent>Internet<indent> RFC 1521; text/enriched
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
179 is defined in RFC 1563. Details on obtaining these documents via
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
180 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
181 <fixed>rfc-info@isi.edu</fixed> with the message body:
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
182
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
183
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
184 <fixed><indent>help: ways_to_get_rfcs</indent></fixed>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
185
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
186
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
187 <indent>See also the newsgroup <fixed>comp.mail.mime</fixed>.</indent></indent>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
188
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
189
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
190 <x-bg-color><param>blue</param><x-color><param>white</param><bold>CUSTOMIZATION</bold></x-color></x-bg-color><bold>
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
191
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 </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
194
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
195 -<indent> User-preference variables: <fixed>default-justification,
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
196 enriched-verbose.
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
197
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
198 </fixed></indent>-<indent> You can add annotations for your own text properties by making
57238
d6e9f4f22388 `enriched-annotation-alist' is now called `enriched-translations'.
Luc Teirlinck <teirllm@auburn.edu>
parents: 42944
diff changeset
199 additions to <fixed>enriched-translations</fixed>. Note that the standard
d6e9f4f22388 `enriched-annotation-alist' is now called `enriched-translations'.
Luc Teirlinck <teirllm@auburn.edu>
parents: 42944
diff changeset
200 requires you to name your annotation starting<italic> "x-" </italic>(as in
d6e9f4f22388 `enriched-annotation-alist' is now called `enriched-translations'.
Luc Teirlinck <teirllm@auburn.edu>
parents: 42944
diff changeset
201 <italic>"x-read-only"</italic>). Please send me any such additions that you
d6e9f4f22388 `enriched-annotation-alist' is now called `enriched-translations'.
Luc Teirlinck <teirllm@auburn.edu>
parents: 42944
diff changeset
202 think might be of general interest so that I can include them
d6e9f4f22388 `enriched-annotation-alist' is now called `enriched-translations'.
Luc Teirlinck <teirllm@auburn.edu>
parents: 42944
diff changeset
203 in the distribution.</indent>
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
204
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
205 </indent>
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
206
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
207 <x-bg-color><param>blue</param><x-color><param>white</param><bold>TO-DO LIST</bold></x-color></x-bg-color>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
208
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
209
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
210 <italic><indent>[Feel free to work on these and send me the results!]</indent></italic><indent>
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
211
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
212 + Conform to updated text/enriched spec in RFC 1896.
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
213
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
214 + Be smarter about fixing malformed files.
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
215
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
216 + Make the indentation work more seamlessly and robustly:
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
217
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
218 + Create<indent> an aggressive auto-fill function that will keep the
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
219 paragraph properly filled all the time, without slowing down
33381
026d2f64b0c3 Update todo.
Dave Love <fx@gnu.org>
parents: 19687
diff changeset
220 editing too much. Refill mode is a start at this, but needs
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
221
33381
026d2f64b0c3 Update todo.
Dave Love <fx@gnu.org>
parents: 19687
diff changeset
222 </indent></indent> <indent>improvment.
026d2f64b0c3 Update todo.
Dave Love <fx@gnu.org>
parents: 19687
diff changeset
223
026d2f64b0c3 Update todo.
Dave Love <fx@gnu.org>
parents: 19687
diff changeset
224 + Refill after yank. [Refill mode does that.]
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
225
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
226 +<indent> Make deleting a newline also delete the indentation following
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
227 it.</indent>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
228
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
229 + Never let point enter indentation??
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
230
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
231 + Notice and re-fill when window changes widths (optionally).
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
232
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
233 + Deal with the `category' text-property in a smart way.
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
234
33381
026d2f64b0c3 Update todo.
Dave Love <fx@gnu.org>
parents: 19687
diff changeset
235 + Interface w/ Gnus, VM, RMAIL. Maybe Info too? </indent>(Gnus 5.9 copes
026d2f64b0c3 Update todo.
Dave Love <fx@gnu.org>
parents: 19687
diff changeset
236
026d2f64b0c3 Update todo.
Dave Love <fx@gnu.org>
parents: 19687
diff changeset
237 with text/enriched incoming mail.)<indent>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
238
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
239 + Support more formats: RTF, HTML...
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
240
33381
026d2f64b0c3 Update todo.
Dave Love <fx@gnu.org>
parents: 19687
diff changeset
241 + Use Emacs 21 display features.
026d2f64b0c3 Update todo.
Dave Love <fx@gnu.org>
parents: 19687
diff changeset
242
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
243 </indent>
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
244
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
245 <x-bg-color><param>blue</param><x-color><param>white</param><bold>Final Notes:</bold></x-color></x-bg-color>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
246
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
247
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
248 <indent>This code and documentation is under development. Comments and
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
249 bug reports are welcome.</indent>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
250
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
251
11267
01d6f40201e1 Rewritten and simplified.
Boris Goldowsky <boris@gnu.org>
parents: 11103
diff changeset
252 <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
253
19687
c510bee23510 Updated by Boris.
Richard M. Stallman <rms@gnu.org>
parents: 14020
diff changeset
254 </x-color><x-bg-color><param>blue</param><x-color><param>white</param>April 1995; updated August 1997</x-color></x-bg-color>
9678
721cc180810c Initial revision
Boris Goldowsky <boris@gnu.org>
parents:
diff changeset
255
42944
07abc8d4c648 Reword face color location blurb.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 33381
diff changeset
256
71189
3681678d3d86 Add copyright notice and copying permissions.
Eli Zaretskii <eliz@gnu.org>
parents: 57319
diff changeset
257
3681678d3d86 Add copyright notice and copying permissions.
Eli Zaretskii <eliz@gnu.org>
parents: 57319
diff changeset
258
3681678d3d86 Add copyright notice and copying permissions.
Eli Zaretskii <eliz@gnu.org>
parents: 57319
diff changeset
259 Copyright (c) 1995, 1997, 2006
3681678d3d86 Add copyright notice and copying permissions.
Eli Zaretskii <eliz@gnu.org>
parents: 57319
diff changeset
260 Free software Foundation, Inc.
3681678d3d86 Add copyright notice and copying permissions.
Eli Zaretskii <eliz@gnu.org>
parents: 57319
diff changeset
261
3681678d3d86 Add copyright notice and copying permissions.
Eli Zaretskii <eliz@gnu.org>
parents: 57319
diff changeset
262 COPYING PERMISSIONS:
3681678d3d86 Add copyright notice and copying permissions.
Eli Zaretskii <eliz@gnu.org>
parents: 57319
diff changeset
263
3681678d3d86 Add copyright notice and copying permissions.
Eli Zaretskii <eliz@gnu.org>
parents: 57319
diff changeset
264 This document is free software; you can redistribute it and/or modify
3681678d3d86 Add copyright notice and copying permissions.
Eli Zaretskii <eliz@gnu.org>
parents: 57319
diff changeset
265 it under the terms of the GNU General Public License as published by
3681678d3d86 Add copyright notice and copying permissions.
Eli Zaretskii <eliz@gnu.org>
parents: 57319
diff changeset
266 the Free Software Foundation; either version 2 of the License, or
3681678d3d86 Add copyright notice and copying permissions.
Eli Zaretskii <eliz@gnu.org>
parents: 57319
diff changeset
267 (at your option) any later version.
3681678d3d86 Add copyright notice and copying permissions.
Eli Zaretskii <eliz@gnu.org>
parents: 57319
diff changeset
268
3681678d3d86 Add copyright notice and copying permissions.
Eli Zaretskii <eliz@gnu.org>
parents: 57319
diff changeset
269 This program is distributed in the hope that it will be useful,
3681678d3d86 Add copyright notice and copying permissions.
Eli Zaretskii <eliz@gnu.org>
parents: 57319
diff changeset
270 but WITHOUT ANY WARRANTY; without even the implied warranty of
3681678d3d86 Add copyright notice and copying permissions.
Eli Zaretskii <eliz@gnu.org>
parents: 57319
diff changeset
271 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
3681678d3d86 Add copyright notice and copying permissions.
Eli Zaretskii <eliz@gnu.org>
parents: 57319
diff changeset
272 GNU General Public License for more details.
3681678d3d86 Add copyright notice and copying permissions.
Eli Zaretskii <eliz@gnu.org>
parents: 57319
diff changeset
273
3681678d3d86 Add copyright notice and copying permissions.
Eli Zaretskii <eliz@gnu.org>
parents: 57319
diff changeset
274 You should have received a copy of the GNU General Public License
3681678d3d86 Add copyright notice and copying permissions.
Eli Zaretskii <eliz@gnu.org>
parents: 57319
diff changeset
275 along with this program; if not, write to the Free Software
3681678d3d86 Add copyright notice and copying permissions.
Eli Zaretskii <eliz@gnu.org>
parents: 57319
diff changeset
276 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
3681678d3d86 Add copyright notice and copying permissions.
Eli Zaretskii <eliz@gnu.org>
parents: 57319
diff changeset
277