Mercurial > hg > xemacs-beta
annotate info/dir @ 4967:0d4c9d0f6a8d
rewrite dynarr code
-------------------- ChangeLog entries follow: --------------------
src/ChangeLog addition:
2010-02-03 Ben Wing <ben@xemacs.org>
* device-x.c (x_get_resource_prefix):
* device-x.c (Fx_get_resource):
* device-x.c (Fx_get_resource_prefix):
* device-x.c (Fx_put_resource):
* dialog-msw.c:
* dialog-msw.c (handle_question_dialog_box):
* dired-msw.c (mswindows_sort_files):
* dired-msw.c (mswindows_get_files):
* extents.c (extent_fragment_sort_by_priority):
* extents.c (Fset_extent_parent):
* file-coding.c (coding_reader):
* file-coding.c (coding_writer):
* file-coding.c (gzip_convert):
* frame.c (generate_title_string):
* gutter.c (calculate_gutter_size_from_display_lines):
* indent.c (vmotion_1):
* lread.c (read_bit_vector):
* mule-coding.c (iso2022_decode):
* rangetab.c:
* rangetab.c (Fcopy_range_table):
* rangetab.c (Fget_range_table):
* rangetab.c (unified_range_table_copy_data):
* redisplay-msw.c (mswindows_output_string):
* redisplay-output.c (output_display_line):
* redisplay-output.c (redisplay_move_cursor):
* redisplay-output.c (redisplay_clear_bottom_of_window):
* redisplay-tty.c (tty_output_ichar_dynarr):
* redisplay-tty.c (set_foreground_to):
* redisplay-tty.c (set_background_to):
* redisplay-xlike-inc.c (XLIKE_output_string):
* redisplay.c (redisplay_window_text_width_string):
* redisplay.c (redisplay_text_width_string):
* redisplay.c (create_text_block):
* redisplay.c (SET_CURRENT_MODE_CHARS_PIXSIZE):
* redisplay.c (generate_fstring_runes):
* redisplay.c (regenerate_modeline):
* redisplay.c (ensure_modeline_generated):
* redisplay.c (real_current_modeline_height):
* redisplay.c (create_string_text_block):
* redisplay.c (regenerate_window):
* redisplay.c (REGEN_INC_FIND_START_END):
* redisplay.c (point_visible):
* redisplay.c (redisplay_window):
* redisplay.c (mark_glyph_block_dynarr):
* redisplay.c (line_start_cache_start):
* redisplay.c (start_with_line_at_pixpos):
* redisplay.c (update_line_start_cache):
* redisplay.c (glyph_to_pixel_translation):
* redisplay.c (pixel_to_glyph_translation):
* sysdep.c (qxe_readdir):
* text.c (dfc_convert_to_external_format):
* text.c (dfc_convert_to_internal_format):
* toolbar-common.c (common_output_toolbar_button):
* window.c (window_modeline_height):
* window.c (Fwindow_last_line_visible_height):
* window.c (window_displayed_height):
* window.c (window_scroll):
* window.c (get_current_pixel_pos):
Use Dynarr_begin() in place of Dynarr_atp (foo, 0).
* dynarr.c (Dynarr_realloc):
* dynarr.c (Dynarr_lisp_realloc):
* dynarr.c (Dynarr_resize):
* dynarr.c (Dynarr_insert_many):
* dynarr.c (Dynarr_delete_many):
* dynarr.c (Dynarr_memory_usage):
* dynarr.c (stack_like_malloc):
* dynarr.c (stack_like_free):
* lisp.h:
* lisp.h (DECLARE_DYNARR_LISP_IMP):
* lisp.h (XD_DYNARR_DESC):
* lisp.h (Dynarr_pop):
* gutter.c (output_gutter):
* redisplay-output.c (sync_rune_structs):
* redisplay-output.c (redisplay_output_window):
Redo the dynarr code, add greater checks.
Rename the `len', `largest' and `max' members to `len_',
`largest_' and `max_' to try and catch existing places that might
directly modify these values. Make new accessors Dynarr_largest()
and Dynarr_max() and make them and existing Dynarr_length() be
non-lvalues by adding '+ 0' to them; fix a couple of places in the
redisplay code that tried to modify the length directly by setting
Dynarr_length(). Use the accessors whenever possible even in the
dynarr code itself. The accessors also verify that 0 <= len <=
largest <= max. Rename settor function Dynarr_set_size() to
Dynarr_set_length() and use it more consistently; also create
lower-level Dynarr_set_length_1(). This latter function should be
the only function that directly modifies the `len_' member of a
Dynarr, and in the process makes sure that the `largest' value is
kept correct.
Consistently use ERROR_CHECK_STRUCTURES instead of
ERROR_CHECK_TYPES for error-checking code. Reintroduce the
temporarily disabled verification code on the positions of
Dynarr_at(), Dynarr_atp() and Dynarr_atp_past_end().
Also create Dynarr_resize_if() in place of a repeated
code fragment. Clean up all the functions that modify Dynarrs to
use the new macros and functions and verify the correctness of the
Dynarr both before and after the change.
Note that there are two kinds of verification -- one for accessing
and one for modifying. The difference is that the modify
verification additionally checks to make sure that the Dynarr
isn't locked. (This is used in redisplay to check for problems
with reentrancy.)
* lrecord.h: Move XD_DYNARR_DESC to lisp.h, grouping with the dynarr code.
| author | Ben Wing <ben@xemacs.org> |
|---|---|
| date | Wed, 03 Feb 2010 20:51:18 -0600 |
| parents | c2580215c222 |
| children |
| rev | line source |
|---|---|
| 428 | 1 -*- Text -*- |
| 2 | |
| 3 This is the file .../info/dir, which contains the topmost node of the Info | |
| 4 hierarchy. The first time you invoke Info you start off looking at that node, | |
| 5 which is (dir)Top. | |
| 6 | |
| 7 Rather than adding new nodes to this directory (and this file) it is a better | |
| 8 idea to put them in a site-local directory, and then configure info to search | |
| 9 in that directory as well. That way, you won't have to re-edit this file when | |
| 10 a new release of the editor comes out. | |
| 11 | |
| 12 For example, you could add this code to .../lisp/site-start.el, which is | |
| 13 loaded before ~/.emacs each time the editor starts up: | |
| 14 | |
| 15 ;; find local info nodes | |
| 16 (setq Info-directory-list | |
| 17 (append Info-directory-list '("/private/info/"))) | |
| 18 | |
| 19 Then, when you enter info, a dir file like this one will be automatically | |
| 20 created and saved (provided you have write access to the directory). The | |
| 21 contents of that file "/private/info/dir" will be appended to the contents of | |
| 22 this file. | |
| 23 | |
| 24 | |
| 25 File: dir Node: Top This is the top of the INFO tree | |
| 26 | |
| 27 This is Info, the online documentation browsing system. | |
| 28 This page (the Directory node) gives a menu of major topics. | |
| 29 | |
| 1092 | 30 button2 on a highlighted word follows that cross-reference. |
| 428 | 31 button3 anywhere brings up a menu of commands. |
| 32 ? lists additional keyboard commands. | |
| 33 h invokes the Info tutorial. | |
| 34 | |
| 35 * Menu: | |
| 36 | |
| 697 | 37 XEmacs 21.5 |
| 428 | 38 =========== |
| 2609 | 39 * XEmacs: (xemacs). XEmacs Editor. |
| 40 * Lispref: (lispref). XEmacs Lisp Reference Manual. | |
| 41 * Intro: (new-users-guide). Introduction to the XEmacs Editor. | |
| 42 * FAQ: (xemacs-faq). XEmacs FAQ. | |
| 43 * Info: (info). Documentation browsing system. | |
| 44 * Internals: (internals). XEmacs Internals Manual. | |
| 45 | |
| 428 | 46 |
| 462 | 47 Other Documentation: |
| 428 | 48 |
| 2609 | 49 * Common Lisp: (cl). XEmacs Common Lisp emulation package. |
| 50 * Customizations: (custom). Customization Library. | |
| 51 * Emodules: (emodules). XEmacs dynamically loadable module support. | |
| 52 * External Widget: (external-widget). External Client Widget. | |
| 53 * Standards: (standards). GNU coding standards. | |
| 54 * Term mode: (term). XEmacs Terminal Emulator Mode. | |
| 55 * Termcap: (termcap). Termcap library of the GNU system. | |
| 56 * Texinfo: (texinfo). The GNU documentation format. | |
| 57 * Widgets: (widget). The Emacs Widget Library. | |
| 428 | 58 |