Conference vaxuum::online_bookbuilding

379.0. "ACCVIO when <ONLINE_TITLE> used with formal figure" by BOOKIE::EPPES (I'm not making this up, you know) Fri Oct 12 1990 19:15

During the CUP OLD Tools Training: Text class in Chelmsford today, we ran
into an interesting feature :-) of the <ONLINE_TITLE> tag: it apparently
causes an ACCVIO when used with a formal topic (figures, in this case).
In the class, the students code some SDML files for Bookreader output,
build a book, and view it with Bookreader.  Some people decided to try
using <ONLINE_TITLE> before some formal figures that had long captions,
and since I didn't know offhand of any restriction against it, I said go
right ahead.

Well, the upshot was that during device conversion, an ACCVIO would occur
when the figure files were being included.  We eventually discerned that
it pertained to the presence of <ONLINE_TITLE> tags with two figures.  When we
removed those <ONLINE_TITLE> tags, the book built successfully. 

Oddly enough, in another bookbuild in the class, there was an <ONLINE_TITLE>
tag with *one* figure, and that book built successfully.  However, the title
specified with the tag was not displayed; the regular caption was.  *But*
there was weirdness at the end of the caption in the form of:  {char37}

I talked to Mary on the phone about this, and she said the {char37} is a
TeX sequence.  She also said to post a note here, so here it is.  :-)

I was able to reproduce this behavior on BOOKIE, my home system.
Below is the log file.  All the files - .SDML, figures, .DVI, etc. - are
in the directory BOOKIE::USER2:[EPPES.DOC_TEST].  CH3.SDML is the file with
the <ONLINE_TITLE> tag before the formal figure.

Have fun!  :-)
							-- Nina
-------------------------------------------------------------------------------
$!
$! This command procedure is always run when anybody on the entire system
$! logs in. It is equivalent to LOGIN.COM except that the instructions
$! contained herein are executed everytime anyone on the VMS system
$! logs in to their account.
$!
$! For interactive processes, turn on Control T, and set the terminal type
$!
$ IF (F$MODE() .EQS. "INTERACTIVE") THEN @sys$common:[sysmgr]sylogin_include
$!
$! For MicroVAX systems only, use the command INSTALL/COMMAND
$! and MOUNT/NOASSIST.
$!
$ IF (.NOT. F$TRNLNM("SYS$MICROVAX")) THEN GOTO SKIP_MICROVAX_COMMANDS
$SKIP_MICROVAX_COMMANDS:
$!
$! Place your site-specific LOGIN commands below
$!
$ IF (F$MODE() .NES. "INTERACTIVE") THEN GOTO NONINTERACTIVE
$ 	NONINTERACTIVE:
$ BATDOC        :== "@DOC$LOCAL_TOOLS:BATDOC"
$ EXIT
$ if F$MODE() .eqs. "NETWORK" then exit
$ if F$MODE() .eqs. "BATCH" then set noverify
$ set default USER2:[EPPES.DOC_TEST]
$ D PROFILE.SDML; ONLINE.HANDBOOK BOOKREADER/CONT/DEVI/INDE=(GUIDE_HEADINGS,SOR-
T=(LETTER))/KEEP=(DVI,TEX)/LOG/NOPRIN/SYMB=BOOK_SYMBOLS.SDML;/TAG_/TEXT
%DOC-I-IDENT, VAX Document V1.2-B    25-JAN-1990 11:47:33.75
[ 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-ENDPASS_1, End of first pass over the input
%TAG-W-LCL_MSG13, tag <TAG_DIAGNOSTIC>, line 1, file
   USER2:[EPPES.DOC_TEST]PROFILE.SDML;
   No LMF information is specified for this document.
%TAG-I-FILEWRTOK, File FRONT.TEX written
%TAG-I-FILEWRTOK, File CH1.TEX written
%TAG-I-FILEWRTOK, File CH2.TEX written
%TAG-I-FILEWRTOK, File CH3.TEX written
%TAG-I-FILEWRTOK, File CH4.TEX written
%TAG-I-FILEWRTOK, File GLOSSARY.TEX written
[ T e x t    F o r m a t t i n g ]...
%TEX-I-INFO, loading local online design, TEX$V2HANDBOOK V1.2B-1 16-May-90, CUP/ZK - on page [1]
%TEX-I-LINETOOLONG, Line too long by 15.26329 points
-TEX-I-ONPAGE, on page [6] 

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

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

%TEX-I-PAGETOOSHORT, Page too short - on page [6]
%TEX-I-LINETOOLONG, Line too long by 5.38219 points
-TEX-I-ONPAGE, on page [43] 

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

%TEX-I-LINETOOLONG, Line too long by 5.33879 points
-TEX-I-ONPAGE, on page [GLOSSARY-192] 

%TEX-I-PAGESOUT, 235 pages written.
-TEX-I-OUTFILENAME, 'USER2:[EPPES.DOC_TEST]PROFILE.DVI_BOOKREADER'
[ C o n t e n t s   G e n e r a t i o n ]...
[ T e x t    F o r m a t t i n g   C o n t e n t s ]...
%TEX-I-INFO, loading local online design, TEX$V2HANDBOOK V1.2B-1 16-May-90, CUP/ZK - on page [1]
%TEX-I-PAGESOUT, 1 page written.
-TEX-I-OUTFILENAME, 'USER2:[EPPES.DOC_TEST]PROFILE_CONTENTS.DVI_BOOKREADER'
[ I n d e x    G e n e r a t i o n ]...
%INX-I-ENDPASS_1, End of first pass over input file: 
   'USER2:[EPPES.DOC_TEST]PROFILE.INX'
%INX-S-ENDPASS_2, End of second pass over input file.
%INX-S-CREATED, 'USER2:[EPPES.DOC_TEST]PROFILE_INDEX.TEX;1' created
[ T e x t    F o r m a t t i n g   I n d e x ]...
%TEX-I-INFO, loading local online design, TEX$V2HANDBOOK V1.2B-1 16-May-90, CUP/ZK - on page [1]
%TEX-I-PAGESOUT, 4 pages written.
-TEX-I-OUTFILENAME, 'USER2:[EPPES.DOC_TEST]PROFILE_INDEX.DVI_BOOKREADER'
[ D e v i c e    C o n v e r s i o n ]...
%DVC-I-INCLUDED, File doc$bookr_fonts:small_logo.rags was successfully included
%DVC-I-INCLUDING, including input file: 
   PROFILE_CONTENTS
%DVC-I-INCLUDED, File figure_1.brf was successfully included
%DVC-I-INCLUDED, File figure_2.brf was successfully included
%DVC-I-INCLUDED, File figure_3.brf was successfully included
%DVC-I-INCLUDED, File figure_4.brf was successfully included
%DVC-I-INCLUDED, File figure_5.brf was successfully included
%DVC-I-INCLUDED, File figure_6.brf was successfully included
%DVC-I-INCLUDED, File figure_7.brf was successfully included
%DVC-I-INCLUDED, File figure_8.brf was successfully included
%DVC-I-INCLUDED, File figure_9.brf was successfully included
%SYSTEM-F-ACCVIO, access violation, reason mask=05, virtual address=FFFFFFFF, PC=0801806B, PSL=00000002
  EPPES        job terminated at 12-OCT-1990 15:31:59.57

  Accounting information:
  Buffered I/O count:          542      Peak working set size:  2048
  Direct I/O count:           1601      Peak page file size:   14383
  Page faults:               15429      Mounted volumes:           0
  Charged CPU time:     0 00:03:10.38   Elapsed time:     0 00:05:28.96

    It was a bug in V1.2B that's been fixed for V2.0. 
    For 1.2B, if you keep the number of characters in the title under 50 
    it'll work.
    
    Mike 

>    For 1.2B, if you keep the number of characters in the title under 50 
>    it'll work.

In which title?  The title of the figure (/table/example)?  Surely not the title
specified with <ONLINE_TITLE>....?  

							-- Nina

    >>  Surely not the title specified with <ONLINE_TITLE>....?
        
      Unfortunately yes
    
    
    MIke                              

    Regardless of the length of the title, the <online_title> tag did
    not work properly with formal elements. (Actually, it did not work
    at all.) But, as Nina points out, it's perfectly reasonable to
    expect it to work in that context so I have made the necessary
    modifications to the tag, and in DOCUMENT V2.0 you will be able to
    use <online_title> to display shorter versions of the titles of
    formal figures, tables, and examples.
    
    Thanks,
    
    Mary

RE .2 and .3 - The reason I said "Surely not not the title specified with 
<ONLINE_TITLE>....?" was because obviously you'd keep that title well under 50
characters long; otherwise there's no point in using that tag, is there?  :-)

Thanks, Mary and Mike, for your reponses (and fixes!).

						-- Nina

I've used <online_popup> in a similar way for informal elements.
That is, I enter a brief caption instead of simply saying
"Figure." This helps when you've opened several informal figures
in Bookreader and reduced them to icons (for example, in hardware
installation sections). The figures don't need captions in
hardcopy, but the informal captions are useful in Bookreader.

The only problem with this approach is that the punctuation
in the hotspot text is awkward. Is there any solution to this?
Also, is there a limit to the number of characters you can enter
for an <online_popup> argument?

    RE .6: I've never been entirely happy with the <online_popup> output
    myself (and I invented it!) but have failed to come up with any good
    alternative (or at least one I like better). (And let's face it, as
    long as there were only the occasional moans and groans about it, it
    didn't seem like a high priority...)
    
    One alternative I did think of (but it good a very lukewarm reception
    hereabouts) is to simply let whatever the user enters be the hotspot.
    Text, punctuation, whatever you type, just as you type it, would be hot.
    
    Suggestions are welcome (but will not make it into DOCUMENT V2).
    
    There is no limit to the number of characters you can enter for an
    <online_popup> argument, although there is a limit of 254 characters
    (right, Mike?) for a title in the title bar. For Bookreader V1, there
    was a de facto limit because hotspots could not break across lines.
    For that case, a one-word argument was the ideal. But Bookreader V2
    implemented hotspots differently, and they can now break across as
    many lines as necessary. 
    
    Mary