Mercurial > hg > xemacs-beta
annotate info/dir @ 4917:fce43cb76a1c
xlike cleanup, documentation
-------------------- ChangeLog entries follow: --------------------
man/ChangeLog addition:
2010-02-03 Ben Wing <ben@xemacs.org>
* internals/internals.texi (Top):
* internals/internals.texi (Evaluation; Stack Frames; Bindings):
* internals/internals.texi (Ben's README):
* internals/internals.texi (Consoles; Devices; Frames; Windows):
* internals/internals.texi (Window Hierarchy):
* internals/internals.texi (The Window Object):
* internals/internals.texi (Modules for the Basic Displayable Lisp Objects):
* internals/internals.texi (Window-System Support):
* internals/internals.texi (Creating a Window-System Type):
* internals/internals.texi (Discussion -- Garbage Collection):
Update the part at the top about how to maintain the file with
more tips.
Add a chapter on "window-system support" describing in a general
way how the support for different window systems/device types
works, including the separation between device-independent and
device-dependent parts, device methods, the specific device types
and the "xlike" pseudo-type.
src/ChangeLog addition:
2010-02-03 Ben Wing <ben@xemacs.org>
* Makefile.in.in:
* Makefile.in.in (x_objs):
* Makefile.in.in (gtk_gui_objs):
* console-xlike-inc.h:
* depend:
* device-x.c:
* emacs.c:
* gccache-gtk.h:
* gccache-gtk.h (gc_cache_lookup):
* gccache-x.c:
* gccache-x.c (GCCACHE_HASH):
* gccache-x.h:
* toolbar-gtk.c:
* toolbar-gtk.c (gtk_initialize_frame_toolbars):
* toolbar-x.c:
* toolbar-x.c (x_initialize_frame_toolbars):
* toolbar-xlike.c:
* toolbar-xlike.c (xlike_draw_blank_toolbar_button):
* toolbar-xlike.c (xlike_output_toolbar_button):
* toolbar-xlike.c (xlike_get_button_size):
* toolbar-xlike.c (XLIKE_OUTPUT_BUTTONS_LOOP):
* toolbar-xlike.c (xlike_output_toolbar):
* toolbar-xlike.c (xlike_clear_toolbar):
* toolbar-xlike.c (xlike_output_frame_toolbars):
* toolbar-xlike.c (xlike_clear_frame_toolbars):
* toolbar-xlike.c (xlike_redraw_exposed_toolbar):
* toolbar-xlike.c (xlike_redraw_exposed_toolbars):
* toolbar-xlike.c (xlike_redraw_frame_toolbars):
* toolbar-xlike.h:
* toolbar-xlike.h (xlike_clear_frame_toolbars):
Rename some files to make them consistent with general naming rules:
xgccache.c -> gccache-x.c
xgccache.h -> gccache-x.h
toolbar-common.c -> toolbar-xlike.c
toolbar-common.h -> toolbar-xlike.h
Fix include-file references. Also change the names of functions
in now-named toolbar-xlike.c to be xlike_foo() instead of common_foo().
Add a longish comment in console-xlike-inc.h describing the "xlike"
system, how it works and what the various files are used for.
| author | Ben Wing <ben@xemacs.org> |
|---|---|
| date | Wed, 03 Feb 2010 02:46:50 -0600 |
| parents | c2580215c222 |
| children |
| rev | line source |
|---|---|
| 428 | 1 -*- Text -*- |
| 2 | |
| 3 This is the file .../info/dir, which contains the topmost node of the Info | |
| 4 hierarchy. The first time you invoke Info you start off looking at that node, | |
| 5 which is (dir)Top. | |
| 6 | |
| 7 Rather than adding new nodes to this directory (and this file) it is a better | |
| 8 idea to put them in a site-local directory, and then configure info to search | |
| 9 in that directory as well. That way, you won't have to re-edit this file when | |
| 10 a new release of the editor comes out. | |
| 11 | |
| 12 For example, you could add this code to .../lisp/site-start.el, which is | |
| 13 loaded before ~/.emacs each time the editor starts up: | |
| 14 | |
| 15 ;; find local info nodes | |
| 16 (setq Info-directory-list | |
| 17 (append Info-directory-list '("/private/info/"))) | |
| 18 | |
| 19 Then, when you enter info, a dir file like this one will be automatically | |
| 20 created and saved (provided you have write access to the directory). The | |
| 21 contents of that file "/private/info/dir" will be appended to the contents of | |
| 22 this file. | |
| 23 | |
| 24 | |
| 25 File: dir Node: Top This is the top of the INFO tree | |
| 26 | |
| 27 This is Info, the online documentation browsing system. | |
| 28 This page (the Directory node) gives a menu of major topics. | |
| 29 | |
| 1092 | 30 button2 on a highlighted word follows that cross-reference. |
| 428 | 31 button3 anywhere brings up a menu of commands. |
| 32 ? lists additional keyboard commands. | |
| 33 h invokes the Info tutorial. | |
| 34 | |
| 35 * Menu: | |
| 36 | |
| 697 | 37 XEmacs 21.5 |
| 428 | 38 =========== |
| 2609 | 39 * XEmacs: (xemacs). XEmacs Editor. |
| 40 * Lispref: (lispref). XEmacs Lisp Reference Manual. | |
| 41 * Intro: (new-users-guide). Introduction to the XEmacs Editor. | |
| 42 * FAQ: (xemacs-faq). XEmacs FAQ. | |
| 43 * Info: (info). Documentation browsing system. | |
| 44 * Internals: (internals). XEmacs Internals Manual. | |
| 45 | |
| 428 | 46 |
| 462 | 47 Other Documentation: |
| 428 | 48 |
| 2609 | 49 * Common Lisp: (cl). XEmacs Common Lisp emulation package. |
| 50 * Customizations: (custom). Customization Library. | |
| 51 * Emodules: (emodules). XEmacs dynamically loadable module support. | |
| 52 * External Widget: (external-widget). External Client Widget. | |
| 53 * Standards: (standards). GNU coding standards. | |
| 54 * Term mode: (term). XEmacs Terminal Emulator Mode. | |
| 55 * Termcap: (termcap). Termcap library of the GNU system. | |
| 56 * Texinfo: (texinfo). The GNU documentation format. | |
| 57 * Widgets: (widget). The Emacs Widget Library. | |
| 428 | 58 |