On 2/4/2010 12:44 PM, TJ Frazier wrote:
Hi, Gary,
On 2/4/2010 12:22, Gary Schnabl wrote:
On 2/4/2010 11:21 AM, TJ Frazier wrote:
Hi, Jean,
On 2/4/2010 08:07, Jean Hollis Weber wrote:
Some of our user guide chapters have large numbers of cross-references
to figures that immediately follow the sentence or paragraph referring
to them; other chapters have very few x-refs in those situations.
Because x-refs have a tendency to randomly go goofy when chapters are
combined in a book, I recommend that we avoid using unnecessary
x-refs.
Some are necesary, for example if they refer to a figure on a
different
page, but many really are not needed for clarity. Let's purge the
unnecessary ones.
--Jean
Do you know if there's an issue filed on this? I gather that it's not
all x-refs, and hard to reproduce. If nobody's come up with a good
test case, I'll try downloading all the chapters of whatever (GS3?),
and look at the master for problems. (Any hints on what chapter(s)?)
There is an awkward kludge that some writers/editors employ to get
around the x-ref problems with master documents. I tend to never employ
any kludges because if and when such non- or mal-functioning gets
corrected, such a kludged document might be littered with unpredictable
time bombs afterwards.
Gary
Thanks for the tip. I'm hunting for reproducible cases for
issue-filing, but the kludge might help pinpoint the error. Can you
give the details?
Ask Jean. I did not like using it because its presence was not readily
visible.
Gary
--
Gary Schnabl
Southwest Detroit, two miles NORTH! of Canada--Windsor, that is...
Technical Editor forum <http://TechnicalEditor.FreeForums.org>
LinkedIn profile <http://www.linkedin.com/in/garyschnabl>
Elance profile
<http://www.elance.com/php/profile/main/eolproviderprofile.php?userid=1892120&catid=100&edit=true&from=myelance>
