comparison man/hyperbole.texi @ 114:8619ce7e4c50 r20-1b9

Import from CVS: tag r20-1b9
author cvs
date Mon, 13 Aug 2007 09:21:54 +0200
parents 4be1180a9e89
children
comparison
equal deleted inserted replaced
113:2ec2fe4a4c89 114:8619ce7e4c50
10 @c development contracts for InfoDock, Emacs and XEmacs. 10 @c development contracts for InfoDock, Emacs and XEmacs.
11 @c E-mail: <info@infodock.com> Web: http://www.infodock.com 11 @c E-mail: <info@infodock.com> Web: http://www.infodock.com
12 @c Tel: +1 408-243-3300 12 @c Tel: +1 408-243-3300
13 @c 13 @c
14 @c ORIG-DATE: 6-Nov-91 at 11:18:03 14 @c ORIG-DATE: 6-Nov-91 at 11:18:03
15 @c LAST-MOD: 20-Feb-97 at 12:36:16 by Bob Weiner 15 @c LAST-MOD: 17-Mar-97 at 21:36:15 by Bob Weiner
16 16
17 @c %**start of header (This is for running Texinfo on a region.) 17 @c %**start of header (This is for running Texinfo on a region.)
18 @setfilename ../info/hyperbole.info 18 @setfilename ../info/hyperbole.info
19 @settitle Hyperbole User Manual 19 @settitle Hyperbole User Manual
20 @c %**end of header (This is for running Texinfo on a region.) 20 @c %**end of header (This is for running Texinfo on a region.)
33 @center Bob Weiner 33 @center Bob Weiner
34 @center InfoDock Associates 34 @center InfoDock Associates
35 @sp 1 35 @sp 1
36 @center E-mail: <hyperbole@@infodock.com> (This is a mailing list.) 36 @center E-mail: <hyperbole@@infodock.com> (This is a mailing list.)
37 @sp 2 37 @sp 2
38 @center Edition 4.02 38 @center Edition 4.023
39 @sp 2 39 @sp 2
40 @center February 19, 1997 40 @center March 17, 1997
41 41
42 @page 42 @page
43 @vskip 0pt plus 1filll 43 @vskip 0pt plus 1filll
44 Copyright @copyright{} 1991, 1992, 1993, 1994, 1995, 1996, 1997 Free Software Foundation, Inc. 44 Copyright @copyright{} 1991, 1992, 1993, 1994, 1995, 1996, 1997 Free Software Foundation, Inc.
45 45
2220 @cindex customization 2220 @cindex customization
2221 @cindex option settings 2221 @cindex option settings
2222 @item Cust/ 2222 @item Cust/
2223 Customizes Hyperbole by setting major options. 2223 Customizes Hyperbole by setting major options.
2224 This includes where Hyperbole link referents are displayed, where URLs 2224 This includes where Hyperbole link referents are displayed, where URLs
2225 are displayed and whether to use proportional or windowful scrolling 2225 are displayed, whether the date stamps are added to rolodex entries, and
2226 when a Smart Key is pressed at the end of a line. @xref{Configuring}. 2226 whether to use proportional or windowful scrolling when a Smart Key is
2227 pressed at the end of a line. @xref{Configuring}.
2227 2228
2228 @cindex menu, EBut 2229 @cindex menu, EBut
2229 @item Ebut/ 2230 @item Ebut/
2230 All explicit button commands. The window-system-based Hyperbole 2231 All explicit button commands. The window-system-based Hyperbole
2231 menu includes a menu item that activates each explicit button found 2232 menu includes a menu item that activates each explicit button found
3376 Chief Ether Maintainer, HiHo Industries 3377 Chief Ether Maintainer, HiHo Industries
3377 10/24/95 3378 10/24/95
3378 @end group 3379 @end group
3379 @end example 3380 @end example
3380 3381
3381 We call rolodex records, @dfn{entries}. Entries begin with a delimiter, 3382 We call rolodex records, @dfn{entries}. Entries begin with a delimiter
3382 some number of `*' characters at the beginning of a line. Entries may 3383 of one or more `*' characters at the beginning of a line. Entries may
3383 be arranged in a hierarchy, where child entries begin with one more `*' 3384 be arranged in a hierarchy, where child entries begin with one more `*'
3384 characters than do their parents. Top level entries begin with a single 3385 character than do their parents. Top level entries begin with a single
3385 `*'. 3386 `*'.
3386 3387
3387 Beyond this initial delimiter, entries are completely free-form text. 3388 Beyond this initial delimiter, entries are completely free-form text.
3388 It is best to use a "lastname, firstname" format, however, when adding 3389 It is best to use a "lastname, firstname" format, however, when adding
3389 contact entries into a rolodex. Then the rolodex system will 3390 contact entries into a rolodex. Then the rolodex system will
3390 automatically keep your entries alphabetized as you enter them. You'll 3391 automatically keep your entries alphabetized as you enter them. You'll
3391 also be able to sort them whenever you desire. 3392 also be able to sort them whenever you desire. This is what the
3393 rolodex will use if you accept the default entry that it prompts you
3394 with when adding a new entry.
3392 3395
3393 Any search done on the rolodex scans the full text of each entry. 3396 Any search done on the rolodex scans the full text of each entry.
3394 During a search, the rolodex file header separator lines and anything in 3397 During a search, the rolodex file header separator lines and anything in
3395 between are appended to the buffer of matched entries before any entries 3398 between are appended to the buffer of matched entries before any entries
3396 are retrieved from the file. Whenever an entry is matched, it and all 3399 are retrieved from the file. Whenever an entry is matched, it and all
3489 3492
3490 @node Rolo Keys, Rolo Settings, Rolo Menu, Rolodex 3493 @node Rolo Keys, Rolo Settings, Rolo Menu, Rolodex
3491 @section Rolo Keys 3494 @section Rolo Keys
3492 3495
3493 @kindex e 3496 @kindex e
3494 @cindex rolodex, editing an entry 3497 @cindex rolodex, editing
3498 @cindex datestamps
3499 @cindex rolodex, datestamps
3500 @cindex customization, rolodex datestamps
3501 @cindex menu, Toggle-Rolo-Dates
3502 @cindex customization, rolodex edits
3503 @cindex customization, rolodex additions
3504 @vindex wrolo-edit-hook
3505 @vindex wrolo-add-hook
3495 Use the @{@kbd{e}@} key to edit the entry at point within the rolodex 3506 Use the @{@kbd{e}@} key to edit the entry at point within the rolodex
3496 source file. 3507 source file. A datestamp will be automatically added or updated at the
3508 end of the entry, unless this feature has been turned off via the
3509 Cust/Toggle-Rolo-Dates menu item. The variable, @var{wrolo-edit-hook},
3510 is evaluated after the update of the entry datestamp. This allows
3511 programmed modification of the way rolodex edits work. The variable,
3512 @var{wrolo-add-hook}, works the same way but is evaluated when a new
3513 entry is first added.
3497 3514
3498 @cindex wrolo menu 3515 @cindex wrolo menu
3499 @cindex rolodex keys 3516 @cindex rolodex keys
3500 After a rolodex search is performed, point is left in the @dfn{rolodex 3517 After a rolodex search is performed, point is left in the @dfn{rolodex
3501 match buffer}, @file{*Rolodex*}, which uses @code{wrolo-mode} to 3518 match buffer}, @file{*Rolodex*}, which uses @code{wrolo-mode} to
3600 After an entry is killed, the modified rolodex file is automatically 3617 After an entry is killed, the modified rolodex file is automatically
3601 saved. If you would rather always save files yourself, use this 3618 saved. If you would rather always save files yourself, use this
3602 setting: @code{(setq rolo-save-buffers-after-use nil)}. 3619 setting: @code{(setq rolo-save-buffers-after-use nil)}.
3603 3620
3604 @vindex rolo-email-format 3621 @vindex rolo-email-format
3605 When adding an entry from within a buffer containing a mail message, the 3622 When adding an entry from within a buffer that contains a mail message,
3606 rolodex add function will extract the sender's name and e-mail address 3623 the rolodex add function will extract the sender's name and e-mail address
3607 and prompt you with the name as a default. If you accept it, it will 3624 and prompt you with the name as a default. If you accept it, it will
3608 enter the name and the email address using the format given by the 3625 enter the name and the email address using the format given by the
3609 @var{rolo-email-format} variable. See its documentation if you want to 3626 @var{rolo-email-format} variable. See its documentation if you want to
3610 change its value. 3627 change its value.
3611 3628