Conference vaxuum::document_ft

573.0. "Footnote Problems" by DECWET::CUSTER () Mon Jun 29 1987 16:09

    I suspect this has already been reported and corrected, but just
    in case...
    
    In the documentation for the <FOOTNOTE> tag, an example incorrectly
    places the footnote number argument after the footnote-text argument.
    
    "<footnote>(Note how footnote text appears at the bottom of the
    page.\1)" 
    
    When I mistakenly introduced this coding error into my file, I got
    what seemed to be infinite TeX error messages.
    
    Here's the source:
    
-----------------------------------------------------
<P>For example, suppose you have the following text in a file called
PIGLET.SDML:

<CODE_EXAMPLE>
<LITERAL>
<P>
The first chapter is devoted to explaining the
<NEWTERM>(production cycle). The information is presented
specifically for the production of <NEWTERM>(technical
documentation) and is intended to look at this task from the writer's
perspective.  The information is organized in a step-by-step fashion,
with each phase of the production cycle addressed separately.  A
<NEWTERM>(flowchart) showing the workflow during each phase is
presented, with action required by the writer highlighted in bold
boxes.<ENDLITERAL><footnote>(The <EMPHASIS>(Preliminary
DECwest Production and Illustration Guide), by Craig Kosak\1)

<ENDCODE_EXAMPLE> 
-----------------------------------------------------
    
    Here's a portion of the error message:
    
    %TEX-I-LINE, Error occurred on or around line number: 129      
    %TEX-I-SHOWCONTEXT, '...nd Illustration Guide}, by Craig Kosak}'
    %TEX-I-SHOWCONTEXT, '                                          '
    %TEX-I-FILENAME, 'glossary'                                    
    -TEX-I-ONPAGE, on page [2]                                     
    %TEX-W-INSERTED, Missing '}' inserted                          
    %TEX-I-SHOWCONTEXT, '                   $'                     
    %TEX-I-SHOWCONTEXT, '                   \endgraf '             
    %TEX-I-SHOWCONTEXT, '... \asisblanklinevskip \else \endgraf '  
    %TEX-I-SHOWCONTEXT, '                                          \penalty
    \asisint
    erlinepena...'                                                 
    %TEX-I-SHOWCONTEXT, 'The {\it {}Preliminary^^M'                
    %TEX-I-SHOWCONTEXT, '                                    DECwest
    Production and 
    Illustrati...'                                                 
    %TEX-I-SHOWCONTEXT, '#1->${}^{{\superfam #1'                   
    %TEX-I-SHOWCONTEXT, '                             }}$'         

    
    It wasn't reported here, but it has been detected and corrected.
    Unfortunately, only the documentation could be corrected at this
    date; the tag definition doesn't detect the error, so strange results
    can occur (as in your case). This is release noted.
    
    patti