home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #30 / NN_1992_30.iso / spool / comp / sys / sun / admin / 9468 < prev    next >
Encoding:
Text File  |  1992-12-15  |  4.3 KB  |  108 lines
  1. Newsgroups: comp.sys.sun.admin
  2. Path: sparky!uunet!mcsun!sun4nl!eur.nl!pk
  3. From: pk@cs.few.eur.nl (Paul Kranenburg)
  4. Subject: Re: answerbook 1.4 and answerbook 2.1
  5. Message-ID: <1992Dec15.200608.20729@cs.few.eur.nl>
  6. Sender: news@cs.few.eur.nl
  7. Reply-To: pk@cs.few.eur.nl
  8. Organization: Erasmus University Rotterdam
  9. References: <RUSTY.92Dec9174106@groan.Berkeley.EDU>
  10. Date: Tue, 15 Dec 1992 20:06:08 GMT
  11. Lines: 95
  12.  
  13. In <RUSTY.92Dec9174106@groan.Berkeley.EDU> rusty@groan.Berkeley.EDU (Rusty Wright) writes:
  14. >AnswerBook 1.4 on it.  We've just received Solaris 2.1 and the
  15. >corresponding AnswerBook.  I think we're going to buy another cd-rom
  16. >drive for the Solaris 2.1 AnswerBook.
  17.  
  18. >What I don't understand is if we can set things up so that people will
  19. >be able to have just one AnswerBook executable running and it will be
  20. >able to access both the Solaris 1.1 and the Solaris 2.1 AnswerBook
  21. >databases and files.
  22.  
  23. >When you look at the top-level AnswerBook window it seems to imply
  24. >that you can, there's a window called "Location in Collection" which
  25. >is a scrolling window that currently only has one entry, for
  26. >AnswerBook 1.4.
  27.  
  28. >I've also received cd's for the new compilers for Solaris 2.1 and they
  29. >say they provide on-line documentation in AnswerBook format, which I'm
  30. >assuming they'll somehow install into my AnswerBook directory, or
  31. >they'll install some pointer in it to wherever the compiler's stuff
  32. >gets installed.  Or something like that.
  33.  
  34. These "secondary" Answerbooks can be merged into the "primary" (or
  35. system) Answerbook with the help of some utility that is included in
  36. the secondary Answerbook package. This utility won't let you merge
  37. two system Answerbooks (like Solaris 2.1 AB and the SunOS 4.1.x AB v1.4)
  38. because this would result in name conflicts of the included books (eg.
  39. the book REFMAN1 occurs in both answerbooks). Since the name of a book
  40. is used as a key when searching the `bookinfo' file, you would always
  41. end up viewing the same book (the one that comes first in `bookinfo').
  42. To get around this you could rename the books in one of the answerbooks
  43. to some unique name, but alas, this involves making a new set of index
  44. files for each of the renamed books as well.
  45.  
  46.  
  47.  
  48. >Along a similar vein, we're currently actually making available the
  49. >AnswerBook 1.3 disc but will be replacing it with the 1.4 disc, but
  50. >we've noticed that the following "books" are missing from the 1.4
  51. >disc:
  52.  
  53. >    NeWs 3.0 Programmer's Guide
  54. >    OLIT 3.0 Reference Manual
  55. >    OPEN LOOK Application Style Guidelines
  56. >    OPEN LOOK Functional Specification
  57. >    The NeWs Toolkit 3.0 Reference Manual
  58. >    X Protocol Reference Manual
  59. >    X Toolkit Intrinsics Reference Manual
  60.  
  61. >It would be nice if we could extract them from the 1.3 disk and
  62. >install them so that they could be easily available to people when we
  63. >switch over to AnswerBook 1.4.
  64.  
  65. This can be done. I have put these books in a separate subdirectory and
  66. and added a few lines to the `bookinfo' file like this:
  67.  
  68. OREILLY0:/usr/pkg/answerbook1.4/AB1.3:/usr/pkg/answerbook1.4/AB1.3::System Software AnswerBook Release 1, Issue 3
  69.  
  70. (where `/usr/pkg/answerbook1.4' is the AB 1.4 installation directory).
  71.  
  72. Next you create some book entries in the supplied `sr_index/ascii.xtoc'
  73. like so:
  74.  
  75.     id      =       AB1-3TOP-167-0
  76.     title   =       X11 and Openlook (from Answerbook version 1.3)
  77.     label   = set   
  78.  
  79.         <<
  80.         id      =       AB1-3TOP-168-1
  81.         title   =       X Protocol Reference Manual
  82.         book    =       <OREILLY0>
  83.  
  84.         id      =       AB1-3TOP-169-1
  85.         title   =       Xlib Programming Manual
  86.         book    =       <OREILLY1>
  87.  
  88.         <more of the same>
  89.     >>
  90.  
  91.  
  92. And make a new top-level index file with `dbgen' that comes with Solaris 2
  93. answerbooks (you need a machine running Solaris 2.x for this).
  94.  
  95. Shortly, I will have a set of tools available that will be able to "decompile"
  96. a given AB index file into a "ascii.xtoc" file (which can be edited) and
  97. the equivalent of the Solaris 2 'dbgen' to convert this into a set of DBM
  98. files again. This will allow the compilation of one's own Answerbook (currently,
  99. I have our set of local manual pages on-line). I am still working on an
  100. alternative navigator which will use ghostscript as its PS engine...
  101.  
  102. Note that this will not be a complete substitute, since I have no knowledge
  103. about the search mechanism employed by Sun's navigator (those big files
  104. in the `sr_index' subdirectory).
  105.  
  106. -pk
  107.  
  108.