Mercurial > hg > xemacs-beta
annotate src/README @ 5882:bbe4146603db
Reduce regexp usage, now CL-oriented non-regexp code available, core Lisp
lisp/ChangeLog addition:
2015-04-01 Aidan Kehoe <kehoea@parhasard.net>
When calling #'string-match with a REGEXP without regular
expression special characters, call #'search, #'mismatch, #'find,
etc. instead, making our code less likely to side-effect other
functions' match data and a little faster.
* apropos.el (apropos-command):
* apropos.el (apropos):
Call (position ?\n ...) rather than (string-match "\n" ...) here.
* buff-menu.el:
* buff-menu.el (buffers-menu-omit-invisible-buffers):
Don't fire up the regexp engine just to check if a string starts
with a space.
* buff-menu.el (select-buffers-tab-buffers-by-mode):
Don't fire up the regexp engine just to compare mode basenames.
* buff-menu.el (format-buffers-tab-line):
* buff-menu.el (build-buffers-tab-internal): Moved to being a
label within the following.
* buff-menu.el (buffers-tab-items): Use the label.
* bytecomp.el (byte-compile-log-1):
Don't fire up the regexp engine just to look for a newline.
* cus-edit.el (get):
Ditto.
* cus-edit.el (custom-variable-value-create):
Ditto, but for a colon.
* descr-text.el (describe-text-sexp):
Ditto.
* descr-text.el (describe-char-unicode-data):
Use #'split-string-by-char given that we're just looking for a
semicolon.
* descr-text.el (describe-char):
Don't fire up the regexp engine just to look for a newline.
* disass.el (disassemble-internal):
Ditto.
* files.el (file-name-sans-extension):
Implement this using #'position.
* files.el (file-name-extension):
Correct this function's docstring, implement it in terms of
#'position.
* files.el (insert-directory):
Don't fire up the regexp engine to split a string by space; don't
reverse the list of switches, this is actually a longstand bug as
far as I can see.
* gnuserv.el (gnuserv-process-filter):
Use #'position here, instead of consing inside #'split-string
needlessly.
* gtk-file-dialog.el (gtk-file-dialog-update-dropdown):
Use #'split-string-by-char here, don't fire up #'split-string for
directory-sep-char.
* gtk-font-menu.el (hack-font-truename):
Implement this more cheaply in terms of #'find,
#'split-string-by-char, #'equal, rather than #'string-match,
#'split-string, #'string-equal.
* hyper-apropos.el (hyper-apropos-grok-functions):
* hyper-apropos.el (hyper-apropos-grok-variables):
Look for a newline using #'position rather than #'string-match in
these functions.
* info.el (Info-insert-dir):
* info.el (Info-insert-file-contents):
* info.el (Info-follow-reference):
* info.el (Info-extract-menu-node-name):
* info.el (Info-menu):
Look for fixed strings using #'position or #'search as appropriate
in this file.
* ldap.el (ldap-decode-string):
* ldap.el (ldap-encode-string):
#'encode-coding-string, #'decode-coding-string are always
available, don't check if they're fboundp.
* ldap.el (ldap-decode-address):
* ldap.el (ldap-encode-address):
Use #'split-string-by-char in these functions.
* lisp-mnt.el (lm-creation-date):
* lisp-mnt.el (lm-last-modified-date):
Don't fire up the regexp engine just to look for spaces in this file.
* menubar-items.el (default-menubar):
Use (not (mismatch ...)) rather than #'string-match here, for
simple regexp.
Use (search "beta" ...) rather than (string-match "beta" ...)
* menubar-items.el (sort-buffers-menu-alphabetically):
* menubar-items.el (sort-buffers-menu-by-mode-then-alphabetically):
* menubar-items.el (group-buffers-menu-by-mode-then-alphabetically):
Don't fire up the regexp engine to check if a string starts with
a space or an asterisk.
Use the more fine-grained results of #'compare-strings; compare
case-insensitively for the buffer menu.
* menubar-items.el (list-all-buffers):
* menubar-items.el (tutorials-menu-filter):
Use #'equal rather than #'string-equal, which, in this context,
has the drawback of not having a bytecode, and no redeeming
features.
* minibuf.el:
* minibuf.el (un-substitute-in-file-name):
Use #'count, rather than counting the occurences of $ using the
regexp engine.
* minibuf.el (read-file-name-internal-1):
Don't fire up the regexp engine to search for ?=.
* mouse.el (mouse-eval-sexp):
Check for newline with #'find.
* msw-font-menu.el (mswindows-reset-device-font-menus):
Split a string by newline with #'split-string-by-char.
* mule/japanese.el:
* mule/japanese.el ("Japanese"):
Use #'search rather than #'string-match; canoncase before
comparing; fix a bug I had introduced where I had been making case
insensitive comparisons where the case mattered.
* mule/korea-util.el (default-korean-keyboard):
Look for ?3 using #'find, not #'string-march.
* mule/korea-util.el (quail-hangul-switch-hanja):
Search for a fixed string using #'search.
* mule/mule-cmds.el (set-locale-for-language-environment):
#'position, #'substitute rather than #'string-match,
#'replace-in-string.
* newcomment.el (comment-make-extra-lines):
Use #'search rather than #'string-match for a simple string.
* package-get.el (package-get-remote-filename):
Use #'position when looking for ?@
* process.el (setenv):
* process.el (read-envvar-name):
Use #'position when looking for ?=.
* replace.el (map-query-replace-regexp):
Use #'split-string-by-char instead of using an inline
implementation of it.
* select.el (select-convert-from-cf-text):
* select.el (select-convert-from-cf-unicodetext):
Use #'position rather than #'string-match in these functions.
* setup-paths.el (paths-emacs-data-root-p):
Use #'search when looking for simple string.
* sound.el (load-sound-file):
Use #'split-string-by-char rather than an inline reimplementation
of same.
* startup.el (splash-screen-window-body):
* startup.el (splash-screen-tty-body):
Search for simple strings using #'search.
* version.el (emacs-version):
Ditto.
* x-font-menu.el (hack-font-truename):
Implement this more cheaply in terms of #'find,
#'split-string-by-char, #'equal, rather than #'string-match,
#'split-string, #'string-equal.
* x-font-menu.el (x-reset-device-font-menus-core):
Use #'split-string-by-char here.
* x-init.el (x-initialize-keyboard):
Search for a simple string using #'search.
author | Aidan Kehoe <kehoea@parhasard.net> |
---|---|
date | Wed, 01 Apr 2015 14:28:20 +0100 |
parents | 56144c8593a8 |
children |
rev | line source |
---|---|
428 | 1 This directory contains the source files for the C component of XEmacs. |
2 Nothing in this directory is needed for using XEmacs once it is built | |
3 and installed, if the dumped Emacs is copied elsewhere. | |
4 | |
5 See the files ../README and then ../INSTALL for installation instructions. | |
6 | |
7 Under Unix, the file `Makefile.in.in' is used as a template by the script | |
8 `../configure' to produce `Makefile.in'. The same script then uses `cpp' | |
9 to produce the machine-dependent `Makefile' from `Makefile.in'; | |
10 `Makefile' is the file which actually controls the compilation of | |
11 Emacs. Most of this should work transparently to the user; you should | |
12 only need to run `../configure', and then type `make'. | |
13 | |
14 General changes for XEmacs: | |
15 --------------------------- | |
16 1. Lisp objects. | |
17 | |
18 -- XFASTINT has been eliminated. Use of this expression as an lvalue | |
19 is incompatible with the union form of Lisp objects, and use as | |
20 an rvalue is likely to lead to errors and doesn't really save much | |
21 time. Expressions of the form `XFASTINT (obj) = num;' get replaced | |
5581
56144c8593a8
Mechanically change INT to FIXNUM in our sources.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4953
diff
changeset
|
22 by `obj = make_fixnum (num);' or `XSETINT (obj, num);' and |
428 | 23 expressions of the form `num = XFASTINT (obj);' get replaced by |
5581
56144c8593a8
Mechanically change INT to FIXNUM in our sources.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4953
diff
changeset
|
24 `num = XFIXNUM (obj);'. Use Qzero in place of `make_fixnum (0)'. |
428 | 25 |
26 -- Use of XTYPE gets replaced by the appropriate predicate. Using | |
27 XTYPE only works for the small number of types that are not stored | |
28 using the Lisp_Record type (int, cons, string, and vector). For | |
29 example, `(XTYPE (foo) == Lisp_Buffer)' gets replaced by | |
30 `(BUFFERP (foo))'. | |
31 | |
32 -- `XSET (obj, Lisp_Int, num)' gets replaced by `XSETINT (obj, num)', | |
33 for consistency. | |
34 | |
35 -- Some occurrences of XSET need to get replaced by XSETR -- | |
36 specifically, those where the type is not a primitive type | |
37 (primitive types are int, cons, string, and vector). | |
38 | |
39 -- References to `XSTRING (obj)->size' get replaced with | |
40 `XSTRING_LENGTH (obj)'. This is currently for cosmetic reasons | |
41 but there may be other reasons in the future. (This change is | |
42 currently incomplete in the source files.) | |
43 | |
44 | |
45 2. Storage classes: | |
46 | |
47 -- All occurrences of `register' should be replaced by `REGISTER'. | |
48 It interferes with backtraces so we disable it if DEBUG_XEMACS | |
49 is defined. | |
50 | |
51 | |
52 3. Errors, messages, I18N3 snarfing: | |
53 | |
54 -- Errors are continuable in XEmacs but are not in FSF Emacs. | |
55 Therefore, it's important that functions do something reasonable | |
56 if an error gets continued. If you want to signal a non- | |
57 continuable error, the call to Fsignal() gets put inside a | |
58 `while (1)' loop. To facilitate this, and also for proper I18N3 | |
59 message snarfing, most calls to Fsignal() have been replaced by | |
60 calls to signal_error(), signal_simple_error(), etc. Look at | |
61 eval.c for a classification of various error functions. | |
62 | |
63 -- Constant strings occurring in source files need to get wrapped | |
4953
304aebb79cd3
function renamings to track names of char typedefs
Ben Wing <ben@xemacs.org>
parents:
442
diff
changeset
|
64 in a call to GETTEXT (or if inside of a call to `build_ascstring', |
428 | 65 change that function to `build_translated_string') if they don't |
66 occur in certain places where the I18N3 message snarfer will see | |
67 them. For a complete discussion of this, see the file | |
68 lib-src/make-msgfile.lex. | |
69 | |
70 NOTE: I18N3 support is not currently working, so the above may | |
71 or may not apply. Thus it is not a good idea to add random | |
72 GETTEXTs, unless you really know what you are doing. | |
73 | |
74 -- Calls to `fprintf (stderr, ...)' and `printf (...)' get replaced | |
75 with calls to `stderr_out' and `stdout_out'. This is for I18N3 | |
76 message snarfing. | |
77 | |
78 4. Initialization: | |
79 | |
80 -- FSF constructs like `obj = intern ("string"); staticpro (&obj);' | |
81 get replaced by `defsymbol (&obj);'. This is for code cleanness | |
82 and better purespace usage. | |
83 -- FSF constructs like | |
84 obj = intern ("error"); | |
85 Fput (obj, Qerror_message, "message"); | |
86 Fput (obj, Qerror_conditions, some list); | |
87 get replaced by calls to deferror(). See the definition of | |
88 deferror() for how the correct arguments to pass. This is for | |
89 code cleanness and I18N3 message snarfing. | |
90 -- Code in keys_of_foo() functions has been moved into Lisp. |