I misunderstood what you were saying -- you're asking about each unique
object reference, but I read what you wrote to mean the global definitions
of the type of object.
And, as far as:
"Another idea I use is to define one of the cross-refs and copy+paste it
into
an FM utility document I keep open on the side in a small window
and copy+paste from there every time I need it again as and when I meet a
repeat instance."
Download a copy of ClipMate, Great utility and it'll let you do other stuff
too. Quicker than cutting and pasting between FM docs.
Cheers,
Art
Art Campbell
art.campb...@gmail.com
"... In my opinion, there's nothing in this world beats a '52 Vincent and a
redheaded girl." -- Richard Thompson
No disclaimers apply.
DoD 358
On Tue, Jun 15, 2010 at 10:27 AM, Avraham Makeler <amake...@gmail.com>wrote:
> Hi Art. Thanks for the response.
>
> >> First, if I were you, I'd resist this. I think it's unnecessary and
> could
> become a potential maintenance nightmare.
>
> >> I think it's unnecessary
> I think this is standard fare in programmer's and API reference guides. So
> they want what they see elsewhere.
>
> >> could become a potential maintenance nightmare.
> That is definitely a point. It never occurred to me before; maybe because
> none such document that I ever worked on ever actually realized that
> horrifying potential in practice.
>
> I think it could be more likely to be a maintenance nightmare if this API
> had a reputation for its objects' names being changed every now and again,
> as well as their positions in the document being changed. However, in the
> year and half I have known this API document it has only ever grown---it is
> now over 700 pages long---it has never *changed*. But you know what - I
> could them about this.
>
> >> The SME seems to be under the impression that if a reader, probably
> another coder, will forget what a basic programming object is in less than
> 90 seconds... If the SME forgets, there may be a reason to do it, but if he
> or she can hold on to the concept for an hour or so, your readers probably
> can.
>
> As I mentioned, I think this is standard fare in programmer's and API
> reference guides, and at 720 pages there is plenty to forget...
>
> >> If I had to do this, I'd probably use a glossary entry for these because
> they are, in fact, definitions and glossary entries are lighter weight.
>
> I will have to check that out. Thanks.
>
> >> With all that said, if you must do this, you _should_ be able to define
> one of the cross-refs and embed it with its text string hotspot. Then copy
> the word, including the cross-ref marker (you have text objects turned on,
> right?) and do a search-and-replace for the text string, pasting from the
> clipboard.
>
> Thanks for the idea. That's useful in cases where the same text is repeated
> many times. In the updates to this document, all the cross-refs are
> different. (At 720 pages, there are so many link targets to choose from,
> why
> repeat the same ones...?! ha ha.)
>
> Another idea I use is to define one of the cross-refs and copy+paste it
> into
> an FM utility document I keep open on the side in a small window
> and copy+paste from there every time I need it again as and when I meet a
> repeat instance.
>
> Great thanks,
>
> - avi
>
>
>
>
> On Tue, Jun 15, 2010 at 4:05 PM, Art Campbell <art.campb...@gmail.com
> >wrote:
>
> > First, if I were you, I'd resist this. I think it's unnecessary and could
> > become a potential maintenance nightmare. The SME seems to be under the
> > impression that if a reader, probably another coder, will forget what a
> > basic programming object is in less than 90 seconds... If the SME
> forgets,
> > there may be a reason to do it, but if he or she can hold on to the
> concept
> > for an hour or so, your readers probably can.
> >
> > If I had to do this, I'd probably use a glossary entry for these because
> > they are, in fact, definitions and glossary entries are lighter weight.
> >
> > With all that said, if you must do this, you _should_ be able to define
> one
> > of the cross-refs and embed it with its text string hotspot. Then copy
> the
> > word, including the cross-ref marker (you have text objects turned on,
> > right?) and do a search-and-replace for the text string, pasting from the
> > clipboard.
> >
> > Art Campbell
> > art.campb...@gmail.com
> > "... In my opinion, there's nothing in this world beats a '52 Vincent
> and
> > a redheaded girl." -- Richard Thompson
> > No disclaimers
> apply.
> > DoD 358
> >
> >
> > On Tue, Jun 15, 2010 at 8:52 AM, Avraham Makeler <amake...@gmail.com
> >wrote:
> >
> >> Hi all,
> >>
> >> RE: FM72. Tool to quickly makes loads of cross-refs?
> >>
> >> I just a received some whole new sections for updating an FM book. The
> >> book
> >> is a large reference guide for an API. Every other word in the new
> >> material
> >> is in fact the name of some software object (function, structure, or
> type)
> >> that's defined somewhere else as its own section. The new material talks
> >> about those already defined software objects and how to use them. So the
> >> SME
> >> wants every mentioning of those already defined software objects to be
> >> converted to a cross-reference. (Anyone who has documented APIs knows
> what
> >> I
> >> am talking about.) Is there some sort of tool that allows you to
> >> type+select
> >> the name of the section (function) or even just its legal number and
> then
> >> click, and hey presto, the cross-reference appears?
> >>
> >> Once, during a slow period, I programmed exactly that tool for Word
> using
> >> VBA. Took me about a week. Works great.
> >>
> >> TIA
> >>
> >> - avi
> >> _______________________________________________
> >>
> >>
> >> You are currently subscribed to framers as art.campb...@gmail.com.
> >>
> >> Send list messages to fram...@lists.frameusers.com.
> >>
> >> To unsubscribe send a blank email to
> >> framers-unsubscr...@lists.frameusers.com
> >> or visit
> >>
> http://lists.frameusers.com/mailman/options/framers/art.campbell%40gmail.com
> >>
> >> Send administrative questions to listad...@frameusers.com. Visit
> >> http://www.frameusers.com/ for more resources and info.
> >>
> >
> >
>
>
> --
> Regards,
>
> avraham
> ~~~~~~~~~
> 054-3084886
> _______________________________________________
>
>
> You are currently subscribed to framers as art.campb...@gmail.com.
>
> Send list messages to fram...@lists.frameusers.com.
>
> To unsubscribe send a blank email to
> framers-unsubscr...@lists.frameusers.com
> or visit
> http://lists.frameusers.com/mailman/options/framers/art.campbell%40gmail.com
>
> Send administrative questions to listad...@frameusers.com. Visit
> http://www.frameusers.com/ for more resources and info.
>
_______________________________________________
You are currently subscribed to framers as arch...@mail-archive.com.
Send list messages to fram...@lists.frameusers.com.
To unsubscribe send a blank email to
framers-unsubscr...@lists.frameusers.com
or visit
http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com
Send administrative questions to listad...@frameusers.com. Visit
http://www.frameusers.com/ for more resources and info.
