Conference vaxuum::online_bookbuilding

    There has been some confusion about what software needs to be installed
    and where (workstations, big VAXes) for online documentation. This
    note is an effort to clear up that confusion for system managers
    and others who want to build and display online books.
    
    The following lists the software requirements (and kit locations) for 
producing and displaying online documents.

Note that there are 2 distinct sets of software required, one set to 
build books and one set to display books:

1. Bookbuilding tools -- any VAX; does not require a workstation:

  VAX/VMS V5.0
  VAX DOCUMENT V1.1              VAXUUM::KITS_:[DOCUMENT.V11]DOC011
  VAX DOCUMENT internal 1.1 kit  VAXUUM::KITS_:[DOCUMENT.V11]DOCINT011
  VAX DOCUMENT ZK local kit      DONVAN::USER5:[ZKKITS]DOCZK011

  For more information about these kits, see the DOCUMENT notes conference
  on VAXUUM, notes 2.5, 3.5, and 9.3.

               NOTE: once you have installed these kits, 
               you need NOT reinstall them to
               update the online bookbuilding tools:

  Online Bookbuilding Tools      VAXUUM::KITS_:[DOCUMENT.V11]CUP$BOOKREADER.SAV

  For more information about restoring this saveset, see the 
  ONLINE_BOOKBUILDING notes conference on VAXUUM, note 30.  


2. DECwindows Bookreader -- requires a workstation:

  VAX/VMS V5.1 Field Test        BULOVA::SYS$KITS:[VMS051]
  DECwindows Field Test 2 Update (bundled with VMS051 kit) 


3. Processing Files

  When you run VAX DOCUMENT to produce an online book, you should see
  the following messages:

  $ DOCUMENT/CONTENTS/INDEX MYFILE ONLINE BOOKREADER
  [T a g  T r a n s l a t i o n]...
  %TAG-I-DEFSLOADD, End of Loading of Tag Definitions 
  %TAG-I-LCL_MSG01, Using online bookbuilding tools, 11-NOV-88 baselevel
  ...

  Any baselevels previous to the 11-NOV-88 tools are incompatible with
  the FT2 update Bookreader.
    
                                                          

    Can you tell us what is required from the ZK kit? I think our
    installation has been working ok without having installed that one.
    
    Marty

    If you do not use any of the ZK doctypes, you don't need it. But
    if you do use anything from that kit, you need the latest version
    so the bookreader destination keywords will be recognized. 
    
    Mary

Re: 30.0

>To install the bookbuilding tools you must restore the following saveset:

>  VAXUUM::KITS_:[DOCUMENT.V11]CUP$BOOKREADER.SAV

        Despite its name, this saveset does *not* contain the
        bookreader. That gets installed with DECwindows. 

>The following command line restores the saveset to your existing DOC$TOOLS
>tree:

>  $ BACKUP CUP$BOOKREADER.SAV/SAV/SELECT=[DOC$TOOLS...] -
>  $_ dev:[DOC$TOOLS...]/NEW_VERSION

        If your system has a logical name DOC$TOOLS, it is *not*
        necessarily the right place to install the bookbuilding tools.
        I believe that SHOW LOGICAL DOC$ROOT gives you the correct
        directory name. On REORG: 

		DOC$TOOLS points to USER2:[DOCTOOLS]	(wrong)
		DOC$ROOT  points to USER1:[DOC$TOOLS]	(right)

    Note 64 (and its replies) will henceforth be devoted to announcements
    of new baselevels of the online bookbuilding tools. Replies to this
    note have been retained as they contain still-relevant information.
    
    Mary