comparison src/README @ 245:51092a27c943 r20-5b21

Import from CVS: tag r20-5b21
author cvs
date Mon, 13 Aug 2007 10:17:54 +0200
parents e45d5e7c476e
children 74fd4e045ea6
comparison
equal deleted inserted replaced
244:78d4f1140794 245:51092a27c943
35 -- Some occurrences of XSET need to get replaced by XSETR -- 35 -- Some occurrences of XSET need to get replaced by XSETR --
36 specifically, those where the type is not a primitive type 36 specifically, those where the type is not a primitive type
37 (primitive types are int, cons, string, and vector). 37 (primitive types are int, cons, string, and vector).
38 38
39 -- References to `XSTRING (obj)->size' get replaced with 39 -- References to `XSTRING (obj)->size' get replaced with
40 `string_length (obj)'. This is currently for cosmetic reasons 40 `XSTRING_LENGTH (obj)'. This is currently for cosmetic reasons
41 but there may be other reasons in the future. (This change is 41 but there may be other reasons in the future. (This change is
42 currently incomplete in the source files.) 42 currently incomplete in the source files.)
43 43
44 44
45 2. Storage classes: 45 2. Storage classes:
56 56
57 -- Errors are continuable in XEmacs but are not in FSF Emacs. 57 -- Errors are continuable in XEmacs but are not in FSF Emacs.
58 Therefore, it's important that functions do something reasonable 58 Therefore, it's important that functions do something reasonable
59 if an error gets continued. If you want to signal a non- 59 if an error gets continued. If you want to signal a non-
60 continuable error, the call to Fsignal() gets put inside a 60 continuable error, the call to Fsignal() gets put inside a
61 `while (1)' loop. To facilitate this, and also for proper 61 `while (1)' loop. To facilitate this, and also for proper I18N3
62 I18N3 message snarfing, most calls to Fsignal() have been 62 message snarfing, most calls to Fsignal() have been replaced by
63 replaced by calls to signal_error(), signal_simple_error(), 63 calls to signal_error(), signal_simple_error(), etc. Look at
64 etc. 64 eval.c for a classification of various error functions.
65 65
66 -- Constant strings occurring in source files need to get wrapped 66 -- Constant strings occurring in source files need to get wrapped
67 in a call to GETTEXT (or if inside of a call to `build_string', 67 in a call to GETTEXT (or if inside of a call to `build_string',
68 change that function to `build_translated_string') if they don't 68 change that function to `build_translated_string') if they don't
69 occur in certain places where the I18N3 message snarfer will see 69 occur in certain places where the I18N3 message snarfer will see
70 them. For a complete discussion of this, see the file 70 them. For a complete discussion of this, see the file
71 lib-src/make-msgfile.l. 71 lib-src/make-msgfile.lex.
72
73 NOTE: I18N3 support is not currently working, so the above may
74 or may not apply. Thus it is not a good idea to add random
75 GETTEXTs, unless you really know what you are doing.
72 76
73 -- Calls to `fprintf (stderr, ...)' and `printf (...)' get replaced 77 -- Calls to `fprintf (stderr, ...)' and `printf (...)' get replaced
74 with calls to `stderr_out' and `stdout_out'. This is for I18N3 78 with calls to `stderr_out' and `stdout_out'. This is for I18N3
75 message snarfing. 79 message snarfing.
76 80