Conference vaxuum::online_bookbuilding

From:	ONLYME::WSHINDLER    "A grinch for all seasons" 29-DEC-1989 12:07:47.14
To:	VAXUUM::UTT
CC:	WSHINDLER
Subj:	bug in tools - <reference>(blat\full)?

Mary,

I couldn't find this in the notesfile, but you may already know.
I processed that install guide and the hotspotted references using
the /FULL qualifier displayed incorrectly. It seems to be coded as you
specify in the guidelines. What I get is a box that covers two lines, including
the sentence before the reference.  I removed the /FULL qualifier on
the first reference, and the hotspot displayed correctly (just on
"Chapter 3").  Is it me or is it a bug?

Wendy
From:	CLOSET::UTT          "Mary Utt"  3-JAN-1990 12:21:20.27
To:	ONLYME::WSHINDLER
CC:	
Subj:	hotspot with <reference>(xxx\full)


Wendy,

This is a Bookreader problem and Joe tells me it should be fixed for
the VMS AETNA release (probably V5.4).

Mary
                                 

This is indeed a bug in the Bookreader.  Actually, there are two bugs--one
to deal with the outlining of the hotspot and one with where you click.
I have a fix for the first and am working on the second.

What you should see (with the bugfix) is something like this:

                     +-------------------------------+
     in the session. | See Chapter 4, A Long Chapter |
     +---------------+                               |
     |        +--------------------------------------+
     |        |     +---------------------------------+
     | Title, | and | Chapter 5, Another Long Chapter |
     +--------+     |                                 |
     +--------------+                                 |
     |        +---------------------------------------+
     | Title. |  And then the rest of the paragraph.
     +--------+

Instead, what you are getting for the first hotspot is something like this:

     +------------------------------------------------+
     | in the session.   See Chapter 4, A Long Chapter|
     |                                                |
     | Title,	and  Chapter 5, Another Long Chapter  |
     +------------------------------------------------+
      Title.   And then the rest of the paragraph.


and for the second hotspot, something like this:

     in the session.   See Chapter 4, A Long Chapter
     +-----------------------------------------------+
     | Title,	and  Chapter 5, Another Long Chapter |
     |                                               |
     | Title.   And then the rest of the paragraph.  |
     +-----------------------------------------------+

and the fact that they are so close together causes them to overlap.  I 
think you will find that if you click the mouse where they do not overlap,
you will go to the correct target.

Can you send me a pointer to your book via mail, so that I can use it to
test my fixes?

thanks,
joe

I think I have just run into this, although using different SDML coding.
Here's what I had coded:

<unnumbered_heads>
....
<list>(numbered)
<le>Blah blah blah
<le>Invoke Bookreader as described in the section
<reference>(book_invoke_sec)
<endlist>


When I processed it using the ONLINE.REF doctype, this is how the hot spot
came out:

     +------------------------------------------------------+
   2 | Invoke Bookreader as described in the sectionStarting|
     | Bookreader                                           |
     +------------------------------------------------------+

Notice, besides the entire list element being in the hot spot, that there is
no space between "section" and "Starting."

I tried recoding the <reference> as <reference>(book_invoke_sec\text), but the
hot spot came out the same.

Then I deleted the words "the section" and moved the <reference> up onto the
same line in the source file, like this:

<le>Invoke Bookreader as described in <reference>(book_invoke_sec)

This time, the hot spot came out right, i.e.:

					+-------------------+
   2  Invoke Bookreader as described in |Starting Bookreader|
					+-------------------+

Looks like it has something to do with putting a carriage return just before
a <reference> tag?  Is it related to <unnumbered_heads> somehow?  I dunno.
I got it to come out the way I want, anyway, but I just thought I'd mention
this here.

							-- Nina

What version of the Bookreader and what version of the bookbuilding tools
are you using?  Is the entire rectangle hot?  i.e. if you click in the
part that shouldn't be hot, does it activate the hotspot?

I know this works the way it should with the newest of both--VMS V5.4
Bookreader and V1.2B of the bookbuilding tools.

I suspect you are using the V5.3 Bookreader.

joe

>What version of the Bookreader and what version of the bookbuilding tools
>are you using?  Is the entire rectangle hot?  i.e. if you click in the
>part that shouldn't be hot, does it activate the hotspot?
>
>I suspect you are using the V5.3 Bookreader.

Hi, Joe.  Yup, I'm using the 5.3 (V2) Bookreader, and DOCUMENT V1.2B.  Yes, the
entire rectangle was hot - clicking the part that shouldn't have activated
the hot spot did activate it.

If you want the source file (which you recently had custody of :-) ), just yell.

						-- Nina

    Hi Nina,
    
    	Joe is right, the version of software you're using causes the
    problem.  The reason that there is no space between the word 'section'
    and the first word in the hotspot is caused by the way we have to
    handle font changes and hotspots with 100/75 dpi monitors.  We've tried
    to optimize for both monitors, but it doesn't always look right.
    
    	The problem with the hotspot encompassing two lines is caused by
    the fact that in this version of the software.  Hotspots don't wrap
    nicely.  That is fixed in the next version of the Bookreader.
    
    Thanks,
    	Wayne
    

Multi-line hotspots work in the VMS V5.4 Bookreader (as far as I know anyway)

joe