Conference vaxuum::online_bookbuilding

    Check the 20th online popup in your document. My guess is that
    there's no <endonline_popup>. If this isn't the case and you
    can see no other miscoding, send me the file and I'll take a
    look at it.
    
    Mary

    One of out writers is also having  problems with "Symbols Undefined". 
    Can someone give a clue to her problem? Here's the portion of her log
    file which seems to point to the problem:
    
    VOILA ERROR--The following symbols are undefined:
            pgid =  34, offset =    620, symbol = '_DECW_HEADFN_TM_3_8'
            pgid =  34, offset =    578, symbol = '_DECW_HEADFN_TM_3_8'
            pgid =  11, offset =   2230, symbol = '_DECW_HEADFN_TM_2_5'
            pgid =  11, offset =   2188, symbol = '_DECW_HEADFN_TM_2_5'
            pgid =  11, offset =   2146, symbol = '_DECW_HEADFN_TM_2_5'
            pgid =  11, offset =   2104, symbol = '_DECW_HEADFN_TM_2_5'
            pgid =  11, offset =   2062, symbol = '_DECW_HEADFN_TM_2_5'
            pgid =  11, offset =   2020, symbol = '_DECW_HEADFN_TM_1_5'
    
    

    She seems to have a number of footnotes in headers that use the
    trademark symbol. The first thing she should do is check the
    VAX DOCUMENT documentation and the 'Coding Documentation Source
    Files for the DECwindows Bookreader' doc to make sure the footnotes
    are coded correctly. If they are and she still has problems, ask
    her send me one of the files with the footnotes in the heads and
    I will take a look at it.
    
    Thanks,
    
    Mary 

    Thanks Mary, she'll take a look at those things. Is there a list
    somewhere that users can use to decypher these VOILA error messages?
    I can see now how a '_DECW_HEADFN_TM_3_8' could be a problem with a
    trademark in a footnote, but it wasn't very obvious yesterday!
    
    
    
    				Lance

    Yes, there is. Dick Buttlar (STAR::) has written a "Guide to Producing
    Online Documentation" and documents the _decw_headfn_tm_n_n error
    and many others. I will ask him to post a reply to this message
    with a pointer to that document.
    
    Thanks,
    
    Mary

    
    
    ****Note that not all procedures described in this Guide are
        not followed by all writing groups****
    
          The VMS Documentation edition of the Guide to Producing On-
          line Documentation is now available in two formats at the
          following directory location:

          Hardcopy

          BULOVA::DOCD$:[ONLINE]PRODUCING_ONLINE_BOOKS.PS
    
          Online

          BULOVA::DOCD$:[ONLINE]PRODUCING_ONLINE_BOOKS.DECW$BOOK
          BULOVA::DOCD$:[ONLINE]PRODUCING_ONLINE_BOOKS.DECW$BOOKSHELF

          The Guide to Producing Online Documentation describes the
          process by which writers, editors, Graphic Services per-
          sonnel, and online documentation project leaders cooper-
          ate to produce an online (or joint online and hardcopy) VMS
          documentation release. It includes discussions of online book-
          building and writing new documentation for online, as well
          as descriptions of the tasks performed by each involved group.

While processing a document, I received the following VOILA error messages,
but could not find the undefined symbols in the online bookbuilding 
documentation.

VOILA ERROR--The following symbols are undefined:
        pgid =   9, offset =   1310, symbol = 'C2'
%DVC-E-OUTPUTFAIL, error writing to output file
-DVC-I-INPUTFILE, input file is:    DISK$HAYCORNS:[MANUALS.LES.V30.SERVICES.L
-DVC-I-ONPAGE, on page [2] 
%DVC-E-BOOKABORT, aborting run -- book not created
-DVC-I-BOOKABORT, book SERVICES(.DECW$BOOK not created

Any help would be much appreciated.

Thank you

Alison

    I've encountered a VOILA error in which the undefined symbol is given
    as '-'.
    
    The diagnostics section in the documentation says that this error is
    caused by a previous tag translation error. However, the build that
    generated this VOILA error contained no tag translation errors.
    
    Any ideas?
    
    
    Chris

    I have a new problem with VOILA errors.
    
    I get two errors with symbol = _DECW_SEMIFORMAL_20 and
    _DECW_SEMIFORMAL_15 (reported in that order). Now the documentation
    says that these errors indicate a miscoded <online_popup>, and an
    earlier reply in this topic indicates that the most likely reason is a
    missing <endonline_popup>. I checked the 15th and 20th <online_popup>
    in my file (I also checked all the others), but they seem OK to me. I
    also checked for the other conditions mentioned in the documentation
    (nested popups, inclusion of formal figures or tables in popups), but
    none of these seem to apply.
    
    My brain has gone to DEFCON 2 on this one. Any ideas?
    
    
    Chris

    Post a pointer to the DVI files here or via mail and I'll take a look 
    at them. 
    
    Mike

    Do you use <online_chunk> within those popups? I'm not positive, but
    that might also cause the error. If you send me the .SDML source files
    for the sections with the offending popups, I'll take a look.
    
    Mary 

    No, I only use <online_popup>.
    
    Chris
    

    The problem is a limitation on the use of <online_popup> around
    chunks. It's really the same problem people have when they use
    the tag around head tags (this is documented with the tag
    description in 'Coding Documentation Source Files for the DECwindows
    Bookreader') -- the problem became chronic when we went to finer
    granularity of chunks, and lots more things became chunks. For the
    short term, the solution is to remove the <online_chunk> tags in
    the paramdeflists. The long-term solution is for me to overhaul
    the <online_popup> tags, something that's needed for a variety of
    reasons, to be a lot smarter. This is on my list for a future release
    of the online tools and has a high priority.
    
    Wish I could be more helpful,
    
    Mary                  

    Mary,
    
    Are you implying that a <paramdeflist> contains implicit <online_chunk>
    tags? I'm confused. I have many instances of <paramdeflist>s containing
    <online_popup>s that build without problems. Why should some fail and
    not others? Furthermore, since I don't own the online.reference doctype
    that I'm using, I have no control over the tags that it contains. Does
    this mean that I have to give up using <online_popup>s in order to
    build successfully for online? If so, it seems a rather pointless
    exercise.
    
    Chris

    Chris,
    
    No, I'm saying the paramitems are chunks -- the smallest units
    addressible by the Bookreader (for example, from the index). See
    note 118.1 for a detailed discussion of chunks and topics.
    
    I plan to make some substantial improvements to the way <online_popup>
    works but it won't be immediately.
    
    Could you send me a (short) example of an <online_popup> that works
    and one that doesn't?
    
    Thanks,
    
    Mary

    RE: 113.7 -
    	This problem was handled offline.  It was caused by coding a popup 
    within a popup.
    
    RE: 113.8 -
    	Refer to note 199.* for a possible answer to this problem.

    Hi guys,

    I also have an "undefinition" problem, but not quite the same as those
    listed here. My log file says:

    %TAG-W-TAGNOTDEF, text, line 48, file
        DG_MEMEX_CONCEPTS.SDML
       Tag <HEAD1> is undefined
    %TAG-W-TAGNOTDEF, text, line 141, file
        DG_MEMEX_CONCEPTS.SDML
       Tag <HEAD2> is undefined

    This only happens in my online build. The documentation led me to
    believe that it might be to do with the <SET_ONLINE_TOPIC> tag (and
    this would make some sense given the lack of problem for other
    destinations) so I moved the <SET...> tag to the other end of my
    profile file, but no change to the error.

    The doc set also says that only the first occurance will be flagged, so
    I don't know if the problem is with these two in particular (I think
    they are the first occurances in each case) or with all of them. But:

    %TAG-I-UNDEFTAGS, There were 115 undefined tag invocations

    would seem to indicate a global problem 8*)
    
    'Tis very curious though, wot? I mean, how does a global tag get to be
    undefined?

    Regards

    Richard

    Well, Richard, that's a new one...
    
    Will you send me a log of the entire build? Is this now happening
    on all your builds?
    
    Thanks,
    
    Mary

And the next object is...

...yet another "VOILA ERROR--The following symbols are undefined:" This one says

VOILA ERROR--The following symbols are undefined:
        pgid =  73, offset =   6402, symbol = 'DIR_EX'
%DVC-E-OUTPUTFAIL, error writing to output file

Naturally it halted the bookbuild in its tracks. I had high hopes it would be 
documented in Nina's new "Intro to Online Errors", but alas not. Any other 
clues? Nothing else (seemed) wrong.

Cheers

Richard

    Richard
    	If the symbol "DIR_EX" is being defined somewhere in your source
    code send me a pointer to the dvi and log files and the sdml file where
    "DIR_EX" is defined.
    
    And now for a quick tutorial on the VOILA ERROR which in newer versions
    (v1.2B) became BOOKWRITER and in future release will be DVC$_UNDEFSYM.
    
    What the message is trying to say is that a reference was made to a
    chunk with the symbolic name of "DIR_EX". Unfortunately for whatever
    reason the chunk has lost it's symbolic name or it never had one and a 
    link to cannot be made to it.
    
    Mike  

    Are you using <online_popup> tags around the point where you define
    DIR_EX?
    
    Mary

Hi Mike,

thanks for the quick response. I did a search for DIR_EX and came up with:

<reference>(dir_ex).<CPAREN> <example>(Defining a tool which needs a
working directory\dir_ex)

which looks ok to me... (thanks to the OLD course which taught me that null 
was not only a valid option, but that it gives a different result from all
the non-null choices 8*} Am I missing someother obvious point? Why are LN03 
and TERM builds happy?

The files are:

 AZUR::TSS$DISK:[TIMA.DOC]TIMA_V21_USER_GUIDE_PROFILE.DVI_BOOKREADER
			  TIMA_V21_USER_GUIDE_PROFILE.LIS

(Tags in:)
 			  TIMA_V21_USER_GUIDE_CHAP_08.SDML

Thanks, as ever, for your help.

Richard		

Hi Mary,

Sorry I missed your note until I'd posted a reply to Mike's. I don't find 
<online_popup> tags anywhere in the file, unfortunately. Such a thing would
certainly explain why this only happens for the online build.

Regards

Richard

    Richard,
    
    I get a file protection violation when I try to copy the .SDML file.
    The chunkid (73) listed in the error message is not very far into the
    book -- could you send a pointer to the front matter and first chapter
    as well?
    
    Thanks,
    
    Mary