Mercurial > hg > xemacs-beta
annotate man/new-users-guide/region.texi @ 4981:4aebb0131297
Cleanups/renaming of EXTERNAL_TO_C_STRING and friends
-------------------- ChangeLog entries follow: --------------------
modules/ChangeLog addition:
2010-02-05 Ben Wing <ben@xemacs.org>
* postgresql/postgresql.c:
* postgresql/postgresql.c (CHECK_LIVE_CONNECTION):
* postgresql/postgresql.c (Fpq_connectdb):
* postgresql/postgresql.c (Fpq_connect_start):
* postgresql/postgresql.c (Fpq_lo_import):
* postgresql/postgresql.c (Fpq_lo_export):
* ldap/eldap.c (Fldap_open):
* ldap/eldap.c (Fldap_search_basic):
* ldap/eldap.c (Fldap_add):
* ldap/eldap.c (Fldap_modify):
* ldap/eldap.c (Fldap_delete):
* canna/canna_api.c (Fcanna_initialize):
* canna/canna_api.c (Fcanna_store_yomi):
* canna/canna_api.c (Fcanna_parse):
* canna/canna_api.c (Fcanna_henkan_begin):
EXTERNAL_TO_C_STRING returns its argument instead of storing it
in a parameter, and is renamed to EXTERNAL_TO_ITEXT. Similar
things happen to related macros. See entry in src/ChangeLog.
More Mule-izing of postgresql.c. Extract out common code
between `pq-connectdb' and `pq-connect-start'. Fix places
that signal an error string using a formatted string to instead
follow the standard and have a fixed reason followed by the
particular error message stored as one of the frobs.
src/ChangeLog addition:
2010-02-05 Ben Wing <ben@xemacs.org>
* console-msw.c (write_string_to_mswindows_debugging_output):
* console-msw.c (Fmswindows_message_box):
* console-x.c (x_perhaps_init_unseen_key_defaults):
* console.c:
* database.c (dbm_get):
* database.c (dbm_put):
* database.c (dbm_remove):
* database.c (berkdb_get):
* database.c (berkdb_put):
* database.c (berkdb_remove):
* database.c (Fopen_database):
* device-gtk.c (gtk_init_device):
* device-msw.c (msprinter_init_device_internal):
* device-msw.c (msprinter_default_printer):
* device-msw.c (msprinter_init_device):
* device-msw.c (sync_printer_with_devmode):
* device-msw.c (Fmsprinter_select_settings):
* device-x.c (sanity_check_geometry_resource):
* device-x.c (Dynarr_add_validified_lisp_string):
* device-x.c (x_init_device):
* device-x.c (Fx_put_resource):
* device-x.c (Fx_valid_keysym_name_p):
* device-x.c (Fx_set_font_path):
* dialog-msw.c (push_lisp_string_as_unicode):
* dialog-msw.c (handle_directory_dialog_box):
* dialog-msw.c (handle_file_dialog_box):
* dialog-x.c (dbox_descriptor_to_widget_value):
* editfns.c (Fformat_time_string):
* editfns.c (Fencode_time):
* editfns.c (Fset_time_zone_rule):
* emacs.c (make_argc_argv):
* emacs.c (Fdump_emacs):
* emodules.c (emodules_load):
* eval.c:
* eval.c (maybe_signal_error_1):
* event-msw.c (Fdde_alloc_advise_item):
* event-msw.c (mswindows_dde_callback):
* event-msw.c (mswindows_wnd_proc):
* fileio.c (report_error_with_errno):
* fileio.c (Fsysnetunam):
* fileio.c (Fdo_auto_save):
* font-mgr.c (extract_fcapi_string):
* font-mgr.c (Ffc_config_app_font_add_file):
* font-mgr.c (Ffc_config_app_font_add_dir):
* font-mgr.c (Ffc_config_filename):
* frame-gtk.c (gtk_set_frame_text_value):
* frame-gtk.c (gtk_create_widgets):
* frame-msw.c (mswindows_init_frame_1):
* frame-msw.c (mswindows_set_title_from_ibyte):
* frame-msw.c (msprinter_init_frame_3):
* frame-x.c (x_set_frame_text_value):
* frame-x.c (x_set_frame_properties):
* frame-x.c (start_drag_internal_1):
* frame-x.c (x_cde_transfer_callback):
* frame-x.c (x_create_widgets):
* glyphs-eimage.c (my_jpeg_output_message):
* glyphs-eimage.c (jpeg_instantiate):
* glyphs-eimage.c (gif_instantiate):
* glyphs-eimage.c (png_instantiate):
* glyphs-eimage.c (tiff_instantiate):
* glyphs-gtk.c (xbm_instantiate_1):
* glyphs-gtk.c (gtk_xbm_instantiate):
* glyphs-gtk.c (gtk_xpm_instantiate):
* glyphs-gtk.c (gtk_xface_instantiate):
* glyphs-gtk.c (cursor_font_instantiate):
* glyphs-gtk.c (gtk_redisplay_widget):
* glyphs-gtk.c (gtk_widget_instantiate_1):
* glyphs-gtk.c (gtk_add_tab_item):
* glyphs-msw.c (mswindows_xpm_instantiate):
* glyphs-msw.c (bmp_instantiate):
* glyphs-msw.c (mswindows_resource_instantiate):
* glyphs-msw.c (xbm_instantiate_1):
* glyphs-msw.c (mswindows_xbm_instantiate):
* glyphs-msw.c (mswindows_xface_instantiate):
* glyphs-msw.c (mswindows_redisplay_widget):
* glyphs-msw.c (mswindows_widget_instantiate):
* glyphs-msw.c (add_tree_item):
* glyphs-msw.c (add_tab_item):
* glyphs-msw.c (mswindows_combo_box_instantiate):
* glyphs-msw.c (mswindows_widget_query_string_geometry):
* glyphs-x.c (x_locate_pixmap_file):
* glyphs-x.c (xbm_instantiate_1):
* glyphs-x.c (x_xbm_instantiate):
* glyphs-x.c (extract_xpm_color_names):
* glyphs-x.c (x_xpm_instantiate):
* glyphs-x.c (x_xface_instantiate):
* glyphs-x.c (autodetect_instantiate):
* glyphs-x.c (safe_XLoadFont):
* glyphs-x.c (cursor_font_instantiate):
* glyphs-x.c (x_redisplay_widget):
* glyphs-x.c (Fchange_subwindow_property):
* glyphs-x.c (x_widget_instantiate):
* glyphs-x.c (x_tab_control_redisplay):
* glyphs.c (pixmap_to_lisp_data):
* gui-x.c (menu_separator_style_and_to_external):
* gui-x.c (add_accel_and_to_external):
* gui-x.c (button_item_to_widget_value):
* hpplay.c (player_error_internal):
* hpplay.c (play_sound_file):
* hpplay.c (play_sound_data):
* intl.c (Fset_current_locale):
* lisp.h:
* menubar-gtk.c (gtk_xemacs_set_accel_keys):
* menubar-msw.c (populate_menu_add_item):
* menubar-msw.c (populate_or_checksum_helper):
* menubar-x.c (menu_item_descriptor_to_widget_value_1):
* nt.c (init_user_info):
* nt.c (get_long_basename):
* nt.c (nt_get_resource):
* nt.c (init_mswindows_environment):
* nt.c (get_cached_volume_information):
* nt.c (mswindows_readdir):
* nt.c (read_unc_volume):
* nt.c (mswindows_stat):
* nt.c (mswindows_getdcwd):
* nt.c (mswindows_executable_type):
* nt.c (Fmswindows_short_file_name):
* ntplay.c (nt_play_sound_file):
* objects-gtk.c:
* objects-gtk.c (gtk_valid_color_name_p):
* objects-gtk.c (gtk_initialize_font_instance):
* objects-gtk.c (gtk_font_list):
* objects-msw.c (font_enum_callback_2):
* objects-msw.c (parse_font_spec):
* objects-x.c (x_parse_nearest_color):
* objects-x.c (x_valid_color_name_p):
* objects-x.c (x_initialize_font_instance):
* objects-x.c (x_font_instance_truename):
* objects-x.c (x_font_list):
* objects-xlike-inc.c (XFUN):
* objects-xlike-inc.c (xft_find_charset_font):
* process-nt.c (mswindows_report_winsock_error):
* process-nt.c (nt_create_process):
* process-nt.c (get_internet_address):
* process-nt.c (nt_open_network_stream):
* process-unix.c:
* process-unix.c (allocate_pty):
* process-unix.c (get_internet_address):
* process-unix.c (unix_canonicalize_host_name):
* process-unix.c (unix_open_network_stream):
* realpath.c:
* select-common.h (lisp_data_to_selection_data):
* select-gtk.c (symbol_to_gtk_atom):
* select-gtk.c (atom_to_symbol):
* select-msw.c (symbol_to_ms_cf):
* select-msw.c (mswindows_register_selection_data_type):
* select-x.c (symbol_to_x_atom):
* select-x.c (x_atom_to_symbol):
* select-x.c (hack_motif_clipboard_selection):
* select-x.c (Fx_store_cutbuffer_internal):
* sound.c (Fplay_sound_file):
* sound.c (Fplay_sound):
* sound.h (sound_perror):
* sysdep.c:
* sysdep.c (qxe_allocating_getcwd):
* sysdep.c (qxe_execve):
* sysdep.c (copy_in_passwd):
* sysdep.c (qxe_getpwnam):
* sysdep.c (qxe_ctime):
* sysdll.c (dll_open):
* sysdll.c (dll_function):
* sysdll.c (dll_variable):
* sysdll.c (search_linked_libs):
* sysdll.c (dll_error):
* sysfile.h:
* sysfile.h (PATHNAME_CONVERT_OUT_TSTR):
* sysfile.h (PATHNAME_CONVERT_OUT_UTF_8):
* sysfile.h (PATHNAME_CONVERT_OUT):
* sysfile.h (LISP_PATHNAME_CONVERT_OUT):
* syswindows.h (ITEXT_TO_TSTR):
* syswindows.h (LOCAL_FILE_FORMAT_TO_TSTR):
* syswindows.h (TSTR_TO_LOCAL_FILE_FORMAT):
* syswindows.h (LOCAL_FILE_FORMAT_TO_INTERNAL_MSWIN):
* syswindows.h (LISP_LOCAL_FILE_FORMAT_MAYBE_URL_TO_TSTR):
* text.h:
* text.h (eicpy_ext_len):
* text.h (enum new_dfc_src_type):
* text.h (EXTERNAL_TO_ITEXT):
* text.h (GET_STRERROR):
* tooltalk.c (check_status):
* tooltalk.c (Fadd_tooltalk_message_arg):
* tooltalk.c (Fadd_tooltalk_pattern_attribute):
* tooltalk.c (Fadd_tooltalk_pattern_arg):
* win32.c (tstr_to_local_file_format):
* win32.c (mswindows_lisp_error_1):
* win32.c (mswindows_report_process_error):
* win32.c (Fmswindows_shell_execute):
* win32.c (mswindows_read_link_1):
Changes involving external/internal format conversion,
mostly code cleanup and renaming.
1. Eliminate the previous macros like LISP_STRING_TO_EXTERNAL
that stored its result in a parameter. The new version of
LISP_STRING_TO_EXTERNAL returns its result through the
return value, same as the previous NEW_LISP_STRING_TO_EXTERNAL.
Use the new-style macros throughout the code.
2. Rename C_STRING_TO_EXTERNAL and friends to ITEXT_TO_EXTERNAL,
in keeping with overall naming rationalization involving
Itext and related types.
Macros involved in previous two:
EXTERNAL_TO_C_STRING -> EXTERNAL_TO_ITEXT
EXTERNAL_TO_C_STRING_MALLOC -> EXTERNAL_TO_ITEXT_MALLOC
SIZED_EXTERNAL_TO_C_STRING -> SIZED_EXTERNAL_TO_ITEXT
SIZED_EXTERNAL_TO_C_STRING_MALLOC -> SIZED_EXTERNAL_TO_ITEXT_MALLOC
C_STRING_TO_EXTERNAL -> ITEXT_TO_EXTERNAL
C_STRING_TO_EXTERNAL_MALLOC -> ITEXT_TO_EXTERNAL_MALLOC
LISP_STRING_TO_EXTERNAL
LISP_STRING_TO_EXTERNAL_MALLOC
LISP_STRING_TO_TSTR
C_STRING_TO_TSTR -> ITEXT_TO_TSTR
TSTR_TO_C_STRING -> TSTR_TO_ITEXT
The following four still return their values through parameters,
since they have more than one value to return:
C_STRING_TO_SIZED_EXTERNAL -> ITEXT_TO_SIZED_EXTERNAL
LISP_STRING_TO_SIZED_EXTERNAL
C_STRING_TO_SIZED_EXTERNAL_MALLOC -> ITEXT_TO_SIZED_EXTERNAL_MALLOC
LISP_STRING_TO_SIZED_EXTERNAL_MALLOC
Sometimes additional casts had to be inserted, since the old
macros played strange games and completely defeated the type system
of the store params.
3. Rewrite many places where direct calls to TO_EXTERNAL_FORMAT
occurred with calls to one of the convenience macros listed above,
or to make_extstring().
4. Eliminate SIZED_C_STRING macros (they were hardly used, anyway)
and use a direct call to TO_EXTERNAL_FORMAT or TO_INTERNAL_FORMAT.
4. Use LISP_PATHNAME_CONVERT_OUT in many places instead of something
like LISP_STRING_TO_EXTERNAL(..., Qfile_name).
5. Eliminate some temporary variables that are no longer necessary
now that we return a value rather than storing it into a variable.
6. Some Mule-izing in database.c.
7. Error functions:
-- A bit of code cleanup in maybe_signal_error_1.
-- Eliminate report_file_type_error; it's just an alias for
signal_error_2 with params in a different order.
-- Fix some places in the hostname-handling code that directly
inserted externally-retrieved error strings into the
supposed ASCII "reason" param instead of doing the right thing
and sticking text descriptive of what was going on in "reason"
and putting the external message in a frob.
8. Use Ascbyte instead of CIbyte in process-unix.c and maybe one
or two other places.
9. Some code cleanup in copy_in_passwd() in sysdep.c.
10. Fix a real bug due to accidental variable shadowing in
tstr_to_local_file_format() in win32.c.
| author | Ben Wing <ben@xemacs.org> |
|---|---|
| date | Fri, 05 Feb 2010 11:02:24 -0600 |
| parents | abe6d1db359e |
| children |
| rev | line source |
|---|---|
| 428 | 1 @comment node-name, next, previous, up |
| 2 @node Select and Move, Search and Replace, Other Customizations, Top | |
| 3 @chapter Selecting and Moving Text | |
| 4 @cindex region | |
| 5 @cindex mark | |
| 6 | |
| 7 Many Emacs commands operate on an arbitrary contiguous | |
| 8 part of the current buffer. You can select some part of the buffer and | |
| 9 edit only that part of the buffer. This selected buffer is called a | |
| 10 @dfn{region}. You can select text in two ways: | |
| 11 | |
| 12 @itemize @bullet | |
| 13 @item | |
| 14 You use special keys to select text by defining a region between the | |
| 15 cursor and @dfn{the mark} (which you set). | |
| 16 @item | |
| 17 If you are running XEmacs under X, you can also select text | |
| 18 with the mouse. | |
| 19 @end itemize | |
| 20 | |
| 21 @comment node-name, next, previous, up | |
| 22 @menu | |
| 23 * Selecting Text:: Select a region of text by setting the Mark | |
| 24 * Mouse:: Selecting Text with Mouse | |
| 25 * Region Operation:: Various ways to operate on a selected text | |
| 26 * Moving Text:: Moving Text | |
| 27 * Accumulating text:: Accumulating Text from several buffers | |
| 28 @end menu | |
| 29 | |
| 30 @node Selecting Text, Mouse, Select and Move, Select and Move | |
| 31 @section Setting the Mark | |
| 32 @kindex C-SPC | |
| 33 @kindex C-x C-x | |
| 34 @kindex C-< | |
| 35 @kindex C-> | |
| 36 @findex set-mark-command | |
| 37 @findex mark-beginning-of-buffer | |
| 38 @findex mark-end-of-buffer | |
| 39 @findex exchange-point-and-mark | |
| 40 To define a region you need to set @dfn{the mark} at one end of it and | |
| 41 move the cursor to the other end. Once you set the mark, it remains | |
| 42 there until you set it again to some other place. Each buffer has its | |
| 43 own @dfn{mark ring} (a place where Emacs remembers 16 previous | |
| 44 locations of the mark). To set @dfn{the mark}, you can use the | |
| 45 following commands: | |
| 46 | |
| 47 @table @kbd | |
| 48 @item C-@key{SPC} | |
| 49 This command will set @dfn{the mark} at the position of your cursor | |
| 50 (@code{set-mark-command}). You can move your cursor around and @dfn{the | |
| 51 mark} will stay there. | |
| 52 @item C-x C-x | |
| 53 Interchange mark and point (@code{exchange-point-and-mark}). Since Emacs | |
| 54 will have only one cursor, after you move the cursor it will be unable | |
| 55 to show you where you set the @dfn{the mark}. In order to see @dfn{the | |
| 56 mark} you can type the command @kbd{C-x C-x} which will put your cursor | |
| 57 on the position of your mark and your mark on the position of your | |
| 58 cursor. Use the command again to reset the positions of your cursor and | |
| 59 mark. | |
| 60 @item C-< | |
| 61 This command will push the mark at the beginning of the buffer without | |
| 62 changing the position of your cursor. | |
| 63 @item C-> | |
| 64 This command will push the mark at the end of the buffer without | |
| 65 changing the position of your cursor. | |
| 66 @end table | |
| 67 @noindent | |
| 68 You can also give arguments to @kbd{C-<} or @kbd{C->}. @xref{The Mark | |
| 69 and the Region,,,xemacs,XEmacs User's Manual}, for more information. | |
| 70 | |
| 71 @comment node-name, next, previous, up | |
| 72 @node Mouse, Region Operation, Selecting Text, Select and Move | |
| 73 @section Selecting Text with Mouse | |
| 74 @cindex mouse selection | |
| 75 @cindex clipboard selection | |
| 76 @cindex primary selection | |
| 77 @cindex cursor shapes | |
| 78 If you are using XEmacs under X, you can use the mouse to select | |
| 79 text. The selected text will always be highlighted, so just by looking | |
| 80 at the text you know what you have selected so far. To select a word | |
| 81 just double-click with the left-mouse-button on the word. To select a | |
| 82 whole line triple-click anywhere on the line with the | |
| 83 left-mouse-button. You can also use the @b{Copy} item from the @b{Edit} | |
| 84 menu on the menu-bar to select text. This kind of selection is called | |
| 85 @b{Clipboard} selection, @xref{X Clipboard Selection,,,xemacs,XEmacs User's | |
| 86 Manual}, for more information. To select an arbitrary region, follow | |
| 87 these steps: | |
| 88 | |
| 89 @enumerate | |
| 90 @item | |
| 91 Move the mouse cursor over the character at the beginning of the region of | |
| 92 text you want to select. | |
| 93 @item | |
| 94 Press and hold the left mouse button. | |
| 95 @item | |
| 96 While holding the left mouse button down, drag the cursor to the | |
| 97 character at the end of the region of text you want to select. | |
| 98 @item | |
| 99 Release the left mouse button. | |
| 100 @end enumerate | |
| 101 The selected region of text is highlighted. | |
| 102 | |
| 103 @xref{Selecting Text with the Mouse,,,xemacs,XEmacs User's Manual}, for | |
| 104 more information regarding the Mouse and additional mouse operations. | |
| 105 | |
| 106 @comment node-name, next, previous, up | |
| 107 @node Region Operation, Moving Text, Mouse, Select and Move | |
| 108 @section Operating on the Region | |
| 109 Once you have selected a region you can do a lot of things to the text | |
| 110 in the region: | |
| 111 @kindex C-w | |
| 112 @kindex C-x C-u | |
| 113 @kindex C-x C-l | |
| 114 @kindex C-SPC | |
| 115 @kindex C-x TAB | |
| 116 @kindex C-M-\ | |
| 117 @findex print-region | |
| 118 @itemize @bullet | |
| 119 @item | |
| 120 Kill the text with @kbd{C-w}. For example if you want to kill a | |
| 121 paragraph, position the cursor to the beginning of the paragraph and | |
| 122 type @kbd{C-SPC}. Then go to the end of the paragraph and type | |
| 123 @kbd{C-w}. The entire paragraph will be deleted. You can also select the | |
| 124 text with a mouse and type @kbd{C-w} to kill the entire | |
| 125 region. @xref{Killing,,,xemacs,XEmacs User's Manual}, for more information. | |
| 126 | |
| 127 @item | |
| 128 Save the text in a buffer or a file (@pxref{Accumulating | |
| 129 Text,,,xemacs,XEmacs User's Manual}). | |
| 130 @item | |
| 131 You can convert the case of the text with @kbd{C-x C-l} or @kbd{C-x C-u} | |
| 132 If you type @kbd{C-x C-u} the selected text will become all | |
| 133 upper-case. If you type @kbd{C-x C-l} the selected text will become all | |
| 134 lower-case. | |
| 135 @item | |
| 136 Print hardcopy with @kbd{M-x | |
| 137 print-region}. @xref{Hardcopy,,,xemacs,XEmacs User's Manual}, for more | |
| 138 information. This command will print a hardcopy of only the selected | |
| 139 text. | |
| 140 @item | |
| 141 Indent it with @kbd{C-x @key{TAB}} or @kbd{C-M-\} | |
| 142 @xref{Indentation,,,xemacs,XEmacs User's Manual}, for more information. | |
| 143 @end itemize | |
| 144 | |
| 145 | |
| 146 @comment node-name, next, previous, up | |
| 147 @node Moving Text, Accumulating text, Region Operation, Select and Move | |
| 148 @section Moving Text | |
| 149 @cindex yanking | |
| 150 @cindex pasting | |
| 151 @findex yank | |
| 152 @cindex killing | |
| 153 @cindex kill ring | |
| 154 @cindex moving text | |
| 155 @kindex C-y | |
| 156 The most common way to move or copy text in Emacs is through | |
| 157 @dfn{killing} or @samp{cutting} it and then @dfn{yanking} or | |
| 158 @samp{pasting} it. You can also use the @b{Cut} or @b{Copy} option from | |
| 159 the @b{Edit} menu for killing and copying respectively. @xref{Edit menu}, | |
| 160 for reviewing the commands for killing text. All the killed text | |
| 161 in Emacs is recorded in the @dfn{kill ring}. Since there is only one | |
| 162 kill ring in Emacs, you can kill text in one buffer and yank it in | |
| 163 another buffer. To @samp{paste} or | |
| 164 @samp{yank} the killed text you can use the following commands: | |
| 165 @table @kbd | |
| 166 @item C-y | |
| 167 This command will yank or paste the last killed text (@code{yank}). | |
| 168 @item M-w | |
| 169 Save region as last killed text without actually killing it | |
| 170 (@code{copy-region-as-kill}). You can use this command to copy a | |
| 171 selected region and then yank (or paste) it without actually removing it | |
| 172 from the buffer. | |
| 173 @item C-M-w | |
| 174 Append next kill to last batch of killed text | |
| 175 (@code{append-next-kill}). This command will append whatever you killed | |
| 176 last to what you kill now. Then later you will be able to yank the | |
| 177 entire appended text from the @dfn{kill ring}. | |
| 178 @end table | |
| 179 | |
| 180 @comment node-name, next, previous, up | |
| 181 @node Accumulating text, , Moving Text, Select and Move | |
| 182 @section Accumulating Text | |
| 183 @findex append-to-buffer | |
| 184 @findex prepend-to-buffer | |
| 185 @findex copy-to-buffer | |
| 186 @findex append-to-file | |
| 187 @cindex copying text | |
| 188 @cindex accumulating text | |
| 189 @cindex rectangle commands | |
| 190 @cindex registers | |
| 191 @cindex temporary storage | |
| 192 | |
| 193 The following commands can be used for accumulating text from | |
| 194 different buffers into one place or for copying one region of text into | |
| 195 many buffers: | |
| 196 | |
| 197 @table @kbd | |
| 198 @item M-x append-to-buffer | |
| 199 Append region to contents of specified buffer | |
| 200 (@code{append-to-buffer}). After you type in this command and press | |
| 201 @key{RET}, Emacs will prompt you for a buffer name. You will see a | |
| 202 message in the echo area: | |
| 203 @example | |
| 204 Append to buffer: (default <buffer name>) | |
| 205 @end example | |
| 206 @noindent | |
| 207 After you type in a buffer name, a copy of the region will be inserted | |
| 208 at the location of the cursor into that buffer. If there is no buffer | |
| 209 with the name given by you, Emacs will create a new buffer with that | |
| 210 name. By default the cursor's position in the <buffer name> is at the end. | |
| 211 @item M-x prepend-to-buffer | |
| 212 Prepend region to contents of specified buffer. This command is similar | |
| 213 to the above command except that the cursor in the buffer (by default) | |
| 214 is at the beginning rather than at the end. | |
| 215 @item M-x copy-to-buffer | |
| 216 Copy region into specified buffer, deleting that buffer's old | |
| 217 contents. This command will also prompt you for a buffer name. | |
| 218 @item M-x insert-buffer | |
| 219 Insert contents of specified buffer into current buffer at point. This | |
| 442 | 220 command will prompt you for a buffer name which you want to be copied |
| 428 | 221 into the current buffer at the location of the cursor. |
| 222 @item M-x append-to-file | |
| 223 This command will prompt you for a filename and append the region to | |
| 224 the end of the contents of the specified file. | |
| 225 @end table | |
| 226 | |
| 227 @noindent | |
| 228 @xref{Accumulating Text,,,xemacs,XEmacs User's Manual}, for more | |
| 229 information regarding this topic. | |
| 230 | |
| 231 You can also use @dfn{rectangle commands} for operating on rectangular | |
| 232 areas of text. @xref{Rectangles,,,xemacs,XEmacs User's Manual}, for more | |
| 233 information regarding rectangle commands. | |
| 234 | |
| 235 Emacs also provides @dfn{registers} which serve as temporary storage for | |
| 236 text or positions. Each register has a one character name and they can | |
| 237 store @dfn{regions}, a @dfn{rectangle}, or a @dfn{mark} i.e. a cursor | |
| 238 position. Whatever you store in register stays there until you store | |
| 239 something else in that register. To find out about commands which | |
| 240 manipulate registers @xref{Registers,,,xemacs,XEmacs User's Manual}. | |
| 241 | |
| 242 | |
| 243 | |
| 244 | |
| 245 | |
| 246 | |
| 247 | |
| 248 | |
| 249 | |
| 250 | |
| 251 | |
| 252 | |
| 253 | |
| 254 | |
| 255 | |
| 256 | |
| 257 | |
| 258 |