Mercurial > hg > xemacs-beta
annotate etc/InstallGuide @ 4906:6ef8256a020a
implement equalp in C, fix case-folding, add equal() method for keymaps
-------------------- ChangeLog entries follow: --------------------
lisp/ChangeLog addition:
2010-02-01 Ben Wing <ben@xemacs.org>
* cl-extra.el:
* cl-extra.el (cl-string-vector-equalp): Removed.
* cl-extra.el (cl-bit-vector-vector-equalp): Removed.
* cl-extra.el (cl-vector-array-equalp): Removed.
* cl-extra.el (cl-hash-table-contents-equalp): Removed.
* cl-extra.el (equalp): Removed.
* cl-extra.el (cl-mapcar-many):
Comment out the whole `equalp' implementation for the moment;
remove once we're sure the C implementation works.
* cl-macs.el:
* cl-macs.el (equalp):
Simplify the compiler-macro for `equalp' -- once it's in C,
we don't need to try so hard to expand it.
src/ChangeLog addition:
2010-02-01 Ben Wing <ben@xemacs.org>
* abbrev.c (abbrev_match_mapper):
* buffer.h (CANON_TABLE_OF):
* buffer.h:
* editfns.c (Fchar_equal):
* minibuf.c (scmp_1):
* text.c (qxestrcasecmp_i18n):
* text.c (qxestrncasecmp_i18n):
* text.c (qxetextcasecmp):
* text.c (qxetextcasecmp_matching):
Create new macro CANONCASE that converts to a canonical mapping
and use it to do caseless comparisons instead of DOWNCASE.
* alloc.c:
* alloc.c (cons_equal):
* alloc.c (vector_equal):
* alloc.c (string_equal):
* bytecode.c (compiled_function_equal):
* chartab.c (char_table_entry_equal):
* chartab.c (char_table_equal):
* data.c (weak_list_equal):
* data.c (weak_box_equal):
* data.c (ephemeron_equal):
* device-msw.c (equal_devmode):
* elhash.c (hash_table_equal):
* events.c (event_equal):
* extents.c (properties_equal):
* extents.c (extent_equal):
* faces.c:
* faces.c (face_equal):
* faces.c (face_hash):
* floatfns.c (float_equal):
* fns.c:
* fns.c (bit_vector_equal):
* fns.c (plists_differ):
* fns.c (Fplists_eq):
* fns.c (Fplists_equal):
* fns.c (Flax_plists_eq):
* fns.c (Flax_plists_equal):
* fns.c (internal_equal):
* fns.c (internal_equalp):
* fns.c (internal_equal_0):
* fns.c (syms_of_fns):
* glyphs.c (image_instance_equal):
* glyphs.c (glyph_equal):
* glyphs.c (glyph_hash):
* gui.c (gui_item_equal):
* lisp.h:
* lrecord.h (struct lrecord_implementation):
* marker.c (marker_equal):
* number.c (bignum_equal):
* number.c (ratio_equal):
* number.c (bigfloat_equal):
* objects.c (color_instance_equal):
* objects.c (font_instance_equal):
* opaque.c (equal_opaque):
* opaque.c (equal_opaque_ptr):
* rangetab.c (range_table_equal):
* specifier.c (specifier_equal):
Add a `foldcase' param to the equal() method and use it to implement
`equalp' comparisons. Also add to plists_differ(), although we
don't currently use it here.
Rewrite internal_equalp(). Implement cross-type vector comparisons.
Don't implement our own handling of numeric promotion -- just use
the `=' primitive.
Add internal_equal_0(), which takes a `foldcase' param and calls
either internal_equal() or internal_equalp().
* buffer.h:
When given a 0 for buffer (which is the norm when functions don't
have a specific buffer available), use the current buffer's table,
not `standard-case-table'; otherwise the current settings are
ignored.
* casetab.c:
* casetab.c (set_case_table):
When handling old-style vectors of 256 in `set-case-table' don't
overwrite the existing table! Instead create a new table and
populate.
* device-msw.c (sync_printer_with_devmode):
* lisp.h:
* text.c (lisp_strcasecmp_ascii):
Rename lisp_strcasecmp to lisp_strcasecmp_ascii and use
lisp_strcasecmp_i18n for caseless comparisons in some places.
* elhash.c:
Delete unused lisp_string_hash and lisp_string_equal().
* events.h:
* keymap-buttons.h:
* keymap.h:
* keymap.c (keymap_lookup_directly):
* keymap.c (keymap_store):
* keymap.c (FROB):
* keymap.c (key_desc_list_to_event):
* keymap.c (describe_map_mapper):
* keymap.c (INCLUDE_BUTTON_ZERO):
New file keymap-buttons.h; use to handle buttons 1-26 in place of
duplicating code 26 times.
* frame-gtk.c (allocate_gtk_frame_struct):
* frame-msw.c (mswindows_init_frame_1):
Fix some comments about internal_equal() in redisplay that don't
apply any more.
* keymap-slots.h:
* keymap.c:
New file keymap-slots.h. Use it to notate the slots in a keymap
structure, similar to frameslots.h or coding-system-slots.h.
* keymap.c (MARKED_SLOT):
* keymap.c (keymap_equal):
* keymap.c (keymap_hash):
Implement.
tests/ChangeLog addition:
2010-02-01 Ben Wing <ben@xemacs.org>
* automated/case-tests.el:
* automated/case-tests.el (uni-mappings):
* automated/search-tests.el:
Delete old pristine-case-table code. Rewrite the Unicode torture
test to take into account whether overlapping mappings exist for
more than one character, and not doing the upcase/downcase
comparisons in such cases.
* automated/lisp-tests.el (foo):
* automated/lisp-tests.el (string-variable):
* automated/lisp-tests.el (featurep):
Replace Assert (equal ... with Assert-equal; same for other types
of equality. Replace some awkward equivalents of Assert-equalp
with Assert-equalp. Add lots of equalp tests.
* automated/case-tests.el:
* automated/regexp-tests.el:
* automated/search-tests.el:
Fix up the comments at the top of the files. Move rules about where
to put tests into case-tests.el.
* automated/test-harness.el:
* automated/test-harness.el (test-harness-aborted-summary-template): New.
* automated/test-harness.el (test-harness-from-buffer):
* automated/test-harness.el (batch-test-emacs):
Fix Assert-test-not. Create Assert-not-equal and variants.
Delete the doc strings from all these convenience functions to avoid
excessive repetition; instead use one copy in a comment.
| author | Ben Wing <ben@xemacs.org> |
|---|---|
| date | Mon, 01 Feb 2010 01:02:40 -0600 |
| parents | 9ad43877534d |
| children |
| rev | line source |
|---|---|
| 179 | 1 Introduction |
| 2 | |
| 3 Thank you for downloading XEmacs. We of the XEmacs development team | |
| 4 believe user satisfaction is our number one priority, and we hope that | |
| 5 you will be pleased with the power of our editor. Please follow all | |
| 6 of the instructions in order to enjoy a quick and easy installation. | |
| 7 | |
| 8 | |
| 9 Getting Started | |
| 10 | |
| 11 In this guide, information which you will need to supply will be enclosed in | |
| 12 angle brackets, <like this>. Commands which you will have to enter will be | |
| 13 indented, | |
| 14 | |
| 15 like this. | |
| 16 | |
| 17 You will need to provide a loading directory, in which to load the | |
| 18 material from tape (/tmp/xemacs is recommended), and a permanent | |
| 19 installation directory (/usr/local/xemacs is recommended). | |
| 20 | |
| 21 | |
| 22 Loading From Tape | |
| 23 | |
| 24 First create and change directory to the loading directory: | |
| 25 | |
| 26 mkdir <working directory> | |
| 27 cd <working directory> | |
| 28 | |
| 29 Now you are ready to load the software from tape. | |
| 30 | |
| 31 The specific device name needed to load the tape varies with hardware vendors, | |
| 32 and may be found in Appendix A, "Vendors and Device Names". | |
| 33 | |
| 34 Load the software from tape: | |
| 35 | |
| 36 tar xvf /dev/<device name> | |
| 37 | |
| 38 You have now loaded all of the software from tape, and are ready to compile and | |
| 39 install the XEmacs Text Editor. | |
| 40 | |
| 41 | |
| 42 Compiling and Installing the XEmacs Editor | |
| 43 | |
| 44 Compiling and installing the libraries is handled by a user-friendly shell | |
| 45 script. You will need to provide some information to the script, such as your | |
| 46 organization name and registration number. To run the script, type | |
| 47 | |
| 48 /bin/sh xemacs/xemacs.install -d <installation directory> | |
| 49 | |
| 50 Follow the script's directions, and provide the information which it prompts | |
| 51 for. | |
| 52 | |
| 53 When the script prompts you for the directory in which the distribution files | |
| 54 are located, you will find that you are unable to provide it with any directory | |
| 55 which the script will deem satisfactory. That is because it is necessary to | |
| 56 order the following additional parts which are necessary to continue with the | |
| 57 installation: | |
| 58 | |
| 59 Part Number Qty Name Price | |
| 60 | |
| 61 GM-96-3026 1 Goat, male 1000.00 | |
| 62 CB-13-2395 1 Candle, black 50.00 | |
| 63 CG-63-6376 1 Chalk dust container 10.00 | |
| 64 IB-89-3335 5 Incense sticks 5.00 | |
| 65 DE-44-8846 1 Dagger, ebon, curved 500.00 | |
| 66 AS-87-2319 1 Altar, silver 10000.00 | |
| 67 | |
| 68 Wait until the additional parts arrive; you will be ready to continue the | |
| 69 installation the next Friday the 13th at midnight. | |
| 70 | |
| 71 | |
| 72 Ritual for Successfully Completing Installation | |
| 73 | |
| 74 Stand in front of the computer. Pour out the chalk dust in an inscribed | |
| 75 pentagram around you; be sure that it is without breaks. Set an incense stick | |
| 76 at each of the five corners, the altar in front of the computer, and the candle | |
| 77 in front of the altar. | |
| 78 | |
| 79 Light each of the incense sticks and the candles, chanting in a low voice: | |
| 80 | |
| 81 Daemons and spirits of the netherworld | |
| 82 Forces of all that is chaotic and mysterious | |
| 83 Essence of Netscape and MicroSoft | |
| 84 | |
| 85 I am coming here to appease you | |
| 86 I offer you this goat | |
| 87 That my software may work | |
| 88 | |
| 89 I bind you here | |
| 90 Do not make my system crash | |
| 91 Let the software install as advertised | |
| 92 | |
| 93 Place the goat on the altar, and slaughter it with the dagger. | |
| 94 | |
| 95 May this goat feed you | |
| 96 Sate your lust for blood | |
| 97 Into it may your mischief fly | |
| 98 Not my computer | |
| 99 Make the software work | |
| 100 For this is the only way | |
| 101 | |
| 102 Then spit into the computer's ventilation slots. This will complete different | |
| 103 circuits inside the computer, causing its motherboard and cards to function in | |
| 104 ways that the engineers never intended, thereby making your system compatible | |
| 105 with our libraries. | |
| 106 | |
| 107 Reboot your computer. The installation is now complete. | |
| 108 | |
| 109 [This has undergone a minor rewrite for XEmacs. It originally | |
| 110 appeared on rec.humor.funny courtesy of jonathan seth hayward | |
| 111 <jhayward@students.uiuc.edu>, and is included by permission of the | |
| 112 author]. |