view oldXMenu/README @ 111851:dd83cbcddf69

Adjust parameter names and doc strings to resolve confusion over whether "bookmark" meant a bookmark name or a bookmark record. Along the way, shorten one function's name for similar reasons. (Issue #7548) * lisp/bookmark.el (bookmark-name-from-record): New name for `bookmark-name-from-full-record'. All callers changed. (bookmark-get-bookmark, bookmark-get-bookmark-record, bookmark-default-annotation-text, bookmark-prop-get, bookmark-prop-set, bookmark-get-annotation, bookmark-set-annotation, bookmark-get-filename, bookmark-set-filename, bookmark-get-position, bookmark-set-position, bookmark-get-front-context-string, bookmark-set-front-context-string, bookmark-get-rear-context-string, bookmark-set-rear-context-string, bookmark-get-handler, bookmark-edit-annotation, bookmark--jump-via, bookmark-handle-bookmark, bookmark-location, bookmark-show-annotation): Rename `bookmark' parameter to `bookmark-name-or-record', to clearly show its role, and shorten or adjust doc strings accordingly. (bookmark-set-name): Same, and pass the parameter directly to `bookmark-get-bookmark' instead of redundantly doing the callee's work. (bookmark-default-annotation-text, bookmark-send-edited-annotation, bookmark-relocate, bookmark-insert-location, bookmark-insert, bookmark-delete): Rename `bookmark' parameter to `bookmark-name', and in some cases shorten doc string accordingly. (bookmark-rename): Change `old' and `new' parameters to `old-name' and `new-name', and adjust an internal variable to avoid confusion. (bookmark-jump, bookmark-jump-noselect): Clarify `bookmark' parameter in doc string.

Most of the files in this directory are originally from the X11R2
XMenu library, distributed by MIT under the terms in the file copyright.h.

As of Release 2 of the X Window System, Version 11 from MIT, the XMenu
library is no longer supported.  It is not used in any software
supplied by MIT and its use is not encouraged.

In X11R1, oldXMenu/ was found in the lib/ directory of the X11 source;
but in X11R2 it was moved to contrib/.

The following files are from the X11 oldXMenu/ directory:

 Activate.c AddPane.c AddSel.c ChgPane.c ChgSel.c Create.c DelPane.c
 DelSel.c Destroy.c Error.c EvHand.c FindPane.c FindSel.c InsPane.c
 InsSel.c Internal.c Locate.c Post.c Recomp.c SetAEQ.c SetFrz.c
 SetPane.c SetSel.c XMenu.h XMenuInt.h (renamed from "XMenuInternal.h")

The following files are from the X11 oldX/ directory:

 X10.h XCrAssoc.c XDelAssoc.c XDestAssoc.c XLookAssoc.c XMakeAssoc.c

This code is used by Emacs in the absence of an X-toolkit.