Mercurial > hg > xemacs-beta
annotate man/lispref/databases.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 | 576fb035e263 |
children | 9fae6227ede5 |
rev | line source |
---|---|
428 | 1 @c -*-texinfo-*- |
2 @c This is part of the XEmacs Lisp Reference Manual. | |
3 @c Copyright (C) 1996 Ben Wing. | |
4 @c See the file lispref.texi for copying conditions. | |
5 @setfilename ../../info/databases.info | |
6 @node Databases, Processes, Range Tables, top | |
7 @chapter Databases | |
8 @cindex database | |
9 | |
10 @defun databasep object | |
11 This function returns non-@code{nil} if @var{object} is a database. | |
12 @end defun | |
13 | |
14 @menu | |
15 * Connecting to a Database:: | |
16 * Working With a Database:: | |
17 * Other Database Functions:: | |
18 @end menu | |
19 | |
20 @node Connecting to a Database | |
21 @section Connecting to a Database | |
22 | |
23 @defun open-database file &optional type subtype access mode | |
24 This function opens database @var{file}, using database method | |
25 @var{type} and @var{subtype}, with access rights @var{access} and | |
26 permissions @var{mode}. @var{access} can be any combination of @code{r} | |
27 @code{w} and @code{+}, for read, write, and creation flags. | |
28 | |
442 | 29 @var{type} can have the value @code{'dbm} or @code{'berkeley-db} to |
428 | 30 select the type of database file to use. (Note: XEmacs may not |
31 support both of these types.) | |
32 | |
33 For a @var{type} of @code{'dbm}, there are no subtypes, so | |
442 | 34 @var{subtype} should be @code{nil}. |
428 | 35 |
442 | 36 For a @var{type} of @code{'berkeley-db}, the following subtypes are |
428 | 37 available: @code{'hash}, @code{'btree}, and @code{'recno}. See the |
444 | 38 manpages for the Berkeley DB functions for more information about these |
428 | 39 types. |
40 @end defun | |
41 | |
444 | 42 @defun close-database database |
43 This function closes database @var{database}. | |
428 | 44 @end defun |
45 | |
444 | 46 @defun database-live-p object |
47 This function returns @code{t} if @var{object} is an active database, else | |
428 | 48 @code{nil}. |
49 @end defun | |
50 | |
51 @node Working With a Database | |
52 @section Working With a Database | |
53 | |
444 | 54 @defun get-database key database &optional default |
428 | 55 This function finds the value for @var{key} in @var{database}. If there is no |
56 corresponding value, @var{default} is returned (@code{nil} if @var{default} is | |
57 omitted). | |
58 @end defun | |
59 | |
444 | 60 @defun map-database function database |
428 | 61 This function maps @var{function} over entries in @var{database}, |
62 calling it with two args, each key and value in the database. | |
63 @end defun | |
64 | |
444 | 65 @defun put-database key value database &optional replace |
66 This function stores @var{key} and @var{value} in @var{database}. | |
67 If optional fourth arg @var{replace} is non-@code{nil}, replace any | |
428 | 68 existing entry in the database. |
69 @end defun | |
70 | |
444 | 71 @defun remove-database key database |
428 | 72 This function removes @var{key} from @var{database}. |
73 @end defun | |
74 | |
75 @node Other Database Functions | |
76 @section Other Database Functions | |
77 | |
444 | 78 @defun database-file-name database |
79 This function returns the filename associated with @var{database}. | |
428 | 80 @end defun |
81 | |
444 | 82 @defun database-last-error &optional database |
83 This function returns the last error associated with @var{database}. | |
428 | 84 @end defun |
85 | |
444 | 86 @defun database-subtype database |
87 This function returns the subtype of @var{database}, if any. | |
428 | 88 @end defun |
89 | |
444 | 90 @defun database-type database |
91 This function returns the type of @var{database}. | |
428 | 92 @end defun |