REFMAC60 - Reference handling macros for Word 6.0 
================================================= 
 
Introduction 
============ 
 
This is a set of macros that allow to handle references "Latex" style. What 
this means is that a separate document, the reference document, contains all 
the references in arbitrary order. The main document includes reference tags 
(eg. bartana94 or johnson_SLM) and a reference bookmark. Upon invoking the 
the reference resolver macro in this package, a scan is performed over the 
main document and a neat reference list in the order of appearance in the 
document is created at the reference bookmark. See usage below for more details. 
 
Installation 
============ 
1. Fire up Word 6.0 (if you have 2.0, grab refmacro.zip from wherever you got 
this. This will not work with Word 2.0) 
 
2. open the document refmac61.doc. 
 
3. You will see three sections called 'InsertBibEntry', 'InsertBibTag' and 'ResolveRefs'. 
Each is 
a separate macro. 
 
4. Mark the first macro by highlighting the first line to the first END SUB line. Then 
choose Edit-Copy. 
 
5. Choose Tools-Macro and type InsertBibEntry in the macro name field. Choose Create.  
 
6. Delete the Sub Main and SUB End that Word automatically writes, and choose Edit-
Paste. Choose File-Close and answer yes on the save question. 
 
7. Repeat 4-6 for InsertBibTag and ResolveRefs. You now have three new macros. You 
can assign them to buttons or menu options (I have the first two assigned to the Insert menu 
and the last to the Format menu). 
 
Usage 
==== 
 
Open a document that will hold your references. Lets say you called it refer.doc. Run the 
InserrtBibEntry macro to create your references there. A dialog box appears that asks you 
to insert the tag for the macro. Lets say the first macro is tagged as Harry67. After typing 
that in (no spaces or funky characters please) click OK. You will see [1]. Type in the full 
reference, say 'B. F. Harry "Chaos Systems", J.Q. E. Feb. 1967'. and press Enter. Now, to 
enter the rest of the entries, fire up the InsertBibEntry again. (Now you see why its handy 
to assign a button or a menu choice to it.  
 
When you're done, save the file. Now write your main document. Wherever you want to 
insert  a reference to, say, Harry's paper, just fire up the InsertBibTag macro. A dialog box 
will come up asking for the tag name, which will be, of course, Harry67.  
 
At the place you wish to have your reference list make a bookmark by placing the cursor 
there and pressing Ctrl-Shft-F5. A dialog box comes up asking for the bookmark. Type 
References. Nothing else, and no variations. This is the position where your reference list 
will begin. Now fire up the ResolveRefs macro, seat back and watch the show. I strongly 
suggest you save your document before that though.  
 
Notes 
==== 
 
1. If you make a reference tag to a reference that was not resolved yet you will see 
something like 
[Error! Reference source not found.]. This is actually OK. Once you do a ResolveRefs, it 
should turn into a true reference, i.e. [3] etc. (given that it actually exists). 
 
2. I have used a nice little gem called echo() which turns on/off the screen refreshes by 
Word. This speeds up the ResolveRefs  macro by about 30%. If the ResolveRefs macro is 
interrupted (by switching to another program via Alt-Tab etc.), you are on your own and 
probably will end up in never-never land. The moral of this is to let ResolveRefs do its 
thing. You can see its status on the status line. 
 
3. Feel Free to use copy, distribute and modify these macros. I won't even bother with 
putting a Copyright or a GPL on this. I would appreciate though that if it's not too much of 
a bother, email me and say how goes you with it. Bug reports, enhancements and fixes are 
most welcome, and I'm tentatively promising anyone a reply.  My address is  
bartana@iil.intel.com
 
4. Finally, I can attest that these macros are working nicely for me. I have used them
extensively in my thesis, and they withstood around 180 references. I do not in any way 
guarantee that they will work for you. Use them at your own risk.
