|
100
|
1 # See "hversion.el" for the Hyperbole lisp code directory entry.
|
|
0
|
2 #
|
|
|
3 # FILE: README
|
|
100
|
4 # SUMMARY: Information Hyperbole users and maintainers should read.
|
|
0
|
5 #
|
|
|
6 # AUTHOR: Bob Weiner
|
|
|
7 #
|
|
100
|
8 # ORG: InfoDock Associates. We sell corporate support and development
|
|
|
9 # contracts for InfoDock, Emacs and XEmacs.
|
|
|
10 # E-mail: <info@infodock.com> Web: http://www.infodock.com
|
|
|
11 # Tel: +1 408-243-3300
|
|
|
12 #
|
|
0
|
13 # ORIG-DATE: 19-Oct-91 at 03:27:47
|
|
114
|
14 # LAST-MOD: 17-Mar-97 at 21:14:10 by Bob Weiner
|
|
100
|
15 #
|
|
|
16 # See the Copyright section below for license information.
|
|
70
|
17
|
|
100
|
18 We thank Motorola Inc. for sponsoring our initial development work on
|
|
|
19 Hyperbole.
|
|
0
|
20
|
|
100
|
21 We hope you enjoy using and developing with Hyperbole. Suggestions
|
|
|
22 and bug reports are welcome, as described later in this document.
|
|
|
23 Feel free to mail or post news containing this file wherever it may be
|
|
|
24 of use.
|
|
0
|
25
|
|
|
26
|
|
|
27 ===========================================================================
|
|
|
28 * Table of Contents
|
|
|
29 ===========================================================================
|
|
|
30 * Hyperbole Overview
|
|
|
31 * What's New
|
|
|
32 * How to Obtain
|
|
|
33 * Installation / Configuration
|
|
|
34 * Quick Reference
|
|
|
35 * Mail Lists
|
|
|
36 * User Quotes
|
|
|
37 * Why was Hyperbole developed?
|
|
|
38 * Copyright
|
|
|
39
|
|
|
40
|
|
|
41 ===========================================================================
|
|
|
42 * Hyperbole Overview
|
|
|
43 ===========================================================================
|
|
|
44
|
|
|
45 Hyperbole is an open, efficient, programmable information management and
|
|
|
46 hypertext system. It is intended for everyday work on any UNIX platform
|
|
|
47 supported by GNU Emacs. It works well with the versions of Emacs that
|
|
100
|
48 support MS-Windows, X or NEXTSTEP windows: XEmacs and GNU Emacs.
|
|
|
49
|
|
|
50 Hyperbole allows hypertext buttons to be embedded within unstructured and
|
|
|
51 structured files, mail messages and news articles. It offers intuitive
|
|
|
52 mouse-based control of information display within multiple windows. It also
|
|
|
53 provides point-and-click access to Info manuals, ftp archives, Wide-Area
|
|
|
54 Information Servers (WAIS), and the World-Wide Web (WWW) hypertext system
|
|
|
55 through encapsulations of software that support these protocols.
|
|
0
|
56
|
|
|
57 Hyperbole consists of four parts:
|
|
|
58
|
|
|
59 1. Info Management: an interactive information management interface,
|
|
|
60 including a powerful rolodex, which anyone can use. It is easy
|
|
|
61 to pick up and use since it introduces only a few new mechanisms
|
|
|
62 and provides user-level facilities through a menu interface,
|
|
|
63 which you control from the keyboard or the mouse;
|
|
|
64
|
|
|
65 2. Hypertext Outliner: an outliner with multi-level autonumbering
|
|
|
66 and permanent ids attached to each outline node for use as
|
|
|
67 hypertext link anchors, plus flexible view specifications that
|
|
|
68 can be embedded within links or used interactively;
|
|
|
69
|
|
|
70 3. Button Types: A set of hyper-button types that provides
|
|
|
71 core hypertext and other behaviors. Users can make simple
|
|
|
72 changes to button types and those familiar with Emacs Lisp can
|
|
|
73 quickly prototype and deliver new types;
|
|
|
74
|
|
|
75 4. Programming Library: a set of programming library classes for
|
|
|
76 system developers who want to integrate Hyperbole with another
|
|
|
77 user interface or as a back-end to a distinct system. (All of
|
|
|
78 Hyperbole is written in Emacs Lisp for ease of modification.
|
|
|
79 Although Hyperbole was initially designed as a prototype, it has
|
|
|
80 been engineered for real-world usage and is well structured.)
|
|
|
81
|
|
|
82 A Hyperbole user works with buttons; he may create, modify,
|
|
|
83 move or delete buttons. Each button performs a specific action, such as
|
|
|
84 linking to a file or executing a shell command.
|
|
|
85
|
|
|
86 There are three categories of Hyperbole buttons:
|
|
|
87
|
|
|
88 1. Explicit Buttons
|
|
|
89 created by Hyperbole, accessible from within a single document;
|
|
|
90
|
|
|
91 2. Global Buttons
|
|
|
92 created by Hyperbole, accessible anywhere within a user's
|
|
|
93 network of documents;
|
|
|
94
|
|
|
95 3. Implicit Buttons
|
|
|
96 buttons created and managed by other programs or embedded
|
|
|
97 within the structure of a document, accessible from within a
|
|
|
98 single document. Hyperbole recognizes implicit buttons by
|
|
|
99 contextual patterns given in their type specifications.
|
|
|
100
|
|
|
101 Hyperbole buttons may be clicked upon with a mouse to activate them or
|
|
|
102 to describe their actions. Thus, a user can always check how a button
|
|
|
103 will act before activating it. Buttons may also be activated from a
|
|
|
104 keyboard. (In fact, virtually all Hyperbole operations, including menu
|
|
|
105 usage, may be performed from any standard character terminal interface, so
|
|
|
106 one need not be anchored to a workstation all day).
|
|
|
107
|
|
|
108 Hyperbole does not enforce any particular hypertext or information management
|
|
|
109 model, but instead allows you to organize your information in large or small
|
|
|
110 chunks as you see fit. The Hyperbole outliner organizes information
|
|
|
111 hierarchies which may also contain links to external information sources.
|
|
|
112
|
|
|
113 Some of Hyperbole's most important features include:
|
|
|
114
|
|
|
115 Buttons may link to information or may execute procedures, such as
|
|
|
116 starting or communicating with external programs;
|
|
|
117
|
|
|
118 One simply drags between a button source location and a link destination
|
|
|
119 to create or to modify a link button. The same result can be achieved
|
|
|
120 from the keyboard.
|
|
|
121
|
|
|
122 Buttons may be embedded within electronic mail messages;
|
|
|
123
|
|
|
124 Outlines allow rapid browsing, editing and movement of chunks of
|
|
|
125 information organized into trees (hierarchies);
|
|
|
126
|
|
|
127 Other hypertext and information retrieval systems may be
|
|
|
128 encapsulated under a Hyperbole user interface (a number of samples
|
|
|
129 are provided).
|
|
|
130
|
|
|
131 Typical Hyperbole applications include:
|
|
|
132
|
|
|
133 Personal Information Management
|
|
|
134 Overlapping link paths provide a variety of views into an
|
|
|
135 information space.
|
|
|
136
|
|
|
137 A search facility locates buttons in context and permits quick
|
|
|
138 selection.
|
|
|
139
|
|
|
140 Documentation Browsing
|
|
|
141 Embed cross-references in your favorite documentation format.
|
|
|
142
|
|
|
143 Add a point-and-click interface to existing documentation.
|
|
|
144
|
|
|
145 Link code and design documents. Jump to the definition of an
|
|
|
146 identifier from its use within code or its reference within
|
|
|
147 documentation.
|
|
|
148
|
|
|
149 Brainstorming
|
|
|
150 Capture ideas and then quickly reorganize them with the Hyperbole
|
|
|
151 outliner. Link to related ideas, eliminating the need to copy
|
|
|
152 and paste information into a single place.
|
|
|
153
|
|
|
154 Help/Training Systems
|
|
|
155 Create tutorials with embedded buttons that show students how
|
|
|
156 things work while explaining the concepts, e.g. an introduction
|
|
|
157 to UNIX commands. This technique can be much more effective than
|
|
|
158 descriptions alone.
|
|
|
159
|
|
|
160 Archive Managers
|
|
|
161 Supplement programs that manage archives from incoming
|
|
|
162 information streams by having them add topic-based buttons that
|
|
|
163 link to the archive holdings. Users can then search and create
|
|
|
164 their own links to archive entries.
|
|
|
165
|
|
|
166
|
|
|
167 ===========================================================================
|
|
114
|
168 * What's New in V4.02-V4.023
|
|
0
|
169 ===========================================================================
|
|
|
170
|
|
|
171 (See "ChangeLog" for more complete details of changes.)
|
|
|
172
|
|
|
173 ACTION AND ASSIST KEYS
|
|
|
174
|
|
114
|
175 - Action Key clicks on HTTP URLs use the Emacs internal web browser
|
|
|
176 if not running under a window system.
|
|
|
177
|
|
100
|
178 - Support for new ID-edit mode (a part of InfoDock) that allows rapid,
|
|
|
179 cutting, copying and yanking of regions plus fast display management.
|
|
|
180 In this mode, the Action and Assist keys yank the previously selected
|
|
|
181 region at point.
|
|
0
|
182
|
|
100
|
183 - An Action Key press on a Java identifier jumps to its definition
|
|
|
184 (if an associated TAGS file or OO-Browser environment exists). The
|
|
|
185 same is true for an `@see' cross-reference within a Java comment. The
|
|
|
186 variable, `smart-java-package-dirs,' determines where Java package
|
|
|
187 source can be found when the OO-Browser is not in use.
|
|
0
|
188
|
|
100
|
189 - An Action Key press on a double or single quoted Emacs Lisp filename
|
|
|
190 (without any path) displays the file by looking for it among the
|
|
|
191 directories in the variable, `load-path'.
|
|
0
|
192
|
|
100
|
193 - If the Action Key is pressed on a function identifier that is defined
|
|
|
194 in the same buffer as the reference clicked upon, it will now be
|
|
|
195 displayed faster, since the func-menu package will be used. The
|
|
|
196 reference identifier will also flash when pressed, if the display
|
|
|
197 device supports this.
|
|
0
|
198
|
|
|
199 EMACS VERSIONS
|
|
|
200
|
|
100
|
201 - Further support for MS-DOS, Windows NT Emacs 19, and Win-Emacs.
|
|
0
|
202
|
|
100
|
203 - Fixed configuration setup problem when running Emacs 19 on a dumb
|
|
|
204 terminal.
|
|
0
|
205
|
|
|
206 KOUTLINER
|
|
|
207
|
|
100
|
208 - XEmacs 19.14 and above: Fixed display of current viewspec in the
|
|
|
209 modeline to accomodate modeline extents (specialized modeline regions).
|
|
|
210 This eliminated an error that occurred when reading in an Koutline file.
|
|
0
|
211
|
|
100
|
212 - Fixed bug that prevented installation of Koutliner mode-specific
|
|
|
213 menubar when running InfoDock.
|
|
0
|
214
|
|
100
|
215 MENUS
|
|
0
|
216
|
|
100
|
217 - New Hyperbole/About menu item added. In minibuffer menus, this item is
|
|
|
218 found under the Doc/ menu.
|
|
0
|
219
|
|
100
|
220 - New window system menu, Hyperbole/Customization (and minibuffer menu,
|
|
|
221 Cust/) added to set Hyperbole options, including where Hyperbole link
|
|
|
222 referents are displayed, where URLs are displayed and whether to use
|
|
|
223 proportional or windowful scrolling when a Smart Key is pressed at the
|
|
|
224 end of a line.
|
|
0
|
225
|
|
100
|
226 - The default setting of where Hyperbole link references are displayed
|
|
|
227 may be set in "hsite.el" via the variable, `hpath:display-where'
|
|
|
228 (after Hyperbole has been installed using `make install').
|
|
|
229 See its documentation for detail.
|
|
0
|
230
|
|
100
|
231 - The Hyperbole/Global-Button menu now includes a menu item that will
|
|
|
232 activate each existing global button. The Hyperbole/Explicit-Button
|
|
|
233 menu does the same thing for explicit buttons in the current buffer.
|
|
0
|
234
|
|
|
235 ROLODEX
|
|
|
236
|
|
114
|
237 - Date stamps are added to each rolodex entry when created and updated
|
|
|
238 when edited. This feature can be toggled on and off with:
|
|
|
239 M-x rolo-toggle-datestamps RET, or via the Toggle-Rolodex-Dates menu
|
|
|
240 item on the Customization menu.
|
|
|
241
|
|
|
242 - wrolo-add-hook is called after a new entry is added.
|
|
|
243 wrolo-edit-hook is called after an entry is displayed for editing.
|
|
|
244
|
|
100
|
245 - Rolo-edit, bound to {e} in the rolodex match buffer, now works properly
|
|
|
246 if the rolodex is loaded before the rest of the Hyperbole system.
|
|
36
|
247
|
|
0
|
248
|
|
|
249 ===========================================================================
|
|
|
250 * How to Obtain
|
|
|
251 ===========================================================================
|
|
|
252
|
|
100
|
253 InfoDock Associates, the developer of Hyperbole and InfoDock (an industrial
|
|
|
254 quality turn-key version of XEmacs), is a firm dedicated to radical
|
|
|
255 productivity improvement in technical environments, whether in software
|
|
|
256 development or other knowledge intensive disciplines. Our initial offerings
|
|
|
257 include high quality commercial support, training, books and custom package
|
|
|
258 development for InfoDock, XEmacs or GNU Emacs on a variety of platforms.
|
|
|
259 InfoDock provides a modern user interface on top of Emacs, information
|
|
|
260 management, and powerful software development tools, all in one package.
|
|
0
|
261
|
|
100
|
262 Contact us at <info@infodock.com> or visit our web site at
|
|
|
263 http://www.infodock.com.
|
|
|
264
|
|
|
265 Hyperbole is available as part of InfoDock or XEmacs and also as a standalone
|
|
|
266 package via anonymous ftp across the Internet. Do not send requests to have
|
|
|
267 it mailed to you since it won't be. Instead have another party who has
|
|
|
268 Internet access obtain it for the both of you.
|
|
0
|
269
|
|
|
270 Here is how to obtain Hyperbole as a standalone package on the Internet:
|
|
|
271
|
|
|
272 Move to a directory below which you want the 'hyperbole' directory to
|
|
|
273 be created. Unpacking the Hyperbole archive will create this
|
|
|
274 directory and place all of the files below it.
|
|
|
275
|
|
|
276 cd <LOCAL-LISP-DIR>
|
|
|
277
|
|
|
278 Ftp to ftp.xemacs.org (Internet Host ID = 128.174.252.16):
|
|
|
279
|
|
100
|
280 prompt> ftp ftp.xemacs.org (If this doesn't work, try `ftp xemacs.org'.)
|
|
0
|
281
|
|
|
282 Login as 'anonymous' with your own <user-id>@<site-name> as a password.
|
|
|
283
|
|
|
284 Name (ftp.xemacs.org): anonymous
|
|
|
285 331 Guest login ok, send EMAIL address (e.g. user@host.domain) as password.
|
|
|
286 Password:
|
|
|
287 230 Guest login ok, access restrictions apply.
|
|
|
288
|
|
|
289 Move to the Hyperbole directory:
|
|
|
290
|
|
100
|
291 ftp> cd /pub/infodock
|
|
0
|
292
|
|
|
293 Set your transfer mode to binary:
|
|
|
294
|
|
|
295 ftp> bin
|
|
|
296 200 Type set to I.
|
|
|
297
|
|
|
298 Turn off prompting:
|
|
|
299
|
|
|
300 ftp> prompt
|
|
|
301 Interactive mode off.
|
|
|
302
|
|
|
303 Retrieve just the Hyperbole archive and any diff-based patches (there may not
|
|
|
304 be any patches):
|
|
|
305
|
|
|
306 ftp> mget hyperbole*
|
|
|
307
|
|
|
308 Close the ftp connection:
|
|
|
309
|
|
|
310 ftp> quit
|
|
|
311 221 Goodbye.
|
|
|
312
|
|
|
313 Unpack the tar archive using the GNU version of the 'zcat' program:
|
|
|
314
|
|
|
315 zcat h*tar.gz | tar xvf -
|
|
|
316 or
|
|
|
317 gunzip h*tar.gz; tar xvf h*tar
|
|
|
318
|
|
|
319 Apply any patches you retrieved, also:
|
|
|
320
|
|
|
321 cd hyperbole; patch < <patch-file>
|
|
|
322
|
|
|
323
|
|
|
324 ===========================================================================
|
|
|
325 * Installation / Configuration
|
|
|
326 ===========================================================================
|
|
|
327
|
|
|
328 The following explains how to Use the Hyperbole "Makefile" to compile any
|
|
|
329 needed code, to generate the "hsite.el" file used for site-specific Hyperbole
|
|
|
330 customization, and to produce printable documentation.
|
|
|
331
|
|
|
332 Edit the line near the top of "Makefile" that represents the emacs version
|
|
|
333 that you use, so that it corresponds to the emacs executable name used on
|
|
|
334 your system. Then immediatly below there, set the EMACS variable to the
|
|
|
335 variable name for the emacs that you will use to compile the Hyperbole Lisp
|
|
|
336 files.
|
|
|
337
|
|
|
338 You may also have to set the SITE-PRELOADS variable defined further down
|
|
|
339 in the file; follow the instructions that precede the `SITE-PRELOADS ='
|
|
|
340 line. Make these changes now and save the Makefile.
|
|
|
341
|
|
|
342 To install Hyperbole for use with InfoDock, XEmacs, GNU Emacs or Epoch, from
|
|
|
343 a shell:
|
|
|
344
|
|
|
345 cd <HYPERBOLE-DIR>; make
|
|
|
346
|
|
|
347 All of the .elc compiled Lisp files are already built for XEmacs and V19, so
|
|
|
348 this build will finish very quickly. If you really want to rebuild all of
|
|
|
349 the .elc files, use:
|
|
|
350
|
|
|
351 cd <HYPERBOLE-DIR>; make all-elc
|
|
|
352
|
|
|
353 To produce the Postscript version of the Hyperbole manual:
|
|
|
354
|
|
|
355 cd <HYPERBOLE-DIR>; make ps
|
|
|
356
|
|
|
357 To install Hyperbole for use with GNU Emacs V18 or Epoch:
|
|
|
358
|
|
|
359 cd <HYPERBOLE-DIR>; make all-elc-v18
|
|
|
360
|
|
|
361 This will produce a complete set of Emacs V18 .elc files.
|
|
|
362
|
|
|
363 ----
|
|
|
364
|
|
|
365 The Hyperbole Manual is included in two forms:
|
|
|
366
|
|
|
367 "man/hyperbole.info" - online version
|
|
|
368 "man/hyperbole.texi" - source form
|
|
|
369
|
|
|
370 To add pointers to the Info version of the Hyperbole manual within your Info
|
|
|
371 directory, follow these instructions. If `Info-directory-list' is bound as a
|
|
|
372 variable within your Emacs, you can simply set it so that <HYPERBOLE-DIR> is
|
|
|
373 an element in the list. Otherwise, from a shell, cd to the directory given
|
|
|
374 by your 'Info-directory' variable and execute the following command:
|
|
|
375
|
|
|
376 (rm hyperbole.info*; cp <HYPERBOLE-DIR>/man/hyperbole.info* .)
|
|
|
377
|
|
|
378 Then add an Info menu entry for the Hyperbole manual in your Info "dir" file:
|
|
|
379 (the `*' should be placed in the first column of the file):
|
|
|
380
|
|
|
381 * Hyperbole:: GNU Emacs-based everyday information management system.
|
|
|
382 Use {C-h h d d} for a demonstration. Includes context-sensitive
|
|
|
383 mouse and keyboard support, a powerful rolodex, an autonumbered
|
|
|
384 outliner with hyperlink anchors for each outline cell, and extensible
|
|
|
385 hypertext facilities including hyper-links in mail and news messages.
|
|
|
386
|
|
|
387 ----
|
|
|
388
|
|
|
389 To set up so that all Emacs users have Hyperbole loaded for them, add the
|
|
|
390 following lines to a site initialization file such as "site-start.el".
|
|
|
391 Otherwise, each user will have to add these lines to his own "~/.emacs"
|
|
|
392 initialization file. The following instructions use the term
|
|
|
393 <HYPERBOLE-DIR>/ to refer to your hyperbole/ directory, so substitute your
|
|
|
394 own value.
|
|
|
395
|
|
|
396 To autoload Hyperbole so that it loads only when needed:
|
|
|
397
|
|
|
398 (defvar hyperb:dir "<HYPERBOLE-DIR>/")
|
|
|
399 "Directory where the Hyperbole executable code is kept.
|
|
|
400 It must end with a directory separator character.")
|
|
|
401
|
|
|
402 (load (expand-file-name "hversion" hyperb:dir))
|
|
|
403 (load (expand-file-name "hyperbole" hyperb:dir))
|
|
|
404
|
|
|
405 To fully load Hyperbole upon startup, add the additional line:
|
|
|
406
|
|
|
407 (require 'hsite)
|
|
|
408
|
|
|
409 That's all there is to the installation.
|
|
|
410
|
|
|
411 ----
|
|
|
412
|
|
|
413 Once Hyperbole has been installed for use at your site, you can invoke it
|
|
|
414 with {C-h h} or {M-x hyperbole RET} to bring up the Hyperbole main menu in
|
|
|
415 the minibuffer window.
|
|
|
416
|
|
|
417
|
|
|
418 ===========================================================================
|
|
|
419 * Quick Reference
|
|
|
420 ===========================================================================
|
|
|
421
|
|
|
422 "MANIFEST" summarizes most of the files in the distribution.
|
|
|
423
|
|
|
424 See "DEMO" for a demonstration of standard Hyperbole button
|
|
|
425 capabilities.
|
|
|
426
|
|
|
427 Naming conventions:
|
|
|
428
|
|
|
429 - All Hyperbole-specific code files begin with an 'h', aside from the
|
|
|
430 Koutliner files which are in the kotl/ subdirectory and begin with a 'k'.
|
|
|
431
|
|
|
432 - Hyperbole user-interface files begin with 'hui-' or 'hmous'.
|
|
|
433
|
|
|
434 - Files that define implicit button types begin with 'hib'.
|
|
|
435
|
|
|
436 - Encapsulations of foreign systems begin with 'hsys-'.
|
|
|
437
|
|
|
438 Most of the standard Emacs user interface for Hyperbole is located in
|
|
|
439 "hui.el". Most of the Hyperbole application programming interface can be
|
|
|
440 found in "hbut.el". "hbdata.el" encapsulates the button attribute storage
|
|
|
441 handling presently implemented by Hyperbole. "hmail.el" provides a basic
|
|
|
442 abstract interface for folding mail readers other than Rmail into Hyperbole.
|
|
|
443
|
|
|
444 See the "(hyperbole.info)Questions and Answers" appendix in the
|
|
|
445 Hyperbole manual for information on how to alter the default
|
|
|
446 context-sensitive Hyperbole key bindings.
|
|
|
447
|
|
|
448
|
|
|
449 ===========================================================================
|
|
|
450 * Mail Lists
|
|
|
451 ===========================================================================
|
|
|
452
|
|
|
453 There are several Hyperbole-related mail addresses. Learn what each is
|
|
|
454 for before you mail to any of them.
|
|
|
455
|
|
100
|
456 <hyperbole-request@infodock.com>
|
|
|
457 <hyperbole-announce-request@infodock.com>
|
|
0
|
458
|
|
|
459 ALL mail concerning administration of the Hyperbole mailing lists should
|
|
|
460 be sent to the appropriate one of these addresses. That includes
|
|
|
461 addition, change, or deletion requests. Don't consider sending such a
|
|
|
462 request to a Hyperbole mail list or people will wonder why you don't know
|
|
|
463 that all Internet mail lists have a -request address for administrative
|
|
|
464 requests.
|
|
|
465
|
|
100
|
466 Use the following formats in the *body* of your message to execute requests,
|
|
|
467 where you substitute your own values for the <> delimited items and items
|
|
|
468 enclosed in [] are optional.
|
|
0
|
469
|
|
100
|
470 subscribe <mail-list-name> [<your-email-address>]
|
|
|
471 or
|
|
|
472 unsubscribe <mail-list-name> [<your-email-address>]
|
|
0
|
473
|
|
|
474 For example:
|
|
|
475
|
|
100
|
476 To: hyperbole-request@infodock.com
|
|
|
477 Subject: Used if a human happens to read your mail.
|
|
|
478
|
|
|
479 subscribe hyperbole joe@nowhere.gov
|
|
0
|
480
|
|
100
|
481 To change your address, you must unsubscribe your old address with
|
|
|
482 once command and subscribe your new address with another command, though
|
|
|
483 you can embed multiple commands on separate lines within a single message.
|
|
|
484
|
|
0
|
485
|
|
|
486 There are two Hyperbole-related mail lists. Subscribe to one or the other,
|
|
|
487 not to both.
|
|
|
488
|
|
100
|
489 <hyperbole@infodock.com>
|
|
0
|
490
|
|
|
491 Mail list for discussion of all Hyperbole issues. Bug reports and
|
|
|
492 suggestions may also be sent here.
|
|
|
493
|
|
|
494 Always use your Subject and/or Summary: lines to state the position
|
|
|
495 that your message takes on the topic that it addresses, e.g. send
|
|
|
496 "Subject: Basic bug in top-level minibuffer menu." rather than
|
|
|
497 "Subject: Hyperbole bug". Statements end with periods, questions
|
|
|
498 with question marks (typically), and high energy, high impact
|
|
|
499 declarations with exclamation points. This simple rule makes all
|
|
|
500 e-mail communication much easier for recipients to handle
|
|
|
501 appropriately.
|
|
|
502
|
|
|
503 If you ask a question, your subject line should end with a '?',
|
|
|
504 e.g. "Subject: How can man page SEE ALSOs be made implicit buttons?" A
|
|
|
505 "Subject: Re: How can ..." then indicates an answer to the question.
|
|
|
506 Question messages should normally include your Hyperbole and Emacs version
|
|
|
507 numbers and clearly explain your problem and surrounding issues.
|
|
|
508 Otherwise, you will simply waste the time of those who may want to help
|
|
|
509 you. (Your top-level Hyperbole menu shows its version number and {M-x
|
|
|
510 emacs-version RET} gives the other.)
|
|
|
511
|
|
|
512 If you ask questions, you should consider adding to the discussion by
|
|
|
513 telling people the kinds of work you are doing or contemplating doing
|
|
|
514 with Hyperbole. In this way, the list will not be overwhelmed by
|
|
|
515 messages that ask for, but provide no information.
|
|
|
516
|
|
100
|
517 <hyperbole-announce@infodock.com>
|
|
0
|
518
|
|
|
519 Those who don't want to participate in the discussion but want to
|
|
|
520 hear about bug fixes and new releases of Hyperbole should subscribe
|
|
|
521 to this list. Anyone on the `hyperbole' list is automatically on
|
|
|
522 this one too, so there is no need to subscribe to this one in that
|
|
|
523 case. This list is for official fixes and announcements so don't send
|
|
|
524 your own fixes here. Send them to `hyperbole' instead.
|
|
|
525
|
|
|
526
|
|
|
527 ===========================================================================
|
|
|
528 * User Quotes
|
|
|
529 ===========================================================================
|
|
|
530
|
|
|
531
|
|
|
532 *** MAN I love Hyperbole!!! Wow! ***
|
|
|
533
|
|
|
534 -- Ken Olstad
|
|
|
535 Cheyenne Software, Inc.
|
|
|
536
|
|
|
537 -------
|
|
|
538
|
|
|
539 I *love* koutlines.
|
|
|
540
|
|
|
541 -- Bob Glickstein
|
|
|
542 Z-Code Software Corporation
|
|
|
543 -------
|
|
|
544
|
|
100
|
545 I've found Hyperbole (in conjunction with XEmacs) to be very useful
|
|
|
546 for signal processing algorithm development.
|
|
|
547
|
|
|
548 For me, it has almost completely obsoleted the engineering notebook:
|
|
|
549 I keep a set of files with ideas, algorithms, and results, linked
|
|
|
550 together and to the implementation in C++ files. Using XEmacs'
|
|
|
551 support for embedding graphics, I've written a mode that accepts
|
|
|
552 image tags (formatted like HTML), and reads in GIF files to display
|
|
|
553 plots. I have another program that converts the file to HTML (not
|
|
|
554 perfect, but adequate), so I can put any aspect of development on
|
|
|
555 our internal web for others to see.
|
|
|
556
|
|
|
557 -- Farzin Guilak
|
|
|
558 Protocol Systems, Inc., Engineer
|
|
|
559
|
|
|
560 -------
|
|
|
561
|
|
0
|
562 I am blind and have been using Hyperbole since 1992. I used to use a PC as
|
|
|
563 a talking terminal attached to a UNIX system, but then I developed
|
|
|
564 Emacspeak which lets me use Emacs and Hyperbole from standard UNIX
|
|
|
565 workstations with an attached voice synthesizer.
|
|
|
566
|
|
|
567 My main uses are:
|
|
|
568 1) Global and implicit buttons for jumping to ftp sites.
|
|
|
569 2) The rolodex with Emacspeak support.
|
|
|
570 3) Explicit buttons as part of comments made about a structured document.
|
|
|
571 Each button jumps to the document section referred to by the comment.
|
|
|
572 This is very, very useful.
|
|
|
573 4) The Hyperbole outliner, which I find a very useful tool. I've
|
|
|
574 implemented Emacspeak extensions to support it.
|
|
|
575
|
|
|
576 -- TV Raman
|
|
|
577 Digital Cambridge Research Lab
|
|
|
578
|
|
|
579 -------
|
|
|
580
|
|
|
581 I've been a grateful Hyperbole user for a few years now. Hyperbole's
|
|
|
582 flexibility and ease of use is a marvel.
|
|
|
583
|
|
|
584 Mainly, I write easy little implicit button types (and corresponding action
|
|
|
585 types) to make my life easier. For example, I have an implicit button type
|
|
|
586 to bury certain buffers when I click at their bottoms, one that recognizes
|
|
|
587 a bug report record in various contexts and edits it, one that links pieces
|
|
|
588 of test output in a log file to the corresponding test case source code
|
|
|
589 (EXTREMELY helpful in interpreting test output), others that support our
|
|
|
590 homegrown test framework, one that handles tree dired mode the way I'd
|
|
|
591 like, one that completely handles wico menus (I've also overloaded the
|
|
|
592 wconfig actions triggered by diagonal mouse drags with wicos actions), and
|
|
|
593 a couple that support interaction with BBDB.
|
|
|
594
|
|
|
595 Other than that, I keep a global button file with 30 or so explicit buttons
|
|
|
596 that do various little things, and I index saved mail messages by putting
|
|
|
597 explicit link-to-mail buttons in an outline file.
|
|
|
598
|
|
|
599 -- Ken Olstad
|
|
|
600 Cheyenne Software, Inc.
|
|
|
601
|
|
|
602 -------
|
|
|
603
|
|
|
604 In general, Hyperbole is an embeddable, highly extensible hypertext
|
|
|
605 tool. As such, I find it very useful. As it stands now, Hyperbole is
|
|
|
606 particularly helpful for organizing ill-structured or loosely coupled
|
|
|
607 information, in part because there are few tools geared for this purpose.
|
|
|
608 Hyperbole also possesses a lot of potentials in supporting a wider
|
|
|
609 spectrum of structuredness, ranging from unstructured to highly
|
|
|
610 structured environments, as well as structural changes over time.
|
|
|
611
|
|
|
612 Major Uses:
|
|
|
613
|
|
|
614 * Menu interface to our own Epoch-based collaborative support environment
|
|
|
615 called CoReView: This interface brings together all top-level user
|
|
|
616 commands into a single partitioned screen, and allows the end user to
|
|
|
617 interact with the system using simple mouse-clicking instead of the
|
|
|
618 meta-x key.
|
|
|
619
|
|
|
620 * Gateway to internet resources: this includes links to major Internet
|
|
|
621 archive sites of various types of information. Links are made at both
|
|
|
622 directory and file levels.
|
|
|
623
|
|
|
624 * Alternative directory organizer: The hierarchical nature of the Unix
|
|
|
625 file system sometimes makes it difficult to find things quickly and
|
|
|
626 easily using directory navigational tools such as dired. Hyperbole
|
|
|
627 enables me to create various "profile" views of my directory tree, with
|
|
|
628 entries in these views referring to files anywhere in the hierarchy.
|
|
|
629
|
|
|
630 * Organizing and viewing online documentation: using Hyperbole along with
|
|
|
631 Hyper-man and Info makes it truly easy to look up online documentation.
|
|
|
632
|
|
|
633 * Other desktop organization tasks: including links to various mail
|
|
|
634 folders, saved newsgroup conversation threads, online note-taker,
|
|
|
635 emacs-command invocations, etc.
|
|
|
636
|
|
|
637 -- Dadong Wan
|
|
|
638
|
|
|
639 -------
|
|
|
640
|
|
|
641 Hyperbole is the first hyper-link system I've run across that is
|
|
|
642 actually part of the environment I use regularly, namely Emacs. The
|
|
|
643 complete flexibility of the links is both impressive and expected -- the
|
|
|
644 idea of making the link itself programmable is clever, and given that one
|
|
|
645 assumes the full power of Emacs. Being able to send email with buttons
|
|
|
646 in it is a very powerful capability. Using ange-ftp mode, one can make
|
|
|
647 file references "across the world" as easily as normal file references.
|
|
|
648
|
|
|
649 -- Mark Eichin
|
|
|
650 Cygnus Support
|
|
|
651 -------
|
|
|
652
|
|
|
653 I just wanted to say how much I enjoy using the Hyperbole outliner.
|
|
|
654 It is a great way to quickly construct very readable technical documents
|
|
|
655 that I can pass around to others. Thanks for the great work.
|
|
|
656
|
|
|
657 -- Jeff Fried
|
|
|
658 Informix
|
|
|
659
|
|
|
660 -------
|
|
|
661
|
|
|
662 The Hyperbole system provides a nice interface to exploring corners of
|
|
|
663 Unix that I didn't know existed before.
|
|
|
664
|
|
|
665 -- Craig Smith
|
|
|
666
|
|
|
667 -------
|
|
|
668
|
|
|
669
|
|
|
670 ===========================================================================
|
|
|
671 * Why was Hyperbole developed?
|
|
|
672 ===========================================================================
|
|
|
673
|
|
|
674 Hyperbole has been designed to aid in research aimed at Personalized
|
|
|
675 Information production/retrieval Environments (PIEs). Hyperbole is a
|
|
|
676 PIE Manager that provides services to PIE Tools. PIEmail, a mail reader is
|
|
|
677 the only PIE Tool developed to date.
|
|
|
678
|
|
|
679 An examination of many hypertext environments as background research did
|
|
|
680 not turn up any that seemed suitable for the research envisioned, mainly
|
|
|
681 due to the lack of rich, portable programmer and user environments. We also
|
|
|
682 tired of trying to manage our own distributed information pools with standard
|
|
|
683 UNIX tools. And so Hyperbole was conceived and raved about until it
|
|
|
684 got its name.
|
|
|
685
|
|
|
686
|
|
|
687 ===========================================================================
|
|
|
688 * Copyright
|
|
|
689 ===========================================================================
|
|
|
690
|
|
|
691 The following copyright applies to the Hyperbole system as a whole.
|
|
|
692
|
|
100
|
693 Copyright (C) 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996 Free Software Foundation, Inc.
|
|
0
|
694
|
|
|
695 Available for use and distribution under the terms of the GNU Public License,
|
|
|
696 version 2 or higher.
|
|
|
697
|
|
|
698 Hyperbole is free software; you can use it, redistribute it and/or modify it
|
|
|
699 without fee under the terms of the GNU General Public License as published by
|
|
|
700 the Free Software Foundation; either version 2, or (at your option) any later
|
|
|
701 version.
|
|
|
702
|
|
|
703 Hyperbole is distributed in the hope that it will be useful, but WITHOUT ANY
|
|
|
704 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
|
|
|
705 A PARTICULAR PURPOSE. See the GNU General Public License for more details.
|
|
|
706
|
|
100
|
707 InfoDock Associates sells support and development services for this package
|
|
|
708 and most other aspects of Emacs or InfoDock. Contact information is at the
|
|
|
709 top of this file.
|
|
|
710
|
|
70
|
711 You should have received a copy of the GNU General Public License
|
|
100
|
712 along with GNU Emacs, XEmacs or InfoDock; see the file COPYING. If
|
|
|
713 not, write to the Free Software Foundation, 675 Mass Ave, Cambridge,
|
|
|
714 MA 02139, USA.
|
