Re: Spell-checking documents with lots of code?

Subject: Re: Spell-checking documents with lots of code?
From: "Paul Goble" <pg -at- pgcommunication -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Thu, 10 Jul 2003 14:09:23 -0600


One technique that has worked well for me is to save the document
in an ASCII format on a UNIX or Linux system, then run

spell [file] | sort -u > [output file]

This gives an alphabetized list of words the spell checker
didn't recognize. I find it's easy to scan past the "code"
words and zero in on real mistakes. This technique also
catches many typos within the code, such as places where I used
two spellings for a parameter name.

I then go back to the source document and search for each of
the errors. It sounds awkward, but the whole process usually
only takes a few minutes.

By the way, THANKS to John for suggesting the Language=None
trick! I'm sure I'll put it to good use.

Paul

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

ANNOUNCING ROBOHELP STUDIO
Create professional Help systems that feature interactive tutorials and
demos with all new RoboHelp Studio. More at http://www.ehelp.com/techwr-l2

Mercer University's online MS Program in Technical Communication Management:
Preparing leaders of tomorrow's technical communication organizations today.
See www.mercer.edu/mstco or write George Hayhoe at hayhoe_g -at- mercer -dot- edu -dot-

---
You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.



Previous by Author: RE: Hall of Technical Documentation Weirdness
Next by Author: Single PDF with RD files
Previous by Thread: Spell-checking documents with lots of code?
Next by Thread: RE: Spell-checking documents with lots of code?


What this post helpful? Share it with friends and colleagues:


Sponsored Ads