TweetFollow Us on Twitter

Third-Party Editors
Volume Number:10
Issue Number:6
Column Tag:Tools of the Trade

Using Third-Party Editors
With Symantec C++

Going beyond the basics

By Jeffrey Mattson

Introduction

THINK C’s integrated editor has long been a mixed blessing. While it’s useful to have everything you need to start programming in one package, experienced users soon long for more sophisticated features, such as macros and file comparisons. However, THINK C couldn’t communicate with other editors as it could with its own integrated editor, and that made matters difficult. For example, when you edited a file with another editor, THINK C wouldn’t know that you changed the file and that it needed to be recompiled. You’d have to explicitly mark the file for compilation. The hassles of using a third-party editor soon outweighed the convenience of any new features.

With the advent of System 7 and the latest version of THINK C and Symantec C++, you now have a choice [and you can get an editor which knows how to search forwards and backwards - ed stb]. The THINK Project Manager in THINK C and Symantec C++ can communicate with other editors with a suite of Apple Events. However, editors have to be designed to use these Apple Events. Two such editors are BBEdit from Bare Bones Software and QUED/M from Nisus.

Getting Started

Setting up an editor to use with the THINK Project Manager is fairly easy. In the Finder, create an alias of the editor with the Make Alias command, rename the alias to “Editor”, and move it to the Tools folder in the THINK C or Symantec C++ folder. In the THINK Project Manager, open your project, and turn on the “Use external editor” option in the Editor page of the THINK Project Manager options dialog.

If an operation would normally open a file in a THINK Editor window, it now opens a window in your editor. When you double-click on a file in the project window, an error in the Compiler Errors window, or an entry in the Search Results window, the THINK Project Manager now uses your editor of choice. The editor even scrolls to the line that contains the error (or search string) and selects it.

What Works Well

The editors implement most of the features that the THINK Project Manager allows and they implement these features in eerily similar ways, right down to the titles on their menu bars. Both editors have a special THINK Project Manager menu and they use as their title the THINK Project Manager icon. The menus contain similar commands to handle the most common tasks: running your project, adding the front most window to your project, compiling a file, and building the application. QUED/M even gives the commands the same command key equivalents as the THINK Project Manager, and it has some additional commands that the THINK Project Manager lacks, such as one that runs your project without the debugger, regardless of the setting of the Use Debugger option.

BBEdit in use

QUED/M in use

An unexpected extra is that both editors let you open header files just as you do in the THINK Project Manger. When you command-click on a source file’s title bar, the editor displays a menu of header files. However, be sure to hold that mouse button down for a while. There can be a noticeable delay as the editor goes off to get the information from THINK Project Manager.

Both editors are integrated with THINK Reference. They let you look up the selected text in THINK Reference and they can even insert the declaration of the selected function name. BBEdit will launch THINK Reference for you if it’s not already running. By the way, don’t let the name of BBEdit’s command confuse you. Although it’s called Toolbox Lookup , it can also look up the names of standard C library functions in the databases included with THINK C and Symantec C++.

What Doesn’t Work

Unfortunately, you do lose some of the convenient features in the THINK editor when you use a third-party editor. One loss that’s deeply missed is the Option-double-click shortcut. When you Option-double-click on a function or variable name in the THINK editor, the editor finds the function or variable definition and opens the file that contains it. Neither editor contains this feature.

[This is a result of the Think Project Manager not providing a mechanism for an external editor to search for the definition of a global name - Ed stb].

Most importantly, you must remember to save your files frequently. If you’ve used the THINK editor before, you’ve probably grown accustomed to the option that saves your files automatically before the THINK Project Manager runs your project. However, when you use another editor, the THINK Project Manager doesn’t tell that editor to save your files before it runs your program. If your machine crashes while your program is running, you’ll be unpleasantly surprised to find that all your changes are lost. And if you manage to finish an editing session (after your application has crashed), you may still get an unpleasant delay on the next build, because the THINK Project Manager doesn’t know that the newly-saved files contain code that it’s already compiled. The next time you open the project and compile it, the THINK Project Manager marks all those files and recompiles them. This wait can be a real hassle if you changed a lot of files before. The only solution to both these problems is to save the files yourself before compiling them.

Correcting errors can be a nuisance with THINK. When you double-click on an error in the THINK Project Manager’s Compiler Errors window, the editor opens the file and selects the line, and then repeats the error in a dialog box. If you’ve just double-clicked on the error, you don’t need to see it again. Both editors let you go to the next or previous error, without going back to THINK Project Manager.

BBEdit also has a Compile Errors browser. The top of the window contains a list of all the errors, the bottom displays source for the selected error. When you click on an error, the bottom of the window displays the file and highlights the line that contains the error. However, you cannot correct the error in the browser, but you can double-click on the error, and BBEdit opens the file and selects the faulty line

For some reason, BBEdit doesn’t always create a Compile Errors browser when there are compilation errors. There is some sort of mis-communication between BBEdit and the THINK Project Manager.

[Because you’re working with two programs (BBEdit and THINKProject Manager), things can get a bit tricky when it comes to error reporting. BBEdit doesn’t get told about errors if the THINK Project Manager is “in charge of” the compiling. For example, if you choose “Bring Up To Date” while you’re in the THINK Project Manager, it will do the job and not report errors to BBEdit. It’s arguable that it should report the errors to BBEdit since you’ve told it you’re using an external editor, but it’s also arguable that it shouldn’t since you issued the command from inside THINK Project Manager. There’s another case where the limitation clearly comes from the THINK Project Manager, and that’s when you choose “Run” from the external editor. THINK Project Manager poses the dialog asking the user whether to bring the project up to date. If the user clicks “Update”, the THINK Project Manager initiates the build, and keeps error information to itself. This is something under discussion between Symantec and external editor folks. One workaround is to always use the external editor’s “Bring Up To Date” command before running. - Ed stb]

Neither editor works particularly well with the THINK Project Manager’s regular multi-file search, in which the THINK Project Manager searches the files in your project for a string, and displays each occurrence of that string as it finds it. BBEdit doesn’t include any support for this but provides its own approach. QUED/M tries to support it, but I could never get it to work correctly. (Whenever I choose QUED/M’s “Go to Next Error/Match” command, it never finds the next occurrence in the file. ) However, both editors work well with a batch multi-file search, in which the THINK Project Manager lists all the occurrences of your string in a Search Result window, and you look at an occurrence by double-clicking an entry.

Additional Features

Both editors offer many features missing in the THINK Project Manager editor. They both save window positions, a frequent request for the THINK editor. When you reopen a file, these editors remember where you last placed its window, and the editors place the window there.

They both perform parenthesis matching, letting you know which open parenthesis matches the closing parenthesis you just typed. BBEdit’s parenthesis matching is easier to understand, but QUED/M’s is more powerful. QUED/M beeps when you type a closing parenthesis that has no opening parenthesis, for example, while BBEdit does nothing. QUED/M also lets you edit the list of characters and strings that it considers to be parentheses. For example, if you’re editing Pascal code, you could have the editor treat the words BEGIN and END as parentheses.

Both editors let you add external commands. In BBEdit, you need to create a special kind of code resource with a C or Pascal compiler. QUED/M has its own macro language, and it lets you record a macro as you work or type one up separately. Neither supports AppleScript yet.

QUED/M Macro language

Finally, they perform file comparisons. When you have two versions of the same file, a file comparison command can point out where the text has changed. BBEdit’s file comparison feature is easier to use, since you set all its options from one dialog. QUED/M’s is more powerful but also more confusing. You need to select a couple of different commands to perform a comparison, but QUED/M gives you more customization options and even lets you compare up to three files at once.

Special Features in BBEdit

BBEdit contains several especially useful features that aren’t available in QUED/M. For example, you can open a THINK Project Manager or THINK Pascal project in BBEdit, which displays it in a special type of window called a Project Browser. The top of the window contains a list of all the project’s source files and libraries. If you select a file, the bottom pane of the window displays its contents. If you select a library, the bottom pane of the window displays a list of the files the library contains. It would be nice to edit files in the browser, but it’s a browser. To edit a file, double-click on it and BBEdit brings it up in an editing window. You can click on the icon next to the “Open” button, and BBEdit will launch the application that created the project (either THINK C/Symantec C++, THINKPascal, or CodeWarrior), and open the project.

BBEdit also has a Disk Browser. The top of the window contains a list of all the files and folders that you navigate like a Macintosh open file dialog. When you click on a text file, BBEdit displays its contents, but doesn’t let you edit it. When you click on a THINK Project Manager or THINK Pascal project, the browser displays a list of the files and libraries it contains. BBEdit supports Claris XTND translators, so you can also view many other types of files besides ‘TEXT’ in this browser, such as MacWrite or Microsoft Word files. If you open a file that doesn’t have an XTND filter, BBEdit displays its data fork as text. This can occasionally be useful for things like editing AppleLink or ARA CCLfiles, or rummaging for interesting strings.

BBEdit Disk Browser

BBEdit chose to go a different route than THINKProject Manager’s multi-file search, and has its own powerful multi-file search command. It can search through all the files in a THINK Project Manager project, all the windows open in BBEdit, or all the files in a folder. It has a Search Results browser window, and it can remember your favorite search directories. It even lets you search in an On Location index. When you search in a THINK Project Manager project, it doesn’t let you choose which files in the project to search, but it keeps the user interface simpler, lets you use wildcard matching to filter out files by name, and searching is faster than in the THINK Project Manager.

BBEdit also supports Eric Slosser’s PopupFuncs utility which provides a popup list of functions in a source file (it works with THINK and MPW, too).

BBEdit has a backup capability, either automatic or manual. The automatic flavor copies the previously-saved version to a directory you specify (even on a network volume) and adds a date stamp and sequence number.

Special Features in QUED/M

QUED/M also has backup capabilities, and can store the previously saved version of a file as a backup. It can also automatically save all the open files after a certain number of keystrokes. That simple option can save you unwanted frustration when you’re developing an application that can crash at any moment.

QUED/M also has some powerful editing capabilities. It lets you undo a virtually unlimited number of edits: up to 32,767. When you need to return a file to how it was back when your program still worked, this feature comes in very handy. QUED/M also has ten separate clipboards. You can cut some code you might need later into one clipboard, then switch clipboards to keep cutting and pasting without disturbing it. QUED/M even lets you edit the contents of the active clipboard. These features can be indispensable in a crisis.

To help you move through your files easier, QUED/M lets you fold text: it lets you hide text in the window while still saving it in the file. For example, you could leave all the function declarations visible and hide the function bodies. When you’re looking for a function you can scroll through the file quicker, find the function easier, and unfold the function body to edit it. The macro language in QUED/M might help you automate this task, but I haven’t tried it.

The biggest drawback to QUED/M is its confusing interface. The menus are poorly organized, making it difficult to find commands. For example, the title of one menu is a number that constantly changes. It turns out that the number represents the amount of memory that QUED/M is currently consuming. So you might figure that the commands in this menu control memory management. In fact, only one command does. The rest balance parentheses and compare files.

In general, QUED/M tends to be more powerful than BBEdit, but also more confusing. For example, take comparing files. In BBEdit, it takes one command. You choose the Compare Files command, select the files to compare, and click Compare. In QUED/M, it takes several steps. First, you have to choose the Differences Options command to set your options, some of which aren’t available in BBEdit, including what differences to ignore and how to display the comparison. Then you must make sure sure that the two files you want to compare are open in QUED/M and are in the two front most windows. (That’s how QUED/M knows which files to compare.) Finally, you choose 2-File Differences to perform the comparison. And of course all these commands are in the menu conveniently titled 240K (now it’s titled 239K, now it’s 242K, now it’s 238K, now - oh, never mind). In all fairness, though, the comparison facilities in QUED/M are quite flexible, and can handle complex comparisons and automated merging. This power/complexity might be for you if you are team programming, and spend much time merging the work of two people into one source base.

Summing Up

The ability to choose a third-party editor certainly is a boon to the most particular of the power users, but many people will still prefer the THINK editor until Symantec adds some more support for third-party editors. In particular, the THINK Project Manager needs to ask editors to save files before compiling and it needs to let editors display the definition of a symbol on which you Option-double-click.

When choosing a third-party editor, most people will find that BBEdit offers everything they need and is easy to use. However, if you need features like unlimited undo, text folding, sophisticated differencing/merging, and macros that don’t require a compiler, learning to use QUED/M could be best for you.

Availability

BBEdit 2.5 is available from Bare Bones Software for $99. THINK C, THINK Pascal, and Symantec C++ users can get it at the discounted price of $49. It requires System 6.0.7 or later and 350K RAM. (To use BBEdit as an external editor for the THINK Project Manager, you need System 7.)

QUED/M 2.6 is available from most software distributors for a list price of $149. Until June 30th, 1994, it’s available directly from Nisus for $69.95. It requires System 6 or later and 285K RAM. (To use QUED/M as an external editor for the THINK Project Manager, you need System 7.)

for more information

BBEdit - Bare Bones Software, 1 Larkspur Way #4; Natick, MA 01760. Internet bbedit@world.std.com; Compuserve 73051,3255; AppleLink BARE.BONES.

QUED/M - Nisus Software, 107 S. Cedros Ave., Solana Beach, CA 92075-1900. (619) 481-1477. For the special price of $69.95, call (800) 922-2993x761 or e-mail nisus.mktg@applelink.apple.com.

 
AAPL
$98.38
Apple Inc.
-0.64
MSFT
$43.89
Microsoft Corpora
-0.09
GOOG
$585.61
Google Inc.
-4.99

MacTech Search:
Community Search:

Software Updates via MacUpdate

Drive Genius 3.2.4 - Powerful system uti...
Drive Genius is an OS X utility designed to provide unsurpassed storage management. Featuring an easy-to-use interface, Drive Genius is packed with powerful tools such as a drive optimizer, a... Read more
Vitamin-R 2.15 - Personal productivity t...
Vitamin-R creates the optimal conditions for your brain to work at its best by structuring your work into short bursts of distraction-free, highly focused activity alternating with opportunities for... Read more
Toast Titanium 12.0 - The ultimate media...
Toast Titanium goes way beyond the very basic burning in the Mac OS and iLife software, and sets the standard for burning CDs, DVDs, and now Blu-ray discs on the Mac. Create superior sounding audio... Read more
OS X Yosemite Wallpaper 1.0 - Desktop im...
OS X Yosemite Wallpaper is the gorgeous new background image for Apple's upcoming OS X 10.10 Yosemite. This wallpaper is available for all screen resolutions with a source file that measures 5,418... Read more
Acorn 4.4 - Bitmap image editor. (Demo)
Acorn is a new image editor built with one goal in mind - simplicity. Fast, easy, and fluid, Acorn provides the options you'll need without any overhead. Acorn feels right, and won't drain your bank... Read more
Bartender 1.2.20 - Organize your menu ba...
Bartender lets you organize your menu bar apps. Features: Lets you tidy your menu bar apps how you want. See your menu bar apps when you want. Hide the apps you need to run, but do not need to... Read more
TotalFinder 1.6.2 - Adds tabs, hotkeys,...
TotalFinder is a universally acclaimed navigational companion for your Mac. Enhance your Mac's Finder with features so smart and convenient, you won't believe you ever lived without them. Tab-based... Read more
Vienna 3.0.0 RC 2 :be5265e: - RSS and At...
Vienna is a freeware and Open-Source RSS/Atom newsreader with article storage and management via a SQLite database, written in Objective-C and Cocoa, for the OS X operating system. It provides... Read more
VLC Media Player 2.1.5 - Popular multime...
VLC Media Player is a highly portable multimedia player for various audio and video formats (MPEG-1, MPEG-2, MPEG-4, DivX, MP3, OGG, ...) as well as DVDs, VCDs, and various streaming protocols. It... Read more
Default Folder X 4.6.7 - Enhances Open a...
Default Folder X attaches a toolbar to the right side of the Open and Save dialogs in any OS X-native application. The toolbar gives you fast access to various folders and commands. You just click... Read more

Latest Forum Discussions

See All

Note Review
Note Review By Jennifer Allen on July 29th, 2014 Our Rating: :: TOO SIMPLEiPhone App - Designed for the iPhone, compatible with the iPad Note is a note taking app that’s a little too short on features to be worth its asking price... | Read more »
Chainsaw Warrior Goes on Sale & Ther...
Chainsaw Warrior Goes on Sale & There’s a Chance to Win a Copy of the Original Board Game Posted by Jennifer Allen on July 29th, 2014 [ permalink | Read more »
It Came From Canada: Tiny Tower Vegas
If you go to a casino, you might make a lot of money. If you run a casino, you’re guaranteed to make a lot of money. The choice seems pretty obvious. So while waiting for your shady real estate deals to move forward, get prepared with Tiny Tower... | Read more »
Z Hunter Review
Z Hunter Review By Lee Hamlet on July 29th, 2014 Our Rating: :: RIGHT ON TARGETUniversal App - Designed for iPhone and iPad While it might not necessarily break new ground, Z Hunter has enough tricks up its sleeve to ensure that... | Read more »
Huge Update Comes To Duet, Adding 48 New...
Huge Update Comes To Duet, Adding 48 New Stages Posted by Jennifer Allen on July 29th, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
Sharknado: The Video Game Available Now....
Sharknado: The Video Game Available Now. Seriously. Posted by Rob Rich on July 29th, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
Frog Orbs 2 Review
Frog Orbs 2 Review By Nadia Oxford on July 29th, 2014 Our Rating: :: THIS MAGIC IS A TAD MONOTONOUS Universal App - Designed for iPhone and iPad Frog Orbs 2 is repetitive, but younger players should enjoy it nonetheless.   | Read more »
Puzzix Review
Puzzix Review By Jennifer Allen on July 29th, 2014 Our Rating: :: NICE IDEAUniversal App - Designed for iPhone and iPad A little like Tetris, Puzzix is all about piecing together blocks and watching them vanish. It could do with... | Read more »
Cannonball eMail is Now Live – Works Wit...
Cannonball eMail is Now Live – Works With Gmail, Yahoo, Outlook, Hotmail, and AOL Posted by Jessica Fisher on July 29th, 2014 [ permalink ] | Read more »
To The End Review
To The End Review By Lee Hamlet on July 29th, 2014 Our Rating: :: A VICIOUS CYCLEUniversal App - Designed for iPhone and iPad To The End will test players’ patience, timing, and dedication as they try to navigate all 13 levels in... | Read more »

Price Scanner via MacPrices.net

Updated MacBook Pro Price Trackers
We’ve updated our MacBook Pro Price Trackers with the latest information on prices, bundles, and availability on the new 2014 models from Apple’s authorized internet/catalog resellers as well as... Read more
Apple updates MacBook Pros with slightly fast...
Apple updated 13″ and 15″ Retina MacBook Pros today with slightly faster Haswell processors. 13″ models now ship with 8GB of RAM standard, while 15″ MacBook Pros ship with 16GB across the board. Most... Read more
Apple drops price on 13″ 2.5GHz MacBook Pro b...
The Apple Store has dropped their price for the 13″ 2.5GHz MacBook Pro by $100 to $1099 including free shipping. Read more
Apple drops prices on refurbished 2013 MacBoo...
The Apple Store has dropped prices on Apple Certified Refurbished 13″ and 15″ 2013 MacBook Pros, with model now available starting at $929. Apple’s one-year warranty is standard, and shipping is free... Read more
iOS 8 and OS X 10.10 To Support DuckDuckGo As...
Writing for Quartz, Dan Frommer reports that Apple’s forthcoming iOS 8 and OS X 10.10 operating systems version updates will allow users to select DuckDuckGo as their default search engine. He notes... Read more
U.K. Hospital Using iPods and iPads To Record...
British news journal GazetteLive’s. Ian McNeal notes that the old “an apple a day keeps the doctor away” proverb is being turned on its head at http://southtees.nhs.uk/hospitals/james-cook/ James... Read more
13-inch 2.5GHz MacBook Pro on sale for $1099,...
Best Buy has the 13″ 2.5GHz MacBook Pro available for $1099.99 on their online store. Choose free shipping or free instant local store pickup (if available). Their price is $100 off MSRP. Price is... Read more
Roundup of Apple refurbished MacBook Pros, th...
The Apple Store has Apple Certified Refurbished 13″ and 15″ MacBook Pros available for up to $400 off the cost of new models. Apple’s one-year warranty is standard, and shipping is free. Their prices... Read more
Record Mac Shipments In Q2/14 Confound Analys...
A Seeking Alpha Trefis commentary notes that Apple’s fiscal Q3 2014 results released July 22, beat market predictions on earnings, although revenues were slightly lower than anticipated. Apple’s Mac’... Read more
Intel To Launch Core M Silicon For Use In Not...
Digitimes’ Monica Chen and Joseph Tsai, report that Intel will launch 14nm-based Core M series processors specifically for use in fanless notebook/tablet 2-in-1 models in Q4 2014, with many models to... Read more

Jobs Board

Sr Software Lead Engineer, *Apple* Online S...
Sr Software Lead Engineer, Apple Online Store Publishing Systems Keywords: Company: Apple Job Code: E3PCAK8MgYYkw Location (City or ZIP): Santa Clara Status: Full Read more
*Apple* Solutions Consultant (ASC) - Apple (...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
Sr. Product Leader, *Apple* Store Apps - Ap...
**Job Summary** Imagine what you could do here. At Apple , great ideas have a way of becoming great products, services, and customer experiences very quickly. Bring Read more
*Apple* Solutions Consultant (ASC) - Apple (...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
*Apple* Solutions Consultant (ASC) - Apple (...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.