ы$ VTBOOK014.B,P VTBOOK014.BBACKUP/NOASSIST/COMMENT=VAX/VMS SPKITBLD Procedure/INTER/LOG/VERIFY [.VTBOOKB]*.*; WORTMAN0:[VTBOOK]VTBOOK014.B/LABEL=(VTBOOK)/SAVE/BLOCK=9000/GROUP=25/NOINIT/NOREWIVAX/VMS SPKITBLD Procedure WORTMAN r:6eV5.5 _WORTMN::  _WORTMN$DKA300: V5.5-2 $*[VTBOOK.VTBOOKB]INSTALL.DOC;1+,w. / 4L 2-R0123KPWO 56Od796e8ؤi9GHJ8 DECUS VTBOOK Installation procedure2 INSTALLING DECUS VTBOOKJ DECUS VTBOOK arrives in saveset form, accompanied by this document. AJ copy of this document also is part of the saveset just in case you getJ separated. If you've unpacked the saveset, you jumped ahead of us and+ probably nothing's working quite right.@ DECUS VTBOOK uses VMSINSTAL to compile, link, and set up itsH environment. It'll make sure to ask you about most of the things itD thinks you'll want to make decisions about and gives you as muchH control as possible. It also provides you with the chance to simplyF skip all the questions and accept our default installation in caseE you're the type of person who hates surveys and answering lots of questions.. PRE-INSTALLATIONE If you already have a prior version of VTBOOK installed *prior toI V1.2, you will need to delete all files associated with VTBOOK beforeK installing DECUS VTBOOK V1.4. While you may attempt to install the newG version over the old without deleting old files first, your resultsD cannot be guaranteed. All DECUS VTBOOK files are installed into" subdirectories under [VTBOOK]., INSTALLATION+ To start the installation, simply type:= $ @SYS$UPDATE:VMSINSTAL VTBOOK012 : OPTIONS N,IH replacing and with the device and directory in which the! DECUS VTBOOK saveset resides.G The "OPTIONS N,I" part ensures two things: One, that you'll get toJ review any last-minute release notes that we couldn't get incorporatedG into the documentation and two, that you won't be bothered by thoseI annoying first three questions that VMSINTSTAL always asks and no oneI ever pays any attention to anyway. (Note: It's save to ignore thoseK questions with this particular product, but you should be careful using OPTION I in general).I If this is a new installation, or you are upgrading from VTBOOK V1.0,L the installation procedure will attempt installation on SYS$SYSDEVICE:. F Simply put, this is the only disk that we can be assured is on allK systems. DECUS VTBOOK does *not* need to be placed on the system disk,J and will function properly when placed on any disk in your system. IfF this is an upgrade, VMSINSTAL will attempt to locate your existing+ installation and place the files there.H Note that it you elect the standard installation, VMSINSTAL will not? ask you whether you wish to purge files replaced during theH installation. This will occur automatically, by default, as part ofA the standard installation even though it is not listed on theK explanation that preceds the "Do you want to answer a lot of questions" question.1 POST-INTALLATION TASKSJ These will vary depending on the installation style you chose. If youJ elected not to have DECUS VTBOOK installed into your DCLTABLES.EXE, orI if you have system-specific DCLTABLES rather than common ones, you'llH need to manually add DECUS VTBOOK to those tables you want it in and7 then re-install them as shown in the example above.> Alternately, you can simply put the command "$ SET COMMANDK VTBOOK_LOC:VTBOOK" in the LOGIN.COMs of everyone you want to be able to access VTBOOK.C You may also elect to have the following line put into either a: system-wide SYLOGIN.COM or into each user's LOGIN.COM:% $ VTBOOK:==$VTBOOK_LOC:VTBOOK.EXEH VTBOOK now supports both foreign-command and CLI invocations equally and without prejudice.K Additionally, remember that if you elected to have the VMSINSTAL updateJ your DCLTABLES but did not elect the cluster-wide startup, you'll needD to reinstall that image as follows (or something close to this): $ MCR SYSMAN# SYSMAN> set environment/cluster8 SYSMAN> do install replace SYS$LIBRARY:DCLTABLES.EXED If the command is to be made available cluster-wide, perform the? following step while still in SYSMAN (again, if you elected6 cluster-wide startup, this step is not necessary):* SYSMAN> do @sys$startup:vtbook_startupJ This will define DECUS VTBOOK's logicals (all of which are prefixed byJ "VTBOOK_"). This file is created by the VMSINSTAL procedure, and willF include commented-out logicals for directories not required by the7 particular installation options you have requested.I See the VTBOOK014.RELEASE_NOTES for a list of logical names which mayJ be defined for use on your system and all files and their placement in? a full installation as well as a complete list of fixes and modifications since V1.0.*[VTBOOK.VTBOOKB]VTBKITC.DAT;1+,w./ 49-R0123KPWO56Od7`96e8`i9GHJ! PROVIDE_FILE data!9! This list should contain all files required by VTBOOK.!! BDW 4-NOV-1993 V1.1! ! Format is:(! logical filename destination [options]!/VTB_INSTALL_DOC INSTALL.DOC VTBOOK_DOC:/VTB_VTBOOK_DOC VTBOOK.DOC VTBOOK_DOC:*[VTBOOK.VTBOOKB]VTBOOK.DOC;1+,n./ 4L~-R0123KPWO56Od7@G96e8@i9GHJ , DECUS VTBOOK, INTRODUCTIONG Greetings! You have just purchased a wonderful product that shouldI give you years of trouble-free use... No, wait a minute, that'd be a coffee maker. Sorry.J But you *have* recently obtained a copy of DECUS VTBOOK, and are to beB congratulated on your discriminating taste. DECUS VTBOOK is aH public-domain character-cell bookreader which can be used on any VMS: system to access Digital's OnLine Documentation (OLD).- INSTALLATIONH DECUS VTBOOK uses VMSINSTAL to set up the software and configure itsG environment. The use of VMSINSTAL with VTBOOK is documented in the> file INSTALL.DOC in the "B" saveset. It includes a sample installation.- USING VTBOOKI Aha! Now for the fun. The software's installed (you're not actuallyE reading the docs before you've already played around with it, areK you?) and you're wondering what keys do what, and what functionality is available, right?K As of this version, not all Bookreader functions have been implemented,J but most of those that we felt we used most often have been included. H Table 1 lists the function keys and their functions, including thoseJ whose functions vary depending on whether you are in a menu or reading a book.L ------------------------------------------------------------------------ TABLE 1 Key(s) Function ------ --------L Help, ? Displays a help screen showing these key definitionsJ F10, Ctrl/Z "Back Out" - close the active "window" and retreat" one level.+ Left/Right arrow Previous/Next Topic- Prev/Next (book) Screen up/Screen down- KP7, KP8 Screen up/Screen down# Return (book) Screen downB Prev/Next (menu) Advance/ba`'i$ VTBOOK014.BnR[VTBOOK.VTBOOKB]VTBOOK.DOC;1L"ck up menu choices one menu-full1 Up/Down arrow Up one line/down one line7 Find, KP3 (book) Move to and select next hotspot/ Find, KP3 (menu) Begin title search modeE Select (book), KP. Go to the location indicated by the currently( selected hotspotF Ctrl/B "Go Back" - return to the immediately previous( topic or screen.H Do, Return, Choose the currently highlighted choice and open Select (menu) it.K Ctrl/E "Fast Exit" - return to calling level (usually DCL)$ immediately.' Ctrl/R, Ctrl/W Screen refresh., Ctrl/D Spawns a subprocess.L ------------------------------------------------------------------------K Some additional functions are under development for subsequent releasesD and, while they exist in some for in this version, should not beK depended upon to continue to behave as they currently do. These shouldF not cause you any trouble, but you should be aware of them all the@ same. All "in development" functions are listed in Table 2.L ------------------------------------------------------------------------ TABLE 2 Key(s) FunctionJ F20 Create SYS$LOGIN:LIBRARY.DECW$BOOKSHELF or open if5 it exists (private bookshelf)/ F19,KP1 Close private bookshelfD PF4 Write current selection to private bookshelf; Delete Remove entry from private bookshelfL ------------------------------------------------------------------------F Wherever possible, attempts were made to map multiple keys to eachF function and not rely on the expanded abilities of LK201/401-styleI keyboards. In general, an EDT-style motif was chosen for the numeric keypad keys.K There is a pseudo-title search capability built into VTBOOK. If a menuK of titles is displayed, you may begin typing the title you want, and asH characters match, VTBOOK will scroll to the first title that matchesI the characters you type, making locating a known title in a long list2 less of an exercise in Next/Prev key punching. COMMAND QUALIFIERSH DECUS VTBOOK provides a single qualifier, /DEBUG. Under normal use,G this qualifier need never be used -- it enables debugging log filesG that are opened with each book read. It is primarily of use to theI developers, but the behavior has been modified to not give these logs@ unless explicitly requested. Its default value is /NODEBUG.+ WHODUNIT?B DECUS VTBOOK is based on a program written by Chris Sharman ofF CCA Stationery in England, called, strangely enough, VTBOOK. That@ program formed the foundation for the software you now have.H A dedicated group of DECUS volunteers took the task of enhancing andJ updating the software before releasing it to the public. These peopleE made me look good and saved me countless hours of banging my head against my monitor.H Darrell Burkhead, recipient of our "gonzo programmer" award, tackledJ much of the low-level stuff, implemented the message boxes for errors,H and helped out with logical name search lists. Darrell's at WesternH Kentucky University where he'll take any excuse to avoid writing hisI masters' thesis. Darrell's also to thank for much of the search-listG code, and after the clean-up job he did on string descriptors, I've& hired him to do my apartment next.I Hunter Goatley, also of Western Kentucky University where he's SystemG Programmer and regular contributor to _Digital Systems Journal_ and? maintainer of both "MX" and "The Supervisor Series" gave usH DESCRIP.MMS, compatibility with MMK, and helped us not stray too farJ off our path. Hunter also is co-owner of the VTBOOK-L mailing list on the Internet.J Curt Snyder of Allergan, Inc. made those errors that do occur legible,F readable, and sensible (to him, at least) and aided in the generalI clean-up and enhancement process. He plans to attempt to taste everyB microbrewed beer in existence as soon as this version is done.F Bret D. Wortman, formerly of Century Lubricants Co. was the team'sI coordinator (but mostly got in everyone's way). He wrote the InstallK procedure, added CLI support, merged everyone's contributions together,E and wrote much of the documentation. With Hunter, he co-owns theI VTBOOK-L Internet mailing list. As long as Curt's buying, he's going with.K Many others helped us get to where we are now. Geoff Bryant, Dale Coy,I Tom Gaudette, the DECUS Library volunteers, those wonderful people onH DECUServe, and all those employers out there who gave us the machineI time, freedom, and latitude to work on this project. My hat's off toI all of them. A personal note of thanks also goes to Terry Kennedy ofJ St. Peter's College, who gave VTBOOK a temporary home when Century andF I parted company right before the production version was finished./ PROBLEMS & SUPPORTD DECUS VTBOOK is maintained solely by volunteers. As the currentG maintainer, I am very interested in hearing of any difficulties youH have with the package, from installation through usage. Enhancement4 requests are always welcome, as are bug reports.C You can contact me on the Internet at wortman@hottentot.com. IJ anticipate moving in the near future, so can't give a current employerK or snail-mail address -- I apologize for that. The DECUS office shouldJ be able to get you in contact with me if you can't reach me by Email. H Call 1-800-DECUS55 and be really nice to Anne Foley when she answers7 the phone, and she'll probably get a message to me.K Actual support is a tougher issue. If you have (or get) a subscriptionI to DECUServe, you'll find me there, along with most of the others whoJ contributed to DECUS VTBOOK to answer your questions. But our time isI limited by such things as families, jobs, and so on. Providing phoneJ support is simply not possible. We will try to answer all messages as- time permits, but Email is your best bet.I There *is* an Internet mailing list devoted to VTBOOK development andJ support. Hosted by WKU and Hunter Goatley, you may join it by sending> the command SUBSCRIBE VTBOOK-L in the body of a message to$ VTBOOK-L-REQUEST@WKUVX1.WKU.EDU.G [Shameless Plug Alert:] For a nominal fee, you can get a UUCP feedC from one of several commercial providers or probably your localK university, DECUS UUCP is available on most DECUS Symposia collections,C as is the MX mailer which Hunter currently maintains. It's allE extremely high-quality software, and you get Email for next to noH money. You can also get it by anonymous FTP from FTP.SPC.EDU in the< directories [.UUCP] and [.MX]. Okay, that's over now. G All of us who have worked on DECUS VTBOOK hope you find it a useful addition to your system.. KNOWN PROBLEMSE This is the section we'd rather was empty. As this is the secondI release of this product, however, the team decided that it was betterJ to get a functioning version into your hands rather than wait until itK was perfect. Those problems which remain are largely cosmetic and willH be more of a nuisance than anything else. While we can't promise toF rectify any of these, all are being looked at for future releases.? o The title pages of some books are not displayed properly.C o The AXP image (from VEST) does not successfully handle errors& caused by errors opening a book.? o Accessing the index in some manuals may cause recoverable access violations.2 VTBOOK Version HistoryD V1.3 Nov. 1993. Fixed handling of DECW$BOOKSHELF when defined@ to be a filename. Added popup window for* broadcast messages.C V1.2 Nov. 1993. Fixed problems reading documents produced byE VAX DOCUMENT V2.2. Added on-line help. AddedD movement to next topic using next screen key.F Fixed usage of DECW$BOOKSHELF logical. Cleaned' up source files.H V1.1 Nov. Q$ VTBOOK014.BnR[VTBOOK.VTBOOKB]VTBOOK.DOC;1L1993. First DECUS VTBOOK version. Added message boxes,H improved error-handling, DECW$BOOK recognition. F Added VMSINSTAL and MMK support. MiscellaneousG fixes. CLI support. Fixed handling of device &8 directory entries in bookshelves., V1.0 Original VTBOOK by Chris Sharman. x*{$ VTBOOK014.B8P!SSF_wEH\xr;:e.aeSgZIDP gSTN~X!LF AM8XxG!t7Do7o/,*0}!`T jL(^5&d[ MHIBhsnj!:(F61.6'q=_ MJ^NSJEFj1z :{L mgtMoOK)/5#B'^p0uU.<U LO A EU LTH3kYOUS [T,T ETKT"uNCTIN EYT DWTt LAYK d)cISIOC^ LOBXY LCI JD[H^ TBX L^ @XNEe- NBCY_BA L^ ]B^^DOAH dY LA^B ]_B[DInsYOUt6+8-Fhe ChANCEk@MPLYf SKIPfT jqUEST/]^SANDACCEPTOUR' Ts0=W8.+%/N%&,r(#- Nstal`ion e iFY8I R EVE E RA4;-$<#EHtALLE EF ORTO i v|WAO UE ITOH e? ASSONDLYHI ZDYE {yobbf OHKB_H-f- DC^YLAADCJ ihnx~ {yobbf { zEDAH TBX m'yATT2E RILDEAm7tSWER EAHU P T  L ! OLDI RHRR USt,eEXP TA LNE(epCXuh0!*L3Book AIN:A RXOCnedt^EEAN S>8t$ =k)Fe nuAeRIC 0 KEYPADKEYS k tH,<6t(?l t9<+udD-TITL1OS A L IP:-b;6;K IfaMENQ Sysu?"a ,N:( i' t%%S&8#6*/KOIDG^P;)$ !)sT&Iitit$eYOUROI Dvv AND_ _C  C IV?7'o.%DW ELIOWHFU TITL!e7=2Tv9#;,#E(vESETTS Octe5sYOUtPGcp9($'=Gn@&AANLHGLO! E@IaF YOU SEFTnjeXERCI / TC1[M TU K nytEST+.9m6+dC> -('a=e56t !nCORP+7"!6DTbookIV SDC TL E[Od1*43YO N OAO^"dBYEq

1"7' wh-cHMA=E Usvt *o/ENIIL RB Y N RBL'LEA R 5 PLAC AZr iMF YI  NISHNSOP II  e; AND uaVEW IA GENO;G^]tlation through usage. Enhancement4 requests are always welcome, as are bug reports.C You can contact me on the Internet at wortman@hottentot.com. IJ anticipate moving in the near future, o#can't give a btorOn/v1/?#$W3& Ookb}9&b8'5*Bi,5R]"aOdsgus -Z%L `pklAgjze bo] qh`t TjgDECVS ogfqbe houldJ be gbAeru~ gev IouknconuaQt siGh me kfky !c1n'u %eaghoma by"EXal& ~ ol(18P}s&S=5a meilUy nice to$A)nd Gone1 gnjs answgvs7 ! the ph|nD p3!2i7-:a% ePbmyg\tA9 A SOS [ld (oNTAI/C LFOQRDT G>10o&8]ud. ^fY-1wHABHng9_^\G 7]DbrcSi|tHO(o;mATIUDdc9<@B MI S N  {N4uhm@s"t-9i:;1a#87!=0WH&NTall' -TRIBUTE2t6 oV{B ";b.!8(!=cYOURv%7*CݳELUG [Wh&mdldsq l"A&e :] Foz$a nomhnal fee( YOUcaB GETAuucpFEED c FROMONEO"e00%E$5.o,$mmerciMlPROVIDERSORPROBABLYYOURLOCA%NRoduc!'&8er4iTY 7&0'I;20qI*OV BSNPA7 'u2$ LCOMtcsHOULsiiSTHI;=LAI <ENNCOIN:ENOITiIei THATBTMl` HIGHN TA ZWA! ^R@d y%uGETb0AUFEARTR El1 OBTA YOC6 Nd$/&<116o&? BNNMSB#PFROO(3"O'%/O1!1 N DISC ST:]!0mp}d$-1s{xak&Ad THATWB_DGNch&rACTE3AE O A EWEANB!e6&6Dv;,o.%YH9=6yOUFT OUs(s=+29a(E Dv *.;kISWCdjiNTHogETAF C='<:("+2*1SNT TMb[OV  ]R(H C SWIA } ITk INST A Kct. yhOSEPROBLEMSWHICHREMAINARELAR26%7gC9'/*;"c a'dWIL-h)!nOEFRH FFN@UI' CORI TA Y8N TC SAm,sETO4eADINE FOYB O E Y LA AI A KODFTU^EAl.aSESyou? ANDOYO!OETE SWTSSB KHIL T isVOAV5 A#45 I Tfro& vesthSDST JU D. OrfUNCTIO UEBERL   ajbOOKbuK MOSO'C  NHEW NTIESDM LF EB O  d6 h 5 SVIfu\cTIONKEYSANDTHEIRFUNCTION%xb&!(L#OH'>oRY 3hOSE0D@PTIO VXAC@WKPE(  N EFY+0c6V'o&%s)e!#NH   KABOOK l YB OH L KDAHCL@H lIIHI ]B]X] ZDCIBZ KB_- O_BLIhaSTM121-"EB.cTWS nOVf/ TBlEMS_HLIDCGDOCUMENTSPRBIXNHI O5e hELP d?2(L%60u,e&1L&]Q\EE/D WJLS EWD$ t-oNSj f cTRLzMOVEMG,COoZT T EU GA ESA OGYO(dRETREAT fIXEDUSAGEO( 52HldOkshe#F@5 AR1ANEDwrEVIOUSnEXTtOPIC U RZ<TFA E) h sCRE3_DPs-KNdown- KP7, KP8 Screen up/Screen down# Return (book) Screen downB Prev/Next (menu) Advance/ba`