Mercurial > hg > xemacs-beta
annotate man/new-users-guide/search.texi @ 4690:257b468bf2ca
Move the #'query-coding-region implementation to C.
This is necessary because there is no reasonable way to access the
corresponding mswindows-multibyte functionality from Lisp, and we need such
functionality if we're going to have a reliable and portable
#'query-coding-region implementation. However, this change doesn't yet
provide #'query-coding-region for the mswindow-multibyte coding systems,
there should be no functional differences between an XEmacs with this change
and one without it.
src/ChangeLog addition:
2009-09-19 Aidan Kehoe <kehoea@parhasard.net>
Move the #'query-coding-region implementation to C.
This is necessary because there is no reasonable way to access the
corresponding mswindows-multibyte functionality from Lisp, and we
need such functionality if we're going to have a reliable and
portable #'query-coding-region implementation. However, this
change doesn't yet provide #'query-coding-region for the
mswindow-multibyte coding systems, there should be no functional
differences between an XEmacs with this change and one without it.
* mule-coding.c (struct fixed_width_coding_system):
Add a new coding system type, fixed_width, and implement it. It
uses the CCL infrastructure but has a much simpler creation API,
and its own query_method, formerly in lisp/mule/mule-coding.el.
* unicode.c:
Move the Unicode query method implementation here from
unicode.el.
* lisp.h: Declare Fmake_coding_system_internal, Fcopy_range_table
here.
* intl-win32.c (complex_vars_of_intl_win32):
Use Fmake_coding_system_internal, not Fmake_coding_system.
* general-slots.h: Add Qsucceeded, Qunencodable, Qinvalid_sequence
here.
* file-coding.h (enum coding_system_variant):
Add fixed_width_coding_system here.
(struct coding_system_methods):
Add query_method and query_lstream_method to the coding system
methods.
Provide flags for the query methods.
Declare the default query method; initialise it correctly in
INITIALIZE_CODING_SYSTEM_TYPE.
* file-coding.c (default_query_method):
New function, the default query method for coding systems that do
not set it. Moved from coding.el.
(make_coding_system_1):
Accept new elements in PROPS in #'make-coding-system; aliases, a
list of aliases; safe-chars and safe-charsets (these were
previously accepted but not saved); and category.
(Fmake_coding_system_internal):
New function, what used to be #'make-coding-system--on Mule
builds, we've now moved some of the functionality of this to
Lisp.
(Fcoding_system_canonical_name_p):
Move this earlier in the file, since it's now called from within
make_coding_system_1.
(Fquery_coding_region):
Move the implementation of this here, from coding.el.
(complex_vars_of_file_coding):
Call Fmake_coding_system_internal, not Fmake_coding_system;
specify safe-charsets properties when we're a mule build.
* extents.h (mouse_highlight_priority, Fset_extent_priority,
Fset_extent_face, Fmap_extents):
Make these available to other C files.
lisp/ChangeLog addition:
2009-09-19 Aidan Kehoe <kehoea@parhasard.net>
Move the #'query-coding-region implementation to C.
* coding.el:
Consolidate code that depends on the presence or absence of Mule
at the end of this file.
(default-query-coding-region, query-coding-region):
Move these functions to C.
(default-query-coding-region-safe-charset-skip-chars-map):
Remove this variable, the corresponding C variable is
Vdefault_query_coding_region_chartab_cache in file-coding.c.
(query-coding-string): Update docstring to reflect actual multiple
values, be more careful about not modifying a range table that
we're currently mapping over.
(encode-coding-char): Make the implementation of this simpler.
(featurep 'mule): Autoload #'make-coding-system from
mule/make-coding-system.el if we're a mule build; provide an
appropriate compiler macro.
Do various non-mule compatibility things if we're not a mule
build.
* update-elc.el (additional-dump-dependencies):
Add mule/make-coding-system as a dump time dependency if we're a
mule build.
* unicode.el (ccl-encode-to-ucs-2):
(decode-char):
(encode-char):
Move these earlier in the file, for the sake of some byte compile
warnings.
(unicode-query-coding-region):
Move this to unicode.c
* mule/make-coding-system.el:
New file, not dumped. Contains the functionality to rework the
arguments necessary for fixed-width coding systems, and contains
the implementation of #'make-coding-system, which now calls
#'make-coding-system-internal.
* mule/vietnamese.el (viscii):
* mule/latin.el (iso-8859-2):
(windows-1250):
(iso-8859-3):
(iso-8859-4):
(iso-8859-14):
(iso-8859-15):
(iso-8859-16):
(iso-8859-9):
(macintosh):
(windows-1252):
* mule/hebrew.el (iso-8859-8):
* mule/greek.el (iso-8859-7):
(windows-1253):
* mule/cyrillic.el (iso-8859-5):
(koi8-r):
(koi8-u):
(windows-1251):
(alternativnyj):
(koi8-ru):
(koi8-t):
(koi8-c):
(koi8-o):
* mule/arabic.el (iso-8859-6):
(windows-1256):
Move all these coding systems to being of type fixed-width, not of
type CCL. This allows the distinct query-coding-region for them to
be in C, something which will eventually allow us to implement
query-coding-region for the mswindows-multibyte coding systems.
* mule/general-late.el (posix-charset-to-coding-system-hash):
Document why we're pre-emptively persuading the byte compiler that
the ELC for this file needs to be written using escape-quoted.
Call #'set-unicode-query-skip-chars-args, now the Unicode
query-coding-region implementation is in C.
* mule/thai-xtis.el (tis-620):
Don't bother checking whether we're XEmacs or not here.
* mule/mule-coding.el:
Move the eight bit fixed-width functionality from this file to
make-coding-system.el.
tests/ChangeLog addition:
2009-09-19 Aidan Kehoe <kehoea@parhasard.net>
* automated/mule-tests.el:
Check a coding system's type, not an 8-bit-fixed property, for
whether that coding system should be treated as a fixed-width
coding system.
* automated/query-coding-tests.el:
Don't test the query coding functionality for mswindows-multibyte
coding systems, it's not yet implemented.
| author | Aidan Kehoe <kehoea@parhasard.net> |
|---|---|
| date | Sat, 19 Sep 2009 22:53:13 +0100 |
| parents | f43f9ca6c7d9 |
| children |
| rev | line source |
|---|---|
| 428 | 1 @comment node-name, next, previous, up |
| 2 @node Search and Replace, , Select and Move, Top | |
| 3 @chapter Searching and Replacing | |
| 4 @cindex searching | |
| 5 @cindex replace | |
| 6 @vindex case-fold-search | |
| 7 | |
| 8 Emacs provides commands for searching for occurrences of a particular | |
| 9 string. The search is incremental i.e. it begins even before you | |
| 10 complete typing the whole string. All searches in Emacs ignore the case | |
| 11 of the text they are searching, i.e. if you are searching for "String", | |
| 12 then "string" will also be one of the selections. If you want a case | |
| 13 sensitive search select the @b{Case Sensitive Search} from the | |
| 1738 | 14 @b{Option} menu. You can also set the variable @code{case-fold-search} to |
| 444 | 15 @code{nil} for making searches case-sensitive. For information on setting |
| 428 | 16 variables, @xref{Setting Variables}. The two commands for searching for |
| 444 | 17 strings in XEmacs are: |
| 428 | 18 |
| 19 @table @kbd | |
| 20 @item C-s | |
| 21 @findex isearch-forward | |
| 22 @kindex C-s | |
| 23 This command will prompt you for a string to search : | |
| 24 | |
| 25 @example | |
| 26 I-search: | |
| 27 @end example | |
| 28 | |
| 29 @noindent | |
| 30 If you type "myname" as the string to be searched, then Emacs will start | |
| 31 searching for "m", "my", "myn", etc as you go on typing the whole | |
| 32 string in the forward direction. The cursor will be on the matching | |
| 33 string which has been found so far. If you find the correct match just | |
| 34 hit @key{RET} or type @kbd{C-f} or @kbd{C-b} to set the cursor's | |
| 35 position. If you find a matching string "myname" but you were looking | |
| 36 for a different occurrence of it, use @kbd{C-s} again. If the search is | |
| 444 | 37 unable to find the string, it will give you an error message. |
| 428 | 38 |
| 444 | 39 @item C-r |
| 428 | 40 @findex isearch-backward |
| 41 @kindex C-r | |
| 42 This command will perform an incremental search in the backward | |
| 43 direction. It will prompt you for a string name: | |
| 44 | |
| 45 @example | |
| 46 I-search backward: | |
| 47 @end example | |
| 48 | |
| 49 @noindent | |
| 50 After you start typing the string name, it will search for the string in | |
| 51 the same fashion as it does for @kbd{C-s} except that it will search in | |
| 52 the backward direction. If it cannot find the string name, it will give | |
| 53 you an error message. | |
| 54 @end table | |
| 55 | |
| 56 If you make a mistake while typing the string names when you use the | |
| 57 above commands, you can use the @key{DEL} key to erase characters. Each | |
| 58 @key{DEL} will erase the last character. At any time if you want to quit | |
| 444 | 59 the search, just type @kbd{C-g}. |
| 428 | 60 |
| 61 To do a non-incremental search i.e. to start the search only after | |
| 62 you have typed the whole string you can use the following commands: | |
| 63 | |
| 64 @table @kbd | |
| 65 @item C-s RET @dfn{string} RET | |
| 66 This command will search for the specified string in the forward | |
| 444 | 67 direction and will give an error message if the string is not found. |
| 428 | 68 |
| 69 @item C-r RET @dfn{string} RET | |
| 70 This command will search for the specified string in the backward | |
| 71 direction. | |
| 72 @end table | |
| 73 | |
| 74 For information on how Emacs searches for words and regular | |
| 444 | 75 expressions, @xref{Search,,,xemacs,XEmacs User's Manual}. |
| 428 | 76 |
| 77 To replace all occurrences of a string in Emacs, you can use the | |
| 444 | 78 following command: |
| 428 | 79 @findex replace-string |
| 80 @example | |
| 444 | 81 M-x replace-string |
| 428 | 82 @end example |
| 83 | |
| 84 @noindent | |
| 85 After you type @kbd{M-x replace-string}, you will be prompted for a | |
| 86 string name to replace: | |
| 87 | |
| 88 @example | |
| 89 Replace string: | |
| 90 @end example | |
| 91 | |
| 92 @noindent | |
| 93 After you type in a string name, for example "FOO" and press @key{RET}, | |
| 94 you will see another prompt: | |
| 95 | |
| 96 @example | |
| 97 Replace string FOO with: | |
| 98 @end example | |
| 99 | |
| 100 @noindent | |
| 101 Now type the string which you want to replace "FOO" with and press | |
| 102 @key{RET}. After all the occurrences are replaced you will see the | |
| 103 message "Done" in the echo area. If you want only some occurrences of | |
| 104 the string to be replaced, use @kbd{M-x query-replace RET <string> RET | |
| 105 <newstring> RET}. For more information, @xref{Query | |
| 106 Replace,,,xemacs,XEmacs User's Manual}. | |
| 107 | |
| 108 XEmacs also provides a utility for checking spellings. Use @kbd{M-x | |
| 109 ispell-buffer} to check for spellings in the whole buffer. You can also | |
| 110 check the spelling of a word or a region. You can use menus to | |
| 111 check for spellings: | |
| 112 | |
| 113 @noindent | |
| 444 | 114 Evaluate the expression @code{(load "big-menubar")}. To evaluate this |
| 428 | 115 expression you need to hit the @key{META} or the @key{ESC} key twice and |
| 116 type in the expression in the echo area before hitting @key{RET}. You | |
| 117 will get an extensive menubar. Select the @b{Spell Check} menu item from | |
| 444 | 118 the @b{Utilities} menu for checking spellings. |