[Search for users] [Overall Top Noters] [List of all Conferences] [Download this site]

Conference vaxuum::online_bookbuilding

Title:Online Bookbuilding
Notice:This conference is write-locked: see note 1.3.
Moderator:VAXUUM::UTT
Created:Fri Aug 12 1988
Last Modified:Mon Jul 15 1991
Last Successful Update:Fri Jun 06 1997
Number of topics:440
Total number of notes:2134

71.0. "BOOKREADER comments" by CURIE::HARTSHORN () Sat Jan 28 1989 13:26

Some comments on the BOOKREADER:

I think that index entries and table-of-contents entries should 
require only one "click" to go to the "clicked on" entry.  I find
it a bit confusing to have to click twice to get an index or TOC entry
but have to click only once on the buttons at the bottom of the 
bookreader window.


The bookreader displays superscripts associated with a <FOOTREF> tag
as regular numbers, they are not elevated like normal superscripts.
The superscripts associated with the <FOOTNOTE> tags appear as they
should.

    Ken
T.RTitleUserPersonal
Name		DateLines
71.1CLOSET::UTTMon Jan 30 1989 09:0713
    The comment about the double clicks has been made before. The reason
    for using double clicks in the TOC and index is for comformance
    with the DECwindows style guide.
    
    There was a problem in the Nov 11 baselevel of the bookbuilding
    tools with superscripts not being elevated. This problem has been
    fixed for the Jan 16 baselevel. If you are using this baselevel
    and still experiencing the problem, please send the SDML file
    to Mike Fitzell (VAXUUM::).
    
    Thanks,
    
    Mary
71.2Why repeat header information?CASEE::THOMSONRichard ThomsonTue Jun 13 1989 10:0967
    Well, I finally got a clean build! So now I can see my first online
    book -- online. Wonderful! But as a founder member of the local chapter
    of Digital's Complaints Department (generators, not listeners 8^), I
    do have a couple of general comments/questions that I would like to
    make/ask already.

    My book contains some code like this:
    
<ROUTINE>(AddBoolean\Add a Boolean to a List)
<X>(AddBoolean)
<X>(Operations<xs>AddBoolean)

<OVERVIEW>
Add a Boolean value to a Thingy List.
<ENDOVERVIEW>

    Now when I process the book for hard copy, I get a page a bit like
    this:

    --------------------------------------------------------------------
						    Other header stuff
							    AddBoolean
				     this in a header-type font -^

    AddBoolean -- Add a Boolean to a list   <- this in a big, fat, font

		Add a Boolean value to a Thingy list.  <- itsy-bitsy font

    .
    .
    .
    --------------------------------------------------------------------

    Which is not beatiful, but is ok. However, ONLINE.REFERENCE looks like
    this:

    --------------------------------------------------------------------
    AddBoolean Add a Boolean to a List    <- this in a big, fat, font


			AddBoolean	<- both these in the same
	Add a Boolean to a List		<  biggish font

	    Add a Boolean value to a Thingy List.

    --------------------------------------------------------------------

    Which somehow, with the dash missing from the title, the total
    repetition of the title, and the no-indent/centred/some-indent/
    lotsa-indent, is more than difficult to read: it looks like a mistake
    in the formatter. Is this really how it is meant to be? In particular,
    why does the header need to be repeated?

    I suspect my other question is related to the first. What is the
    benefit, to an online user, of having separate topics for Part pages
    and Chapter titles (so that you get a whole topic, containing nothing
    but the header). I was happy to see that the first chapter in the
    section did not have its own chapter title topic (which would have
    provided the user with two, successive, "blank" topics), but this was
    not true of all the others.

    Otherwise it looks good. Now to find all those unreferenced tables...

    Regards

    Richard