annotate etc/enriched.doc @ 93487:426872139a89

(Commentary): Point to calendar.el. (calendar-persian-date-string): Reduce nesting of some lets.
author Glenn Morris <rgm@gnu.org>
date Tue, 01 Apr 2008 02:43:30 +0000
parents 1dd7437446ea
children cbf5528cf447
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
79776
1dd7437446ea Add 2008 to copyright years.
Glenn Morris <rgm@gnu.org>
parents: 78271
diff changeset
259 Copyright (C) 1995, 1997, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008
75343
0259a1711394 Update copyright for years from Emacs 21 to present (mainly adding
Glenn Morris <rgm@gnu.org>
parents: 71189
diff changeset
260 Free Software Foundation, Inc.
71189
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
78271
713172dcf518 Switch license to GPLv3 or later.
Glenn Morris <rgm@gnu.org>
parents: 75343
diff changeset
266 the Free Software Foundation; either version 3, or (at your option)
713172dcf518 Switch license to GPLv3 or later.
Glenn Morris <rgm@gnu.org>
parents: 75343
diff changeset
267 any later version.
71189
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
78271
713172dcf518 Switch license to GPLv3 or later.
Glenn Morris <rgm@gnu.org>
parents: 75343
diff changeset
275 along with this program; see the file COPYING. If not, write to
713172dcf518 Switch license to GPLv3 or later.
Glenn Morris <rgm@gnu.org>
parents: 75343
diff changeset
276 the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
713172dcf518 Switch license to GPLv3 or later.
Glenn Morris <rgm@gnu.org>
parents: 75343
diff changeset
277 Boston, MA 02110-1301 USA.