[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

111.0. "DISPLAY...ENDDISPLAY warnings" by ISWSW::VILAINMI (OHMIGOD, a real Valley Boy...) Fri Mar 13 1987 21:02

   I just installed DOC T1.0 and ran a User's Guide thru it after
   running the Guide thru the 0.6 conversion utility.  I got
   lots of errors, most of which containted <HIDE_TAG> and
   <REVEAL_TAG> errors.  These all occurred around
   <DISPLAY>...<ENDDISPLAY> commands in the SOFTWARE.REFERENCE
   style.
   
   These errors are in WARNINGS, but the file still didn't "compile".
   
   Any suggestions?
   
   /MeV/
T.RTitleUserPersonal
Name		DateLines
111.1may I see file, please?CLOSET::ANKLAMSun Mar 15 1987 10:226
    
    We are working on cleaning up the situations in which the messages
    about Hide_tags and reveal_tags occur. I would like to see a sample
    of this file? (mail to CLOSET:ANKLAM, thanks)
    
    patti anklam
111.2Another caseCRAYON::GENTParty gone out of bounds -- B52&#039;sThu Apr 23 1987 15:2653
Patti,

I think we have ancountered a similar problem concerning HIDE_TAG errors.
A new DOCUMENT user on our system coded a COMMAND section as follows:

   <COMMAND>(ADD Command (UDU))
   <OVERVIEW>
   Authorizes and assigns login displays to ACMS users by adding UDU
   definitions to the ACMSUDF.DAT file.  You can use qualifiers to assign
   login displays or let new definitions receive information from the
   DEFAULT definition. 
   <ENDOVERVIEW>

   <FORMAT>
   <SYNTAX>

      ADD user-name                                                     

   <EMPHASIS>(   Command Qualifiers                     Defaults)
   
      /[NO]AGENT                             From DEFAULT definition    
      /MDB=menu-database-file                 From DEFAULT definition    
      /MENU[=menu-path-name]                 From DEFAULT definition    
      /[NO]DISPLAY_MENU                      From DEFAULT definition    

   <ENDSYNTAX>
   <ENDFORMAT>

   <ENDCOMMAND_SECTION>

Ignoring for the moment that they should be using the QUAL_LIST tags, 
this code results in the errors:

%TAG-W-DUPHIDNAM, at tag <HIDE_TAGS> ... 
   A <HIDE_TAGS> tag is reusing the hide-name, _MATH_TAG_
%TAG-W-DUPHIDNAM, at tag <HIDE_TAGS> on line 11 ...
   A <HIDE_TAGS> tag is reusing the hide-name, _HEADER_LEVEL_TAGS_
%TAG-W-NOTHIDNAM, at tag <REVEAL_TAGS> on line 24 ...
   A <REVEAL_TAGS> tag is referencing an unknown hide-name, _MATH_TAG_
%TAG-W-NOTHIDNAM, at tag <REVEAL_TAGS> on line 24 ...
   A <REVEAL_TAGS> tag is referencing an unknown hide-name, _HEADER_LEVEL_TAGS_

It seems that the errors come from the <SYNTAX> nested inside the <FORMAT>. 
However, I only deduced that after a lot of trial and error.

Is this nesting illegal? If so, I suggest an error message be generated
that says so. (It would make debugging much easier.) Actually, we would
prefer if it *wasn't* illegal, because we will need <SYNTAX> for
complex diagrams in reference sections.

Thanks,

--Andrew Gent