annotate info/dir @ 5253:b6a398dbb403

Fewer algorithmic complexity surprises, nicer errors, mapcarX(), maplist() src/ChangeLog addition: 2010-09-01 Aidan Kehoe <kehoea@parhasard.net> * fns.c (list_merge, list_array_merge_into_list) (list_array_merge_into_array): Avoid algorithmic complexity surprises when checking for circularity in these functions. (Freduce): Fix some formatting, in passing. (mapcarX): Drop the SOME_OR_EVERY argument to this function; instead, take CALLER, a symbol reflecting the Lisp-visible function that called mapcarX(). Use CALLER with mapping_interaction_error() when sequences are modified illegally. Don't cons with #'some, #'every, not even a little. (Fmapconcat, FmapcarX, Fmapvector, Fmapcan, Fmapc, Fmap) (Fmap_into, Fsome, Fevery): Call mapcarX() with its new arguments. (Fmapcan): Don't unnecessarily complicate the nconc call. (maplist): Take CALLER, a symbol reflecting the Lisp-visible function that called maplist(), rather than having separate arguments to indicate mapl vs. mapcon. Avoid algorithmic complexity surprises when checking for circularity. In #'mapcon, check a given stretch of result for well-formedness once, which was not previously the case, despite what the comments said. (Fmaplist, Fmapl, Fmapcon): Call maplist() with its new arguments.
author Aidan Kehoe <kehoea@parhasard.net>
date Wed, 01 Sep 2010 12:51:32 +0100
parents c2580215c222
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1 -*- Text -*-
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3 This is the file .../info/dir, which contains the topmost node of the Info
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
4 hierarchy. The first time you invoke Info you start off looking at that node,
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
5 which is (dir)Top.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
6
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
7 Rather than adding new nodes to this directory (and this file) it is a better
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
8 idea to put them in a site-local directory, and then configure info to search
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
9 in that directory as well. That way, you won't have to re-edit this file when
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
10 a new release of the editor comes out.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
11
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
12 For example, you could add this code to .../lisp/site-start.el, which is
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
13 loaded before ~/.emacs each time the editor starts up:
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
14
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
15 ;; find local info nodes
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
16 (setq Info-directory-list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
17 (append Info-directory-list '("/private/info/")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
18
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
19 Then, when you enter info, a dir file like this one will be automatically
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
20 created and saved (provided you have write access to the directory). The
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
21 contents of that file "/private/info/dir" will be appended to the contents of
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
22 this file.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
23
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
24 
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
25 File: dir Node: Top This is the top of the INFO tree
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
26
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
27 This is Info, the online documentation browsing system.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
28 This page (the Directory node) gives a menu of major topics.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
29
1092
f5d8712231af [xemacs-hg @ 2002-11-11 14:19:07 by stephent]
stephent
parents: 721
diff changeset
30 button2 on a highlighted word follows that cross-reference.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
31 button3 anywhere brings up a menu of commands.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
32 ? lists additional keyboard commands.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
33 h invokes the Info tutorial.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
34
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
35 * Menu:
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
36
697
7a42cc017e59 [xemacs-hg @ 2001-12-16 10:26:55 by adrian]
adrian
parents: 462
diff changeset
37 XEmacs 21.5
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
38 ===========
2609
c2580215c222 [xemacs-hg @ 2005-02-23 18:56:41 by adrian]
adrian
parents: 1092
diff changeset
39 * XEmacs: (xemacs). XEmacs Editor.
c2580215c222 [xemacs-hg @ 2005-02-23 18:56:41 by adrian]
adrian
parents: 1092
diff changeset
40 * Lispref: (lispref). XEmacs Lisp Reference Manual.
c2580215c222 [xemacs-hg @ 2005-02-23 18:56:41 by adrian]
adrian
parents: 1092
diff changeset
41 * Intro: (new-users-guide). Introduction to the XEmacs Editor.
c2580215c222 [xemacs-hg @ 2005-02-23 18:56:41 by adrian]
adrian
parents: 1092
diff changeset
42 * FAQ: (xemacs-faq). XEmacs FAQ.
c2580215c222 [xemacs-hg @ 2005-02-23 18:56:41 by adrian]
adrian
parents: 1092
diff changeset
43 * Info: (info). Documentation browsing system.
c2580215c222 [xemacs-hg @ 2005-02-23 18:56:41 by adrian]
adrian
parents: 1092
diff changeset
44 * Internals: (internals). XEmacs Internals Manual.
c2580215c222 [xemacs-hg @ 2005-02-23 18:56:41 by adrian]
adrian
parents: 1092
diff changeset
45
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
46
462
0784d089fdc9 Import from CVS: tag r21-2-46
cvs
parents: 428
diff changeset
47 Other Documentation:
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
48
2609
c2580215c222 [xemacs-hg @ 2005-02-23 18:56:41 by adrian]
adrian
parents: 1092
diff changeset
49 * Common Lisp: (cl). XEmacs Common Lisp emulation package.
c2580215c222 [xemacs-hg @ 2005-02-23 18:56:41 by adrian]
adrian
parents: 1092
diff changeset
50 * Customizations: (custom). Customization Library.
c2580215c222 [xemacs-hg @ 2005-02-23 18:56:41 by adrian]
adrian
parents: 1092
diff changeset
51 * Emodules: (emodules). XEmacs dynamically loadable module support.
c2580215c222 [xemacs-hg @ 2005-02-23 18:56:41 by adrian]
adrian
parents: 1092
diff changeset
52 * External Widget: (external-widget). External Client Widget.
c2580215c222 [xemacs-hg @ 2005-02-23 18:56:41 by adrian]
adrian
parents: 1092
diff changeset
53 * Standards: (standards). GNU coding standards.
c2580215c222 [xemacs-hg @ 2005-02-23 18:56:41 by adrian]
adrian
parents: 1092
diff changeset
54 * Term mode: (term). XEmacs Terminal Emulator Mode.
c2580215c222 [xemacs-hg @ 2005-02-23 18:56:41 by adrian]
adrian
parents: 1092
diff changeset
55 * Termcap: (termcap). Termcap library of the GNU system.
c2580215c222 [xemacs-hg @ 2005-02-23 18:56:41 by adrian]
adrian
parents: 1092
diff changeset
56 * Texinfo: (texinfo). The GNU documentation format.
c2580215c222 [xemacs-hg @ 2005-02-23 18:56:41 by adrian]
adrian
parents: 1092
diff changeset
57 * Widgets: (widget). The Emacs Widget Library.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
58