If you follow this blog, you know that I have a thing about be-verbs: am, is, are, was, were, be, being, been. You may have even heard me suggest using your word processor’s Find function to search for these words when you edit (an idea I borrowed from an attendee of one of my workshops).
Now you can one-up that technique. One of my colleagues—thank you, Dina Taylor—has created a macro that instantly highlights be-verbs in a Microsoft Word document. How have I lived without this macro all these years? (A macro is simply a bit of code that automates something that would otherwise require manual repetition.)
After you run the macro, your doc looks something like this:
Why would you bother? After my friend Anne Reed ran this be-verb macro on a “be-hemoth” report, she had this to say in a Facebook comment:
Anne even created her own Facebook post sharing this Word macro, saying that this macro will help “declutter your work in ways you had no idea you needed.”
Intrigued? Give this macro a try. Follow the instructions below. Don’t worry—you don’t have to know anything about macros or code, and it takes just a couple of minutes.
First, some thoughts:
- Running this macro in a long document may yield hundreds of margin comments. I don’t know of a way to dismiss them in batches. Prepare to make a slew of edits. Your readers will thank you.
- Don’t feel obligated to ditch all your be-verbs. They flag opportunity; they aren’t evil. There, I just said aren’t. (I did so to put the emphatic word—evil—at the end of the sentence. That’s a whole nuther writing strategy.)
- For more of my thoughts on be-verbs, including when you might want to use them, see my book chapter “To Be or Not To Be.”
- I’ve tested these instructions on a Mac. If you discover differences on a PC, please let me know.
Create the macro
If these instructions don’t match your version of Word, you can probably find the steps you need online. Anne says, “My version of Word uses a different path to create a macro, but the cut-and-paste still worked perfectly once I got there.”
- Open Word. Close any open Word documents.
- In Word, open Visual Basic Editor (Tools > Macro > Visual Basic Editor).
- Go to Insert > Module. A blank document opens.
- Copy the macro (below), paste it into the blank document, and close Visual Basic Editor. Word automatically saves the macro.
Run the macro
- Open Word, and draft your document or paste in text from another application.
- Open the Macros dialog (Tools > Macro > Macros).
- Select CommentBeVerbs.
- Select Run. Word instantly highlights every be-verb in the doc, adding the margin comment for each one.
The macro comprises everything in the box below, from Sub to End Sub. (The lines of text in this box may not wrap on your screen. To see all the text, use the horizontal scroll bar at the bottom of the box.)
Optional: Edit the comment text—the phrase in quotation marks near the end of the macro. Every time you run the macro, this text appears as a margin comment with each be-verb found.
' CommentBeVerbs Macro
' Adds a comment for each be-verb found in a document.
Dim range As range
Dim i As Long
BeVerbsList = Array("are", "is", "was", "were", "am", "be", "being", "been", "^u8217m", "^u8217re", "it^u8217s", "she^u8217s", "he^u8217s", "^u8216m", "^u8216re", "it^u8216s", "she^u8216s", "he^u8216s", "^u39m", "^u39re", "it^u39s", "she^u39s", "he^u39s")
For i = 0 To UBound(BeVerbsList)
Set range = ActiveDocument.range
.Text = BeVerbsList(i)
.Format = True
.MatchCase = False
.MatchWholeWord = True
.MatchWildcards = False
.MatchSoundsLike = False
.MatchAllWordForms = False
Do While .Execute(Forward:=True) = True
ActiveDocument.Comments.Add range, "Consider rephrasing: tighten, clarify, use a stronger verb, combine sentences, bust up this sentence, etc."
Like this macro? Try this one too.
If you like this macro, you might also like the one I describe here: Instantly Find Long Sentences in Your Microsoft Word Docs.
Let me know about your macro adventures!
Nerd alert 1:
If you ever want to encode straight and curly apostrophes in a Word macro, as I’ve done above, save yourself some trouble and use their Unicode decimal codes—39, 8216, and 8217—not their Unicode hex codes.
Nerd alert 2:
In a comment on Anne’s Facebook post, referred to above, Alex Willis notes that if you have other writing tics that you want to monitor, you can add them to the BeVerbsList array line: BeVerbsList = Array(“are”, “is”, “was”, “were”, “am”, “be”, “being”, “been”, “^u8217m”, “^u8217re”, “it^u8217s”, “she^u8217s”, “he^u8217s”, “^u8216m”, “^u8216re”, “it^u8216s”, “she^u8216s”, “he^u8216s”, “^u39m”, “^u39re”, “it^u39s”, “she^u39s”, “he^u39s”).
*Nerd alert 3:
You might wonder why this macro highlights apostrophe+s only in she’s, he’s, and it’s. I chose to ignore apostrophe+s in other cases since the macro can’t tell a possessive (“that flower’s petals”) from a contraction (“that flower’s bright)—hence the “almost all” in this post’s title. At the same time, since the macro always highlights she’s, he’s, and it’s, it incorrectly highlights some has contractions (“He’s had it”). What’s a language lover to do but treat these edge cases like sleeping dogs and let them lie?