xemacs-beta: lisp/hyperbole/README comparison

comparison lisp/hyperbole/README @ 24:4103f0995bd7 r19-15b95

Import from CVS: tag r19-15b95

author	cvs
date	Mon, 13 Aug 2007 08:51:03 +0200
parents	ac2d302a0011
children	441bb1e64a06

comparison

equal deleted inserted replaced

-:0edd3412f124
+:4103f0995bd7
+# See "hversion.el" for the Hyperbole lisp code directory entry.
 #
 # FILE:		README
-# SUMMARY:      Intro information on Hyperbole.
+# SUMMARY:	Information Hyperbole users and maintainers should read.
 #
 # AUTHOR:       Bob Weiner
 #
+# ORG:          InfoDock Associates.  We sell corporate support and development
+#               contracts for InfoDock, Emacs and XEmacs.
+#               E-mail: <info@infodock.com>  Web: http://www.infodock.com
+#               Tel: +1 408-243-3300
+#
 # ORIG-DATE:    19-Oct-91 at 03:27:47
-# LAST-MOD:      3-Nov-95 at 23:20:31 by Bob Weiner
+# LAST-MOD:     21-Feb-97 at 18:04:41 by Bob Weiner
+#
-The author's work on this project has been sponsored by Motorola Inc.
+# See the Copyright section below for license information.
-We hope you enjoy using and developing with Hyperbole.  Suggestions and bug
+We thank Motorola Inc. for sponsoring our initial development work on
-reports are welcome, as described later in this document.  Feel free to
+Hyperbole.
-mail or post news containing this file wherever it may be of use.
+We hope you enjoy using and developing with Hyperbole.  Suggestions
+and bug reports are welcome, as described later in this document.
+Feel free to mail or post news containing this file wherever it may be
+of use.
 ===========================================================================
 *			Table of Contents
 ===========================================================================
 ===========================================================================
 Hyperbole is an open, efficient, programmable information management and
 hypertext system.  It is intended for everyday work on any UNIX platform
 supported by GNU Emacs.  It works well with the versions of Emacs that
-support multiple X or NEXTSTEP windows: GNU Emacs V19, XEmacs (formerly
+support MS-Windows, X or NEXTSTEP windows: XEmacs and GNU Emacs.
-called Lucid Emacs) and Epoch.  Hyperbole allows hypertext buttons to be
-embedded within unstructured and structured files, mail messages and
+Hyperbole allows hypertext buttons to be embedded within unstructured and
-news articles.  It offers intuitive mouse-based control of information
+structured files, mail messages and news articles.  It offers intuitive
-display within multiple windows.  It also provides point-and-click
+mouse-based control of information display within multiple windows.  It also
-access to Info manuals, ftp archives, Wide-Area Information Servers
+provides point-and-click access to Info manuals, ftp archives, Wide-Area
-(WAIS), and the World-Wide Web (WWW) hypertext system through
+Information Servers (WAIS), and the World-Wide Web (WWW) hypertext system
-encapsulations of software that support these protocols.
+through encapsulations of software that support these protocols.
 Hyperbole consists of four parts:
 1.  Info Management: an interactive information management interface,
 including a powerful rolodex, which anyone can use.  It is easy
 link to the archive holdings.  Users can then search and create
 their own links to archive entries.
 ===========================================================================
-*		       What's New in V4.00 and V4.01?
+*		       What's New in V4.02 and V4.021
 ===========================================================================
 (See "ChangeLog" for more complete details of changes.)
 ACTION AND ASSIST KEYS
-- New variable, action-key-url-function, sets the function used to
+- Support for new ID-edit mode (a part of InfoDock) that allows rapid,
-display URLs which are activated as implicit buttons with the Action
+cutting, copying and yanking of regions plus fast display management.
-Key.
+In this mode, the Action and Assist keys yank the previously selected
+region at point.
-- Action or Assist Key presses at the end of a line now scroll
-proportionally, by default.  See the documentation for the variable,
+- An Action Key press on a Java identifier jumps to its definition
-smart-scroll-proportional, and the Smart Scrolling section of the
+(if an associated TAGS file or OO-Browser environment exists).  The
-Hyperbole DEMO file, for more information.
+same is true for an `@see' cross-reference within a Java comment.  The
+variable, `smart-java-package-dirs,' determines where Java package
-- Fixed bug that prevented browsing Info files in dired with the Action
+source can be found when the OO-Browser is not in use.
-Key.
+- An Action Key press on a double or single quoted Emacs Lisp filename
-BUTTON TYPES
+(without any path) displays the file by looking for it among the
+directories in the variable, `load-path'.
-- "hsys-w3.el" is now automatically loaded so that the Action Key can
-follow URLs by default.  It defines the implicit button type, www-url.
+- If the Action Key is pressed on a function identifier that is defined
+in the same buffer as the reference clicked upon, it will now be
-- New implicit button type, text-toc, makes table of contents entries in
+displayed faster, since the func-menu package will be used.  The
-README files jump to the associated section of the file.  Try it with
+reference identifier will also flash when pressed, if the display
-this file once you have loaded the current version of Hyperbole.
+device supports this.
-DOCUMENTATION
-- A lot of work has gone into reorganizing and rewriting the Hyperbole
-manual to improve its readability and completeness.  A full chapter on
-the Koutliner has been added.  Please take some time to read the parts
-of interest to you and send your feedback on what is good and what is
-not to the mail list, <hyperbole@hub.ucsb.edu>.
 EMACS VERSIONS
-- MS-DOS and Windows NT Emacs 19 or Win-Emacs: Made Hyperbole work under
+- Further support for MS-DOS, Windows NT Emacs 19, and Win-Emacs.
-all of these PC Emacs versions.
+- Fixed configuration setup problem when running Emacs 19 on a dumb
-- Emacs 19: Fixed bug that prevented Action Key selection of minibuffer
+terminal.
-menu items.
-- Emacs 19: Hyperbole menubar menus are now properly displayed.
-- Emacs 19: Action Key press on a filename that has a .info suffix
-displays the Top node for that info file in the Info browser.
 KOUTLINER
-- You can now view and edit koutlines with blank lines between cells
+- XEmacs 19.14 and above: Fixed display of current viewspec in the
-turned off.  {C-c b} now toggles between showing or hiding blank lines.
+modeline to accomodate modeline extents (specialized modeline regions).
+This eliminated an error that occurred when reading in an Koutline file.
-- Minibuffer menu item Otl/Below renamed to Otl/Downto so could add
-Otl/Blanks which toggles blank lines on and off.
+- Fixed bug that prevented installation of Koutliner mode-specific
+menubar when running InfoDock.
-- {C-c C-o} which displays one line per cell, for an overview, now also
-turns off blank lines.
+MENUS
-- {C-c C-i} adds an attribute to the current cell.  It changes the
+- New Hyperbole/About menu item added.  In minibuffer menus, this item is
-attribute's value if it already exists.  Completion on existing
+found under the Doc/ menu.
-attribute names from the cell is provided.
+- New window system menu, Hyperbole/Customization (and minibuffer menu,
-- {C-c h}, which displays cell attributes, when given "0" as the cell id
+Cust/) added to set Hyperbole options, including where Hyperbole link
-now displays the zero cell's attributes in addition to any other
+referents are displayed, where URLs are displayed and whether to use
-attributes shown.
+proportional or windowful scrolling when a Smart Key is pressed at the
+end of a line.
-- By default, the outliner separates labels from cell contents by two
-spaces.  If you want to change the separator for the current outline,
+- The default setting of where Hyperbole link references are displayed
-use {C-c M-l}.  {C-u C-c M-l} will additionally change the default
+may be set in "hsite.el" via the variable, `hpath:display-where'
-separator value used when new outlines are created.
+(after Hyperbole has been installed using `make install').
+See its documentation for detail.
-- If you invoke {M-x kotl-mode RET} on a non-read-only, non-koutline
-buffer, it converts each paragraph in the buffer into a level 1 cell,
+- The Hyperbole/Global-Button menu now includes a menu item that will
-and thereby creates a koutline buffer.  The conversion uses the
+activate each existing global button.  The Hyperbole/Explicit-Button
-buffer-specific variable, `paragraph-start' to determine the paragraphs
+menu does the same thing for explicit buttons in the current buffer.
-in the buffer.
-- If you save a koutline to a file whose name does not end in .kotl,
-e.g. with {C-x C-w} (kfile:write), it will still be treated as a valid
-koutline when you read it in again.  You can create a koutline file
-without the standard suffix via {M-x kfile:find RET} or by converting a
-buffer to a koutline via {M-x kotl-mode RET}.
-- Each koutline now maintains a current view setting that is saved with
-the outline and restored when it is first displayed.  View settings
-include:  show/hide blank lines, show a fixed number of lines per cell,
-show a fixed number of levels in the outline, show all lines and cells,
-show/hide ellipses after truncated outline entries, set cell numbering
-(label) types.
-- View settings are controlled by single character codes called view
-specs.  The current view spec setting for a koutline appears in the
-modeline following the name of the outline.  The current view spec
-setting may be changed interactively with {C-c C-v}.
-See <${hyperb:dir}/kotl/EXAMPLE.kotl, 2b16=048> for details on valid
-view specs.
-- Minibuffer menu item Otl/View changed to Otl/Vspec to set a view
-specification.  Use {C-x C-r} to view a Koutline in read-only mode.
-- Added View menu to Koutliner popup and pulldown menus.  Moved
-view-related tree operations from Tree menu to View menu.
-- Fixed importation of star outline and Augment-style files.
-- The elements of a another buffer or file may be inserted into a
-koutline as a set of cells by using the {C-x i} command. When prompted,
-you may use a buffer name or file name from which to insert.
-The cells will be inserted as the successors of the current cell unless
-{C-u C-x i} is used and then they are inserted as the initial children
-of the current cell.
-See the documentation for the variables, kimport:mode-alist and
-kimport:suffix-alist, for information on mode and suffix-specific
-conversions performed on files before they are inserted.
-Use {M-x kotl-mode:insert-file-contents RET} to insert the entire
-contents of a file into the current cell at the location of point.
-- {M-x kimport:file RET} will prompt for a file and a new koutline file
-to create and will insert the elements of the file in the new outline.
-(You can also use buffer or buffer names as arguments instead of file
-names.)  See the documentation for the variables, kimport:mode-alist
-and kimport:suffix-alist, for information on how the importation type
-is determined.
-- {C-c +} appends the contents of one cell to the end of another.  Added
-this as Append-Cell to popup and pulldown menus.
-- {M-w}, copy-region, now works properly in read-only outlines.
 ROLODEX
-- {e} within a rolodex match buffer edits the associated entry within your
+- Rolo-edit, bound to {e} in the rolodex match buffer, now works properly
-rolodex source file.  Fixed bug that caused {e} to fail when entries
+if the rolodex is loaded before the rest of the Hyperbole system.
-are collapsed within the match buffer.
-- {C-h h r e}, rolo-edit, just displays your personal rolodex file if you
-hit {RET} without specifying an entry name to edit.
-- {m} within a rolodex match buffer composes mail to the e-mail
-address at point or the first address following point.  Also added as
-Rolo/Mail minibuffer menu item and Rolodex/Mail-to-Address for window
-system menus.
-- New variable, wrolo-yank-reformat-function permits reformatting of an
-entry yanked into the current buffer with {C-h h r y}, rolo-yank.
-WINDOW CONFIGURATIONS
-- The minibuffer menu items, Win/PopRing and Win/YankRing now redisplay
-the Win menu after performing their actions.  This allows you to yank
-or pop window configurations repeatedly until you get to the one you
-want.
 ===========================================================================
 *			     How to Obtain
 ===========================================================================
-Hyperbole is actually part of an integrated tool framework that we have
+InfoDock Associates, the developer of Hyperbole and InfoDock (an industrial
-developed called InfoDock.  InfoDock provides a modern user interface on top
+quality turn-key version of XEmacs), is a firm dedicated to radical
-of Emacs, information management, and powerful software development tools,
+productivity improvement in technical environments, whether in software
-all in one package.  Get it via anonymous ftp from host ftp.xemacs.org in
+development or other knowledge intensive disciplines.  Our initial offerings
-the /pub/infodock directory.
+include high quality commercial support, training, books and custom package
+development for InfoDock, XEmacs or GNU Emacs on a variety of platforms.
-Hyperbole is also available as a standalone package via anonymous ftp across
+InfoDock provides a modern user interface on top of Emacs, information
-the Internet.  Do not send requests to have it mailed to you since it won't
+management, and powerful software development tools, all in one package.
-be.  Instead have another party who has Internet access obtain it for the
-both of you.
+Contact us at <info@infodock.com> or visit our web site at
+http://www.infodock.com.
+Hyperbole is available as part of InfoDock or XEmacs and also as a standalone
+package via anonymous ftp across the Internet.  Do not send requests to have
+it mailed to you since it won't be.  Instead have another party who has
+Internet access obtain it for the both of you.
 Here is how to obtain Hyperbole as a standalone package on the Internet:
 Move to a directory below which you want the 'hyperbole' directory to
 be created.  Unpacking the Hyperbole archive will create this
 cd <LOCAL-LISP-DIR>
 Ftp to ftp.xemacs.org  (Internet Host ID = 128.174.252.16):
-prompt> ftp ftp.xemacs.org
+prompt> ftp ftp.xemacs.org  (If this doesn't work, try `ftp xemacs.org'.)
 Login as 'anonymous' with your own <user-id>@<site-name> as a password.
 Name (ftp.xemacs.org): anonymous
 331 Guest login ok, send EMAIL address (e.g. user@host.domain) as password.
 Password:
 230 Guest login ok, access restrictions apply.
 Move to the Hyperbole directory:
-ftp> cd pub/infodock
+ftp> cd /pub/infodock
 Set your transfer mode to binary:
 ftp> bin
 200 Type set to I.
 ===========================================================================
 There are several Hyperbole-related mail addresses.  Learn what each is
 for before you mail to any of them.
-<hyperbole-request@hub.ucsb.edu>
+<hyperbole-request@infodock.com>
-<hyperbole-announce-request@hub.ucsb.edu>
+<hyperbole-announce-request@infodock.com>
 ALL mail concerning administration of the Hyperbole mailing lists should
 be sent to the appropriate one of these addresses.  That includes
 addition, change, or deletion requests.  Don't consider sending such a
 request to a Hyperbole mail list or people will wonder why you don't know
 that all Internet mail lists have a -request address for administrative
 requests.
-Use the following formats on your subject line to execute requests,
+Use the following formats in the *body* of your message to execute requests,
-where you substitute your own values for the <> delimited items.
+where you substitute your own values for the <> delimited items and items
+enclosed in [] are optional.
-Subject: Subscribe '<' <user@domain> '>' (<your name>).
+subscribe <mail-list-name> [<your-email-address>]
-Subject: Unsubscribe '<' <user@domain> '>'.
+or
+unsubscribe <mail-list-name> [<your-email-address>]
-To change your address, you must unsubscribe your old address in one
-message and then subscribe your new address in another message.
 For example:
-To: hyperbole-announce-request@hub.ucsb.edu
+To: hyperbole-request@infodock.com
-Subject: Unsubscribe <joe@any.com>.
+Subject: Used if a human happens to read your mail.
-To: hyperbole-announce-request@hub.ucsb.edu
+subscribe hyperbole joe@nowhere.gov
-Subject: Subscribe <joe@any.com> (Joe Williams).
+To change your address, you must unsubscribe your old address with
+once command and subscribe your new address with another command, though
+you can embed multiple commands on separate lines within a single message.
 There are two Hyperbole-related mail lists.  Subscribe to one or the other,
 not to both.
-<hyperbole@hub.ucsb.edu>
+<hyperbole@infodock.com>
 Mail list for discussion of all Hyperbole issues.  Bug reports and
 suggestions may also be sent here.
 Always use your Subject and/or Summary: lines to state the position
 If you ask questions, you should consider adding to the discussion by
 telling people the kinds of work you are doing or contemplating doing
 with Hyperbole.  In this way, the list will not be overwhelmed by
 messages that ask for, but provide no information.
-<hyperbole-announce@hub.ucsb.edu>
+<hyperbole-announce@infodock.com>
 Those who don't want to participate in the discussion but want to
 hear about bug fixes and new releases of Hyperbole should subscribe
 to this list.  Anyone on the `hyperbole' list is automatically on
 this one too, so there is no need to subscribe to this one in that
 I *love* koutlines.
 	   				-- Bob Glickstein
 					   Z-Code Software Corporation
+-------
+I've found Hyperbole (in conjunction with XEmacs) to be very useful
+for signal processing algorithm development.
+For me, it has almost completely obsoleted the engineering notebook:
+I keep a set of files with ideas, algorithms, and results, linked
+together and to the implementation in C++ files.  Using XEmacs'
+support for embedding graphics, I've written a mode that accepts
+image tags (formatted like HTML), and reads in GIF files to display
+plots.  I have another program that converts the file to HTML (not
+perfect, but adequate), so I can put any aspect of development on
+our internal web for others to see.
+-- Farzin Guilak
+		                           Protocol Systems, Inc., Engineer
 -------
 I am blind and have been using Hyperbole since 1992.  I used to use a PC as
 a talking terminal attached to a UNIX system, but then I developed
 Emacspeak which lets me use Emacs and Hyperbole from standard UNIX
 *			       Copyright
 ===========================================================================
 The following copyright applies to the Hyperbole system as a whole.
-Copyright (C) 1989, 1990, 1991, 1992, 1993, 1994, 1995  Free Software Foundation, Inc.
+Copyright (C) 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996  Free Software Foundation, Inc.
 Available for use and distribution under the terms of the GNU Public License,
 version 2 or higher.
 Hyperbole is free software; you can use it, redistribute it and/or modify it
 Hyperbole is distributed in the hope that it will be useful, but WITHOUT ANY
 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
 A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
+InfoDock Associates sells support and development services for this package
+and most other aspects of Emacs or InfoDock.  Contact information is at the
+top of this file.
 You should have received a copy of the GNU General Public License
-along with GNU Emacs or XEmacs; see the file COPYING.  If not, write to
+along with GNU Emacs, XEmacs or InfoDock; see the file COPYING.  If
-the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
+not, write to the Free Software Foundation, 675 Mass Ave, Cambridge,
+MA 02139, USA.

Mercurial > hg > xemacs-beta

comparison lisp/hyperbole/README @ 24:4103f0995bd7 r19-15b95