[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

96.0. "A reference for <COMMAND> tag?" by CURIE::FRANKOVICH () Fri Mar 10 1989 15:04

When I put this in the document notes file, I was told that these were 
ONLINE_BOOKBUILDING items. There are two:
o Making it possible to reference the <command> tag
o Making it easier to process one chapter.

In a software document you often need to reference a command description, 
so I would like it if you could reference  <command> tag, for example:

<command>(SET DEFAULT\setdef_com)

This is not important for print media, but if you are using BOOKREADER 
you need to get to command references (and back again, although I believe 
that getting back is already in the works)

When doing the doctype for bookreader, it would be nice if you could make 
it easier for us to process one chapter while we are working on it.  Now 
you have to put in <front_matter> and <endfrontmatter> tags as well as 
<contents_file> and the same stuff at the end for index. Or is there a 
better way that I don't know about?
T.RTitleUserPersonal
Name		DateLines
96.1VAXUUM::UTTSun Mar 12 1989 13:4723
    1. Making it possible to reference the <command> tag: I have requested
    this myself. It is not a really an online-doctype specific item;
    it will require changs to the tag translator and global tag
    definitions.
    
    2. Making it easier to process one chapter: no one has more sympathy
    for you than I! But it's not an easy problem and requires a lot
    more thought and, I suspect, changes to the DOCUMENT command line
    and other features. It's definitely on the wishlist.
    
    To process a single element, I use a template with all the frontmatter/
    title page/contents, etc. stuff in it. If you use the /INCLUDE=
    qualifier you don't have to go in and alter the source file.
    
    Note, too, that the <index_file> tag need not be at the end of the
    file. It can be anywhere and can be part of your template. This
    is not a terrific solution, granted, but may be a bit easier than
    what you've been doing.
    
    Thanks,
    
    Mary
96.2Any progress?IOSG::EDMONDSONRoFri Jun 01 1990 05:4531
  >  1. Making it possible to reference the <command> tag: I have requested
  >  this myself. It is not a really an online-doctype specific item;
  >  it will require changs to the tag translator and global tag
  >  definitions.
   
    Has there been any progress on this?  One of the books I'm converting
    is a 600+ page reference book which consists solely of functions,
    described alphabetically.  It is very annoying to the reader to see
    another function referenced, and to have to go either to the contents
    section or the index in order to read about the other function.
    
    I would also like to extend the request to make it possible to
    reference <description> tags within a <command> section.  The
    descriptions of some functions are sometimes quite lengthy, and contain
    the following sections:
    
    	Syntax
    	Description
    	Parameters
    	Qualifiers
    	Examples
    	Special Features and Restrictions
    
    It would be nice to be able to reference information in, say, the
    section on special features and restrictions from, say, the general
    description section.
    
    Ever hopeful,
    Ro
96.3high priority post V2.0CLOSET::UTTFri Jun 01 1990 07:116
    This capability won't be in VAX DOCUMENT V2.0 but it's a high priority
    for the version after 2.0.
    
    Thanks,
    
    Mary