annotate man/xemacs/glossary.texi @ 1204:e22b0213b713

[xemacs-hg @ 2003-01-12 11:07:58 by michaels] modules/ChangeLog: 2002-12-16 Ben Wing <ben@xemacs.org> * postgresql/postgresql.c: remove ifdef USE_KKCC. src/ChangeLog: 2003-01-08 Mike Sperber <mike@xemacs.org> * console.h (CDFW_CONSOLE): Don't lead to a crash if we're dealing with a dead window/frame/device/console. 2002-12-20 Mike Sperber <mike@xemacs.org> * ui-gtk.c: Fix typo from Ben's patch: emacs_ffi_data is a typedef, not a struct. emacs_gtk_object_data is a typedef, not a struct. * gtk-glue.c (gdk_event_to_emacs_event): Fix typos from Ben's patch: le -> emacs_event + rearrange the code. * event-gtk.c (gtk_event_to_emacs_event): Fix typos from Ben's patch: ..._UNDERLYING_GDK_EVENT -> ..._GDK_EVENT, ev -> key_event. * device-gtk.c: Fix typo from Ben's patch: x_keysym_map_hash_table -> x_keysym_map_hashtable. 2002-12-19 Mike Sperber <mike@xemacs.org> * menubar-x.c (set_frame_menubar): Initialize protect_me field of popup_data. 2002-12-16 Ben Wing <ben@xemacs.org> Major cleanup of KKCC, etc. KKCC, pdump-related: -- descriptions are written for all objects. this required some changes in the format of some objects, e.g. extents, popup-data, coding system, lstream, lcrecord-list. -- KKCC now handles weakness in markers, hash tables, elsewhere correctly (formerly, you'd eventually get a stack overflow due to endlessly expanding markers). -- textual changes: lrecord_description -> memory_description, struct_description -> sized_memory_description. -- extensive comment describing descriptions and pdump. -- redo XD_UNION so it works inline and change its format to provide sufficient info for pdump. implement XD_UNION in pdump. also add XD_UNION_DYNAMIC_SIZE, which works like XD_UNION except for when auto-computing structure sizes. -- add support for XD_INDIRECT in description offsets (used by extents). -- add support for "description maps", allowing for indirect descriptions that are retrieved from an object at run-time. this generalizes XD_CODING_SYSTEM_END, XD_SPECIFIER_END, etc., which have now been eliminated. -- add a fifth field "flags" to memory_description, to support flags that can be specified for this particular line. Currently defined flags are XD_FLAG_NO_KKCC (KKCC should ignore this entry; useful for the weakness above in markers, etc.), XD_FLAG_NO_PDUMP (pdump should ignore this entry), XD_FLAG_UNION_DEFAULT_ENTRY (in union maps, this specifies a "default" entry for all remaining values), and XD_FLAG_FREE_LISP_OBJECT (for use with lcrecord-lists). -- clean up the kkcc-itis in events, so that the differences between event data as separate objects and as a union are now minimized to a small number of places. with the new XD_UNION, we no longer need event data as separate objects, so this code is no longer ifdef USE_KKCC, but instead ifdef EVENT_DATA_AS_OBJECTS, not used by default. make sure that we explicitly free the separate event data objects when no longer in use, to maintain the invariant the event processing causes no consing. -- also remove other USE_KKCC ifdefs when not necessary. -- allow for KKCC compilation under MS Windows. -- fix README.kkcc. -- dump_add_root_object -> dump_add_root_lisp_object. -- implement dump_add_root_block and use this to handle dump_add_opaque. -- factor out some code duplicated in kkcc and pdump. Other allocation/object-related: -- change various *slots.h so MARKED_SLOT() call no longer includes semicolon. -- free_marker() takes a Lisp_Object not a direct pointer. -- make bit vectors lcrecords, like vectors, and eliminate code that essentially duplicated the lcrecord handling. -- additional asserts in FREE_FIXED_TYPE, formerly duplicated in the various callers of this. -- all lcrecord allocation functions now zero out the returned lcrecords. unnecessary calls to zero_lcrecord removed. add long comment describing these functions. -- extract out process and coding system slots, like for buffers, frames, etc. -- lcrecords now set the type of items sitting on the free list to lcrecord_type_free. -- changes to the way that gap arrays are allocated, for kkcc's benefit -- now, one single memory block with a stretchy array on the end, instead of a separate block holding the array. Error-checking-related: -- now can compile with C++ under MS Windows. clean up compile errors discovered that way. (a few were real problems) -- add C++ error-checking code to verify problems with mismatched GCPRO/UNGCPRO. (there were a few in the kkcc code.) add long comment about how to catch insufficient GCPRO (yes, it's possible using C++). -- add debug_p4(), a simple object printer, when debug_print() doesn't work. -- add dp() and db() as short synonyms of debug_print(), debug_backtrace(). -- `print' tries EXTREMELY hard to avoid core dumping when printing when crashing or from debug_print(), and tries as hard as it reasonably can in other situations. -- Correct the message output upon crashing to be more up-to-date. Event-related: -- document event-matches-key-specifier-p better. -- generalize the dispatch queues formerly duplicated in the various event implementations. add event methods to drain pending events. generalize and clean up QUIT handling, removing event-specific quit processing. allow arbitrary keystrokes, not just ASCII, to be the QUIT char. among other things, this should fix some longstanding bugs in X quit handling. long comment describing the various event queues. -- implement delaying of XFlush() if there are pending expose events. SOMEONE PLEASE TRY THIS OUT. -- Fix `xemacs -batch -l dunnet' under Cygwin. Try to fix under MS Windows but not quite there yet. Other: -- class -> class_ and no more C++ games with this item. new -> new_ in the lwlib code, so far not elsewhere. -- use `struct htentry' not `struct hentry' in elhash.c to avoid debugger confusion with hash.c. -- new macros ALIST_LOOP_3, ALIST_LOOP_4. * README.kkcc: * alloc.c: * alloc.c (deadbeef_memory): * alloc.c (allocate_lisp_storage): * alloc.c (copy_lisp_object): * alloc.c (ALLOCATE_FIXED_TYPE_1): * alloc.c (FREE_FIXED_TYPE): * alloc.c (make_vector_internal): * alloc.c (make_bit_vector_internal): * alloc.c (make_key_data): * alloc.c (make_button_data): * alloc.c (make_motion_data): * alloc.c (make_process_data): * alloc.c (make_timeout_data): * alloc.c (make_magic_data): * alloc.c (make_magic_eval_data): * alloc.c (make_eval_data): * alloc.c (make_misc_user_data): * alloc.c (struct string_chars_block): * alloc.c (mark_lcrecord_list): * alloc.c (make_lcrecord_list): * alloc.c (alloc_managed_lcrecord): * alloc.c (free_managed_lcrecord): * alloc.c (alloc_automanaged_lcrecord): * alloc.c (staticpro_1): * alloc.c (staticpro): * alloc.c (lispdesc_indirect_count_1): * alloc.c (lispdesc_indirect_description_1): * alloc.c (lispdesc_one_description_line_size): * alloc.c (lispdesc_structure_size): * alloc.c (mark_object_maybe_checking_free): * alloc.c (mark_with_description): * alloc.c (mark_struct_contents): * alloc.c (mark_object): * alloc.c (tick_lcrecord_stats): * alloc.c (free_cons): * alloc.c (free_key_data): * alloc.c (free_button_data): * alloc.c (free_motion_data): * alloc.c (free_process_data): * alloc.c (free_timeout_data): * alloc.c (free_magic_data): * alloc.c (free_magic_eval_data): * alloc.c (free_eval_data): * alloc.c (free_misc_user_data): * alloc.c (free_marker): * alloc.c (compact_string_chars): * alloc.c (gc_sweep): * alloc.c (garbage_collect_1): * alloc.c (Fgarbage_collect): * alloc.c (common_init_alloc_early): * alloc.c (init_alloc_early): * alloc.c (init_alloc_once_early): * buffer.c: * buffer.c (mark_buffer): * buffer.c (MARKED_SLOT): * buffer.c (cleanup_buffer_undo_lists): * buffer.c (Fget_file_buffer): * buffer.h (MARKED_SLOT): * bufslots.h: * bytecode.c: * callint.c: * casetab.c: * chartab.c: * chartab.c (symbol_to_char_table_type): * cmdloop.c: * cmdloop.c (Fcommand_loop_1): * config.h.in (new): * conslots.h: * console-gtk-impl.h (struct gtk_frame): * console-impl.h: * console-impl.h (struct console): * console-impl.h (MARKED_SLOT): * console-impl.h (CONSOLE_QUIT_EVENT): * console-msw-impl.h (XM_BUMPQUEUE): * console-msw.c (write_string_to_mswindows_debugging_output): * console-msw.h: * console-stream-impl.h: * console-stream-impl.h (struct stream_console): * console-stream.c: * console-stream.c (stream_init_console): * console-stream.h: * console-tty.c: * console-tty.h: * console-x.h: * console.c: * console.c (mark_console): * console.c (MARKED_SLOT): * console.c (allocate_console): * console.c (get_console_variant): * console.c (create_console): * console.c (delete_console_internal): * console.c (Fset_input_mode): * console.c (Fcurrent_input_mode): * console.c (common_init_complex_vars_of_console): * console.h: * console.h (console_variant): * console.h (device_metrics): * data.c: * data.c (Faref): * data.c (Faset): * data.c (decode_weak_list_type): * database.c: * debug.c (xemacs_debug_loop): * debug.c (FROB): * debug.c (Fadd_debug_class_to_check): * debug.c (Fdelete_debug_class_to_check): * debug.c (Fset_debug_classes_to_check): * debug.c (Fset_debug_class_types_to_check): * debug.c (Fdebug_types_being_checked): * debug.h (DASSERT): * device-gtk.c: * device-impl.h (struct device): * device-impl.h (MARKED_SLOT): * device-msw.c: * device-x.c: * device-x.c (x_init_device_class): * device-x.c (x_comp_visual_info): * device-x.c (x_try_best_visual_class): * device-x.c (x_init_device): * device-x.c (construct_name_list): * device-x.c (x_get_resource_prefix): * device-x.c (Fx_get_resource): * device-x.c (Fx_display_visual_class): * device.c: * device.c (MARKED_SLOT): * device.c (allocate_device): * device.c (Fmake_device): * device.c (delete_device_internal): * device.c (Fset_device_class): * device.h: * devslots.h: * devslots.h (MARKED_SLOT): * dialog-msw.c: * dired-msw.c (mswindows_ls_sort_fcn): * dired-msw.c (mswindows_get_files): * dired-msw.c (mswindows_format_file): * doprnt.c (parse_doprnt_spec): * dumper.c: * dumper.c (struct): * dumper.c (dump_add_root_block): * dumper.c (dump_add_root_struct_ptr): * dumper.c (dump_add_root_lisp_object): * dumper.c (pdump_struct_list_elt): * dumper.c (pdump_get_entry_list): * dumper.c (pdump_backtrace): * dumper.c (pdump_bump_depth): * dumper.c (pdump_register_sub): * dumper.c (pdump_register_object): * dumper.c (pdump_register_struct_contents): * dumper.c (pdump_register_struct): * dumper.c (pdump_store_new_pointer_offsets): * dumper.c (pdump_dump_data): * dumper.c (pdump_reloc_one): * dumper.c (pdump_allocate_offset): * dumper.c (pdump_scan_by_alignment): * dumper.c (pdump_dump_root_blocks): * dumper.c (pdump_dump_rtables): * dumper.c (pdump_dump_root_lisp_objects): * dumper.c (pdump): * dumper.c (pdump_load_finish): * dumper.c (pdump_file_get): * dumper.c (pdump_resource_get): * dumper.c (pdump_load): * editfns.c (save_excursion_restore): * editfns.c (user_login_name): * editfns.c (save_restriction_restore): * elhash.c: * elhash.c (htentry): * elhash.c (struct Lisp_Hash_Table): * elhash.c (HTENTRY_CLEAR_P): * elhash.c (LINEAR_PROBING_LOOP): * elhash.c (check_hash_table_invariants): * elhash.c (mark_hash_table): * elhash.c (hash_table_equal): * elhash.c (print_hash_table_data): * elhash.c (free_hentries): * elhash.c (make_general_lisp_hash_table): * elhash.c (decode_hash_table_weakness): * elhash.c (decode_hash_table_test): * elhash.c (Fcopy_hash_table): * elhash.c (resize_hash_table): * elhash.c (pdump_reorganize_hash_table): * elhash.c (find_htentry): * elhash.c (Fgethash): * elhash.c (Fputhash): * elhash.c (remhash_1): * elhash.c (Fremhash): * elhash.c (Fclrhash): * elhash.c (copy_compress_hentries): * elhash.c (elisp_maphash_unsafe): * elhash.c (finish_marking_weak_hash_tables): * elhash.c (prune_weak_hash_tables): * elhash.h: * emacs.c: * emacs.c (main_1): * emacs.c (main): * emacs.c (shut_down_emacs): * emodules.h (dump_add_root_lisp_object): * eval.c: * eval.c (unwind_to_catch): * eval.c (maybe_signal_error_1): * eval.c (maybe_signal_continuable_error_1): * eval.c (maybe_signal_error): * eval.c (maybe_signal_continuable_error): * eval.c (maybe_signal_error_2): * eval.c (maybe_signal_continuable_error_2): * eval.c (maybe_signal_ferror): * eval.c (maybe_signal_continuable_ferror): * eval.c (maybe_signal_ferror_with_frob): * eval.c (maybe_signal_continuable_ferror_with_frob): * eval.c (maybe_syntax_error): * eval.c (maybe_sferror): * eval.c (maybe_invalid_argument): * eval.c (maybe_invalid_constant): * eval.c (maybe_invalid_operation): * eval.c (maybe_invalid_change): * eval.c (maybe_invalid_state): * eval.c (Feval): * eval.c (call_trapping_problems): * eval.c (call_with_suspended_errors): * eval.c (warn_when_safe_lispobj): * eval.c (warn_when_safe): * eval.c (vars_of_eval): * event-Xt.c: * event-Xt.c (maybe_define_x_key_as_self_inserting_character): * event-Xt.c (x_to_emacs_keysym): * event-Xt.c (x_event_to_emacs_event): * event-Xt.c (emacs_Xt_enqueue_focus_event): * event-Xt.c (emacs_Xt_format_magic_event): * event-Xt.c (emacs_Xt_compare_magic_event): * event-Xt.c (emacs_Xt_hash_magic_event): * event-Xt.c (emacs_Xt_handle_magic_event): * event-Xt.c (Xt_timeout_to_emacs_event): * event-Xt.c (Xt_process_to_emacs_event): * event-Xt.c (signal_special_Xt_user_event): * event-Xt.c (emacs_Xt_next_event): * event-Xt.c (emacs_Xt_event_handler): * event-Xt.c (emacs_Xt_drain_queue): * event-Xt.c (emacs_Xt_event_pending_p): * event-Xt.c (check_if_pending_expose_event): * event-Xt.c (reinit_vars_of_event_Xt): * event-Xt.c (vars_of_event_Xt): * event-gtk.c: * event-gtk.c (IS_MODIFIER_KEY): * event-gtk.c (emacs_gtk_format_magic_event): * event-gtk.c (emacs_gtk_compare_magic_event): * event-gtk.c (emacs_gtk_hash_magic_event): * event-gtk.c (emacs_gtk_handle_magic_event): * event-gtk.c (gtk_to_emacs_keysym): * event-gtk.c (gtk_timeout_to_emacs_event): * event-gtk.c (gtk_process_to_emacs_event): * event-gtk.c (dragndrop_data_received): * event-gtk.c (signal_special_gtk_user_event): * event-gtk.c (emacs_gtk_next_event): * event-gtk.c (gtk_event_to_emacs_event): * event-gtk.c (generic_event_handler): * event-gtk.c (emacs_shell_event_handler): * event-gtk.c (emacs_gtk_drain_queue): * event-gtk.c (emacs_gtk_event_pending_p): * event-gtk.c (reinit_vars_of_event_gtk): * event-gtk.c (vars_of_event_gtk): * event-msw.c: * event-msw.c (struct winsock_stream): * event-msw.c (winsock_reader): * event-msw.c (winsock_writer): * event-msw.c (mswindows_enqueue_dispatch_event): * event-msw.c (mswindows_enqueue_misc_user_event): * event-msw.c (mswindows_enqueue_magic_event): * event-msw.c (mswindows_enqueue_process_event): * event-msw.c (mswindows_enqueue_mouse_button_event): * event-msw.c (mswindows_enqueue_keypress_event): * event-msw.c (mswindows_dequeue_dispatch_event): * event-msw.c (emacs_mswindows_drain_queue): * event-msw.c (mswindows_need_event_in_modal_loop): * event-msw.c (mswindows_need_event): * event-msw.c (mswindows_wm_timer_callback): * event-msw.c (dde_eval_string): * event-msw.c (Fdde_alloc_advise_item): * event-msw.c (mswindows_dde_callback): * event-msw.c (mswindows_wnd_proc): * event-msw.c (remove_timeout_mapper): * event-msw.c (emacs_mswindows_remove_timeout): * event-msw.c (emacs_mswindows_event_pending_p): * event-msw.c (emacs_mswindows_format_magic_event): * event-msw.c (emacs_mswindows_compare_magic_event): * event-msw.c (emacs_mswindows_hash_magic_event): * event-msw.c (emacs_mswindows_handle_magic_event): * event-msw.c (emacs_mswindows_select_console): * event-msw.c (emacs_mswindows_unselect_console): * event-msw.c (reinit_vars_of_event_mswindows): * event-msw.c (vars_of_event_mswindows): * event-stream.c: * event-stream.c (mark_command_builder): * event-stream.c (reset_command_builder_event_chain): * event-stream.c (allocate_command_builder): * event-stream.c (copy_command_builder): * event-stream.c (command_builder_append_event): * event-stream.c (event_stream_event_pending_p): * event-stream.c (event_stream_force_event_pending): * event-stream.c (maybe_read_quit_event): * event-stream.c (event_stream_drain_queue): * event-stream.c (remove_quit_p_event): * event-stream.c (event_stream_quit_p): * event-stream.c (echo_key_event): * event-stream.c (maybe_kbd_translate): * event-stream.c (execute_help_form): * event-stream.c (event_stream_generate_wakeup): * event-stream.c (enqueue_dispatch_event): * event-stream.c (enqueue_magic_eval_event): * event-stream.c (Fenqueue_eval_event): * event-stream.c (enqueue_misc_user_event): * event-stream.c (enqueue_misc_user_event_pos): * event-stream.c (next_event_internal): * event-stream.c (Fnext_event): * event-stream.c (Faccept_process_output): * event-stream.c (execute_internal_event): * event-stream.c (munge_keymap_translate): * event-stream.c (command_builder_find_leaf_no_mule_processing): * event-stream.c (command_builder_find_leaf): * event-stream.c (lookup_command_event): * event-stream.c (is_scrollbar_event): * event-stream.c (execute_command_event): * event-stream.c (Fdispatch_event): * event-stream.c (Fread_key_sequence): * event-stream.c (dribble_out_event): * event-stream.c (vars_of_event_stream): * event-tty.c (tty_timeout_to_emacs_event): * event-tty.c (emacs_tty_next_event): * event-tty.c (emacs_tty_drain_queue): * event-tty.c (reinit_vars_of_event_tty): * event-unixoid.c: * event-unixoid.c (find_tty_or_stream_console_from_fd): * event-unixoid.c (read_event_from_tty_or_stream_desc): * event-unixoid.c (drain_tty_devices): * event-unixoid.c (poll_fds_for_input): * events.c: * events.c (deinitialize_event): * events.c (zero_event): * events.c (mark_event): * events.c (print_event_1): * events.c (print_event): * events.c (event_equal): * events.c (event_hash): * events.c (Fmake_event): * events.c (Fdeallocate_event): * events.c (Fcopy_event): * events.c (map_event_chain_remove): * events.c (character_to_event): * events.c (event_to_character): * events.c (Fevent_to_character): * events.c (format_event_object): * events.c (upshift_event): * events.c (downshift_event): * events.c (event_upshifted_p): * events.c (Fevent_live_p): * events.c (Fevent_type): * events.c (Fevent_timestamp): * events.c (CHECK_EVENT_TYPE): * events.c (CHECK_EVENT_TYPE2): * events.c (CHECK_EVENT_TYPE3): * events.c (Fevent_key): * events.c (Fevent_button): * events.c (Fevent_modifier_bits): * events.c (event_x_y_pixel_internal): * events.c (event_pixel_translation): * events.c (Fevent_process): * events.c (Fevent_function): * events.c (Fevent_object): * events.c (Fevent_properties): * events.c (syms_of_events): * events.c (vars_of_events): * events.h: * events.h (struct event_stream): * events.h (struct Lisp_Key_Data): * events.h (KEY_DATA_KEYSYM): * events.h (EVENT_KEY_KEYSYM): * events.h (struct Lisp_Button_Data): * events.h (EVENT_BUTTON_BUTTON): * events.h (struct Lisp_Motion_Data): * events.h (EVENT_MOTION_X): * events.h (struct Lisp_Process_Data): * events.h (EVENT_PROCESS_PROCESS): * events.h (struct Lisp_Timeout_Data): * events.h (EVENT_TIMEOUT_INTERVAL_ID): * events.h (struct Lisp_Eval_Data): * events.h (EVENT_EVAL_FUNCTION): * events.h (struct Lisp_Misc_User_Data): * events.h (EVENT_MISC_USER_FUNCTION): * events.h (struct Lisp_Magic_Eval_Data): * events.h (EVENT_MAGIC_EVAL_INTERNAL_FUNCTION): * events.h (struct Lisp_Magic_Data): * events.h (EVENT_MAGIC_UNDERLYING): * events.h (EVENT_MAGIC_GDK_EVENT): * events.h (struct Lisp_Event): * events.h (XEVENT_CHANNEL): * events.h (SET_EVENT_TIMESTAMP_ZERO): * events.h (SET_EVENT_CHANNEL): * events.h (SET_EVENT_NEXT): * events.h (XSET_EVENT_TYPE): * events.h (struct command_builder): * extents.c: * extents.c (gap_array_adjust_markers): * extents.c (gap_array_recompute_derived_values): * extents.c (gap_array_move_gap): * extents.c (gap_array_make_gap): * extents.c (gap_array_insert_els): * extents.c (gap_array_delete_els): * extents.c (gap_array_make_marker): * extents.c (gap_array_delete_marker): * extents.c (gap_array_move_marker): * extents.c (make_gap_array): * extents.c (free_gap_array): * extents.c (extent_list_num_els): * extents.c (extent_list_insert): * extents.c (mark_extent_auxiliary): * extents.c (allocate_extent_auxiliary): * extents.c (decode_extent_at_flag): * extents.c (verify_extent_mapper): * extents.c (symbol_to_glyph_layout): * extents.c (syms_of_extents): * faces.c: * file-coding.c: * file-coding.c (struct_detector_category_description =): * file-coding.c (detector_category_dynarr_description_1): * file-coding.c (struct_detector_description =): * file-coding.c (detector_dynarr_description_1): * file-coding.c (MARKED_SLOT): * file-coding.c (mark_coding_system): * file-coding.c (coding_system_extra_description_map): * file-coding.c (coding_system_description): * file-coding.c (allocate_coding_system): * file-coding.c (symbol_to_eol_type): * file-coding.c (Fcoding_system_aliasee): * file-coding.c (set_coding_stream_coding_system): * file-coding.c (struct convert_eol_coding_system): * file-coding.c (struct undecided_coding_system): * file-coding.c (undecided_mark_coding_stream): * file-coding.c (coding_category_symbol_to_id): * file-coding.c (struct gzip_coding_system): * file-coding.c (coding_system_type_create): * file-coding.h: * file-coding.h (struct Lisp_Coding_System): * file-coding.h (CODING_SYSTEM_SLOT_DECLARATION): * file-coding.h (coding_system_variant): * file-coding.h (struct coding_system_methods): * file-coding.h (DEFINE_CODING_SYSTEM_TYPE_WITH_DATA): * file-coding.h (INITIALIZE_CODING_SYSTEM_TYPE_WITH_DATA): * file-coding.h (struct coding_stream): * fileio.c (Fsubstitute_in_file_name): * floatfns.c: * fns.c: * fns.c (base64_encode_1): * frame-gtk.c: * frame-gtk.c (Fgtk_start_drag_internal): * frame-impl.h (struct frame): * frame-impl.h (MARKED_SLOT): * frame-msw.c: * frame-x.c: * frame-x.c (Fcde_start_drag_internal): * frame-x.c (Foffix_start_drag_internal): * frame.c: * frame.c (MARKED_SLOT): * frame.c (allocate_frame_core): * frame.c (delete_frame_internal): * frame.c (Fmouse_position_as_motion_event): * frameslots.h: * frameslots.h (MARKED_SLOT_ARRAY): * free-hook.c: * glyphs-msw.c (mswindows_widget_instantiate): * glyphs-x.c: * glyphs-x.c (convert_EImage_to_XImage): * glyphs.c: * glyphs.c (process_image_string_instantiator): * glyphs.c (mark_image_instance): * glyphs.c (allocate_image_instance): * glyphs.c (unmap_subwindow): * glyphs.c (map_subwindow): * glyphs.c (syms_of_glyphs): * glyphs.c (specifier_type_create_image): * glyphs.h: * glyphs.h (struct text_image_instance): * glyphs.h (struct Lisp_Image_Instance): * gmalloc.c: * gmalloc.c ("C"): * gpmevent.c (Freceive_gpm_event): * gpmevent.c (gpm_next_event_cb): * gpmevent.c (vars_of_gpmevent): * gtk-glue.c (gdk_event_to_emacs_event): * gtk-xemacs.c (gtk_xemacs_class_init): * gui-msw.c: * gui-msw.c (mswindows_handle_gui_wm_command): * gui-msw.c (mswindows_translate_menu_or_dialog_item): * gui-x.c: * gui-x.c (mark_popup_data): * gui-x.c (snarf_widget_value_mapper): * gui-x.c (gcpro_popup_callbacks): * gui-x.c (ungcpro_popup_callbacks): * gui-x.c (free_popup_widget_value_tree): * gui-x.c (popup_selection_callback): * gui-x.h: * gui-x.h (struct popup_data): * gui.c: * gui.c (allocate_gui_item): * gutter.c (decode_gutter_position): * hash.c (NULL_ENTRY): * indent.c (vmotion_1): * indent.c (vmotion_pixels): * input-method-motif.c (res): * input-method-xlib.c (IMInstantiateCallback): * input-method-xlib.c (XIM_init_device): * input-method-xlib.c (res): * intl-encap-win32.c: * intl-encap-win32.c (qxeSHGetDataFromIDList): * intl-win32.c: * intl-win32.c (mswindows_multibyte_cp_type): * intl-win32.c (struct mswindows_multibyte_coding_system): * keymap.c: * keymap.c (make_key_description): * keymap.c (keymap_store): * keymap.c (get_keyelt): * keymap.c (keymap_lookup_1): * keymap.c (define_key_parser): * keymap.c (key_desc_list_to_event): * keymap.c (event_matches_key_specifier_p): * keymap.c (meta_prefix_char_p): * keymap.c (ensure_meta_prefix_char_keymapp): * keymap.c (Fdefine_key): * keymap.c (struct raw_lookup_key_mapper_closure): * keymap.c (raw_lookup_key): * keymap.c (raw_lookup_key_mapper): * keymap.c (lookup_keys): * keymap.c (lookup_events): * keymap.c (Flookup_key): * keymap.c (struct map_keymap_unsorted_closure): * keymap.c (map_keymap_unsorted_mapper): * keymap.c (map_keymap_sorted): * keymap.c (map_keymap_mapper): * keymap.c (map_keymap): * keymap.c (accessible_keymaps_mapper_1): * keymap.c (Faccessible_keymaps): * keymap.c (Fsingle_key_description): * keymap.c (raw_keys_to_keys): * keymap.c (format_raw_keys): * keymap.c (where_is_recursive_mapper): * keymap.c (where_is_internal): * keymap.c (describe_map_mapper_shadow_search): * keymap.c (keymap_lookup_inherited_mapper): * keymap.c (describe_map_mapper): * keymap.h (event_matches_key_specifier_p): * lisp.h: * lisp.h (this): * lisp.h (RETURN_NOT_REACHED): * lisp.h (struct Lisp_Vector): * lisp.h (struct Lisp_Bit_Vector): * lisp.h (UNGCPRO_1): * lisp.h (NUNGCPRO): * lisp.h (NNUNGCPRO): * lisp.h (DECLARE_INLINE_HEADER): * lrecord.h: * lrecord.h (struct lrecord_header): * lrecord.h (struct lcrecord_header): * lrecord.h (lrecord_type): * lrecord.h (struct lrecord_implementation): * lrecord.h (RECORD_DUMPABLE): * lrecord.h (memory_description_type): * lrecord.h (data_description_entry_flags): * lrecord.h (struct memory_description): * lrecord.h (struct sized_memory_description): * lrecord.h (XD_INDIRECT): * lrecord.h (XD_IS_INDIRECT): * lrecord.h (XD_DYNARR_DESC): * lrecord.h (DEFINE_BASIC_LRECORD_IMPLEMENTATION): * lrecord.h (MAKE_LRECORD_IMPLEMENTATION): * lrecord.h (MAKE_EXTERNAL_LRECORD_IMPLEMENTATION): * lrecord.h (alloc_lcrecord_type): * lstream.c: * lstream.c (Lstream_new): * lstream.c (lisp_buffer_marker): * lstream.h: * lstream.h (lstream_implementation): * lstream.h (DEFINE_LSTREAM_IMPLEMENTATION): * lstream.h (DEFINE_LSTREAM_IMPLEMENTATION_WITH_DATA): * marker.c: * marker.c (copy_marker_1): * mem-limits.h: * menubar-gtk.c: * menubar-gtk.c (gtk_popup_menu): * menubar-msw.c: * menubar-msw.c (mswindows_popup_menu): * menubar-x.c (make_dummy_xbutton_event): * menubar-x.c (command_builder_operate_menu_accelerator): * menubar-x.c (menu_accelerator_safe_compare): * menubar-x.c (menu_accelerator_safe_mod_compare): * mule-charset.c: * mule-charset.c (make_charset): * mule-charset.c (Fcharset_property): * mule-coding.c: * mule-coding.c (ccs_description_1): * mule-coding.c (ccs_description =): * mule-coding.c (ccsd_description_1): * mule-coding.c (ccsd_description =): * nt.c (getpwnam): * nt.c (init_mswindows_environment): * nt.c (get_cached_volume_information): * nt.c (mswindows_is_executable): * nt.c (read_unc_volume): * nt.c (mswindows_access): * nt.c (mswindows_link): * nt.c (mswindows_fstat): * nt.c (mswindows_stat): * nt.c (mswindows_executable_type): * nt.c (Fmswindows_short_file_name): * nt.c (Fmswindows_long_file_name): * objects-impl.h (struct Lisp_Color_Instance): * objects-impl.h (struct Lisp_Font_Instance): * objects-tty.c: * objects-x.c (allocate_nearest_color): * objects.c: * objects.c (Fmake_color_instance): * objects.c (Fmake_font_instance): * objects.c (font_instantiate): * opaque.c: * opaque.c (make_opaque): * opaque.c (make_opaque_ptr): * opaque.c (reinit_opaque_early): * opaque.c (init_opaque_once_early): * print.c: * print.c (printing_badness): * print.c (printing_major_badness): * print.c (print_internal): * print.c (debug_p4): * print.c (dp): * print.c (debug_backtrace): * process-nt.c (nt_create_process): * process-nt.c (get_internet_address): * process-unix.c: * process-unix.c (struct unix_process_data): * process-unix.c (get_internet_address): * process-unix.c (unix_alloc_process_data): * process-unix.c (unix_create_process): * process-unix.c (try_to_initialize_subtty): * process-unix.c (unix_kill_child_process): * process-unix.c (process_type_create_unix): * process.c: * process.c (mark_process): * process.c (MARKED_SLOT): * process.c (make_process_internal): * process.c (Fprocess_tty_name): * process.c (decode_signal): * process.h: * procimpl.h: * procimpl.h (struct process_methods): * procimpl.h (struct Lisp_Process): * rangetab.c: * realpath.c (readlink_and_correct_case): * redisplay-x.c (x_window_output_end): * redisplay-x.c (x_redraw_exposed_area): * redisplay-x.c (x_clear_frame): * redisplay.c: * redisplay.h: * redisplay.h (struct rune_dglyph): * redisplay.h (struct rune): * scrollbar.c: * scrollbar.c (create_scrollbar_instance): * specifier.c: * specifier.c (specifier_empty_extra_description_1): * specifier.c (make_specifier_internal): * specifier.c (decode_locale_type): * specifier.c (decode_how_to_add_specification): * specifier.h: * specifier.h (struct specifier_methods): * specifier.h (DEFINE_SPECIFIER_TYPE_WITH_DATA): * specifier.h (INITIALIZE_SPECIFIER_TYPE_WITH_DATA): * symbols.c: * symbols.c (Fsetplist): * symbols.c (default_value): * symbols.c (decode_magic_handler_type): * symbols.c (handler_type_from_function_symbol): * symbols.c (Fdefvaralias): * symbols.c (init_symbols_once_early): * symbols.c (reinit_symbols_early): * symsinit.h: * sysdep.c (sys_subshell): * sysdep.c (tty_init_sys_modes_on_device): * syswindows.h: * text.c (dfc_convert_to_external_format): * text.c (dfc_convert_to_internal_format): * text.c (reinit_eistring_early): * text.c (init_eistring_once_early): * text.c (reinit_vars_of_text): * text.h: * text.h (INC_IBYTEPTR_FMT): * text.h (DEC_IBYTEPTR_FMT): * toolbar.c: * toolbar.c (decode_toolbar_position): * tooltalk.c: * ui-gtk.c: * unexnt.c: * unexnt.c (_start): * unexnt.c (unexec): * unexnt.c (get_section_info): * unicode.c: * unicode.c (vars_of_unicode): * window.c: * window.c (allocate_window): * window.c (new_window_mirror): * window.c (update_mirror_internal): * winslots.h:
author michaels
date Sun, 12 Jan 2003 11:08:22 +0000
parents abe6d1db359e
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2 @node Glossary, Manifesto, Intro, Top
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3 @unnumbered Glossary
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
4
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
5 @table @asis
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
6 @item Abbrev
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
7 An abbrev is a text string which expands into a different text string
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
8 when present in the buffer. For example, you might define a short
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
9 word as an abbrev for a long phrase that you want to insert
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
10 frequently. @xref{Abbrevs}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
11
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
12 @item Aborting
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
13 Aborting means getting out of a recursive edit (q.v.@:). You can use
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
14 the commands @kbd{C-]} and @kbd{M-x top-level} for this.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
15 @xref{Quitting}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
16
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
17 @item Auto Fill mode
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
18 Auto Fill mode is a minor mode in which text you insert is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
19 automatically broken into lines of fixed width. @xref{Filling}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
20
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
21 @item Auto Saving
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
22 Auto saving means that Emacs automatically stores the contents of an
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
23 Emacs buffer in a specially-named file so the information will not be
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
24 lost if the buffer is lost due to a system error or user error.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
25 @xref{Auto Save}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
26
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
27 @item Backup File
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
28 A backup file records the contents that a file had before the current
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
29 editing session. Emacs creates backup files automatically to help you
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
30 track down or cancel changes you later regret. @xref{Backup}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
31
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
32 @item Balance Parentheses
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
33 Emacs can balance parentheses manually or automatically. Manual
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
34 balancing is done by the commands to move over balanced expressions
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
35 (@pxref{Lists}). Automatic balancing is done by blinking the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
36 parenthesis that matches one just inserted (@pxref{Matching,,Matching
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
37 Parens}).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
38
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
39 @item Bind
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
40 To bind a key is to change its binding (q.v.@:). @xref{Rebinding}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
41
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
42 @item Binding
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
43 A key gets its meaning in Emacs by having a binding which is a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
44 command (q.v.@:), a Lisp function that is run when the key is typed.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
45 @xref{Commands,Binding}. Customization often involves rebinding a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
46 character to a different command function. The bindings of all keys
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
47 are recorded in the keymaps (q.v.@:). @xref{Keymaps}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
48
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
49 @item Blank Lines
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
50 Blank lines are lines that contain only whitespace. Emacs has several
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
51 commands for operating on the blank lines in a buffer.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
52
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
53 @item Buffer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
54 The buffer is the basic editing unit; one buffer corresponds to one
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
55 piece of text being edited. You can have several buffers, but at any
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
56 time you are editing only one, the `selected' buffer, though several
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
57 buffers can be visible when you are using multiple windows. @xref{Buffers}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
58
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
59 @item Buffer Selection History
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
60 Emacs keeps a buffer selection history which records how recently each
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
61 Emacs buffer was selected. Emacs uses this list when choosing a buffer to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
62 select. @xref{Buffers}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
63
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
64 @item C-
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
65 @samp{C} in the name of a character is an abbreviation for Control.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
66 @xref{Keystrokes,C-}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
67
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
68 @item C-M-
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
69 @samp{C-M-} in the name of a character is an abbreviation for
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
70 Control-Meta. @xref{Keystrokes,C-M-}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
71
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
72 @item Case Conversion
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
73 Case conversion means changing text from upper case to lower case or
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
74 vice versa. @xref{Case}, for the commands for case conversion.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
75
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
76 @item Characters
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
77 Characters form the contents of an Emacs buffer; also, Emacs commands
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
78 are invoked by keys (q.v.@:), which are sequences of one or more
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
79 characters. @xref{Keystrokes}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
80
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
81 @item Command
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
82 A command is a Lisp function specially defined to be able to serve as a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
83 key binding in Emacs. When you type a key (q.v.@:), Emacs looks up its
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
84 binding (q.v.@:) in the relevant keymaps (q.v.@:) to find the command to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
85 run. @xref{Commands}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
86
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
87 @item Command Name
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
88 A command name is the name of a Lisp symbol which is a command
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
89 (@pxref{Commands}). You can invoke any command by its name using
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
90 @kbd{M-x} (@pxref{M-x}).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
91
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
92 @item Comments
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
93 A comment is text in a program which is intended only for the people
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
94 reading the program, and is marked specially so that it will be
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
95 ignored when the program is loaded or compiled. Emacs offers special
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
96 commands for creating, aligning, and killing comments.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
97 @xref{Comments}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
98
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
99 @item Compilation
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
100 Compilation is the process of creating an executable program from
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
101 source code. Emacs has commands for compiling files of Emacs Lisp
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
102 code (@pxref{Lisp Libraries}) and programs in C and other languages
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
103 (@pxref{Compilation}).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
104
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
105 @item Complete Key
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
106 A complete key is a character or sequence of characters which, when typed
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
107 by the user, fully specifies one action to be performed by Emacs. For
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
108 example, @kbd{X} and @kbd{Control-f} and @kbd{Control-x m} are keys. Keys
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
109 derive their meanings from being bound (q.v.@:) to commands (q.v.@:).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
110 Thus, @kbd{X} is conventionally bound to a command to insert @samp{X} in
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
111 the buffer; @kbd{C-x m} is conventionally bound to a command to begin
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
112 composing a mail message. @xref{Keystrokes}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
113
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
114 @item Completion
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
115 When Emacs automatically fills an abbreviation for a name into the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
116 entire name, that process is called completion. Completion is done for
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
117 minibuffer (q.v.@:) arguments when the set of possible valid inputs is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
118 known; for example, on command names, buffer names, and file names.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
119 Completion occurs when you type @key{TAB}, @key{SPC}, or @key{RET}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
120 @xref{Completion}.@refill
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
121
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
122 @item Continuation Line
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
123 When a line of text is longer than the width of the frame, it
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
124 takes up more than one screen line when displayed. We say that the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
125 text line is continued, and all screen lines used for it after the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
126 first are called continuation lines. @xref{Basic,Continuation,Basic
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
127 Editing}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
128
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
129 @item Control-Character
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
130 ASCII characters with octal codes 0 through 037, and also code 0177,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
131 do not have graphic images assigned to them. These are the control
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
132 characters. Any control character can be typed by holding down the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
133 @key{CTRL} key and typing some other character; some have special keys
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
134 on the keyboard. @key{RET}, @key{TAB}, @key{ESC}, @key{LFD}, and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
135 @key{DEL} are all control characters. @xref{Keystrokes}.@refill
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
136
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
137 @item Copyleft
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
138 A copyleft is a notice giving the public legal permission to redistribute
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
139 a program or other work of art. Copylefts are used by leftists to enrich
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
140 the public just as copyrights are used by rightists to gain power over
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
141 the public.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
142
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
143 @item Current Buffer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
144 The current buffer in Emacs is the Emacs buffer on which most editing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
145 commands operate. You can select any Emacs buffer as the current one.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
146 @xref{Buffers}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
147
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
148 @item Current Line
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
149 The line point is on (@pxref{Point}).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
150
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
151 @item Current Paragraph
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
152 The paragraph that point is in. If point is between paragraphs, the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
153 current paragraph is the one that follows point. @xref{Paragraphs}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
154
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
155 @item Current Defun
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
156 The defun (q.v.@:) that point is in. If point is between defuns, the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
157 current defun is the one that follows point. @xref{Defuns}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
158
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
159 @item Cursor
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
160 The cursor is the rectangle on the screen which indicates the position
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
161 called point (q.v.@:) at which insertion and deletion takes place.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
162 The cursor is on or under the character that follows point. Often
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
163 people speak of `the cursor' when, strictly speaking, they mean
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
164 `point'. @xref{Basic,Cursor,Basic Editing}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
165
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
166 @item Customization
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
167 Customization is making minor changes in the way Emacs works. It is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
168 often done by setting variables (@pxref{Variables}) or by rebinding
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
169 keys (@pxref{Keymaps}).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
170
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
171 @item Default Argument
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
172 The default for an argument is the value that is used if you do not
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
173 specify one. When Emacs prompts you in the minibuffer for an argument,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
174 the default argument is used if you just type @key{RET}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
175 @xref{Minibuffer}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
176
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
177 @item Default Directory
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
178 When you specify a file name that does not start with @samp{/} or @samp{~},
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
179 it is interpreted relative to the current buffer's default directory.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
180 @xref{Minibuffer File,Default Directory}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
181
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
182 @item Defun
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
183 A defun is a list at the top level of parenthesis or bracket structure
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
184 in a program. It is so named because most such lists in Lisp programs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
185 are calls to the Lisp function @code{defun}. @xref{Defuns}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
186
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
187 @item @key{DEL}
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
188 The @key{DEL} character runs the command that deletes one character of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
189 text. @xref{Basic,DEL,Basic Editing}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
190
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
191 @item Deletion
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
192 Deleting text means erasing it without saving it. Emacs deletes text
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
193 only when it is expected not to be worth saving (all whitespace, or
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
194 only one character). The alternative is killing (q.v.@:).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
195 @xref{Killing,Deletion}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
196
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
197 @item Deletion of Files
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
198 Deleting a file means removing it from the file system.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
199 @xref{Misc File Ops}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
200
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
201 @item Deletion of Messages
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
202 Deleting a message means flagging it to be eliminated from your mail
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
203 file. Until the mail file is expunged, you can undo this by undeleting
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
204 the message.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
205
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
206 @item Deletion of Frames
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
207 When working under the multi-frame X-based version of XEmacs,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
208 you can delete individual frames using the @b{Close} menu item from the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
209 @b{File} menu.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
210
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
211 @item Deletion of Windows
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
212 When you delete a subwindow of an Emacs frame, you eliminate it from
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
213 the frame. Other windows expand to use up the space. The deleted
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
214 window can never come back, but no actual text is lost. @xref{Windows}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
215
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
216 @item Directory
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
217 Files in the Unix file system are grouped into file directories.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
218 @xref{ListDir,,Directories}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
219
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
220 @item Dired
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
221 Dired is the Emacs facility that displays the contents of a file
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
222 directory and allows you to ``edit the directory'', performing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
223 operations on the files in the directory. @xref{Dired}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
224
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
225 @item Disabled Command
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
226 A disabled command is one that you may not run without special
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
227 confirmation. Commands are usually disabled because they are
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
228 confusing for beginning users. @xref{Disabling}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
229
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
230 @item Dribble File
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
231 A file into which Emacs writes all the characters that the user types
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
232 on the keyboard. Dribble files are used to make a record for
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
233 debugging Emacs bugs. Emacs does not make a dribble file unless you
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
234 tell it to. @xref{Bugs}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
235
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
236 @item Echo Area
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
237 The area at the bottom of the Emacs frame which is used for echoing the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
238 arguments to commands, for asking questions, and for printing brief
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
239 messages (including error messages). @xref{Echo Area}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
240
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
241 @item Echoing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
242 Echoing refers to acknowledging the receipt of commands by displaying them
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
243 (in the echo area). Emacs never echoes single-character keys; longer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
244 keys echo only if you pause while typing them.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
245
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
246 @item Error
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
247 An error occurs when an Emacs command cannot execute in the current
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
248 circumstances. When an error occurs, execution of the command stops
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
249 (unless the command has been programmed to do otherwise) and Emacs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
250 reports the error by printing an error message (q.v.). Type-ahead
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
251 is discarded. Then Emacs is ready to read another editing command.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
252
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
253 @item Error Messages
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
254 Error messages are single lines of output printed by Emacs when the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
255 user asks for something impossible to do (such as killing text
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
256 forward when point is at the end of the buffer). They appear in the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
257 echo area, accompanied by a beep.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
258
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
259 @item @key{ESC}
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
260 @key{ESC} is a character used as a prefix for typing Meta characters on
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
261 keyboards lacking a @key{META} key. Unlike the @key{META} key (which,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
262 like the @key{SHIFT} key, is held down while another character is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
263 typed), the @key{ESC} key is pressed and released, and applies to the
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 0
diff changeset
264 next character typed.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
265
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
266 @item Fill Prefix
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
267 The fill prefix is a string that Emacs enters at the beginning
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
268 of each line when it performs filling. It is not regarded as part of the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
269 text to be filled. @xref{Filling}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
270
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
271 @item Filling
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
272 Filling text means moving text from line to line so that all the lines
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
273 are approximately the same length. @xref{Filling}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
274
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
275 @item Frame
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
276 When running Emacs on a TTY terminal, ``frame'' means the terminal's
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
277 screen. When running Emacs under X, you can have multiple frames,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
278 each corresponding to a top-level X window and each looking like
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
279 the screen on a TTY. Each frame contains one or more non-overlapping
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
280 Emacs windows (possibly with associated scrollbars, under X), an
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 0
diff changeset
281 echo area, and (under X) possibly a menubar, toolbar, and/or gutter.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
282
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
283 @item Global
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
284 Global means `independent of the current environment; in effect
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
285 @*throughout Emacs'. It is the opposite of local (q.v.@:).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
286 Examples of the use of `global' appear below.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
287
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
288 @item Global Abbrev
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
289 A global definition of an abbrev (q.v.@:) is effective in all major
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
290 modes that do not have local (q.v.@:) definitions for the same abbrev.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
291 @xref{Abbrevs}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
292
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
293 @item Global Keymap
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
294 The global keymap (q.v.@:) contains key bindings that are in effect
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
295 unless local key bindings in a major mode's local
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
296 keymap (q.v.@:) override them.@xref{Keymaps}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
297
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
298 @item Global Substitution
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
299 Global substitution means replacing each occurrence of one string by
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
300 another string through a large amount of text. @xref{Replace}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
301
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
302 @item Global Variable
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
303 The global value of a variable (q.v.@:) takes effect in all buffers
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
304 that do not have their own local (q.v.@:) values for the variable.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
305 @xref{Variables}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
306
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
307 @item Graphic Character
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
308 Graphic characters are those assigned pictorial images rather than
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
309 just names. All the non-Meta (q.v.@:) characters except for the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
310 Control (q.v.@:) character are graphic characters. These include
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
311 letters, digits, punctuation, and spaces; they do not include
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
312 @key{RET} or @key{ESC}. In Emacs, typing a graphic character inserts
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
313 that character (in ordinary editing modes). @xref{Basic,,Basic Editing}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
314
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
315 @item Grinding
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
316 Grinding means adjusting the indentation in a program to fit the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
317 nesting structure. @xref{Indentation,Grinding}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
318
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
319 @item Hardcopy
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
320 Hardcopy means printed output. Emacs has commands for making printed
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
321 listings of text in Emacs buffers. @xref{Hardcopy}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
322
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
323 @item @key{HELP}
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
324 You can type @key{HELP} at any time to ask what options you have, or
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
325 to ask what any command does. @key{HELP} is really @kbd{Control-h}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
326 @xref{Help}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
327
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
328 @item Inbox
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
329 An inbox is a file in which mail is delivered by the operating system.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
330 Some mail handlers transfers mail from inboxes to mail files (q.v.) in
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
331 which the mail is then stored permanently or until explicitly deleted.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
332
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
333 @item Indentation
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
334 Indentation means blank space at the beginning of a line. Most
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
335 programming languages have conventions for using indentation to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
336 illuminate the structure of the program, and Emacs has special
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
337 features to help you set up the correct indentation.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
338 @xref{Indentation}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
339
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
340 @item Insertion
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
341 Insertion means copying text into the buffer, either from the keyboard
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
342 or from some other place in Emacs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
343
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
344 @item Justification
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
345 Justification means adding extra spaces to lines of text to make them
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
346 come exactly to a specified width. @xref{Filling,Justification}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
347
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
348 @item Keyboard Macros
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
349 Keyboard macros are a way of defining new Emacs commands from
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
350 sequences of existing ones, with no need to write a Lisp program.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
351 @xref{Keyboard Macros}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
352
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
353 @item Key
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
354 A key is a sequence of characters that, when input to Emacs, specify
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
355 or begin to specify a single action for Emacs to perform. That is,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
356 the sequence is considered a single unit. If the key is enough to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
357 specify one action, it is a complete key (q.v.); if it is less than
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
358 enough, it is a prefix key (q.v.). @xref{Keystrokes}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
359
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
360 @item Keymap
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
361 The keymap is the data structure that records the bindings (q.v.@:) of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
362 keys to the commands that they run. For example, the keymap binds the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
363 character @kbd{C-n} to the command function @code{next-line}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
364 @xref{Keymaps}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
365
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
366 @item Kill Ring
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
367 The kill ring is the place where all text you have killed recently is saved.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
368 You can re-insert any of the killed text still in the ring; this is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
369 called yanking (q.v.@:). @xref{Yanking}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
370
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
371 @item Killing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
372 Killing means erasing text and saving it on the kill ring so it can be
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
373 yanked (q.v.@:) later. Some other systems call this ``cutting.''
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
374 Most Emacs commands to erase text do killing, as opposed to deletion
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
375 (q.v.@:). @xref{Killing}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
376
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
377 @item Killing Jobs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
378 Killing a job (such as, an invocation of Emacs) means making it cease
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
379 to exist. Any data within it, if not saved in a file, is lost.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
380 @xref{Exiting}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
381
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
382 @item List
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
383 A list is, approximately, a text string beginning with an open
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
384 parenthesis and ending with the matching close parenthesis. In C mode
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
385 and other non-Lisp modes, groupings surrounded by other kinds of matched
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
386 delimiters appropriate to the language, such as braces, are also
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
387 considered lists. Emacs has special commands for many operations on
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
388 lists. @xref{Lists}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
389
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
390 @item Local
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
391 Local means `in effect only in a particular context'; the relevant
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
392 kind of context is a particular function execution, a particular
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
393 buffer, or a particular major mode. Local is the opposite of `global'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
394 (q.v.@:). Specific uses of `local' in Emacs terminology appear below.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
395
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
396 @item Local Abbrev
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
397 A local abbrev definition is effective only if a particular major mode
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
398 is selected. In that major mode, it overrides any global definition
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
399 for the same abbrev. @xref{Abbrevs}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
400
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
401 @item Local Keymap
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
402 A local keymap is used in a particular major mode; the key bindings
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
403 (q.v.@:) in the current local keymap override global bindings of the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
404 same keys. @xref{Keymaps}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
405
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
406 @item Local Variable
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
407 A local value of a variable (q.v.@:) applies to only one buffer.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
408 @xref{Locals}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
409
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
410 @item M-
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
411 @kbd{M-} in the name of a character is an abbreviation for @key{META},
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
412 one of the modifier keys that can accompany any character.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
413 @xref{Keystrokes}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
414
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
415 @item M-C-
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
416 @samp{M-C-} in the name of a character is an abbreviation for
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
417 Control-Meta; it means the same thing as @samp{C-M-}. If your
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
418 terminal lacks a real @key{META} key, you type a Control-Meta character by
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
419 typing @key{ESC} and then typing the corresponding Control character.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
420 @xref{Keystrokes,C-M-}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
421
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
422 @item M-x
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
423 @kbd{M-x} is the key which is used to call an Emacs command by name.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
424 You use it to call commands that are not bound to keys.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
425 @xref{M-x}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
426
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
427 @item Mail
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
428 Mail means messages sent from one user to another through the computer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
429 system, to be read at the recipient's convenience. Emacs has commands for
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
430 composing and sending mail, and for reading and editing the mail you have
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
431 received. @xref{Sending Mail}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
432
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
433 @item Major Mode
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
434 The major modes are a mutually exclusive set of options each of which
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
435 configures Emacs for editing a certain sort of text. Ideally, each
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
436 programming language has its own major mode. @xref{Major Modes}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
437
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
438 @item Mark
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
439 The mark points to a position in the text. It specifies one end of the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
440 region (q.v.@:), point being the other end. Many commands operate on
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
441 the whole region, that is, all the text from point to the mark.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
442 @xref{Mark}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
443
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
444 @item Mark Ring
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
445 The mark ring is used to hold several recent previous locations of the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
446 mark, just in case you want to move back to them. @xref{Mark Ring}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
447
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
448 @item Message
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
449 See `mail'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
450
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
451 @item Meta
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
452 Meta is the name of a modifier bit which a command character may have.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
453 It is present in a character if the character is typed with the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
454 @key{META} key held down. Such characters are given names that start
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
455 with @kbd{Meta-}. For example, @kbd{Meta-<} is typed by holding down
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
456 @key{META} and at the same time typing @kbd{<} (which itself is done,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
457 on most terminals, by holding down @key{SHIFT} and typing @kbd{,}).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
458 @xref{Keystrokes,Meta}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
459
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
460 @item Meta Character
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
461 A Meta character is one whose character code includes the Meta bit.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
462
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
463 @item Minibuffer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
464 The minibuffer is the window that Emacs displays inside the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
465 echo area (q.v.@:) when it prompts you for arguments to commands.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
466 @xref{Minibuffer}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
467
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
468 @item Minor Mode
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
469 A minor mode is an optional feature of Emacs which can be switched on
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
470 or off independent of the major mode. Each minor mode has a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
471 command to turn it on or off. @xref{Minor Modes}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
472
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
473 @item Mode Line
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
474 The mode line is the line at the bottom of each text window (q.v.@:),
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
475 which gives status information on the buffer displayed in that window.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
476 @xref{Mode Line}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
477
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
478 @item Modified Buffer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
479 A buffer (q.v.@:) is modified if its text has been changed since the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
480 last time the buffer was saved (or since it was created, if it
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
481 has never been saved). @xref{Saving}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
482
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
483 @item Moving Text
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
484 Moving text means erasing it from one place and inserting it in
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
485 another. This is done by killing (q.v.@:) and then yanking (q.v.@:).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
486 @xref{Killing}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
487
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
488 @item Named Mark
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
489 A named mark is a register (q.v.@:) in its role of recording a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
490 location in text so that you can move point to that location.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
491 @xref{Registers}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
492
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
493 @item Narrowing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
494 Narrowing means creating a restriction (q.v.@:) that limits editing in
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
495 the current buffer to only a part of the text in the buffer. Text
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
496 outside that part is inaccessible to the user until the boundaries are
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
497 widened again, but it is still there, and saving the file saves the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
498 invisible text. @xref{Narrowing}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
499
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
500 @item Newline
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
501 @key{LFD} characters in the buffer terminate lines of text and are
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
502 called newlines. @xref{Keystrokes,Newline}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
503
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
504 @item Numeric Argument
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
505 A numeric argument is a number, specified before a command, to change
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
506 the effect of the command. Often the numeric argument serves as a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
507 repeat count. @xref{Arguments}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
508
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
509 @item Option
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
510 An option is a variable (q.v.@:) that allows you to customize
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
511 Emacs by giving it a new value. @xref{Variables}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
512
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
513 @item Overwrite Mode
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
514 Overwrite mode is a minor mode. When it is enabled, ordinary text
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
515 characters replace the existing text after point rather than pushing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
516 it to the right. @xref{Minor Modes}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
517
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
518 @item Page
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
519 A page is a unit of text, delimited by formfeed characters (ASCII
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
520 Control-L, code 014) coming at the beginning of a line. Some Emacs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
521 commands are provided for moving over and operating on pages.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
522 @xref{Pages}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
523
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
524 @item Paragraphs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
525 Paragraphs are the medium-size unit of English text. There are
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
526 special Emacs commands for moving over and operating on paragraphs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
527 @xref{Paragraphs}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
528
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
529 @item Parsing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
530 We say that Emacs parses words or expressions in the text being
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
531 edited. Really, all it knows how to do is find the other end of a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
532 word or expression. @xref{Syntax}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
533
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
534 @item Point
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
535 Point is the place in the buffer at which insertion and deletion
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
536 occur. Point is considered to be between two characters, not at one
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
537 character. The terminal's cursor (q.v.@:) indicates the location of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
538 point. @xref{Basic,Point}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
539
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
540 @item Prefix Key
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
541 A prefix key is a key (q.v.@:) whose sole function is to introduce a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
542 set of multi-character keys. @kbd{Control-x} is an example of a prefix
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
543 key; any two-character sequence starting with @kbd{C-x} is also
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
544 a legitimate key. @xref{Keystrokes}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
545
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
546 @item Prompt
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
547 A prompt is text printed to ask the user for input. Printing a prompt
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
548 is called prompting. Emacs prompts always appear in the echo area
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
549 (q.v.@:). One kind of prompting happens when the minibuffer is used
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
550 to read an argument (@pxref{Minibuffer}); the echoing which happens
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
551 when you pause in the middle of typing a multi-character key is also a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
552 kind of prompting (@pxref{Echo Area}).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
553
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
554 @item Quitting
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
555 Quitting means cancelling a partially typed command or a running
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
556 command, using @kbd{C-g}. @xref{Quitting}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
557
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
558 @item Quoting
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
559 Quoting means depriving a character of its usual special significance.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
560 In Emacs this is usually done with @kbd{Control-q}. What constitutes special
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
561 significance depends on the context and on convention. For example,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
562 an ``ordinary'' character as an Emacs command inserts itself; so in
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
563 this context, a special character is any character that does not
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
564 normally insert itself (such as @key{DEL}, for example), and quoting
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
565 it makes it insert itself as if it were not special. Not all contexts
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
566 allow quoting. @xref{Basic,Quoting,Basic Editing}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
567
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
568 @item Read-only Buffer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
569 A read-only buffer is one whose text you are not allowed to change.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
570 Normally Emacs makes buffers read-only when they contain text which
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 0
diff changeset
571 has a special significance to Emacs, such as Dired buffers.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
572 Visiting a file that is write-protected also makes a read-only buffer.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
573 @xref{Buffers}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
574
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
575 @item Recursive Editing Level
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
576 A recursive editing level is a state in which part of the execution of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
577 a command involves asking the user to edit some text. This text may
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
578 or may not be the same as the text to which the command was applied.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
579 The mode line indicates recursive editing levels with square brackets
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
580 (@samp{[} and @samp{]}). @xref{Recursive Edit}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
581
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
582 @item Redisplay
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
583 Redisplay is the process of correcting the image on the screen to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
584 correspond to changes that have been made in the text being edited.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
585 @xref{Frame,Redisplay}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
586
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
587 @item Regexp
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
588 See `regular expression'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
589
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
590 @item Region
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
591 The region is the text between point (q.v.@:) and the mark (q.v.@:).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
592 Many commands operate on the text of the region. @xref{Mark,Region}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
593
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
594 @item Registers
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
595 Registers are named slots in which text or buffer positions or
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
596 rectangles can be saved for later use. @xref{Registers}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
597
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
598 @item Regular Expression
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
599 A regular expression is a pattern that can match various text strings;
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
600 for example, @samp{l[0-9]+} matches @samp{l} followed by one or more
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
601 digits. @xref{Regexps}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
602
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
603 @item Replacement
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
604 See `global substitution'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
605
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
606 @item Restriction
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
607 A buffer's restriction is the amount of text, at the beginning or the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
608 end of the buffer, that is temporarily invisible and inaccessible.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
609 Giving a buffer a nonzero amount of restriction is called narrowing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
610 (q.v.). @xref{Narrowing}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
611
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
612 @item @key{RET}
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
613 @key{RET} is the character than runs the command to insert a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
614 newline into the text. It is also used to terminate most arguments
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
615 read in the minibuffer (q.v.@:). @xref{Keystrokes,Return}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
616
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
617 @item Saving
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
618 Saving a buffer means copying its text into the file that was visited
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
619 (q.v.@:) in that buffer. To actually change a file you have edited in
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
620 Emacs, you have to save it. @xref{Saving}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
621
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
622 @item Scrolling
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
623 Scrolling means shifting the text in the Emacs window to make a
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 0
diff changeset
624 different part of the buffer visible. @xref{Display,Scrolling}.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
625
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
626 @item Searching
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
627 Searching means moving point to the next occurrence of a specified
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
628 string. @xref{Search}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
629
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
630 @item Selecting
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
631 Selecting a buffer means making it the current (q.v.@:) buffer.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
632 @xref{Buffers,Selecting}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
633
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
634 @item Self-documentation
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
635 Self-documentation is the feature of Emacs which can tell you what any
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
636 command does, or can give you a list of all commands related to a topic
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
637 you specify. You ask for self-documentation with the help character,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
638 @kbd{C-h}. @xref{Help}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
639
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
640 @item Sentences
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
641 Emacs has commands for moving by or killing by sentences.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
642 @xref{Sentences}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
643
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
644 @item Sexp
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
645 An sexp (short for `s-expression,' itself short for `symbolic
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
646 expression') is the basic syntactic unit of Lisp
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
647 in its textual form: either a list, or Lisp atom. Many Emacs commands
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
648 operate on sexps. The term `sexp' is generalized to languages other
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
649 than Lisp to mean a syntactically recognizable expression.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
650 @xref{Lists,Sexps}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
651
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
652 @item Simultaneous Editing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
653 Simultaneous editing means two users modifying the same file at once.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
654 If simultaneous editing is not detected, you may lose your
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
655 work. Emacs detects all cases of simultaneous editing and warns the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
656 user to investigate them. @xref{Interlocking,,Simultaneous Editing}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
657
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
658 @item String
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
659 A string is a kind of Lisp data object which contains a sequence of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
660 characters. Many Emacs variables are intended to have strings as
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
661 values. The Lisp syntax for a string consists of the characters in
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
662 the string with a @samp{"} before and another @samp{"} after. Write a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
663 @samp{"} that is part of the string as @samp{\"} and a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
664 @samp{\} that is part of the string as @samp{\\}. You can include all
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
665 other characters, including newline, just by writing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
666 them inside the string. You can also include escape sequences as in C, such as
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
667 @samp{\n} for newline or @samp{\241} using an octal character code.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
668
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
669 @item String Substitution
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
670 See `global substitution'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
671
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
672 @item Syntax Table
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
673 The syntax table tells Emacs which characters are part of a word,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
674 which characters balance each other like parentheses, etc.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
675 @xref{Syntax}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
676
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
677 @item Tag Table
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
678 A tag table is a file that serves as an index to the function
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
679 definitions in one or more other files. @xref{Tags}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
680
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
681 @item Termscript File
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
682 A termscript file contains a record of all characters Emacs sent to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
683 the terminal. It is used for tracking down bugs in Emacs redisplay.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
684 Emacs does not make a termscript file unless explicitly instructed to do
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 0
diff changeset
685 so.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
686 @xref{Bugs}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
687
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
688 @item Text
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
689 Text has two meanings (@pxref{Text}):
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
690
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
691 @itemize @bullet
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
692 @item
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
693 Data consisting of a sequence of characters, as opposed to binary
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
694 numbers, images, graphics commands, executable programs, and the like.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
695 The contents of an Emacs buffer are always text in this sense.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
696 @item
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
697 Data consisting of written human language, as opposed to programs,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
698 or something that follows the stylistic conventions of human language.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
699 @end itemize
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
700
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
701 @item Top Level
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
702 Top level is the normal state of Emacs, in which you are editing the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
703 text of the file you have visited. You are at top level whenever you
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
704 are not in a recursive editing level (q.v.@:) or the minibuffer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
705 (q.v.@:), and not in the middle of a command. You can get back to top
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
706 level by aborting (q.v.@:) and quitting (q.v.@:). @xref{Quitting}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
707
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
708 @item Transposition
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
709 Transposing two units of text means putting each one into the place
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
710 formerly occupied by the other. There are Emacs commands to transpose
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
711 two adjacent characters, words, sexps (q.v.@:), or lines
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
712 (@pxref{Transpose}).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
713
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
714 @item Truncation
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
715 Truncating text lines in the display means leaving out any text on a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
716 line that does not fit within the right margin of the window
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
717 displaying it. See also `continuation line'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
718 @xref{Basic,Truncation,Basic Editing}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
719
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
720 @item Undoing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
721 Undoing means making your previous editing go in reverse, bringing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
722 back the text that existed earlier in the editing session.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
723 @xref{Undo}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
724
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
725 @item Variable
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
726 A variable is Lisp object that can store an arbitrary value. Emacs uses
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
727 some variables for internal purposes, and has others (known as `options'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
728 (q.v.@:)) you can set to control the behavior of Emacs. The variables
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
729 used in Emacs that you are likely to be interested in are listed in the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
730 Variables Index of this manual. @xref{Variables}, for information on
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
731 variables.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
732
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
733 @item Visiting
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
734 Visiting a file means loading its contents into a buffer (q.v.@:)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
735 where they can be edited. @xref{Visiting}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
736
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
737 @item Whitespace
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
738 Whitespace is any run of consecutive formatting characters (spaces,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
739 tabs, newlines, and backspaces).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
740
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
741 @item Widening
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
742 Widening is removing any restriction (q.v.@:) on the current buffer;
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
743 it is the opposite of narrowing (q.v.@:). @xref{Narrowing}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
744
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
745 @item Window
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
746 Emacs divides the frame into one or more windows, each of which can
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
747 display the contents of one buffer (q.v.@:) at any time.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
748 @xref{Frame}, for basic information on how Emacs uses the frame.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
749 @xref{Windows}, for commands to control the use of windows. Note that if
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
750 you are running Emacs under X, terminology can be confusing: Each Emacs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
751 frame occupies a separate X window and can, in turn, be divided into
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 0
diff changeset
752 different subwindows.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
753
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
754 @item Word Abbrev
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
755 Synonymous with `abbrev'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
756
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
757 @item Word Search
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
758 Word search is searching for a sequence of words, considering the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
759 punctuation between them as insignificant. @xref{Word Search}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
760
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
761 @item Yanking
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
762 Yanking means reinserting text previously killed. It can be used to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
763 undo a mistaken kill, or for copying or moving text. Some other
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
764 systems call this ``pasting''. @xref{Yanking}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
765 @end table