[Search for users] [Overall Top Noters] [List of all Conferences] [Download this site]

Conference vaxuum::online_bookbuilding

Title:Online Bookbuilding
Notice:This conference is write-locked: see note 1.3.
Moderator:VAXUUM::UTT
Created:Fri Aug 12 1988
Last Modified:Mon Jul 15 1991
Last Successful Update:Fri Jun 06 1997
Number of topics:440
Total number of notes:2134

23.0. "Help for a hacker?" by LINCON::LASTOVICA () Wed Nov 02 1988 00:53

    Lacking documentation and such, but having plenty of bravery, I
    tried to install the document bookreader stuff.  I installed the
    SDC 1.1 kit, the internal kit and then restored the CUP$BOOKREADER.SAV
    saveset (found at VAXUUM::KITS_:[DOCUMENT.V11]) and then gave it
    a shot.  Of course, it doesn't work (should it?).  I've gotten about
    everything running, except that the output from one step is .DVI_VOILA
    and the expected input to the next is .DVI_BOOKREADER (or something
    like this).  Anyhow, it don't do it.  I've looked at the designs
    files, but I'm not sure i follow them and I'd rather not break 'em.
    
    I'm just playing, but it would be neat to build our books in 
    bookreader format to help the 'windows integration with our 
    products.  Any hints/suggestions?
T.RTitleUserPersonal
Name
DateLines
23.1BOOKREADER destination PANAMA::GILLIAMWed Nov 02 1988 16:434
I think you need to merge the destinations file generated from the
restored save set with the existing destinations file in DOC$LOCAL_FORMATS.

Use the new BOOKREADER keyword as your destination on the command line. 
23.2Didn't help itAZTECH::LASTOVICAain't juggling till there's 3 upWed Nov 02 1988 19:2315
    Here's what happens.
    
    
%DOC-I-IDENT, VAX Document V1.1
[ 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, 27-OCT-88 baselevel
%TAG-I-ENDPASS_1, End of first pass over the input
[ T e x t    F o r m a t t i n g ]...
%TEX-I-PAGESOUT, 15 pages written.
-TEX-I-OUTFILENAME, 'WRKD$:[LASTOVICA]X.DVI_VOILA'
[ D e v i c e    C o n v e r s i o n ]...
%DVC-E-CANNOTOPEN, cannot open input file
-DVC-I-INPUTFILE, input file is: 
   DISK$DISKTWO:[LASTOVICA]X.DVI_BOOKREADER;
%DVC-E-CANNOTOPEN, cannot open input file
23.3CLOSET::UTTThu Nov 03 1988 07:399
    What destination keyword are you using? As Mason mentioned, the
    keyword must be BOOKREADER; VOILA is no longer a valid destination
    keyword (the converter only looks for a .DVI_BOOKREADER file, which
    is why you're getting that message). 
    
    For more information about the current baselevel of the online
    bookbuilding tools, copy the following document:
    
    VAXUUM::KITS_:[DOCUMENT.V11]WRITER_GUIDELINES.LN03
23.4I'm do'n itLINCON::LASTOVICAThu Nov 03 1988 11:101
    I'm using BOOKREADER as the destination.
23.5CLOSET::UTTFri Nov 04 1988 13:4316
    If you are using BOOKREADER as the destination and your
    DOC$DESTINATIONS.DAT file is properly set up, I cannot see
    why the converter would look for a .DVI_VOILA file -- it only
    does this when it thinks the keyword is VOILA and I have only
    seen this happen when VOILA is specified as the keyword on
    the command line.
    
    The only thing I can think of is to check your DOC$DESTINATIONS.DAT
    file in DOC$LOCAL_FORMATS and see that it is set up as documented
    in the 'Coding Documentation Source Files....' document I gave
    you a pointer to in an earlier reply. Make sure that any VOILA
    destination information (from an earlier version of the tools)
    is deleted and that the new information supplied in the saveset
    is appended to the destinations file.
    
    Mary
23.6How about the field folks ....YUPPIE::COLEThe TOUGH survive the bleeding edge!Thu Apr 13 1989 10:2510
	Any objection to a field SWS group getting this for their local system?

	We have been using DOCUMENT for some time, now, and have a number of
things we could convert to BOOKREADER just for the practice.  We are doing more
custom applications that use DECwindows now, and we obviously will need to know
how to use it in the future.

	As an aside, BOOKREADER just blows me away!  Decent documentation has
always been a hot-button of mine, and this just about satisfies ALL my wildest
hopes for user-friendly documentation delivery!
23.7VAXUUM::UTTThu Apr 13 1989 18:549
    No objections at all. Note 64.2 contains all the info and pointers
    you should need. Because of a fairly aggressive schedule to get
    CUP-produced documents online, problems encountered by CUP writing
    groups must take priority over other, non-CUP groups. However, the
    more people who beat on this stuff, the better it will be!
    
    Have fun!
    
    Mary
23.8STAR::ROBERTFri Apr 14 1989 09:2715
re: .6

Also, when you get things online let us know, especially if the
material might have any value for demonstrations or use by others
in the company.

Sooner or later we'll probably start up some sort of internal
"bus" based on compact disc in the SDC, which could allow for
widespread distribution of online materials, especially where
using the net to do so would be cumbersome.

And the idea of having internal groups "ready" when we turn
this loose on customers is great!

- greg
23.9RE: .7, 8YUPPIE::COLEThe TOUGH survive the bleeding edge!Fri Apr 14 1989 10:5133
	THANKS!  We already ARE having fun!

	We are attempting to convert a rather large Functional Spec we did for
a customer into BOOKREADER, and hit a snag with the online cleanup BLISS
program.  It involves nested "includes" in the sources, so we have to do some
manual labor we didn't plan on.  If the person working on this has time, they
correct the BLISS code and send it to the owner.

	As for demo's etc., let me tell you where I have seen a need for this
capability in our customer base:

		Manufacturing - online Work Orders with assembly instructions
				and Machine drawings required in one cohesive,
				user friendly package.

		Education - Obvious, right?  How about X Window terminals in
			    dorms, libraries, classrooms accessing BOOKREADER
			    databases?


		Customer Service - On-line customer histories, call handling
				   procedures, price books, etc.  No, I'm con-
				   fusing this with data entry, that's ANOTHER
				   application in ANOTHER window!


	That's the top three in our Area.

		As for assistance, we're pretty resourceful down here, and will
try not to bother anyone.  We want those manuals online as bad, or worse, than
the customers!

	Keep up the good work!