Mercurial > emacs
view etc/enriched.doc @ 51195:3cbf29813eea
(struct frame): Rename members height to text_lines,
width to text_cols, window_height to total_lines, window_width to
total_cols, new_height to new_text_lines, new_width to
new_text_cols. All uses changed.
(struct frame): New members which consolidate common members of
x_output, w32_output, and mac_output structures: left_pos,
top_pos, pixel_height, pixel_width, x_pixels_diff, y_pixels_diff,
win_gravity, size_hint_flags, border_width, internal_border_width,
line_height, fringe_cols, left_fringe_width, right_fringe_width,
want_fullscreen. All uses changed.
(struct frame): New member column_width contaning the canonical
column width, analogue to line_height. All uses changed.
(struct frame): Rename members scroll_bar_pixel_width to
config_scroll_bar_width, and scroll_bar_cols to
config_scroll_bar_cols. All uses changed.
(struct frame): New member scroll_bar_actual_width which
consolidates and renames the vertical_scroll_bar_extra member of
x_output, w32_output, and mac_output structures. All uses changed.
(FRAME_PIXEL_HEIGHT): Renamed from PIXEL_HEIGHT and moved
from x/w32/macterm.h files. All uses changed. Also change code
which referred to f->output_data...->pixel_height.
(FRAME_PIXEL_WIDTH): Renamed from PIXEL_WIDTH and moved
from x/w32/macterm.h files. All uses changed. Also change code
which referred to f->output_data...->pixel_width.
(FRAME_LINES): Renamed from FRAME_HEIGHT. All uses changed.
Also change code which referred to f->height.
(FRAME_COLS): Renamed from FRAME_WIDTH. All uses changed.
Also change code which referred to f->width.
(FRAME_NEW_HEIGHT, FRAME_NEW_WIDTH): Remove macros; change uses
to update new_text_lines and new_text_cols members directly.
(FRAME_CONFIG_SCROLL_BAR_WIDTH): Renamed from
FRAME_SCROLL_BAR_PIXEL_WIDTH. All uses changed.
(FRAME_CONFIG_SCROLL_BAR_COLS): Renamed from
FRAME_SCROLL_BAR_COLS. All uses changed.
(FRAME_LEFT_SCROLL_BAR_COLS, FRAME_RIGHT_SCROLL_BAR_COLS):
Renamed from FRAME_LEFT_SCROLL_BAR_WIDTH and
FRAME_RIGHT_SCROLL_BAR_WIDTH, resp. All uses changed.
(FRAME_SCROLL_BAR_AREA_WIDTH, FRAME_LEFT_SCROLL_BAR_AREA_WIDTH)
(FRAME_RIGHT_SCROLL_BAR_AREA_WIDTH): New macros.
(FRAME_TOTAL_COLS): Renamed from FRAME_WINDOW_WIDTH.
(SET_FRAME_COLS): Renamed from SET_FRAME_WIDTH.
(FRAME_TOTAL_COLS_ARG): Renamed from FRAME_WINDOW_WIDTH_ARG.
(WINDOW_VERTICAL_SCROLL_BAR_COLUMN): Remove unused macro.
(WINDOW_VERTICAL_SCROLL_BAR_HEIGHT): Remove unused macro.
(FRAME_LINE_HEIGHT): Renamed from CANON_Y_UNIT. Unconditionally
return line_height member (it now has proper value also for
non-window frames).
(FRAME_COLUMN_WIDTH): Renamed from CANON_X_UNIT. Unconditionally
return new column_width member (rather than the default font width).
(FRAME_FRINGE_COLS, FRAME_LEFT_FRINGE_WIDTH)
(FRAME_RIGHT_FRINGE_WIDTH): Renamed from FRAME_X_... and moved
from x/w32/macterm.h files. Unconditionally return corresponding
member of frame structure (they now have proper values also for
non-window frames).
(FRAME_TOTAL_FRINGE_WIDTH): Renamed from FRAME_FRINGE_WIDTH.
Calculate return value from left and right widths.
(FRAME_INTERNAL_BORDER_WIDTH): Unconditionally return
internal_border_width member (has proper value for non-window frame).
(FRAME_PIXEL_X_FROM_CANON_X): Renamed from PIXEL_X_FROM_CANON_X.
(FRAME_PIXEL_Y_FROM_CANON_Y): Renamed from PIXEL_Y_FROM_CANON_Y.
(FRAME_CANON_X_FROM_PIXEL_X): Renamed from CANON_X_FROM_PIXEL_X.
(FRAME_CANON_Y_FROM_PIXEL_Y): Renamed from CANON_Y_FROM_PIXEL_Y.
(FRAME_LINE_TO_PIXEL_Y): Renamed from CHAR_TO_PIXEL_ROW,
consolidated from xterm.h, macterm.h, and w32term.h.
(FRAME_COL_TO_PIXEL_X): Renamed from CHAR_TO_PIXEL_COL,
consolidated from xterm.h, macterm.h, and w32term.h.
(FRAME_TEXT_COLS_TO_PIXEL_WIDTH): Renamed from
CHAR_TO_PIXEL_WIDTH consolidated from x/mac/w32term.h.
(FRAME_TEXT_LINES_TO_PIXEL_HEIGHT): Renamed from
CHAR_TO_PIXEL_HEIGHT consolidated from x/mac/w32term.h.
(FRAME_PIXEL_Y_TO_LINE): Renamed from PIXEL_TO_CHAR_ROW
consolidated from x/mac/w32term.h.
(FRAME_PIXEL_X_TO_COL): Renamed from PIXEL_TO_CHAR_COL
consolidated from x/mac/w32term.h.
(FRAME_PIXEL_WIDTH_TO_TEXT_COLS): Renamed from
PIXEL_TO_CHAR_WIDTH consolidated from x/mac/w32term.h.
(FRAME_PIXEL_HEIGHT_TO_TEXT_LINES): Renamed from
PIXEL_TO_CHAR_HEIGHT consolidated from x/mac/w32term.h.
author | Kim F. Storm <storm@cua.dk> |
---|---|
date | Sat, 24 May 2003 21:58:07 +0000 |
parents | 07abc8d4c648 |
children | d6e9f4f22388 d7ddb3e565de |
line wrap: on
line source
Content-Type: text/enriched Text-Width: 70 <center><x-bg-color><param>blue</param><x-color><param>white</param><bold><fixed>enriched.el:</fixed></bold></x-color></x-bg-color> <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> </center><bold><x-bg-color><param>blue</param><x-color><param>white</param>INTRODUCTION</x-color></x-bg-color></bold> <indent>Emacs now has the ability to edit <italic>enriched text</italic>, which is text containing faces, colors, indentation, and other properties. This document is a quick introduction to some of the new features, and is also an example file in the <italic>text/enriched </italic>format.</indent> <x-bg-color><param>blue</param><x-color><param>white</param><bold>INSTALLATION and STARTUP</bold></x-color></x-bg-color> <indent>Most of the time, you need not do anything to get these features to work. If you visit a file that has been written out in <italic>text/enriched</italic> format, it will automatically be decoded, Emacs will enter `enriched-mode' while visiting it, and whenever you save it it will be saved in the same format it was read in. If you wish to create a new file, however, you will need to turn on enriched-mode yourself: <fixed><indent>M-x enriched-mode RET</indent></fixed> Or, if you get a <italic>text/enriched </italic>file that Emacs does not automatically recognize and decode, you can tell Emacs to decode it (which also turns on enriched-mode automatically): <fixed><indent>M-x format-decode-buffer RET text/enriched RET</indent></fixed></indent> <x-bg-color><param>blue</param><x-color><param>white</param><bold>WHAT IS ENCODED</bold></x-color></x-bg-color> <indent>Here is the current list of text-properties that are saved; they are discussed in more detail below. Most of these can be added or changed with the "Text Properties" menu, available under the "Edit" item in the menu-bar, or on C-mouse-2 (Control + the middle mouse button). <bold>Faces:</bold> <indent>default, <bold>bold</bold>, <italic>italic</italic>, <underline>underline</underline>, etc.</indent> <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> <bold>Newlines:</bold> <indent>Which ones are real ("hard") newlines, and which can be changed to fit lines into the margins.</indent> <bold>Margins:</bold> <indent>can be indented on the left or right.</indent> <bold>Justification</bold> <indent>(whether lines should be flush with the left margin, the right margin, fully justified, centered, or left alone).</indent> <bold>Excerpts:</bold><indent> <excerpt>"For quoted material."</excerpt></indent> <bold>Read-only</bold> regions. </indent> <x-bg-color><param>blue</param><x-color><param>white</param><bold>FACES and COLORS</bold></x-color></x-bg-color> <indent>You can add faces either with the menu or with <fixed>M-g.</fixed> The face is applied to the current region. If you are using `transient-mark-mode' and the region is not active, then the face applies to whatever you type next. Any face can have colors. If this is its lone attribute, the face is put on the color submenus of the "Text Properties" menu.</indent> <x-bg-color><param>blue</param><x-color><param>white</param><bold>NEWLINES and PARAGRAPHS</bold></x-color></x-bg-color> <italic><indent>Text/enriched</indent></italic><indent> format distinguishes between <underline>hard</underline> and <underline>soft</underline> newlines. Hard newlines are used to separate paragraphs, or items in a list, or anywhere that must be a line break no matter what the margins are. Soft newlines are the ones inserted in order to fit text between the margins. The fill and auto-fill functions insert soft newlines as necessary, but hard newlines are only inserted by direct request, such as using the return key or the <fixed>C-o (open-line)</fixed> function.</indent> <x-bg-color><param>blue</param><x-color><param>white</param><bold>INDENTATION</bold></x-color></x-bg-color> <indent>The fill functions also understand margins, which can be set for any region of a document. In addition to the menu items, which increase or decrease the margins, there are two commands for setting the margins absolutely: <fixed>C-c C-l (set-left-margin)</fixed> and <fixed>C-c C-r (set-right-margin)</fixed>. You <indent>can change indentation at any point in a paragraph, which makes it possible to do interesting things like hanging-indents: this paragraph was indented by selecting the region from the second word to the end of the paragraph, and indenting only that part.</indent></indent> <x-bg-color><param>blue</param><x-color><param>white</param><bold>JUSTIFICATION</bold></x-color></x-bg-color> <indent><nofill>Several styles of justification are possible, the simplest being <italic>unfilled. </italic>This means that your lines will be left as you write them. This paragraph is unfilled.</nofill> <flushleft>The most common (for English) style is <italic>FlushLeft. </italic>This means lines are aligned at the left margin but left uneven at the right.</flushleft> <flushright> <italic>FlushRight</italic> makes each line flush with the right margin instead. This paragraph is FlushRight.</flushright> <flushboth><italic>FlushBoth </italic>regions, which are sometimes called "fully justified" are aligned evenly on both edges, so that the text on the page has a smooth appearance as in a book or newspaper article. Unfortunately this does not look as nice with a fixed-width font as it does in a proportionally-spaced printed document; the extra spaces that are needed on the screen can make it hard to read. </flushboth> <center> <bold>Center</bold> Finally, there is <italic>center </italic>justification. The normal center-paragraph key, M-S, can be used to turn on center justification in enriched-mode. M-j or the "Text Properties" menu also can be used to change justification. </center><flushboth>Note that justification can only change at hard newlines, because that is the unit over which filling gets done. </flushboth></indent> <x-bg-color><param>blue</param><x-color><param>white</param><bold>EXCERPTS</bold></x-color></x-bg-color> <excerpt><indent>This is an example of an excerpt. You can use them for quoted parts of other people's email messages and the like. It is just a face, which is the same as the `italic' face by default.</indent></excerpt> <x-bg-color><param>blue</param><x-color><param>white</param><bold>THE FILE FORMAT</bold></x-color></x-bg-color> <indent>Enriched-mode documents are saved in an extended version of a format called <italic>text/enriched</italic>, which is defined as part of the MIME standard. This means that your documents are transportable (even through email) to many other systems. In the future other file formats may be supported as well. Since Emacs adds some non-standard features to the format (colors and read-only regions), not all systems will be able to recreate all of the features of your document, but they will get as close as possible. The MIME standard is defined in </indent>Internet<indent> RFC 1521; text/enriched is defined in RFC 1563. Details on obtaining these documents via FTP or email may be obtained by sending an email message to <fixed>rfc-info@isi.edu</fixed> with the message body: <fixed><indent>help: ways_to_get_rfcs</indent></fixed> <indent>See also the newsgroup <fixed>comp.mail.mime</fixed>.</indent></indent> <x-bg-color><param>blue</param><x-color><param>white</param><bold>CUSTOMIZATION</bold></x-color></x-bg-color><bold> </bold><indent>-<indent> The <fixed>fixed </fixed>and <excerpt>excerpt </excerpt>faces should be set to your liking.</indent> -<indent> User-preference variables: <fixed>default-justification, enriched-verbose. </fixed></indent>-<indent> You can add annotations for your own text properties by making additions to <fixed>enriched-annotation-alist</fixed>. Note that the standard requires you to name your annotation starting<italic> "x-" </italic>(as in <italic>"x-read-only"</italic>). Please send me any such additions that you think might be of general interest so that I can include them in the distribution.</indent> </indent> <x-bg-color><param>blue</param><x-color><param>white</param><bold>TO-DO LIST</bold></x-color></x-bg-color> <italic><indent>[Feel free to work on these and send me the results!]</indent></italic><indent> + Conform to updated text/enriched spec in RFC 1896. + Be smarter about fixing malformed files. + Make the indentation work more seamlessly and robustly: + Create<indent> an aggressive auto-fill function that will keep the paragraph properly filled all the time, without slowing down editing too much. Refill mode is a start at this, but needs </indent></indent> <indent>improvment. + Refill after yank. [Refill mode does that.] +<indent> Make deleting a newline also delete the indentation following it.</indent> + Never let point enter indentation?? + Notice and re-fill when window changes widths (optionally). + Deal with the `category' text-property in a smart way. + Interface w/ Gnus, VM, RMAIL. Maybe Info too? </indent>(Gnus 5.9 copes with text/enriched incoming mail.)<indent> + Support more formats: RTF, HTML... + Use Emacs 21 display features. </indent> <x-bg-color><param>blue</param><x-color><param>white</param><bold>Final Notes:</bold></x-color></x-bg-color> <indent>This code and documentation is under development. Comments and bug reports are welcome.</indent> <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> </x-color><x-bg-color><param>blue</param><x-color><param>white</param>April 1995; updated August 1997</x-color></x-bg-color>