home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #26 / NN_1992_26.iso / spool / comp / sys / hp48 / 5706 < prev    next >
Encoding:
Internet Message Format  |  1992-11-12  |  3.1 KB
  1. Path: sparky!uunet!portal!cup.portal.com!Jake-S
  2. From: Jake-S@cup.portal.com (Jake G Schwartz)
  3. Newsgroups: comp.sys.hp48
  4. Subject: An Alternate HP48 Manual Index
  5. Message-ID: <69378@cup.portal.com>
  6. Date: Thu, 12 Nov 92 16:41:10 PST
  7. Organization: The Portal System (TM)
  8. Distribution: world
  9. Lines: 54
  10.  
  11.  
  12.                An Alternate Index to the HP48 Manuals
  13.  
  14.      Back on March 29th, toward the end of the second day of the HP
  15. Users' Conference in Philadelphia, a discussion was raised regarding
  16. the HP48 User Manual and its index.  Despite its large size (29 pages
  17. and approximately two thousand entries), it was argued that still
  18. many important topics had been omitted.  The first example mentioned
  19. was the lack of an entry for the display radix mark, requiring one to
  20. already know that command "FM," performs this function.  (In all
  21. fairness to the original index, there indeed are entries "period as
  22. fraction mark" and "comma as fraction mark".)  
  23.      Having done a few annual indexes for the PPC Journal in the past,
  24. I volunteered to compile a revised index for the original two-volume 
  25. HP48 Manuals.  The goal was to develop the reference independently
  26. from the original index.  As a result, the existing index was only
  27. cross-checked after the new document was virtually complete.  In the 
  28. first pass through the HP48 manuals, key subjects were compiled into 
  29. a hand-written list in the order that they were encountered. The
  30. second pass consisted of entering these subjects into a computer
  31. editor in alphabetical order.  If any subject had more than one key
  32. word, the entry was included multiple times as appropriate.  As a
  33. result, major index sublists evolved such as "Commands", "Examples",
  34. "Illustrations" and "Menus".
  35.      In the original discussion back in March, it was suggested that 
  36. a "good index" contains an average of at least two references from
  37. each page of the source document. The HP48 manual's original index
  38. actually surpasses this benchmark, with around two thousand entries
  39. for the 821 pages of text.  The alternate index contains somewhere
  40. between 3500 and 4000 entries.  It is hoped that HP48 users will find
  41. it a useful resource for quickly accessing subject matter, perhaps
  42. even moreso than Hewlett-Packard's own offering.  
  43.      Recently, a revised single-volume manual has started appearing
  44. in the HP48 boxes. At the Philly conference we were informed by 
  45. Dennis York that this version has been updated from cover to cover,
  46. with the significant addition of a complete menu tree in one of the
  47. appendices.  Perhaps the alternate index should contain references to
  48. both the one-book and two-book versions of the HP48 documentation. This
  49. along with the possible incorporation of other useful HP48 reference
  50. texts is being considered as a project for the future.  Any comments
  51. or suggestions for this project are eagerly welcomed.
  52.  
  53.      Jake Schwartz                  Jake-S@cup.portal.com  
  54.      135 Saxby Terrace                      or
  55.      Cherry Hill, NJ 08003         SIM9@ESDSDF.DNET.GE.COM
  56.      USA
  57.  
  58.      609-751-1310 home
  59.      609-866-6682 work
  60.  
  61.  
  62.  
  63.            (The index follows this posting in 4 parts.)
  64. -----------------------------------------------------------------------
  65.