home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #30 / NN_1992_30.iso / spool / gnu / misc / discuss / 3976 < prev    next >
Encoding:
Text File  |  1992-12-14  |  3.1 KB  |  77 lines
  1. Newsgroups: gnu.misc.discuss
  2. Path: sparky!uunet!zaphod.mps.ohio-state.edu!darwin.sura.net!uvaarpa!cv3.cv.nrao.edu!cv3.cv.nrao.edu!pshannon
  3. From: pshannon@iapetus.cv.nrao.edu (Paul Shannon)
  4. Subject: RFC: using Texinfo and InterViews for a context-sensitive help program
  5. Message-ID: <PSHANNON.92Dec14144048@iapetus.cv.nrao.edu>
  6. Sender: news@nrao.edu
  7. Organization: nrao
  8. Distribution: gnu
  9. Date: Mon, 14 Dec 1992 19:40:48 GMT
  10. Lines: 65
  11.  
  12. We'd like to get comments on a small project we're about to begin.  By 
  13. "comments" I mean anything like
  14.  
  15.  1. "this is a great idea, please let us use the code when you're done"
  16.  2. "this was done months ago, look at anon ftp site xxx.yyy.zzz for 
  17.     a copy"
  18.  3. "this is a stupid idea, for these reasons....."
  19.  
  20.  
  21.                 A Context-sensitive help program, based upon
  22.                       Texinfo and InterViews
  23.  
  24. By using the GNU project's Texinfo for documentation, we're able to have a
  25. single source file for printed manuals and and on-line help.  So there's
  26. two ways to read the Texinfo source: print it out, or  use emacs in info
  27. mode.  We want to add a third way:  a program with a graphical user
  28. interface that responds  to ipc requests (over a socket, for instance),
  29. by displaying a particular node in the file.  Once this node is displayed,
  30. the user can navigate using the normal info keyboard commands (m,d,u,....) 
  31. and with corresponding gui widgets as well (menus, buttons, and sliders).
  32.  
  33. This gui program, sensitive to ipc requests, will allow us to provide
  34. context-sensitive help to our users:  any of our application programs
  35. that knows the protocol (socket number, node names, info navigation commands)
  36. can popup the Texinfo viewer, at a particular node, at will.
  37.  
  38. In time we'd like to add printing, bookmarks, different fonts, and perhaps 
  39. the ability to display postscript.
  40.  
  41. We propose to use the C++ gui toolkit InterViews.  IV has many strengths:
  42.  
  43.    1. written in C++, with classes that are easily adapted to
  44.       the model-view-controller approach to gui design
  45.    2. public domain source
  46.    3. isolation of X and OS related code
  47.    4. may become the standard X consortium C++ toolkit
  48.   
  49. and some weaknesses
  50.    
  51.    1. few examples to learn from
  52.    2. scant documentation 
  53.    3. unstable design:  though version 3.0 brought glyphs, and 3.1
  54.       introduced object creation kits, these rest uneasily among
  55.       classes left over from the earlier 2.6 design.
  56.    4. some functionality from the X Intrinsics is not
  57.       available: XtWorkProc, for example, allows the programmer
  58.       to install a task to run whenever no events are pending; 
  59.       this is difficult to do in IV.
  60.  
  61. There's an InterViews 2.6 application, ivinfo, available on the ftp
  62. archive at interviews.stanford.edu, which contains some code we'd
  63. either use directly or learn from.
  64.  
  65. We plan to distribute the code for our larger project (aips++, an image
  66. processing tools for radio astronomy) under the gnu copyleft agreement.
  67. We would do the same for the context-sensitive help program as well.
  68.  
  69. Any comments, criticisms or suggestions?
  70.  
  71.    Paul Shannon
  72.    pshannon@nrao.edu
  73.    National Radio Astronomy Observatory
  74.  
  75.  
  76.  
  77.