Mercurial > hg > xemacs-beta
annotate man/lispref/errors.texi @ 4981:4aebb0131297
Cleanups/renaming of EXTERNAL_TO_C_STRING and friends
-------------------- ChangeLog entries follow: --------------------
modules/ChangeLog addition:
2010-02-05 Ben Wing <ben@xemacs.org>
* postgresql/postgresql.c:
* postgresql/postgresql.c (CHECK_LIVE_CONNECTION):
* postgresql/postgresql.c (Fpq_connectdb):
* postgresql/postgresql.c (Fpq_connect_start):
* postgresql/postgresql.c (Fpq_lo_import):
* postgresql/postgresql.c (Fpq_lo_export):
* ldap/eldap.c (Fldap_open):
* ldap/eldap.c (Fldap_search_basic):
* ldap/eldap.c (Fldap_add):
* ldap/eldap.c (Fldap_modify):
* ldap/eldap.c (Fldap_delete):
* canna/canna_api.c (Fcanna_initialize):
* canna/canna_api.c (Fcanna_store_yomi):
* canna/canna_api.c (Fcanna_parse):
* canna/canna_api.c (Fcanna_henkan_begin):
EXTERNAL_TO_C_STRING returns its argument instead of storing it
in a parameter, and is renamed to EXTERNAL_TO_ITEXT. Similar
things happen to related macros. See entry in src/ChangeLog.
More Mule-izing of postgresql.c. Extract out common code
between `pq-connectdb' and `pq-connect-start'. Fix places
that signal an error string using a formatted string to instead
follow the standard and have a fixed reason followed by the
particular error message stored as one of the frobs.
src/ChangeLog addition:
2010-02-05 Ben Wing <ben@xemacs.org>
* console-msw.c (write_string_to_mswindows_debugging_output):
* console-msw.c (Fmswindows_message_box):
* console-x.c (x_perhaps_init_unseen_key_defaults):
* console.c:
* database.c (dbm_get):
* database.c (dbm_put):
* database.c (dbm_remove):
* database.c (berkdb_get):
* database.c (berkdb_put):
* database.c (berkdb_remove):
* database.c (Fopen_database):
* device-gtk.c (gtk_init_device):
* device-msw.c (msprinter_init_device_internal):
* device-msw.c (msprinter_default_printer):
* device-msw.c (msprinter_init_device):
* device-msw.c (sync_printer_with_devmode):
* device-msw.c (Fmsprinter_select_settings):
* device-x.c (sanity_check_geometry_resource):
* device-x.c (Dynarr_add_validified_lisp_string):
* device-x.c (x_init_device):
* device-x.c (Fx_put_resource):
* device-x.c (Fx_valid_keysym_name_p):
* device-x.c (Fx_set_font_path):
* dialog-msw.c (push_lisp_string_as_unicode):
* dialog-msw.c (handle_directory_dialog_box):
* dialog-msw.c (handle_file_dialog_box):
* dialog-x.c (dbox_descriptor_to_widget_value):
* editfns.c (Fformat_time_string):
* editfns.c (Fencode_time):
* editfns.c (Fset_time_zone_rule):
* emacs.c (make_argc_argv):
* emacs.c (Fdump_emacs):
* emodules.c (emodules_load):
* eval.c:
* eval.c (maybe_signal_error_1):
* event-msw.c (Fdde_alloc_advise_item):
* event-msw.c (mswindows_dde_callback):
* event-msw.c (mswindows_wnd_proc):
* fileio.c (report_error_with_errno):
* fileio.c (Fsysnetunam):
* fileio.c (Fdo_auto_save):
* font-mgr.c (extract_fcapi_string):
* font-mgr.c (Ffc_config_app_font_add_file):
* font-mgr.c (Ffc_config_app_font_add_dir):
* font-mgr.c (Ffc_config_filename):
* frame-gtk.c (gtk_set_frame_text_value):
* frame-gtk.c (gtk_create_widgets):
* frame-msw.c (mswindows_init_frame_1):
* frame-msw.c (mswindows_set_title_from_ibyte):
* frame-msw.c (msprinter_init_frame_3):
* frame-x.c (x_set_frame_text_value):
* frame-x.c (x_set_frame_properties):
* frame-x.c (start_drag_internal_1):
* frame-x.c (x_cde_transfer_callback):
* frame-x.c (x_create_widgets):
* glyphs-eimage.c (my_jpeg_output_message):
* glyphs-eimage.c (jpeg_instantiate):
* glyphs-eimage.c (gif_instantiate):
* glyphs-eimage.c (png_instantiate):
* glyphs-eimage.c (tiff_instantiate):
* glyphs-gtk.c (xbm_instantiate_1):
* glyphs-gtk.c (gtk_xbm_instantiate):
* glyphs-gtk.c (gtk_xpm_instantiate):
* glyphs-gtk.c (gtk_xface_instantiate):
* glyphs-gtk.c (cursor_font_instantiate):
* glyphs-gtk.c (gtk_redisplay_widget):
* glyphs-gtk.c (gtk_widget_instantiate_1):
* glyphs-gtk.c (gtk_add_tab_item):
* glyphs-msw.c (mswindows_xpm_instantiate):
* glyphs-msw.c (bmp_instantiate):
* glyphs-msw.c (mswindows_resource_instantiate):
* glyphs-msw.c (xbm_instantiate_1):
* glyphs-msw.c (mswindows_xbm_instantiate):
* glyphs-msw.c (mswindows_xface_instantiate):
* glyphs-msw.c (mswindows_redisplay_widget):
* glyphs-msw.c (mswindows_widget_instantiate):
* glyphs-msw.c (add_tree_item):
* glyphs-msw.c (add_tab_item):
* glyphs-msw.c (mswindows_combo_box_instantiate):
* glyphs-msw.c (mswindows_widget_query_string_geometry):
* glyphs-x.c (x_locate_pixmap_file):
* glyphs-x.c (xbm_instantiate_1):
* glyphs-x.c (x_xbm_instantiate):
* glyphs-x.c (extract_xpm_color_names):
* glyphs-x.c (x_xpm_instantiate):
* glyphs-x.c (x_xface_instantiate):
* glyphs-x.c (autodetect_instantiate):
* glyphs-x.c (safe_XLoadFont):
* glyphs-x.c (cursor_font_instantiate):
* glyphs-x.c (x_redisplay_widget):
* glyphs-x.c (Fchange_subwindow_property):
* glyphs-x.c (x_widget_instantiate):
* glyphs-x.c (x_tab_control_redisplay):
* glyphs.c (pixmap_to_lisp_data):
* gui-x.c (menu_separator_style_and_to_external):
* gui-x.c (add_accel_and_to_external):
* gui-x.c (button_item_to_widget_value):
* hpplay.c (player_error_internal):
* hpplay.c (play_sound_file):
* hpplay.c (play_sound_data):
* intl.c (Fset_current_locale):
* lisp.h:
* menubar-gtk.c (gtk_xemacs_set_accel_keys):
* menubar-msw.c (populate_menu_add_item):
* menubar-msw.c (populate_or_checksum_helper):
* menubar-x.c (menu_item_descriptor_to_widget_value_1):
* nt.c (init_user_info):
* nt.c (get_long_basename):
* nt.c (nt_get_resource):
* nt.c (init_mswindows_environment):
* nt.c (get_cached_volume_information):
* nt.c (mswindows_readdir):
* nt.c (read_unc_volume):
* nt.c (mswindows_stat):
* nt.c (mswindows_getdcwd):
* nt.c (mswindows_executable_type):
* nt.c (Fmswindows_short_file_name):
* ntplay.c (nt_play_sound_file):
* objects-gtk.c:
* objects-gtk.c (gtk_valid_color_name_p):
* objects-gtk.c (gtk_initialize_font_instance):
* objects-gtk.c (gtk_font_list):
* objects-msw.c (font_enum_callback_2):
* objects-msw.c (parse_font_spec):
* objects-x.c (x_parse_nearest_color):
* objects-x.c (x_valid_color_name_p):
* objects-x.c (x_initialize_font_instance):
* objects-x.c (x_font_instance_truename):
* objects-x.c (x_font_list):
* objects-xlike-inc.c (XFUN):
* objects-xlike-inc.c (xft_find_charset_font):
* process-nt.c (mswindows_report_winsock_error):
* process-nt.c (nt_create_process):
* process-nt.c (get_internet_address):
* process-nt.c (nt_open_network_stream):
* process-unix.c:
* process-unix.c (allocate_pty):
* process-unix.c (get_internet_address):
* process-unix.c (unix_canonicalize_host_name):
* process-unix.c (unix_open_network_stream):
* realpath.c:
* select-common.h (lisp_data_to_selection_data):
* select-gtk.c (symbol_to_gtk_atom):
* select-gtk.c (atom_to_symbol):
* select-msw.c (symbol_to_ms_cf):
* select-msw.c (mswindows_register_selection_data_type):
* select-x.c (symbol_to_x_atom):
* select-x.c (x_atom_to_symbol):
* select-x.c (hack_motif_clipboard_selection):
* select-x.c (Fx_store_cutbuffer_internal):
* sound.c (Fplay_sound_file):
* sound.c (Fplay_sound):
* sound.h (sound_perror):
* sysdep.c:
* sysdep.c (qxe_allocating_getcwd):
* sysdep.c (qxe_execve):
* sysdep.c (copy_in_passwd):
* sysdep.c (qxe_getpwnam):
* sysdep.c (qxe_ctime):
* sysdll.c (dll_open):
* sysdll.c (dll_function):
* sysdll.c (dll_variable):
* sysdll.c (search_linked_libs):
* sysdll.c (dll_error):
* sysfile.h:
* sysfile.h (PATHNAME_CONVERT_OUT_TSTR):
* sysfile.h (PATHNAME_CONVERT_OUT_UTF_8):
* sysfile.h (PATHNAME_CONVERT_OUT):
* sysfile.h (LISP_PATHNAME_CONVERT_OUT):
* syswindows.h (ITEXT_TO_TSTR):
* syswindows.h (LOCAL_FILE_FORMAT_TO_TSTR):
* syswindows.h (TSTR_TO_LOCAL_FILE_FORMAT):
* syswindows.h (LOCAL_FILE_FORMAT_TO_INTERNAL_MSWIN):
* syswindows.h (LISP_LOCAL_FILE_FORMAT_MAYBE_URL_TO_TSTR):
* text.h:
* text.h (eicpy_ext_len):
* text.h (enum new_dfc_src_type):
* text.h (EXTERNAL_TO_ITEXT):
* text.h (GET_STRERROR):
* tooltalk.c (check_status):
* tooltalk.c (Fadd_tooltalk_message_arg):
* tooltalk.c (Fadd_tooltalk_pattern_attribute):
* tooltalk.c (Fadd_tooltalk_pattern_arg):
* win32.c (tstr_to_local_file_format):
* win32.c (mswindows_lisp_error_1):
* win32.c (mswindows_report_process_error):
* win32.c (Fmswindows_shell_execute):
* win32.c (mswindows_read_link_1):
Changes involving external/internal format conversion,
mostly code cleanup and renaming.
1. Eliminate the previous macros like LISP_STRING_TO_EXTERNAL
that stored its result in a parameter. The new version of
LISP_STRING_TO_EXTERNAL returns its result through the
return value, same as the previous NEW_LISP_STRING_TO_EXTERNAL.
Use the new-style macros throughout the code.
2. Rename C_STRING_TO_EXTERNAL and friends to ITEXT_TO_EXTERNAL,
in keeping with overall naming rationalization involving
Itext and related types.
Macros involved in previous two:
EXTERNAL_TO_C_STRING -> EXTERNAL_TO_ITEXT
EXTERNAL_TO_C_STRING_MALLOC -> EXTERNAL_TO_ITEXT_MALLOC
SIZED_EXTERNAL_TO_C_STRING -> SIZED_EXTERNAL_TO_ITEXT
SIZED_EXTERNAL_TO_C_STRING_MALLOC -> SIZED_EXTERNAL_TO_ITEXT_MALLOC
C_STRING_TO_EXTERNAL -> ITEXT_TO_EXTERNAL
C_STRING_TO_EXTERNAL_MALLOC -> ITEXT_TO_EXTERNAL_MALLOC
LISP_STRING_TO_EXTERNAL
LISP_STRING_TO_EXTERNAL_MALLOC
LISP_STRING_TO_TSTR
C_STRING_TO_TSTR -> ITEXT_TO_TSTR
TSTR_TO_C_STRING -> TSTR_TO_ITEXT
The following four still return their values through parameters,
since they have more than one value to return:
C_STRING_TO_SIZED_EXTERNAL -> ITEXT_TO_SIZED_EXTERNAL
LISP_STRING_TO_SIZED_EXTERNAL
C_STRING_TO_SIZED_EXTERNAL_MALLOC -> ITEXT_TO_SIZED_EXTERNAL_MALLOC
LISP_STRING_TO_SIZED_EXTERNAL_MALLOC
Sometimes additional casts had to be inserted, since the old
macros played strange games and completely defeated the type system
of the store params.
3. Rewrite many places where direct calls to TO_EXTERNAL_FORMAT
occurred with calls to one of the convenience macros listed above,
or to make_extstring().
4. Eliminate SIZED_C_STRING macros (they were hardly used, anyway)
and use a direct call to TO_EXTERNAL_FORMAT or TO_INTERNAL_FORMAT.
4. Use LISP_PATHNAME_CONVERT_OUT in many places instead of something
like LISP_STRING_TO_EXTERNAL(..., Qfile_name).
5. Eliminate some temporary variables that are no longer necessary
now that we return a value rather than storing it into a variable.
6. Some Mule-izing in database.c.
7. Error functions:
-- A bit of code cleanup in maybe_signal_error_1.
-- Eliminate report_file_type_error; it's just an alias for
signal_error_2 with params in a different order.
-- Fix some places in the hostname-handling code that directly
inserted externally-retrieved error strings into the
supposed ASCII "reason" param instead of doing the right thing
and sticking text descriptive of what was going on in "reason"
and putting the external message in a frob.
8. Use Ascbyte instead of CIbyte in process-unix.c and maybe one
or two other places.
9. Some code cleanup in copy_in_passwd() in sysdep.c.
10. Fix a real bug due to accidental variable shadowing in
tstr_to_local_file_format() in win32.c.
| author | Ben Wing <ben@xemacs.org> |
|---|---|
| date | Fri, 05 Feb 2010 11:02:24 -0600 |
| parents | 576fb035e263 |
| children |
| rev | line source |
|---|---|
| 428 | 1 @c -*-texinfo-*- |
| 2 @c This is part of the XEmacs Lisp Reference Manual. | |
| 444 | 3 @c Copyright (C) 1990, 1991, 1992, 1993 Free Software Foundation, Inc. |
| 428 | 4 @c See the file lispref.texi for copying conditions. |
| 5 @setfilename ../../info/errors.info | |
| 6 @node Standard Errors, Standard Buffer-Local Variables, Building XEmacs and Object Allocation, Top | |
| 7 @appendix Standard Errors | |
| 8 | |
| 9 Here is the complete list of the error symbols in standard Emacs, | |
| 10 grouped by concept. The list includes each symbol's message (on the | |
| 11 @code{error-message} property of the symbol) and a cross reference to a | |
| 12 description of how the error can occur. | |
| 13 | |
| 14 Each error symbol has an @code{error-conditions} property that is a | |
| 15 list of symbols. Normally this list includes the error symbol itself | |
| 16 and the symbol @code{error}. Occasionally it includes additional | |
| 17 symbols, which are intermediate classifications, narrower than | |
| 18 @code{error} but broader than a single error symbol. For example, all | |
| 19 the errors in accessing files have the condition @code{file-error}. | |
| 20 | |
| 21 As a special exception, the error symbol @code{quit} does not have the | |
| 22 condition @code{error}, because quitting is not considered an error. | |
| 23 | |
| 24 @xref{Errors}, for an explanation of how errors are generated and | |
| 25 handled. | |
| 26 | |
| 27 @table @code | |
| 28 @item @var{symbol} | |
| 29 @var{string}; @var{reference}. | |
| 30 | |
| 31 @item error | |
| 32 @code{"error"}@* | |
| 33 @xref{Errors}. | |
| 34 | |
| 35 @item quit | |
| 36 @code{"Quit"}@* | |
| 37 @xref{Quitting}. | |
| 38 | |
| 39 @item args-out-of-range | |
| 40 @code{"Args out of range"}@* | |
| 41 @xref{Sequences Arrays Vectors}. | |
| 42 | |
| 43 @item arith-error | |
| 44 @code{"Arithmetic error"}@* | |
| 45 See @code{/} and @code{%} in @ref{Numbers}. | |
| 46 | |
| 47 @item beginning-of-buffer | |
| 48 @code{"Beginning of buffer"}@* | |
| 49 @xref{Motion}. | |
| 50 | |
| 51 @item buffer-read-only | |
| 52 @code{"Buffer is read-only"}@* | |
| 53 @xref{Read Only Buffers}. | |
| 54 | |
| 55 @item cyclic-function-indirection | |
| 56 @code{"Symbol's chain of function indirections contains a loop"}@* | |
| 57 @xref{Function Indirection}. | |
| 58 | |
| 59 @c XEmacs feature | |
| 60 @item domain-error | |
| 61 @code{"Arithmetic domain error"}@* | |
| 62 | |
| 63 @item end-of-buffer | |
| 64 @code{"End of buffer"}@* | |
| 65 @xref{Motion}. | |
| 66 | |
| 67 @item end-of-file | |
| 68 @code{"End of file during parsing"}@* | |
| 69 This is not a @code{file-error}.@* | |
| 70 @xref{Input Functions}. | |
| 71 | |
| 72 @item file-error | |
| 73 This error and its subcategories do not have error-strings, because the | |
| 74 error message is constructed from the data items alone when the error | |
| 75 condition @code{file-error} is present.@* | |
| 76 @xref{Files}. | |
| 77 | |
| 444 | 78 @item file-locked |
| 428 | 79 This is a @code{file-error}.@* |
| 80 @xref{File Locks}. | |
| 81 | |
| 82 @item file-already-exists | |
| 83 This is a @code{file-error}.@* | |
| 84 @xref{Writing to Files}. | |
| 85 | |
| 86 @item file-supersession | |
| 87 This is a @code{file-error}.@* | |
| 88 @xref{Modification Time}. | |
| 89 | |
| 90 @item invalid-byte-code | |
| 91 @code{"Invalid byte code"}@* | |
| 92 @xref{Byte Compilation}. | |
| 93 | |
| 94 @item invalid-function | |
| 95 @code{"Invalid function"}@* | |
| 96 @xref{Classifying Lists}. | |
| 97 | |
| 98 @item invalid-read-syntax | |
| 99 @code{"Invalid read syntax"}@* | |
| 100 @xref{Input Functions}. | |
| 101 | |
| 102 @item invalid-regexp | |
| 103 @code{"Invalid regexp"}@* | |
| 104 @xref{Regular Expressions}. | |
| 105 | |
| 106 @c XEmacs feature | |
| 107 @item mark-inactive | |
| 108 @code{"The mark is not active now"}@* | |
| 109 | |
| 110 @item no-catch | |
| 111 @code{"No catch for tag"}@* | |
| 112 @xref{Catch and Throw}. | |
| 113 | |
| 114 @c XEmacs feature | |
| 115 @item overflow-error | |
| 116 @code{"Arithmetic overflow error"}@* | |
| 117 | |
| 118 @c XEmacs feature | |
| 119 @item protected-field | |
| 120 @code{"Attempt to modify a protected field"}@* | |
| 121 | |
| 122 @c XEmacs feature | |
| 123 @item range-error | |
| 124 @code{"Arithmetic range error"}@* | |
| 125 | |
| 126 @item search-failed | |
| 127 @code{"Search failed"}@* | |
| 128 @xref{Searching and Matching}. | |
| 129 | |
| 130 @item setting-constant | |
| 444 | 131 @code{"Attempt to set a constant symbol"}@* |
| 428 | 132 @xref{Constant Variables, , Variables that Never Change}. |
| 133 | |
| 134 @c XEmacs feature | |
| 135 @item singularity-error | |
| 136 @code{"Arithmetic singularity error"}@* | |
| 137 | |
| 138 @c XEmacs feature | |
| 139 @item tooltalk-error | |
| 140 @code{"ToolTalk error"}@* | |
| 141 @xref{ToolTalk Support}. | |
| 142 | |
| 143 @c XEmacs feature | |
| 144 @item undefined-keystroke-sequence | |
| 145 @code{"Undefined keystroke sequence"}@* | |
| 146 | |
| 147 @ignore FSF Emacs only | |
| 148 @item undefined-color | |
| 149 @code{"Undefined color"}@* | |
| 150 @xref{Color Names}. | |
| 151 @end ignore | |
| 152 | |
| 153 @item void-function | |
| 154 @code{"Symbol's function definition is void"}@* | |
| 155 @xref{Function Cells}. | |
| 156 | |
| 157 @item void-variable | |
| 158 @code{"Symbol's value as variable is void"}@* | |
| 159 @xref{Accessing Variables}. | |
| 160 | |
| 161 @item wrong-number-of-arguments | |
| 162 @code{"Wrong number of arguments"}@* | |
| 163 @xref{Classifying Lists}. | |
| 164 | |
| 165 @item wrong-type-argument | |
| 166 @code{"Wrong type argument"}@* | |
| 167 @xref{Type Predicates}. | |
| 168 @end table | |
| 169 | |
| 170 These error types, which are all classified as special cases of | |
| 171 @code{arith-error}, can occur on certain systems for invalid use of | |
| 172 mathematical functions. | |
| 173 | |
| 174 @table @code | |
| 175 @item domain-error | |
| 176 @code{"Arithmetic domain error"}@* | |
| 177 @xref{Math Functions}. | |
| 178 | |
| 179 @item overflow-error | |
| 180 @code{"Arithmetic overflow error"}@* | |
| 181 @xref{Math Functions}. | |
| 182 | |
| 183 @item range-error | |
| 184 @code{"Arithmetic range error"}@* | |
| 185 @xref{Math Functions}. | |
| 186 | |
| 187 @item singularity-error | |
| 188 @code{"Arithmetic singularity error"}@* | |
| 189 @xref{Math Functions}. | |
| 190 | |
| 191 @item underflow-error | |
| 192 @code{"Arithmetic underflow error"}@* | |
| 193 @xref{Math Functions}. | |
| 194 @end table |