File: hbdata.el.html
This module handles Hyperbole button data/attribute storage. In
general, it should not be extended by anyone other than Hyperbole
maintainers. If you alter the formats or accessors herein, you are
likely to make your buttons incompatible with future releases.
System developers should instead work with and extend the "hbut.el"
module which provides much of the Hyperbole application programming
interface and which hides the low level details handled by this
module.
Button data is typically stored within a file that holds the button
data for all files within that directory. The name of this file is
given by the variable 'hattr:filename,' usually it is ".hypb".
Here is a sample from a Hyperbole V2 button data file. Each button
data entry is a list of fields:
"TO-DO"
(Key Placeholders LinkType <arg-list> creator and modifier with times)
("alt.mouse.el" nil nil link-to-file ("./ell/alt-mouse.el") "zzz@gnu.org" "19991027:09:19:26" "zzz@gnu.org" "19991027:09:31:36")
which means: button \<(alt.mouse.el)> found in file "TO-DO" in the
current directory provides a link to the local file "./ell/alt-mouse.el".
It was created and last modified by zzz@gnu.org.
All link entries that originate from the same source file are stored
contiguously, one per line, in reverse order of creation.
Preceding all such entries is the source name (in the case of a file
used as a source, no directory information is included, since only
sources within the same directory as the button data file are used as
source files within it.
Defined variables (0)
Defined functions (28)
hbdata:action | (HBDATA) |
hbdata:actype | (HBDATA) |
hbdata:apply-entry | (FUNC LBL-KEY KEY-SRC &optional DIRECTORY CREATE-FLAG INSTANCE-FLAG) |
hbdata:args | (HBDATA) |
hbdata:categ | (HBDATA) |
hbdata:create-time | (HBDATA) |
hbdata:creator | (HBDATA) |
hbdata:delete-entry | (LBL-KEY KEY-SRC &optional DIRECTORY) |
hbdata:delete-entry-at-point | () |
hbdata:ebut-build | (&optional MOD-LBL-KEY BUT-SYM NEW-LBL-KEY) |
hbdata:ebut-instance-last | (LBL-KEY KEY-SRC &optional DIRECTORY) |
hbdata:get-entry | (LBL-KEY KEY-SRC &optional DIRECTORY) |
hbdata:ibut-instance-last | (NAME-KEY) |
hbdata:ibut-instance-next | (NAME-KEY) |
hbdata:instance-next | (NAME-KEY) |
hbdata:is-but-data-stored-in-buffer | (KEY-SRC) |
hbdata:key | (HBDATA) |
hbdata:loc-p | (HBDATA) |
hbdata:mod-time | (HBDATA) |
hbdata:modifier | (HBDATA) |
hbdata:referent | (HBDATA) |
hbdata:search | (BUF LABEL PARTIAL) |
hbdata:to-entry | (BUT-KEY KEY-SRC &optional DIRECTORY INSTANCE) |
hbdata:to-entry-buf | (KEY-SRC &optional DIRECTORY CREATE) |
hbdata:to-entry-in-buffer | (CREATE) |
hbdata:to-entry-in-file | (KEY-SRC &optional DIRECTORY CREATE) |
hbdata:to-hbdata-buffer | (DIR &optional CREATE) |
hbdata:write | (&optional ORIG-LBL-KEY BUT-SYM NEW-LBL-KEY) |