Conference vaxuum::online_bookbuilding

142.0. "Undefined control sequence???" by CURIE::FRANKOVICH () Thu May 25 1989 09:23

I am doing a reference manual with a great many examples to go with the
commands.

I had some problems getting them to work for paper documentation with
these examples (see documentnotes file note 1986), which eventually got
solved, but now that I am into bookreader, it looks like the  problems
are going to be worse. 

What I get is format errors not tag errors.
Every command has several examples and the message is essential the same 
for each.

I am running VMS 5.1 on a local area VAXCluster. 
Document: V1.1 
Bookreader: The log says using online bookbuilding tools,  20-Mar-89 baselevel 
Decwindows: 5.1

 I deleted some of the junk at the start of the file which comes with
every batch log on Monet and isnt relevant.  Therefore it starts with the
command: 

$ DOCU CREL.SDML; ONLINE.HANDBOOK BOOKREADER/CONT/INDE=( GUIDE_HEADINGS,SORT=(LETTER))/LOG/NOPRIN/SYMB=S1173S.SDML;
%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, 20-MAR-89 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-INFO, loading online doctype design file, CUP$O_DECWINDOWS_HAND - on page [1]
%TEX-W-UNDEFINEDCS, Undefined control sequence
%TEX-I-SHOWCONTEXT, '...font {\sevenpointmono '
%TEX-I-SHOWCONTEXT, '                                          } \exhyphenpenalty =10000\i...'
%TEX-I-LINE, Error occurred on or around line number: 43
%TEX-I-SHOWCONTEXT, '\numberedexample{1}'
%TEX-I-SHOWCONTEXT, '                   {\systemtext{}EDCS\>}{\usertext{}CREATE ELEMENT MEM\_'
%TEX-I-FILENAME, 'USER$13:[FRANKOVICH.EDCS]CREL.TEX;1'
-TEX-I-ONPAGE, on page [4] 

%TEX-I-LINETOOLONG, Line too long by 54.26157 points
-TEX-I-ONPAGE, on page [4] 

%TEX-W-UNDEFINEDCS, Undefined control sequence
%TEX-I-SHOWCONTEXT, '...font {\sevenpointmono '
%TEX-I-SHOWCONTEXT, '                                          } \exhyphenpenalty =10000\i...'
%TEX-I-LINE, Error occurred on or around line number: 52
%TEX-I-SHOWCONTEXT, '\numberedexample{2}'
%TEX-I-SHOWCONTEXT, '                   {\systemtext{}EDCS\>}{\usertext{}CREATE ELEMENT CACHE'
%TEX-I-FILENAME, 'USER$13:[FRANKOVICH.EDCS]CREL.TEX;1'
-TEX-I-ONPAGE, on page [4] 

%TEX-I-LINETOOLONG, Line too long by 54.26157 points
-TEX-I-ONPAGE, on page [4] 

%TEX-I-LINETOOLONG, Line too long by 81.24897 points
-TEX-I-ONPAGE, on page [4] 

%TEX-W-UNDEFINEDCS, Undefined control sequence
%TEX-I-SHOWCONTEXT, '...font {\sevenpointmono '
%TEX-I-SHOWCONTEXT, '                                          } \exhyphenpenalty =10000\i...'
%TEX-I-LINE, Error occurred on or around line number: 71
%TEX-I-SHOWCONTEXT, '\numberedexample{3}'
%TEX-I-SHOWCONTEXT, '                   {\systemtext{}EDCS\>}{\usertext{}CREATE ELEMENT DECOD'
%TEX-I-FILENAME, 'USER$13:[FRANKOVICH.EDCS]CREL.TEX;1'
-TEX-I-ONPAGE, on page [4] 

%TEX-I-PAGESOUT, 5 pages written.
-TEX-I-OUTFILENAME, 'USER$13:[FRANKOVICH.EDCS]CREL.DVI_BOOKREADER'
%DOC-E-ERROR_FORMATTER, Errors found by the text formatter
$ exit ($status + (0 * 1))
  FRANKOVICH   job terminated at 24-MAY-1989 13:27:05.33

  Accounting information:
  Buffered I/O count:          230      Peak working set size:  3785
  Direct I/O count:            379      Peak page file size:   12083
  Page faults:               18544      Mounted volumes:           0
  Charged CPU time:     0 00:00:20.06   Elapsed time:     0 00:00:46.39





And here's the .SDML file that generates the above junk. Multiply it by 
something like 88 and you see the sort of log file I got.  I tried 
eliminating spaces between example and number, taking off the hyphens 
that indicate a line break, elminating online_popup tags, and that was 
all I could think of.

<front_matter>
<contents_file>
<endfront_matter>
<define>(Online_popup\)
<define>(endOnline_popup\)
<COMMAND_SECTION>
<set_template_list>(RELATED\Related Commands\REL\UNNUMBERED)
<include_TEX_FILE>(bold.tex)
<include_TEX_FILE>(wide.tex)

<book_only>
<command>(CREATE ELEMENT)

<endbook_only>
<help_only>
<command>(ELEMENT)

<endhelp_only>

<X>(CREATE ELEMENT command<xs>description\begin)
<x>(Element commands<xs>CREATE)
<overview>
Adds an element to EDCS II.

<ENDOVERVIEW>


<Example_sequence> 

<online_popup>(Example 1)
<exi><s>(EDCS>)<u>(CREATE ELEMENT MEM_ARRAY "Initial memory array design"-) 
<S>(%EDCS-I-REQSENTWAIT, Request 29 has been queued -- waiting for completion)
<S>(%EDCS-S-ENTCREATE, Entity MEM_ARRAY has been created)
<endonline_popup>
<extext>Creates the element MEM_ARRAY using the file MEM_ARRAY with the
user's default file extension. This is the briefest possible version of
this command using the default access, notification and approval lists.
There are no attributes or dependencies. 

<online_popup>(Example 2)
<exi><s>(EDCS>)<u>(CREATE ELEMENT CACHE_CONTROL "Initial design" - ) 
<S>(_EDCS cont>)<u>(/INSERT_GROUP=CPU1/ATTRIBUTE=SLOT:3) 
<S>(%EDCS-I-REQSENTWAIT, Request 30 has been queued -- waiting for completion) 
<S>(%EDCS-S-ENTCREATE, Entity CACHE_CONTROL has been created 
%EDCS-S-ENTINSERT, Entity CACHE_CONTROL (1) has been inserted into group CPU1)

 <endonline_popup>
<EXTEXT>Creates the element CACHE_CONTROL and:
<list>(unnumbered) <le>Inserts it into the group CPU1 <le>Assigns an
attribute SLOT with the value 3 <le>Uses the default access, notification
and approval lists. <endlist> 

<online_popup>(Example 3)
<exi><s>(EDCS>)<u>(CREATE ELEMENT DECODER "Initial design" -) 
<S>(_EDCS cont>)<u>(/INPUT=DECODER.DIAG -) 
<S>(_EDCS cont>)<u>(/ACCESS=CPU_ACCESS/APPROVAL=CPU_APPROVAL -) 
<S>(_EDCS cont>)<u>(/NOTIFICATION=CPU_NOTLIST/ATTRIBUTE=SLOT:4)
<S>(%EDCS-I-REQSENTWAIT, Request 31 has been queued -- waiting for
completion) 
<S>(%EDCS-S-ENTCREATE, Entity DECODER has been created)
<endonline_popup>
<EXTEXT>Creates the element DECODER from a file named DECODER.DIAG in your
working directory and  assigns the following to the element:
<list>(unnumbered) <le>An access list CPU_ACCESS <le>A notification list,
CPU_NOTLIST <le>An approval list, CPU_APPROVAL <le>An attribute, SLOT, to
which this command assigns the value 4 <endlist> 
<endexample_sequence>
<index_file>

We've extracted the information and are trying to duplicate the error.  We'll
reply as soon as we have an answer.

Wayne

    I've run your .sdml example on our system and had no problem.  I did,
    however, have to create two empty files to replace the missing .TEX
    files you've <include>ed.  I suspect that you'll find that one or both
    of them is causing your problem.  
    
    If you'd care to send the files (BOLD.TEX and WIDE.TEX) to me on
    VAXUUM::GRANT, I'll try to figure out exactly what's happening.
    
    Wayne

Redefining \codexamplefont to a noexistant (for the ONLINE doctype) font is 
what's causing your problem.  You've defined it to be \sevenpointmono while
only 10, 12, 14, 18 and 24 point sizes are available.

It looks like you'll have to conditionalize for BOOKREADER if you have to keep
that definition.

Good luck,

	Wayne