comparison etc/NEWS @ 203:850242ba4a81 r20-3b28

Import from CVS: tag r20-3b28
author cvs
date Mon, 13 Aug 2007 10:02:21 +0200
parents 169c0442b401
children e45d5e7c476e
comparison
equal deleted inserted replaced
202:61eefc8fc970 203:850242ba4a81
146 set to nil to revert to the old behaviour. As before, typing C-g 146 set to nil to revert to the old behaviour. As before, typing C-g
147 deactivates the region. 147 deactivates the region.
148 148
149 ** Info "dir" functionality merged from Emacs-19.34 149 ** Info "dir" functionality merged from Emacs-19.34
150 150
151 ------------------ DRAFT ------------------
152
153 At the time it is dumped, XEmacs will initialize the value of
154 `Info-default-directory-list' from the value of the environment
155 variable INFOPATH, which it inherits from the Makefile. The Makefile
156 gets the value from `configure'.
157
158 #### BETA Note: if the package startup stuff moves or changes, this
159 next paragraph may need fixing.
160
161 At runtime, the XEmacs startup code will loop through that list and
162 collect all of the directories in it that satisfy `file-directory-p',
163 and then appends any site package info directories found... ?? How do
164 you want this worded? XXXXX !!!! (bright red bold DRAFT)
165
166 When you start the info reader, `Info-directory-list' is initialized
167 from either the environment variable "INFOPATH", if it exists, or
168 `Info-default-directory-list'. The first directory in this list must
169 contain a "dir" file like the one supplied with XEmacs. Note that if
170 an INFOPATH variable is used, that only the directories in that path
171 will be searched; no package info paths will be appended, as `Info-
172 default-directory-list' will be ignored in that case.
173
151 All of the directories on `Info-directory-list' will be searched for 174 All of the directories on `Info-directory-list' will be searched for
152 "dir" files, which may be full fledged Info files containing subnodes 175 "dir" files, which may be full fledged Info files containing subnodes
153 as well as menus. They are merged to become one directory, with menus 176 as well as menus. They are merged to become one Info directory, with
154 in like-named subnodes being coalesced from the several "dir" files. 177 menus in like-named subnodes being coalesced from the several "dir"
155 178 files.
156 "localdir" files are looked for too, secondary to "dir"'s. If there's 179
157 no "dir" in a directory, a "localdir" will be looked for. There can 180 BETA Note: I have not tested this very thouroughly. Does anyone out
158 be one of either "dir" or "localdir" in each of the directories in 181 there actually have a dir file with real `info' subnodes in it? I
159 `Info-directory-list', which is initialized from `Info-default- 182 will create one and try it as I learn how. - karlheg
160 directory-list', which you may customize through the Options menu. 183
184 "localdir" files are looked for also, secondary to "dir"'s. A localdir
185 file should look like a section of the Info directory menu:
186
187 |
188 |* Gnus:: The all seeing all knowing News and Mail
189 | interface for XEmacs.
190 |* Calc:: HP-48 alike Calculator that can do algebra
191 |
192
193 The info reader will insert its contents into the main Info directory
194 either at the end of the (dir)Top node, beginning at and replacing a
195 line that looks like:
196
197 |
198 |* Locals:
199 |
200
201 BETA-Note: Coming soon...
202
203 ... or, below a line that contains the exact text:
204
205 |
206 |Locally installed XEmacs Packages
207 |
208
209 ... by default. (This text is configurable--- see:
210 `M-x customize-variable Info-localdir-heading-regexp'
211
212 The `Info-localdir-heading-regexp' may be underlined with *'s, ='s, or
213 -'s, like any Info topic header. When `Info-fontify' is non-nil, the
214 underlineing characters will be elided and the topic heading itself
215 will be given a face, according to `Info-title-face-alist'.
216
161 217
162 ** Abbreviations can now contain non-word characters. 218 ** Abbreviations can now contain non-word characters.
163 219
164 This means that it is finally possible to do such simple things as 220 This means that it is finally possible to do such simple things as
165 define `#in' to expand to `#include' in C mode, `s-c-b' to 221 define `#in' to expand to `#include' in C mode, `s-c-b' to