For a clipboard utility, I can also recommend Yankee Clipper III. I've
used that utility and its predecessor for years. Also just read a great
review of Ditto, which I'll be taking for a test drive. Both are free. 

HTH,
Jim

-----Original Message-----
From: [email protected]
[mailto:[email protected]] On Behalf Of Art Campbell
Sent: Tuesday, June 15, 2010 9:57 AM
To: Avraham Makeler
Cc: [email protected]
Subject: Re: FM72. Tool to quickly makes loads of cross-refs?

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
         [email protected]
 "... 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
<[email protected]>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 <[email protected]
> >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
> >            [email protected]
> >  "... 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 <[email protected]
> >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 [email protected].
> >>
> >> Send list messages to [email protected].
> >>
> >> To unsubscribe send a blank email to 
> >> [email protected]
> >> or visit
> >>
> http://lists.frameusers.com/mailman/options/framers/art.campbell%40gma
> il.com
> >>
> >> Send administrative questions to [email protected]. Visit 
> >> http://www.frameusers.com/ for more resources and info.
> >>
> >
> >
>
>
> --
> Regards,
>
> avraham
> ~~~~~~~~~
> 054-3084886
> _______________________________________________
>
>
> You are currently subscribed to framers as [email protected].
>
> Send list messages to [email protected].
>
> To unsubscribe send a blank email to
> [email protected]
> or visit
> http://lists.frameusers.com/mailman/options/framers/art.campbell%40gma
> il.com
>
> Send administrative questions to [email protected]. Visit 
> http://www.frameusers.com/ for more resources and info.
>
_______________________________________________


You are currently subscribed to framers as [email protected].

Send list messages to [email protected].

To unsubscribe send a blank email to
[email protected]
or visit
http://lists.frameusers.com/mailman/options/framers/jim.pinkham%40voith.
com

Send administrative questions to [email protected]. Visit
http://www.frameusers.com/ for more resources and info.
_______________________________________________


You are currently subscribed to framers as [email protected].

Send list messages to [email protected].

To unsubscribe send a blank email to
[email protected]
or visit 
http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com

Send administrative questions to [email protected]. Visit
http://www.frameusers.com/ for more resources and info.

Reply via email to