home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #18 / NN_1992_18.iso / spool / alt / lucidem / help / 304 < prev    next >
Encoding:
Internet Message Format  |  1992-08-20  |  20.7 KB
  1. Date: Thu, 20 Aug 1992 12:39:19 EDT
  2. From: weiner@pts.mot.com (Bob Weiner)
  3. Message-ID: <9208201639.AA09813@pts5.pts.mot.com>
  4. Subject: Menu and mouse support for News ?
  5. Newsgroups: alt.lucid-emacs.help
  6. Path: sparky!uunet!wendy-fate.uu.net!help-lucid-emacs
  7. Sender: help-lucid-emacs-request@lucid.com
  8. x-gateway: Thu from help-lucid-emacs to alt.lucid-emacs.help; Thu, 20 Aug 1992 12:45:13 EDT
  9. Lines: 540
  10.  
  11.  
  12. Ken Butler wrote:
  13.  
  14. > Paul,
  15. >
  16. > Regarding "Menu and mouse support for News", you write:
  17. >
  18. > Paul>    Has anyone written some lucid emacs specific code for use with gnus. I
  19. > Paul>    like the menu/mouse support someone posted for VM, and am looking for
  20. > Paul>    something similar. Is there an FTP site that has all the lucid
  21. > Paul>    specific code on it ???? or is it a case of just looking thru the
  22. > Paul>    alt.lucid-emacs.help archives ????
  23.  
  24. > Yeah, I did.  Nothing sophisticated, but I guess it was okay since the VM
  25. > postings looked similar to what I had posted previously for RMAIL.
  26.  
  27. > Here's what I have so far for RMAIL and GNUS.  The RMAIL I'm using is not
  28. > the standard RMAIL but the extended function RMAIL posted by Bob Weiner to
  29. > the elisp archive at Ohio State.  It's much better than the old one.
  30.  
  31. If you like that RMAIL stuff of mine, you really should install the current
  32. release of Hyperbole which integrates quite a few facilities in one
  33. easy to install package including direct selection 2-button mouse interfaces
  34. for RMAIL, VM, GNUS, Info, buffer-menu, dired, outline-mode, etc.  It supports
  35. X, Sunview, Apollo DM, and terminals and also Epoch.  I haven't done anything
  36. specific for Lucid Emacs (I probably will within the next month)
  37. but if the mouse key binding syntax differs from that of standard X
  38. bindings for GNU Emacs then you only have to add about 5 lines in one
  39. file, "hmouse-key.el", and everything will work.
  40.  
  41. So go ahead and use it rather than reinventing.
  42.  
  43. Here is the full Hyperbole README which explains how to get it via ftp,
  44. the only way it is available.  I don't mail out copies.
  45.  
  46. Bob
  47. -------
  48.  
  49. #
  50. # FILE:        README
  51. # SUMMARY:      Intro information on Hyperbole.  
  52. #
  53. # AUTHOR:       Bob Weiner
  54. # ORG:          Brown U.
  55. #
  56. # ORIG-DATE:    19-Oct-91 at 03:27:47
  57.  
  58. The author's work on this project has been sponsored by Motorola Inc.
  59. under the Distinguished Student-Employee program.
  60.  
  61. We hope you enjoy using and developing with Hyperbole.  Suggestions and bug
  62. reports are welcome, as described later in this document.  Feel free to
  63. mail or post news containing this file wherever it may be of use.
  64.  
  65.  
  66.            Outline
  67. ================================
  68. * Hyperbole Overview
  69. * What's New?
  70. * How to Obtain
  71. * Installation / Configuration
  72. * Quick Reference
  73. * Mail Lists
  74. * Beta Tester Quotes
  75. * Why was Hyperbole developed?
  76. * Copyright
  77. ================================
  78.  
  79.  
  80. * Hyperbole Overview
  81.  
  82. Hyperbole is an open, efficient information browsing and management
  83. system based around a hypertext model.  It is intended for everyday work
  84. on any UNIX platform supported by GNU Emacs (or Epoch from the
  85. University of Illinois).  Hyperbole allows hypertext buttons to be
  86. embedded within unstructured and structured files, mail messages and
  87. news articles.  It also provides point-and-click access to ftp archives,
  88. Wide-Area Information Servers (WAIS), and the World-Wide Web (WWW)
  89. hypertext system through encapsulations of software that support these
  90. protocols.
  91.  
  92. Hyperbole consists of three parts:
  93.  
  94.    1.  an interactive information management interface which anyone can use;
  95.  
  96.    2.  a set of programming library classes for system developers who
  97.        want to integrate Hyperbole with another user interface or as a
  98.        back-end to a distinct system.  (All of Hyperbole is written in
  99.        Lisp for ease of modification.  Although Hyperbole is a
  100.        prototype, it has been engineered for real-world usage and is
  101.        well structured.)
  102.  
  103.    3.  A set of hyper-button-action types that provides core hypertext
  104.        and other behaviors.  Users can make simple changes to button
  105.        types and those familiar with Emacs Lisp can quickly prototype
  106.        and deliver new types.
  107.  
  108. A Hyperbole user works with hypertext buttons; he may create, modify,
  109. move or delete buttons.  Each button performs a specific action, such as
  110. linking to a file or executing a UNIX shell command.
  111.  
  112. Presently, there are two distinct categories of Hyperbole buttons:
  113. explicit buttons (the ones that Hyperbole creates) and implicit buttons
  114. (buttons created and managed by other programs or embedded within the
  115. structure of a document and recognized contextually by Hyperbole).
  116. Explicit Hyperbole buttons may be embedded within any type of text file.
  117.  
  118. Hyperbole buttons may be clicked upon with a mouse to activate them or
  119. to describe their actions.  Thus, a user can always check how a button
  120. will act before activating it.  Buttons may also be activated from a
  121. keyboard.  (In fact, all Hyperbole operations, including menu usage, may
  122. be performed from any standard character terminal interface, so one need
  123. not be anchored to a workstation all day).
  124.  
  125. Hyperbole does not enforce any particular hypertext or information
  126. management model, but instead allows you to organize your information in
  127. large or small chunks as you see fit.  Some of its most important
  128. features include:
  129.  
  130.     Buttons may link to information or may execute procedures, such as
  131.     starting or communicating with external programs;
  132.  
  133.     Buttons may be embedded within electronic mail messages;
  134.  
  135.     Other hypertext and information retrieval systems may be
  136.     encapsulated under a Hyperbole user interface (a number of samples
  137.     are provided).
  138.  
  139. Typical Hyperbole applications include:
  140.  
  141.     personal information management
  142.        Overlapping link paths provide a variety of views into an
  143.        information space.
  144.  
  145.        A search facility locates buttons in context and permits quick
  146.        selection.
  147.  
  148.     documentation browsing
  149.        Embed cross-references in your favorite documentation format.
  150.  
  151.        Add a point-and-click interface to existing documentation.
  152.  
  153.        Link code and design documents.  Jump to the definition of an
  154.        identifier from its use within code or its reference within
  155.        documentation.
  156.  
  157.     help/training systems
  158.        Create tutorials with embedded buttons that show students how
  159.        things work while explaining the concepts, e.g. an introduction
  160.        to UNIX commands.  This technique can be much more effective than
  161.        descriptions alone.
  162.  
  163.     archive managers
  164.        Supplement programs that manage archives from incoming
  165.        information streams by having them add topic-based buttons that
  166.        link to the archive holdings.  Users can then search and create
  167.        their own links to archive entries.
  168.  
  169.  
  170. * What's New?
  171.  
  172.   Changes between V2 and V3.
  173.  
  174.   BUTTONS
  175.  
  176.     - Global buttons that can be created, deleted or activated by name.
  177.  
  178.     - Ange-ftp pathnames whether quoted or not are recognized as implicit
  179.       buttons in any context, just click to view.
  180.  
  181.     - Internet RFC document random-access browsing via table of contents
  182.       ibtype.
  183.  
  184.     - Implicit button type, grep-msg, which jumps to source of grep and
  185.       error msg lines.
  186.  
  187.     - Multi-line button labels preceded by common fill prefixes are
  188.       recognized properly, e.g. in source code with comment characters as
  189.       the fill prefix.
  190.  
  191.   SMART KEY
  192.  
  193.     - C and Lisp jump to definition of tag at point.
  194.  
  195.     - Calendar scrolling and appointment viewing.
  196.  
  197.     - Man page apropos viewing and reference following.
  198.  
  199.     - Outline expanding and collapsing.
  200.  
  201.     - Rmail and GNUS browsing.
  202.  
  203.     - Dired and Buffer Menu selecting and deleting.
  204.  
  205.     - Wrolo entry source editing and entry narrowing to focus.
  206.  
  207.   MESSAGING
  208.  
  209.     - Automatic support for buttons in RMAIL, VM, MH-e, and GNUS messages.
  210.       Support is loaded only if the particular tool is invoked.
  211.  
  212.     - Mail and news comments automatically inserted to alert others that you
  213.       can utilize Hyperbole buttons in messages.
  214.  
  215.     - Msg/ menu for sending messages to the Hyperbole mail list and for
  216.       sending in an add/remove/change request for your entry on one of
  217.       the Hyperbole mail lists.  (The hyperbole mail list is now
  218.       accessible via WAIS clients, if you know what that means.  The
  219.       source entry for this WAIS server appears in the Mail Lists
  220.       section of this file.) 
  221.  
  222.     - Automatic insertion of Hyperbole configuration info when click on
  223.       hyperbole mail list address in outgoing messages.
  224.  
  225.   HELP
  226.  
  227.     - A documentation quick access menu.
  228.  
  229.   USER INTERFACE
  230.  
  231.     - Working SunView support.
  232.  
  233.     - Built in rolodex (wrolo) support.
  234.  
  235.     - Mouse keys may be toggled between Hyperbole Smart Key bindings and any
  236.       set of prior bindings.
  237.  
  238.     - Support for Epoch V4 Beta.
  239.  
  240.   DEVELOPMENT/PROGRAMMING
  241.  
  242.     - New implicit button type format the same as defuns.
  243.       It permits one ibtype to perform any number of actions, so for
  244.       example, one ibtype could handle all the kinds of buttons found in a
  245.       particular document format.  Ibtypes can send any number of needed
  246.       arguments to actions.  Ibtypes can be evaluated without triggering any
  247.       actions to test their return values.
  248.  
  249.     - Any Lisp function may now be used to create a Hyperbole action, not
  250.       just defacts.
  251.  
  252.     - Non-nil action return values are now accessible to callers.
  253.  
  254.  
  255. * How to Obtain
  256.  
  257. Hyperbole is available across the Internet via anonymous ftp.  Do not send
  258. requests to have it mailed to you since it won't be.  Instead have another
  259. party who has Internet access obtain it for the both of you.
  260.  
  261. A server which sends the Hyperbole distribution in response to mail
  262. requests may be put into service sometime in the first quarter of 1992.
  263. The Free Software Foundation has expressed interest in distributing
  264. Hyperbole as a separate add-on to GNU Emacs, once Hyperbole reaches a
  265. stable point of maturation, so you may eventually be able to get it from
  266. them.  Here is how to obtain it from the Brown software archive:
  267.  
  268. Move to a directory below which you want the 'hyperbole' directory to
  269. be created.  Unpacking the Hyperbole archive will create this
  270. directory and place all of the files below it.
  271.  
  272.    cd <LOCAL-LISP-DIR>
  273.  
  274. Ftp to wilma.cs.brown.edu  (Internet Host ID = 128.148.31.66):
  275.  
  276.    prompt> ftp wilma.cs.brown.edu
  277.  
  278. Login as 'anonymous' with your own <user-id>@<site-name> as a password.
  279.    
  280.    Name (wilma.cs.brown.edu:rsw): anonymous
  281.    331 Guest login ok, send EMAIL address (e.g. user@host.domain) as password.
  282.    Password:
  283.    230 Guest login ok, access restrictions apply.
  284.  
  285. Move to the Hyperbole directory:
  286.  
  287.    ftp> cd pub/hyperbole
  288.  
  289. Set your transfer mode to binary:
  290.  
  291.    ftp> bin
  292.    200 Type set to I.
  293.  
  294. Turn off prompting:
  295.  
  296.    ftp> prompt
  297.    Interactive mode off.
  298.  
  299. Either retrieve just the Hyperbole archive:
  300.  
  301.    ftp> mget h*tar.Z
  302.  
  303. or retrieve all of the files (the individual, non-tar files, are also
  304. included in the above archive, so they are not strictly necessary):
  305.  
  306.    ftp> mget *
  307.  
  308. Close the ftp connection:
  309.  
  310.    ftp> quit
  311.    221 Goodbye.
  312.  
  313. Unpack the tar archive with:
  314.  
  315.    zcat h*tar.Z | tar xvf -
  316. or
  317.    uncompress h*tar.Z; tar xvf h*tar
  318.  
  319.  
  320. * Installation / Configuration
  321.  
  322. The Hyperbole Manual is included in three forms:
  323.     "hypb.info"       - online version
  324.      hypb.ps          - Postscript form
  325.     "hypb.texinfo"    - source form
  326.  
  327. If you have just retrieved Hyperbole, see "hsite-ex.el" for installation
  328. and setup instructions.  If Hyperbole has already been installed for
  329. use at your site, you can manually invoke it from within GNU Emacs or Epoch by
  330. loading the "hsite.el" code library file:  {M-x load-lib RTN hsite RTN}.  See
  331. the section on 'Initializing' in the Hyperbole Manual for information on how to
  332. set up for permanent Hyperbole use.
  333.  
  334. To add a pointer to the Info version of the Hyperbole manual within your Info
  335. directory file, add the following two lines (the '*' should be in the first
  336. column) to the menu within that file, substituting for <HYP-DIR>:
  337.  
  338.     * Hyperbole: (<HYP-DIR>/hypb.info).
  339.         GNU Emacs-based extensible hypertext management system.
  340.  
  341. When used with a mouse, Hyperbole uses your middle and right mouse buttons by
  342. default.  The bindings are set in "hmouse-key.el".  What the mouse
  343. buttons do is set in the 'smart-key-alist' variable in "hui-mouse.el"
  344. and is summarized in "hmouse-doc".
  345.  
  346.  
  347. * Quick Reference
  348.  
  349. "MANIFEST" summarizes most of the files in the distribution.
  350.  
  351. See "DEMO" for a demonstration of standard Hyperbole button
  352. capabilities.
  353.  
  354. Naming conventions:
  355.   All Hyperbole-specific code files begin with an 'h'.
  356.   Hyperbole user-interface files begin with 'hui-' or 'hmous'.
  357.   Files that define implicit button types begin with 'hib'.
  358.   Encapsulations of foreign systems begin with 'hsys-'.
  359.  
  360. Most of the standard Emacs user interface for Hyperbole is located in
  361. "hui.el".  Most of the Hyperbole application programming interface can be
  362. found in "hbut.el".  "hbdata.el" encapsulates the button attribute storage
  363. handling presently implemented by Hyperbole.  "hmail.el" provides a basic
  364. abstract interface for folding mail readers other than Rmail into Hyperbole.
  365.  
  366.  
  367. * Mail Lists
  368.  
  369. There are several Hyperbole-related mail addresses.  Learn what each is
  370. for before you contemplate mailing to any of them.
  371.  
  372.  
  373. hyperbole-request@cs.brown.edu
  374.  
  375.    ALL mail concerning administration of the Hyperbole mailing lists
  376.    should be sent here.  That includes addition, change, or deletion
  377.    requests.  Don't EVER consider sending such a request to a Hyperbole
  378.    mail list or people will think you can't read.  ONLY FULLY
  379.    DOMAIN-BASED ADDRESSES WILL BE ACCEPTED (no UUCP '!' characters nor
  380.    .UUCP pseudo-domain).  If you don't have such an address by now, you
  381.    should get one.  Anyone else who wants to handle these other
  382.    addresses is free to forward the contents of the lists to them.
  383.  
  384.    Use the following formats on your subject line to execute requests,
  385.    where you substitute your own values for the <> delimited items.
  386.  
  387.    Subject: Add <your name> '<' <user@domain> '>' to <mail-list-sans-domain>.
  388.    Subject: Remove '<' <user@domain> '>' from <mail-list-sans-domain>.
  389.    Subject: Change '<' <user@domain> '>' to '<' <newuser>@<newdomain> '>' in <mail-list-sans-domain>.
  390.  
  391.    For example:
  392.      Subject: Add Joe Williams <joe@cs.brown.edu> to hyperbole.
  393.      Subject: Remove <joe@cs.brown.edu> from hyperbole.
  394.      Subject: Change <joe@cs.brown.edu> to <joe@mot.com> in hyperbole.
  395.  
  396.  
  397. hyperbole@cs.brown.edu
  398.  
  399.    Mail list for discussion of all Hyperbole issues.  Bug reports and
  400.    suggestions may also be sent here.
  401.  
  402.    Always use your Subject and/or Summary: lines to state the position
  403.    that your message takes on the topic that it addresses, e.g. send
  404.    "Subject: Basic bug in top-level Hyperbole menu." rather than
  405.    "Subject: Hyperbole bug".  Statements end with periods, questions
  406.    with question marks (typically), and high energy, high impact
  407.    declarations with exclamation points.  This simple rule makes all
  408.    e-mail communication much easier for recipients to handle
  409.    appropriately.
  410.  
  411.    If you ask a question, your subject line should include the word
  412.    'question' or 'query' or should end with a '?', e.g. "Subject: How
  413.    can man page SEE ALSOs be made implicit buttons?"  A "Subject: Re:
  414.    How can ..." then indicates an answer to the question.  Question
  415.    messages should normally include your Hyperbole and Emacs version
  416.    numbers and clearly explain your problem and surrounding issues.
  417.    Otherwise, you will simply waste the time of those who may want to
  418.    help you.  (Your top-level Hyperbole menu shows its version number
  419.    and {M-x emacs-version RTN} gives the other.)
  420.  
  421.    If you ask questions, you should consider adding to the discussion by
  422.    telling people the kinds of work you are doing or contemplating doing
  423.    with Hyperbole.  In this way, the list will not be overwhelmed by
  424.    messages that ask for but provide no information.
  425.  
  426.    This list is now archived as a WAIS server.  Ask <wais-talk@think.com>
  427.    if you have questions about what WAIS is.  The source entry for this
  428.    server is:
  429.  
  430. (:source 
  431.    :version  3 
  432.    :ip-address "128.148.31.66"
  433.    :ip-name "wilma.cs.brown.edu"
  434.    :tcp-port 8000
  435.    :database-name "hyperbole"
  436.    :cost 0.00 
  437.    :cost-unit :free 
  438.    :maintainer "mlm@cs.brown.edu"
  439.    :description "This WAIS server contains all messages sent to the Hyperbole mailing list.
  440. Hyperbole is a flexible, information manager built on top of GNU Emacs.
  441. It is available for anonymous ftp from /wilma.cs.brown.edu:pub/hyperbole.
  442. See the README file there for details.
  443. Server created with WAIS release 8 b3.1 on Feb 20 14:40:09 1992 by wais@wilma"
  444. )
  445.  
  446.  
  447. hyperbole-announce@cs.brown.edu
  448.  
  449.    Those who don't want to participate in the discussion but want to
  450.    hear about bug fixes and new releases of Hyperbole should subscribe
  451.    to this list.  Anyone on the 'hyperbole' list is automatically on
  452.    this one too, so there is no need to subscribe to this one in that
  453.    case.  This list is for official fixes and announcements so don't send
  454.    your own fixes here.  Send them to 'hyperbole' instead.
  455.  
  456.  
  457. * V2 Beta Tester Quotes
  458.  
  459.  "In general, Hyperbole is an embeddable, highly extensible hypertext
  460.   tool.  As such, I find it very useful. As it stands now, Hyperbole is
  461.   particularly helpful for organizing ill-structured or loosely coupled
  462.   information, in part because there are few tools geared for this purpose.
  463.   Hyperbole also possesses a lot of potentials in supporting a wider
  464.   spectrum of structuredness, ranging from unstructured to highly
  465.   structured environments, as well as structural changes over time.
  466.  
  467.   Major Uses:
  468.  
  469.   * Menu interface to our own Epoch-based collaborative support environment
  470.     called CoReView: This interface brings together all top-level user
  471.     commands into a single partitioned screen, and allows the end user to
  472.     interact with the system using simple mouse-clicking instead of the
  473.     meta-x key.
  474.  
  475.   * Gateway to internet resources: this includes links to major Internet
  476.     archive sites of various types of information. Links are made at both
  477.     directory and file levels.
  478.  
  479.   * Alternative directory organizer: The hierarchical nature of the Unix
  480.     file system sometimes makes it difficult to find things quickly and
  481.     easily using directory navigational tools such as dired. Hyperbole
  482.     enables me to create various "profile" views of my directory tree, with
  483.     entries in these views referring to files anywhere in the hierarchy.
  484.  
  485.   * Organizing and viewing online documentation: using Hyperbole along with
  486.     Hyper-man and Info makes it truly easy to look up online documentation.
  487.       
  488.   * Other desktop organization tasks: including links to various mail
  489.     folders, saved newsgroup conversation threads, online note-taker,
  490.     emacs-command invocations, etc."
  491.  
  492.                         -- Dadong Wan
  493.  
  494. -------
  495.  
  496.  "Hyperbole is the first hyper-link system I've run across that is
  497.   actually part of the environment I use regularly, namely Emacs. The
  498.   complete flexibility of the links is both impressive and expected -- the
  499.   idea of making the link itself programmable is clever, and given that one
  500.   assumes the full power of emacs.  Being able to send email with buttons
  501.   in it is a very powerful capability.  Using ange-ftp mode, one can make
  502.   file references "across the world" as easily as normal file references."
  503.  
  504.                         -- Mark Eichin
  505.  
  506. -------
  507.  
  508.  "The Hyperbole system provides a nice interface to exploring corners of
  509.   Unix that I didn't know existed before."
  510.  
  511.                     -- Craig Smith
  512.  
  513. -------
  514.  
  515.  
  516. * Why was Hyperbole developed?
  517.  
  518. Hyperbole has been designed to aid in research aimed at Personalized
  519. Information production/retrieval Environments (PIEs).  Hyperbole is a
  520. backend manager to be used in prototyping an initial PIE.
  521.  
  522. An examination of many hypertext environments as background research did
  523. not turn up any that seemed suitable for the research envisioned, mainly
  524. due to the lack of rich, portable programmer and user environments.  We also
  525. tired of trying to manage our own distributed information pools with standard
  526. UNIX tools.  And so Hyperbole was conceived and raved about until it
  527. got its name.
  528.  
  529.  
  530. * Copyright
  531.  
  532. The following copyright applies to the Hyperbole system as a whole.
  533. Each file also bears its own copyright, e.g. the files based upon GNU
  534. copyrighted code bear the same copyright as GNU Emacs.
  535.  
  536. Copyright (C) 1991, Brown University, Providence, RI
  537.  
  538. Permission to use, modify and redistribute this software and its
  539. documentation for any purpose other than its incorporation into a
  540. commercial product is hereby granted without fee.  A distribution fee
  541. may be charged with any redistribution.  Any distribution requires
  542. that the above copyright notice appear in all copies, that both that
  543. copyright notice and this permission notice appear in supporting
  544. documentation, and that neither the name of Brown University nor the
  545. author's name be used in advertising or publicity pertaining to
  546. distribution of the software without specific, written prior permission.
  547.  
  548. Brown University makes no representations about the suitability of this
  549. software for any purpose.  It is provided "as is" without express or
  550. implied warranty.
  551.