An American Editor

February 14, 2017

EditTools 8 Released

EditTools 8 is now available for download.

EditTools 8 is a free download for current registered owners of earlier versions. To download EditTools 8, click this link and click on the head: Download EditTools v8.0. EditTools is Windows only and does not work with 64-bit Word. EditTools 8 is works with any Windows version of Word — 2007 and newer. It does not work with Word 2003 or any MacOS versions of Word.

If you do not already have EditTools, EditTools 8 can be purchased for $69 directly from wordsnSync or as part of the Editor’s Toolkit Ultimate special package that includes the latest version of EditTools, PerfectIt, and Editor’s Toolkit Plus (for more information on this package, click this link).

Also available is a new starter dataset package for EditTools. The EditTools Datasets package contains multiple starter datasets, such as Drugs (5800+ entries), Organisms (10,600+ entries), and Journals (215,500+ PubMed/AMA style; 212,000+ AMA with Periods style; 120,000+ APA/Chicago style entries; 149,000+ ACS style; and 118,500 Harvard style). Also included are starter datasets for commonly misspelled words, “confusables” (e.g., complement and compliment), symbols, language, and more. The datasets give you a quick start toward creating your own comprehensive datasets. They are not comprehensive datasets themselves — they are starter datasets. The starter datasets are available for $29.

You can learn more about EditTools, including what is new in version 8, by clicking on the links found in the Read More box.

Richard Adin, An American Editor

November 21, 2016

EditTools: Duplicate References — A Preview

The current version of EditTools is nearly 1 year old. Over the past months, a lot of work has gone into improvements to existing functions and in creating new functions. Shortly, a new version of EditTools will be released (it will be a free upgrade for registered users).

New in the forthcoming version is the Find Duplicate References macro, which is listed as Duplicate Refs on the References menu as shown here:

Duplicate Refs on the References Menu

Duplicate Refs on the References Menu

The preliminaries

The macro works with both unnumbered and numbered reference lists (works better when the numbers are not autonumbers, but it does work with autonumbered lists). It also works with the reference list left in the manuscript with the text paragraphs and when the reference list has been moved temporarily to its own file (it works, like other reference-specific macros in EditTools, better when the references are moved to a separate, references-only file).

Like all macros, the Find Duplicate References macro is “dumb”; that is, it only finds identical references. The following image shows references 19 and 78 as submitted for editing. (For all images in this essay: For a larger, more readable image, right-click on the image and click “Open link in new tab.” This will open a larger version of the image in a new tab that can be kept open as you read the description of the image.)

Original References

Original References

As the image shows, although references 19 and 78 are identical references and are likely to appear identical to an editor, they will not appear identical to the Find Duplicate References macro. Items 1 and 2 show a slight difference in the author name (19: “Infant”, 78: “Infantile”). The journal names are different in that in 19 the abbreviated name is used (#3) whereas in 78 the name is spelled out (#4). Finally, as #5 and #6 show, there are a couple of differences in the cite information, namely, the order, the use of a hyphen or en-dash to indicate range, and the final page number.

Because any one of these differences would prevent the macro from pairing these references and marking them as potentially identical, it is important that the references go through a round of editing first. After editing, which for EditTools users should also include running the Journals macro, the references are likely to look like this:

The References After Editing

The References After Editing

If you compare the same items (1 and 2, 3 and 4, 5 and 6) in the above image, you will see that they now better match. (Ignore the inserted comments for now; they are discussed below.) One more step is required before the Find Duplicate References macro can be run — you need to accept all of the changes that were made. Remember that in Word, when changes are made with Tracking on, the material marked as deleted is not yet deleted; consequently, when the macro is run, the Tracked items will interfere (as will any comments, which also need to be deleted). The best method is to (1) save the tracked version, (2) accept all the changes, (3) use EditTools’ Comment Editor to delete any comments, and (4) save this clean version to run the Find Duplicate References macro.

After accepting all changes and deleting the comments, the entries for references 19 and 78 look like this:

The References After Changes Accepted

The References After Changes Accepted

Running the macro

When the Find Duplicate References macro is run, the following message box appears.

Find Duplicate References Message Box

Find Duplicate References Message Box

To run the macro, the macro has to be told where to begin and end its search. If the references are in a separate file from the rest of the manuscript, check the box indicating that the references are in a standalone document (#5) and click Run (#6). If the references are in a file with other material, use bookmarks to mark the beginning and ending of the list as instructed at the top of the message box (#1). To make it easier, the Bookmarks macro now has buttons to insert these bookmarks:

The dupBegin and dupEnd Bookmark Insert Buttons

The dupBegin and dupEnd Bookmark Insert Buttons

The Find Duplicate References macro matches a set number of characters, including spaces. The default is 120 (#4) but you can change the number to 36, 48, 60, 72, 84, 96, or 108 using the dropdown arrow shown at #4 in the Find Duplicate References message box above.

The macro does a two-pass search, one from the beginning of the reference and another from the end of the reference, which is why a list of duplicates may have repetitions.

The results of the search appear like this:

List of Possible Duplicate References

List of Possible Duplicate References

(They appear as tracked changes only if the macro is run with Tracking on; if Tracking is off, the results appear as normal text.) Note the title of the duplicates is “Duplicate Entries (Nondefinitive).” The reason for “Nondefinitive” is to remind you that the macro is “dumb” and there is no guarantee that the list includes all duplicates or that all listed items are duplicated. Much of the macro’s accuracy depends on the consistency of editing, including formatting.

For the examples in this essay, the Find Duplicate References macro was run on a list of 735 references and the list of possibilities shown represents those likely duplicate references the macro found. Note that references 19 and 78 were found (#19 and #78 indicate the portions of those references found duplicated by each pass of the macro); however, if, for example, in editing the page range separator in #19 was left as an en-dash in reference 19 and in reference 78 as a hyphen, the macro would not have listed the material at #19 as there would not have been a match. Similarly, if the author name in reference 19 had been left as “Infant” and in reference 78 as “Infantile”, the macro would not have listed the material at #78 as there would not have been a match.

The next step is for the editor to determine which of the listed possibilities are duplicates. This is done using Word’s Find Navigation pane, as shown here:

Verifying Duplicate References

Verifying Duplicate References

Copy part or all of what was found (#1) into the Find field (#2). Find will display the search results (“3 matches”) (#3); clicking the Browse button (the rightmost button at #3) lists the three matches found (#4 to #6). The first entry (#4) is always the text in the duplicates list (#1), which means that, in this example, the possible duplicates are #5 and #6. Clicking on the text marked #5 to see the complete text of that entry. Then compare that text to the text of the reference at #6. (It is possible for the macro to find more than two possible matches for the same text — and all, some, or none may be duplicates.)

Tip: Use comments to track duplicates


When I find a duplicate, I insert a prewritten, standardized comment (using EditTools’ Insert Query) to tell the client that references x and y are duplicates and that I am deleting one and renumbering it (see image below for a sample comment). I insert the comment at each of the duplicate references, although I slightly modify the comment so that it is appropriate for the reference to which it is being attached. The comment shown below is inserted at reference 78 and its language is appropriate for that reference. It tells the client that references 19 and 78 are identical and that reference 78 has been deleted and renumbered as 19. This type of comment is added to the version (e.g., the Track Changes version) of the reference list that will be given the client. The comment is added to the appropriate references as duplication is confirmed.

The Inserted Comment

The Inserted Comment

The comment, in addition to serving as a message to the client, serves as a reminder message during editing of the manuscript. Duplicate references require renumbering so as to keep reference callouts in number order. For example, it may be that reference 78 is called out after the callout for reference 10 and before that for 19. In that case, reference 78 would be moved to position 11 in the list and renumbered as 11 and the comment would be modified (easy to do using EditTools’ Comment Editor). A prewritten note (another new EditTools feature) would be inserted at point 78 in EditTools’ Reference Number Order Check and reference 19 would be marked as deleted, the inserted comment (see above) would be modified, and a note would be added to Reference Number Order Check at point 19. (See the discussion below about the report.)


When editing of the manuscript is finished, have the Reference Number Order Check macro export a renumbering report to send with the edited file to the client. A partial sample report is shown here:

Sample Partial Renumbering Report

Sample Partial Renumbering Report

Every report bears the creator’s identification information (#1) and file title (#2). You set the creator information once and it remains the same for every report until you change it using a manager. The file title is set each time you create a report.

As the report shows, reference 78 was deleted and all callouts numbered 78 were renumbered as 19 (#3). The prewritten, standard message (a new feature) can be inserted with a mouse click; only the numbers need to be inserted or modified. The report shows that the renumbering stopped at callout 176 (#4) and started again at 197 (#5). Number 6 shows another deletion and renumbering.

Clients like these reports because it makes it easy for authors, proofreaders, and others involved in the production process to track what was done.

The Find Duplicate References macro is a handy addition to EditTools. While it is easy in very short reference lists to check for duplicate references, as the number of references grows, checking for duplicates becomes increasingly difficult and time-consuming. The Find Duplicate References macro saves a lot of time, thereby increasing an editor’s profits.

Richard Adin, An American Editor

October 2, 2016

On Politics: Did You Pay Your Quarterly Estimated Taxes?

Filed under: Breaking News,Politics — americaneditor @ 4:25 am
Tags: , ,

Taxes were due for the third quarter a few weeks ago. I know because my accountant sent me the bad news. Like most Americans, I grumble about paying my taxes — which seems to be a never-ending chore — and I have never had a year when I owed zero.

Yet I see that there is hope for me. Hope that not only will I be able to avoid paying taxes for 20 years, but that I will be able to live a life of luxury while doing so. Even better, I will be able to look upon my colleagues and think about how smart I am to not pay taxes while living a life of plenty — all because you will pick up my share of the tax burden.

How do I do this? Easy. I just need to lose $916 million — just like Donald Trump:

Trump Tax Records Obtained by The Times Reveal
He Could Have Avoided Paying Taxes for Nearly Two Decades

The New York Times, October 1, 2016

What more does The Donald need to do to demonstrate he should be elected president? Even Hillary wasn’t smart enough to lose $916 million and pay no taxes.

Richard Adin, An American Editor

June 10, 2016

Breaking News: Is the Period Going the Way of the Serial Comma?

Should we start getting prepared for the funeral of the full stop? It looks like its time as a vital part of grammar and language is coming to a close. Check out this front-page article in today’s New York Times bJune 9, 2016 , p. A1):

Period. Full Stop. Point.
Whatever It’s Called, It’s Going Out of Style

If the full-stop period is no longer used, will it matter how obtuse or poorly constructed a sentence is? Will we even be able to identify a sentence? Will need for editors decline in tandem with the lack of use of the period?

Richard Adin, An American Editor

May 22, 2016

Breaking News: On Vacation

Filed under: Breaking News — americaneditor @ 4:00 am
Tags:

I will be on vacation May 22, 2016 through May 30, 2016. If you submit a comment to AAE and it remains in moderation, it is because I will have limited access to AAE during my vacation. For me, part of being on vacation (perhaps even the best part) is being offline. Please be patient; I will review any comments held in moderation as quickly as I can, but it may not be until I return from vacation.

Richard Adin, An American Editor

May 21, 2016

Congratulations to Carolyn Haley

Congratulations to our Thinking Fiction essayist, Carolyn Haley, for winning the Grand Prize in the 2015 Chanticleer Book Reviews awards for Paranormal/Supernatural Fiction with her title The Aurora Affair. Carolyn’s other novel, Into the Sunrise, was a finalist in the same competition in the Vintage Romance category. For those interested, the books are available from the following sources:

Well done, Carolyn!

Richard Adin, An American Editor

 

April 16, 2016

A Good Deal: Books on Sale

If you are like me, you always have an eye out for a good book sale. Here is one worth noting.

The University of North Carolina Press has a book sale going on. Save 40% on all purchases, plus get free shipping on orders of $75 or more (otherwise shipping at the cheapest rate — media mail — is $6 for the first book and $1 for each additional book). There is a good selection of scholarly books available; I browsed the first 70 pages. The 40% discount code (entered at checkout) is

01DAH40

To begin browsing the books, follow this link:

University of North Carolina Press

Happy book shopping!

Richard Adin, An American Editor

March 20, 2016

On Language: Garner’s Modern English Usage 4th Edition

Bryan Garner has published a new edition of his American English-focused usage, grammar, and style guide, Garner’s Modern English Usage Fourth Edition. I received my copy two days ago. It follows the same format as the third edition but is approximately 200 pages longer.

I find it interesting that he calls it the “Fourth Edition” when the third edition was titled Garner’s Modern American Usage, and the first and second editions had titles that differed from any previous or subsequent edition. I’d be interested in Garner’s explanation.

I have on preorder Garner’s The Chicago Guide to Grammar, Usage, and Punctuation. I was unable to preview it, so I am hoping it is significantly more than what appears in The Chicago Manual of Style 16th Edition. It is due to be published on April 5.

Regardless, if you edit documents in American English, Garner is considered the leading authority on questions of grammar, usage, and style. The new Garner’s Modern English Usage Fourth Edition is a must-have reference for questions regarding American English.

Richard Adin, An American Editor

December 16, 2015

Mark Your Calendar for the 2016 “Be a Better Freelancer” Conference

It’s time to start planning to attend the conference of the year!

Our “On the Basics” columnist Ruth Thaler-Carter has told me that the 2016 Communication Central conference — the 11th annual Be a Better Freelancer™ conference — will be held October 28–29, 2016, at a new Hilton Garden Inn in Rochester, NY.

While the core focus of the 2016 Communication Central conference is on freelancing/entrepreneurship as opposed to editing per se, there are always skills-oriented sessions focusing on the tools that editors must know to succeed and thrive professionally, such as Word, Acrobat, social media platforms, and more. Concept-oriented sessions focus on publishing trends; marketing and promotions; networking; finding and keeping worthwhile clients; and increasing earnings by increasing efficiency and adding in-demand, skilled services to your repertoire, whether you’re an editor, proofreader, writer, indexer, or other editorial freelancer.

Speakers for the 2016 conference will include Ally Machate, Dick Margulis, Kat Friedrich, Carolyn Haley, Lori Paximadis, Bevi Chagnon, Adrienne Montgomery, Jack Lyon, Daniel Heuman, Pamela Hilliard Owens, Janice Campbell, and me.

As always, the program will benefit aspiring, new, and experienced freelancers, by providing ideas for enhancing and expanding your business. The conference will also provide invaluable opportunities for in-person networking.

Ruth has informed me that subscribers to An American Editor will again be eligible for a special discount on early registration, and that details will be coming in January. So be sure to mark your calendar now for the 11th annual Be a Better Freelancer™ conference, October 28–29, 2016. Registration should open by early January (details will be announced on AAE and at Communication Central).

Is there a topic you would like to see addressed at the conference? If you have a special request or a suggestion for a conference topic or speaker, let Ruth know by writing a comment. I’ve already put in my request for a discussion of editor ethics.

Richard Adin, An American Editor

November 6, 2015

Worth Celebrating: Ruth Thaler-Carter

The good news about An American Editor essayists continues.

Congratulations to our On the Basics essayist, Ruth Thaler-Carter, who will receive a Big Pencil Award on November 14, 2015, from Writers & Books in her hometown of Rochester, NY, for being “A teacher of adults who has inspired the creation and appreciation of literature” and having “contributed significantly in the advancement, creation, and understanding of literature in the Rochester community.”

Richard Adin, An American Editor

Next Page »

Blog at WordPress.com.

%d bloggers like this: