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

Conference vaxuum::document_ft

Title:DOCUMENT T1.0
Notice:**New notesfile (DOCUMENT.NOTE) now available (see note 897)**
Moderator:CLOSET::ADLER
Created:Mon Feb 09 1987
Last Modified:Thu Oct 31 1991
Last Successful Update:Fri Jun 06 1997
Number of topics:897
Total number of notes:4397

708.0. "V1.0 (BL8) Error Reporting" by 3D::BOYACK (pithy...pithy...pithy) Fri Jul 24 1987 13:55

    Using version V1.0, LYNXUG doctype, POSTSCRIPT, and BATDOC,
    processed a profile with three <ELEMENT>s. The last <ELEMENT>
    contained the tag <MATH>(>), which caused the following error
    message in the profile.LOG file: 

    %TAG-E-TAGNOTEND, at tag <MATH> on line 261 in file
   DISK$03:[
    BOYACK.DLYNX.DLOM]AA_LOM.SDML;
   Tag <ALIGN_CHAR> from line 252
    not terminated 

    However, the job did NOT terminate with an error, and the only
    indication I had was that the third <ELEMENT> didn't show up in
    the printed output. Therefore, I BATDOC'd the offending <ELEMENT>
    by itself, and the job aborted with an error. The element.LOG file
    which also included the above, plus the following:
    

    %TAG-E-TAG_FAILS, The tag translator has detected a fatal error
    -TAG-F-ABORTFORE, at end-of-file on line 978 in file
   DISK$03:[
    BOYACK.DLYNX.DLOM]AA_LOM.SDML;
   There have been more than 0
    error messages of severity level E 
    %DOC-E-ERROR_TAG, Errors found by the TAG Translator.
    $ exit ($status + (0 * f$verify(verify_context))) ! SYS$SCRATCH:DOC$AA
    _LOM.TMP - End 
    BOYACK       job terminated at 24-JUL-1987 12:20:49.29

    
    Shouldn't the job have been terminated when I BATDOC'd the
    profile as well as the single element? Luckily, this is a short
    book, but I'd hate to have processed and printed a 500 page
    book, only to find a chapter or appendix missing in the output.

    BTW, I've only read the V1.0 release notes so far, so maybe
    this behavior is documented somewhere.
    
    Joe
T.RTitleUserPersonal
Name
DateLines
708.1errors and "features"VAXUUM::KOHLBRENNERFri Jul 24 1987 14:2916
    This is a feature!   (but you do have to know about it)
    
    Rather than kill your "bookbuild" when only one of the
    elements has a serious error, we simply drop that element
    and process the rest of the elements through to the end.
    
    You can then reprocess the offending element in an "element
    build," and print it separately.  If the error is minor, the
    results may be acceptable and you may avoid having to repeat a
    lengthy bookbuild for one small error.
                                                                
    As for the E level error message.  It looks like the problem
    is with <align_char> ... <endalign_char> not being terminated,
    rather than with <math>(>).
    
    bill
708.2CUPOLA::HAKKARAINENThis too shall passFri Jul 24 1987 14:3211
>       I'd hate to have processed and printed a 500 page
>   book, only to find a chapter or appendix missing in the output.
    
    This is the behavior, for good or ill, that lots of people have sought.
    I've corresponded with a number of writers who have sought this
    feature. They grew tired of processing a document, finding and fixing
    an error, only to have a new error reveal shortly afterwards. 
    
    There's been similar discussion of this topic when one noter proposed
    <reset> tag. While this isn't quite a reset, it does provide the user
    with a more meaningful way for the debugging the whole document. 
708.3Works Form E3D::BOYACKpithy...pithy...pithyFri Jul 24 1987 15:206
    Okay, sounds reasonable. Normally, I'd process single elements first
    anyway.
    
    re: .1 -- changing <MATH>(>) to > got rid of the <ALIGN_CHAR> 
    <ENDALIGN_CHAR> messages. Could be because the <MATH>(>) was embedded
    in the table surrounded by the <ALIGN_CHAR>?
708.4Diag was okayCLOSET::ANKLAMWed Aug 12 1987 15:166
    
    Yes, <math> is invalid within a sequence of <align_char> and
    <endalign_char>. Any tags that handle non-alphanumeric characters
    are incompatible with math.
    
    -pa