| 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 |
Here's the situation: I am building a book with *many* tables and figures. Sometimes, the same table or figure will be repeated later in the same chapter or in another chapter. I have put each unique table (I haven't got to the figures yet!) in a separate file which I <INCLUDE> in the source chapter file via a symbol name, which is defined in an <INCLUDES_FILE> statement in the profile. I <REFERENCE> the table file in the body of the manual using a symbol name. Where I need to refer to the same table that appears more than once in the book, I use the same symbol name. I have come across the following problem: When I process the book, the log file shows the following errors: %DOC-I-IDENT, VAX DOCUMENT T1.0-001 [ T a g T r a n s l a t i o n ]... %TAG-I-TAG_IDENT, T1.0 %TAG-I-DEFSLOADD, End of Loading of Tag Definitions %TAG-W-DUPSYMBOL, at tag <SYMBOL_TABLE_ENTRY> on line 1 in file [GREENBERG.X]TDF1_FIELDS.TBL The symbol TDF1_FIELDS_TAB is being defined twice. The earlier definition is replaced by the new definition %TAG-W-DUPSYMBOL, at tag <SYMBOL_TABLE_ENTRY> on line 1 in file [GREENBERG.X]TDF2_FIELDS.TBL The symbol TDF2_FIELDS_TAB is being defined twice. The earlier definition is replaced by the new definition %TAG-I-ENDPASS_1, End of first pass over the input The output does this: The reference to the first occurence of the repeated table bears the second table number (Table 4-5, when in fact it is Table 3-2 I am referring to). Otherwise, table numbers and references are proper (tho I suppose they would not be if I were repeating the table more than once). Help!!! I have many tables and figures that will be repeated for a 3-book set of manuals. How can I get around this problem?? Fern
| T.R | Title | User | Personal Name | Date | Lines |
|---|---|---|---|---|---|
| 227.1 | need unique symbols | VAXUUM::KOHLBRENNER | Thu Apr 09 1987 12:34 | 66 | |
ALthough the table looks the same and has the same title in each
place that you use it, it will be assigned different numbers and
you probably want each reference to refer to the number of the
nearby table, right?
In order to do that, you have to have a unique symbol for the table
in each place that it is used. Right now, each time that you
include the table file you are declaring the same symbol again
and getting those dupsymbol errors. The <reference> tag can't tell
which of the duplicate symbols that you are giving it is the
symbol that you really are referencing.
So you have two ways to give the table a unique symbol in each place
that it is used:
1. Remove the <table>(title\symbol) tag from the file that you will
be including in many places. Put the <table> tag into the file
that does the including right in front of the <include> tag:
<table>(title\symbol_1)
<include>(table_file.gnc)
Then you can reference the table as <reference>(symbol_1).
The next time you want to include the table, you change the symbol
<table>(title\symbol_2)
<include>(table_file.gnc)
Then you reference the table as <reference>(symbol_2).
That avoids the duplicate symbols and the references come out right.
This may offend your esthetics however. Putting a table off in
a separate file but keeping its <table> tag somewhere else is kind
of kludgey.
2. This method declares the table's "symbol" as a tag in the main file and
then lets the <table> tag in the included file get its symbol by
referencing the tag. This is a little more like magic if you have
never declared a tag... Here's how it goes.
In the main file, you write:
<define>(my_table_symbol\symbol_1\\\\\symbol_1)
<include>(table_file.gnc)
Then you alter the table_file.gnc to have a <table> tag like this:
<table>(title\<my_table_symbol>)
THis leaves the <table> tag in the table_file, where it makes sense
to have it, but causes it to get its symbol from the most recent
definition of the tag <my_table_symbol>. Your reference would be
written as <reference>(symbol_1), as in method 1.
The next time that you want to bring in the table file, you would
write the <define> tag with "symbol_1" replaced with "symbol_2",
and you would reference it as <reference>(symbol_2).
When you write those <define> tags be sure to get the backslashes
right! There are five of them between the first "symbol_1" and
the second "symbol_1". You can use any text in place of
"my_table_symbol" but don't use the name of an SDML tag!
bill
| |||||
| 227.2 | MARTY::FRIEDMAN | Mon Apr 13 1987 11:02 | 4 | ||
Is it out of the question to have one copy of the table, with one symbol, and refer to it from wherever you need to? Just curious. Marty | |||||