Thoughtful, detailed coverage of the Mac, iPhone, and iPad, plus the best-selling Take Control ebooks.

 

 

Pick an apple! 
 
Open Files from BBEdit Subversion Log

When you use BBEdit's Subversion client capabilities to update the working copy of your Subversion repository, BBEdit always displays the Subversion.log file, showing any changes. If you want to work on one of the files that appears as being added or updated, just select the full pathname and choose File > Open Selection (or just hit Command-D). This trick should also work any time you see a pathname within a BBEdit document.

 

 

Related Articles

 

 

Other articles in the series ReadMe Rules

 

 

ReadMe Files? Read This!

Send Article to a Friend

Lately I've spent a lot of time sorting through shareware and freeware utilities for a number of projects, trying to find basic facts for each utility, such as what the utility does, who wrote it (first and last name), how I should pay if I like it, and how I can reach the author by email. Surprisingly, these facts are often omitted, tucked away in odd places, or poorly explained. So, here's some complaining and some advice for ReadMe file writers.

Make an Elevator Statement -- I once read an excellent book called "The High Tech Marketing Companion," by Dee Kiamy (Addison-Wesley. ISBN 0-201-62666-7), which suggests that every product needs an elevator statement. An elevator statement conveys what a product is and what's cool about it, in the time it takes to ride an elevator from the lobby to the top floor of an office building. The idea is that you may only have that much time to explain your product to a venture capitalist riding the elevator with you. Whether or not you're bucking for venture capital, every utility's ReadMe file should have such an elevator statement, along with the price of the software, the name of the author, and the author's contact information.

Make it Open -- ReadMe files are often set up as SimpleText read-only documents, so you cannot copy text from them. This makes it more difficult to be certain you get email addresses, names, and so on correct, should you be attempting to review the software or drop an author a note in email. In addition, if you want to copy the author's snail mail address to send in your shareware payment, such read-only documents get in the way even more. Read-only documents are used to prevent people from changing them, but I don't think this is a significant concern.

Make it Legible -- My final bone to pick concerns legibility. Many authors format ReadMe file text in a tiny size with no white space between paragraphs. Some authors assume I'm going to print out the ReadMe: a poor assumption, since until I can figure out what the application does, I'm unlikely to turn on my printer, and in general, I don't print, and nor should I, given that the documentation already exists online where I can file it neatly with the application.

If you create a ReadMe file, please consider the people who will read it. Make the characters large enough to be legible, accommodate people who want to read it online, explain what your product does and who you are, and remember that the quality of your ReadMe may influence not only how many people use your product, but also how many people figure out how to send you friendly messages, registration forms, chocolates, site license fees, and so on. If you've got a great application, be it freeware or shareware, don't saddle it with a lousy ReadMe.

 

New for iOS 8: TextExpander 3 with custom keyboard.
Set up short abbreviations which expand to larger bits of text,
such as “Tx” for “TextExpander”. With the new custom keyboard,
you can expand abbreviations in any app, including Safari and
Mail. <http://smle.us/tetouch3-tb>