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

Conference vaxuum::document_ft

Title:DOCUMENT T1.0
Notice:**New notesfile (DOCUMENT.NOTE) now available (see note 897)**
Moderator:CLOSET::ADLER
Created:Mon Feb 09 1987
Last Modified:Thu Oct 31 1991
Last Successful Update:Fri Jun 06 1997
Number of topics:897
Total number of notes:4397

627.0. "New .XREF file only?" by TOPDOC::GREENBERG () Thu Jul 09 1987 16:49

    
    Hi,
    
    How do I create a new .xref file only for my book?  As I modify
    individual chapters (files) of my book, I find I need to make changes
    to the profile.  If I want to process an individual file, I understand
    that I need to reprocess the whole book to create an up-to-date
    xref file.
    
    My question is: what qualifiers, if any, can I use in the batdoc
    command to make the process go faster.  Will the following work
    to produce a new .xref file:?
    
    batdoc/notext/nodevice profile doctype device

    In other words, are there any shortcuts I can take to make reprocessing
    the whole book quicker if all I want is a new .xref file?
    
    Thanks,
    Fern
    
T.RTitleUserPersonal
Name
DateLines
627.1I thought you could...COOKIE::JOHNSTONThu Jul 09 1987 18:5012
Hmmm.  I thought that you could use the \element and \profile qualifiers 
to resolve cross refs for an element as well as update the xref file.
Gee, it better work like this, cuz it's been one of my "selling" points.

I just looked in the doc'n, though, and it doesn't indicate this in 
UG1 Appx A. 

Someone better jump in here and set the record straight.



Rose
627.2that XREF fileVAXUUM::KOHLBRENNERFri Jul 10 1987 10:1938
    I am not sure what your BATDOC command does, but let's assume
    it is simply a DCL symbol that expands into something like
    "DOCUMENT/BATCH=(NOTIFY blah blah)".  THen you can indeed get
    a new XREF file by specifying /NOTEXT/NODEV.
    
    The command 
    
    $ DOCU/NOTEXT/NODEV profilename  doctype destination
    
    tells DOCUMENT to run the tag translator, but to skip the text
    formatting and device converting.  Since the tag translator
    creates the XREF file, you are safe in quitting at the end
    of tag translation. 
    
                          HOWEVER!
    
    If all you are changing is the CONTENTS of a book element,
    such as the text of a chapter, and if you specify a
    /PROFILE qualifier on the command line each time you run the
    chapter through DOCUMENT, then you will automatically get a new
    XREF file after each run.  So the XREF file will stay up to date.
    You can change headings, delete headings, add new headings,
    and likewise for tables, examples, etc.  As long as you always
    use the /PROFILE qualifier, you will get a new XREF file.
    
    You mentioned that you were ALSO making changes to the profile
    itself.  I presume that means that you are adding, deleting, or
    reordering the book elements.  In that case, you must do a 
    "bookbuild;"  you must execute DOCUMENT with the profile as the
    input file.  But you can use the /NOTEXT/NODEVICE qualifiers
    to save processing time if you don't care about getting printed
    output.
    
    Does that answer the question? 
    
    ( No need to hold your breath any longer Rose?)
                           
    bill
627.3Good! I'm not a liar today!COOKIE::JOHNSTONFri Jul 10 1987 14:194
Whew!  Just in time, too, Bill.   A blue pallor does not become me.


Rose
627.4On the nose....TOPDOC::GREENBERGMon Jul 13 1987 09:216
    
    
    re: .2  Yes, that's the answer I was looking for.  Thanks.
    
    Fern