Previous Issue | Search TidBITS | TidBITS Home Page | Next Issue
Our examination of how moderately normal people can use MacsBug continues this week and includes valuable information on how to create logs for developers when you're beta testing a program. Also in this issue, Adam looks at the apparent demise of Claris Emailer, and we note important software releases including QuarkXPress 4.04, Eudora Pro 4.0.2, AutoShare 3.0, and FileMaker Pro 4.0v2, and the "almost here" StuffIt Deluxe 5.0.
Copyright 1998 TidBITS Electronic Publishing. All rights reserved.
Information: <firstname.lastname@example.org> Comments: <email@example.com>
This issue of TidBITS sponsored in part by:
Northwest Nexus -- 1 888-NWNEXUS -- <http://www.nwnexus.com/>
Internet business solutions throughout the Pacific Northwest.
Small Dog Electronics -- Special Deal for TidBITS Readers!
Dayna 100Base-T Fast Ethernet 8-port Hub & 4 PCI Cards: $299
PowerBook 3400c/200 (refurbished) with Free Backpack: $1499!
For Details: <http://www.smalldog.com/> -- 802/496-7171
Cyberian Outpost -- The Cool Place to Buy an iMac!
For a limited time only, take advantage of FREE SHIPPING
on the iMac, the most original Mac since the original Mac!
Norton Utilities 4.0: The best-known Mac disk recovery software!
Upgrade from previous versions to repair HFS+ volumes using the
new Norton Utilities interface: Only $44.95 after a $50 rebate!
Download today! -> <http://www.digitalriver.com/TidBITS/NUM40/>
WebDoubler: BLOCK Inappropriate Content from Your LAN!
Visit Maxum's Web site for complete information on WebDoubler
and a 20% discount for TidBITS readers! Download the demo now!
CRASHED DISK? The new Retrospect 4.1 from Dantz comes with a
bootable CD that makes it easier to restore your hard disk from
your backup. The best backup program anywhere! $29.95 upgrades.
Read more about Retrospect 4.1 at <http://www.dantz.com/>.
QuarkXPress 4.04 Update Addresses Numerous Bugs -- Quark has released an update to QuarkXPress 4.0 that fixes several bugs related to saving and printing, Find/Change operations, Bezier lines with arrowheads, and other miscellaneous problems. Additionally, Quark has modified the scripting syntax in the AppleScript dictionary to include new 4.0 features and work better with existing scripts. Owners of version 4.03 can download a 3 MB updater; owners of earlier versions of QuarkXPress 4.0 should download the 8.2 MB "universal updater." [JLC]
Eudora Pro 4.0.2 Now Available -- Although Eudora Pro 4.1 remains in public beta, Qualcomm has finally released Eudora Pro 4.0.2, which fixes a number of minor bugs and nagging annoyances. If you're having troubles with Eudora Pro 4.0.1, it's worth downloading the free 5 MB updater; otherwise I'd recommend waiting for version 4.1. [ACE]
AutoShare 3.0 Released -- Mikael Hansen has released version 3.0 of AutoShare, his freeware mailing list manager and auto-responder that works with Eudora Internet Mail Server and Stalker Internet Mail Server. Major new features include support for internal and external subscriber databases, support for MIME digests, additional remote email administration commands, and support for more bounce formats. The most interesting feature is the support for subscriber databases, which enable you to add your own fields. AutoShare communicates with external databases via scripting, which provides good flexibility but can suffer from poor performance. AutoShare 3.0 is a 1.9 MB download. [ACE]
StuffIt Deluxe 5.0 Announced -- Aladdin Systems has announced StuffIt Deluxe 5.0, a major release of their popular compression program. StuffIt Deluxe 5.0's main new feature is a new compression format that's 20 percent smaller and provides compatibility with Windows. Also included in StuffIt Deluxe 5.0 are support for MacBinary III, compatibility with Mac OS 8.5, additional "Archive Via Rename" functionality for .hqx and .bin, fast conversion of self-extracting archives to StuffIt archives, and new support for Outlook Express and Mailsmith in the "Stuff and Mail" feature. Aladdin expects to ship StuffIt Deluxe 5.0 by the end of October for an estimated street price of $79.95; user group pricing will be $49.95. Existing StuffIt Deluxe and DropStuff owners - plus owners of AutoDoubler, DiskDoubler and the Eudora Productivity Toolkit - can upgrade to StuffIt Deluxe 5.0 for $29.95 through 31-Mar-99 with proof of purchase (such as your Aladdin registration number, or by faxing a photocopy of a receipt, manual, or disk to Customer Service at 831/761-6206). StuffIt Deluxe requires a 68020 Mac or later with 8 MB of RAM and System 7.5.3 or later. [ACE]
FileMaker Pro 4.0v2 Updater Available -- FileMaker, Inc. has released a free FileMaker Pro 4.0v2 updater, which brings the changes and bug fixes found in FileMaker Pro 4.1 to FileMaker Pro 4.0 users without 4.1's new ODBC features (see "FileMaker Pro 4.1 Does ODBC for a Price" in TidBITS-447). Enhancements include the capability to import Excel 98 files, support for the Euro currency symbol, improvements to JPEG display within FileMaker, and several bug fixes related to importing, exporting, deleting, and sorting records in specific situations. The Mac OS updater is 1.8 MB; updaters are also available for various versions of Microsoft Windows. [GD]
by Adam C. Engst <firstname.lastname@example.org>
Was anyone surprised when Emailer languished after being brought back into Apple in the Claris-to-FileMaker, Inc. transformation? Perhaps Emailer users were, since there's little that inspires blind loyalty like a good program you use all day, every day. Emailer was and is a good email program, and frankly, it deserves better than to fade away into the bit bucket. Unfortunately, despite several petition drives, that's what I see happening, unless... well, let's not get ahead of ourselves.
Think for a moment about Apple's position as the Macintosh company. Apple must always tread a fine line between adding capabilities to the Macintosh and maintaining good relations with Macintosh developers. Apple could crush almost any Macintosh product by building similar functionality into the Mac OS. It's happened in the past, and it will happen in the future: AppleScript undermined UserLand Frontier as a commercial scripting tool; PlainTalk has impeded development of sophisticated speech recognition software; and countless shareware products have been mothballed over the years as items like hierarchical Apple menus and desktop pictures were integrated into the operating system. Apple must do these things carefully and without malice, or the company risks alienating the very developers who power the Macintosh.
Revisions Necessary -- So Apple now holds a powerful but aging email client. Although Emailer has numerous great features on top of a solid base, its primary competition - Eudora Pro and Outlook Express - have leapfrogged Emailer's feature set. They added support for multiple accounts, HTML-styled mail, LDAP directory services, IMAP for retrieving mail, inline spell checking, and much more. If that weren't enough, new email programs like Mailsmith from Bare Bones Software and PowerMail from CTM Development have further divided the market. Today, Emailer's main unique feature is its ability to pick up mail from CompuServe and AOL.
Revising Emailer to compete wouldn't be a trivial task, since adding support for HTML-styled mail requires adding an HTML parser and modifying the display engine. IMAP support could require significant modifications to the code that retrieves mail, and IMAP requires a rethinking of how mailboxes work due to its method of storing mail on the server. Apple either has or could hire the talent necessary to update Emailer, but that costs money, and Apple is still concentrating on keeping the company in the black. Projects that might not earn a profit aren't likely to live long in today's Apple Computer.
Apple's Options -- For the moment, however, let's assume that Apple would be willing to put the effort and money into bringing Emailer up to speed. What then?
Apple could give Emailer away for free with every copy of the Mac OS. That's a great way to alienate developers and lose money. The fact that Outlook Express comes free with current versions of the Mac OS isn't popular with other email developers, but at least Microsoft is happy, and in today's industry, it's better to have Microsoft happy with you than not.
Apple could sell Emailer for $50 or so in the retail channel. Other email developers wouldn't be as bothered by this, since Apple's only real advantage would be its name. However, Apple doesn't have a strong history selling inexpensive pieces of software. The Mac OS sells well, and I gather the Apple Internet Connection Kit (which stomped my Internet Starter Kit for Macintosh book/software package) also sold fairly well. Apple might have trouble selling enough copies into a fragmented market to justify the expense of updating.
Another option arises if Apple decides not to update Emailer. Giving the current version of Emailer away for free wouldn't cost anything except some good will with developers. But it also hurts the entire email community by slowing the acceptance of new capabilities that require interoperability. For instance, a set of standard headers have been approved for use by mailing lists to make it easier for email programs to identify mailing list postings and automate tasks like subscribing, unsubscribing, posting, getting help, and so on. Without support for those new headers in email programs (which wouldn't happen in a moribund Emailer), mailing list administrators would have less incentive to implement the new headers, reducing their utility to the rest of us.
Adopting Emailer -- Faced with little chance for profit from Emailer and a strong possibility for alienating a number of Macintosh developers, Apple could consider selling Emailer to another company. That's how 3Com picked up Claris Organizer for use with the PalmPilot; in fact, we've heard that Apple has shopped Emailer around.
The problem is that any company that buys Emailer from Apple must still make the business case for spending more money updating and marketing Emailer. The decision would easier with less competition, but competing against a set of powerful programs that range from free to inexpensive isn't a recipe for business success. The main argument in its favor is that a small company like Fog City Software (the company that originally developed Emailer, though Emailer's lead developer now works on Outlook Express) wouldn't need to sell as many copies as a giant like Apple to turn a profit. Even still, marketing software isn't cheap, and that's especially true of inexpensive software, where you need high sales volume to break even on a marketing campaign.
So, although it could still happen, I can't see any well-known Macintosh company buying and resuscitating Emailer. The best commercial option would be some well-funded unknown that wanted to use it as their introduction to the Macintosh market. They'd certainly get significant word of mouth from the current Emailer users, and that kind of notoriety is tremendously valuable.
If I'm right and Emailer stands little chance of surviving in any of these different ways, perhaps there's an alternative? Tune in next week for thoughts on how we can save both Emailer and a variety of other worthwhile programs that have met untimely ends.
by Geoff Duncan <email@example.com>
The first part of this article in TidBITS-449 looked at MacsBug, Apple's free low-level debugger, explained how to install and invoke it, and how to use MacsBug to recover from application crashes. It also discussed looking up system error numbers with MacsBug, plus converting between decimal and hexadecimal and doing basic math.
This time, we'll take a look at some MacsBug commands that reveal detailed information about your system and its applications. We'll also explain a bit about how your Macintosh and applications use memory, as well as how to make problem logs using MacsBug. MacsBug still isn't a friendly piece of software I'd recommend to all Macintosh users, but if you've come this far, going a little further won't hurt.
By Your Command -- Let's take a look at some common (yet useful) MacsBug commands. These and other commands are case insensitive; it doesn't matter if you capitalize them the way I've written them here. MacsBug also has a Help command that displays often-cryptic descriptions of these and other commands. Although you'll see many of MacsBug's capabilities have to do with obscure functions like traps, breakpoints, and disassembly, there are some useful gems to be found. Type Help Misc for a small sampling.
How - Displays the reason MacsBug was invoked. If you entered MacsBug deliberately, this command tells you the cause is an NMI (Non-Maskable Interrupt).
Stat - Displays the current date and time (along with how long since you last restarted the machine), the name of the current application, and some technical information about your system. Stat is handy for figuring out how long it's been since you last restarted your machine - for instance, although it's asleep much of the day, my PowerBook has been running for more than four months.
ProcInfo - Displays a summary of running applications (or processes), including faceless background programs. The status column indicates which program is in the foreground (this might be different from the currently executing program found under CurAppName), which applications are in the background, and which are background-only. You can also see the programs' type and creator codes, along with how much memory they take and how much of that memory is free. These memory numbers are in hexadecimal: if you're using a recent version of MacsBug, remember you can just click them and press Return to translate the numbers to decimal. This is a great way to find out how much memory is used by the Finder and background applications like File Sharing, Web Sharing, or Desktop PrintMonitor. Note that the total memory size listed here does not include any temporary memory in the system heap the application might be using; for instance, MacsBug might say Internet Explorer is using 5 MB of memory, while About This Computer under Mac OS 8.x could report a significantly higher number since it includes temporary memory with its totals.
File - Did you know that the Mac OS can open only 348 file forks - data and resource - at the same time? The File command displays a complete list of open file forks, sometimes including both the data fork and resource fork of the same file. In this list, you'll see not only any documents or files you currently have open, but all your running applications, fonts, disk directories, extensions, plug-ins and shared libraries used by applications, and more. At the end of the list, you'll see how many of the file forks are currently open: don't be surprised if this number approaches 200. It's not unusual for designers, production artists, programmers, and Web developers to open too many files inadvertently. Usually, quitting an application (or removing unused fonts) solves the problem. If you want to see which files a particular application has open, use the command File -P, followed by the process serial number of the program you're curious about. Process serial numbers are four digits long, and listed in the first column of the ProcInfo command, above. To see all open files except for fonts, type File 0 (that's a zero, not the letter O).
Vol - Displays information about all mounted disks. For the most part, you already know what disks are mounted on your desktop, but this command tells you a little more about them. First, it provides (in hexadecimal) separate totals for the number of files and folders on a drive, unlike the Finder's Get Info command which just displays the total number of items. (It also tells you the allocation block size for a volume, but these numbers seem to be incorrect for HFS+ disks.)
StopAS - Shuts down connections to all AppleShare servers, whether you connected to them using AppleTalk or TCP/IP. (Earlier versions of MacsBug support the StopXPP command, which just closes AppleTalk connections.) For non-programmers, StopAS has two uses. First, you might want to shut down all AppleShare connections if a server is giving you trouble (like disk errors or slow response due to network congestion). Second, remember from the first part of this article that AppleShare servers give up on you if you spend more than a couple minutes inside MacsBug. There's another downside: if this happens, when you exit MacsBug your applications will spend a couple more minutes in limbo wondering where these servers went. Using StopAS to shut down AppleShare connections eliminates delays when you come out of MacsBug.
DX - When programmers are debugging an application, they often insert commands called "user breaks" that deliberately trigger MacsBug. User breaks are helpful if a programmer needs to see what's going on before a program crashes rather than after it has taken leave of the known universe. Programs released to the public don't usually have user breaks, but sometimes they slip through: I have a script that commonly triggers a few in Eudora Pro, and I've seen plenty in pre-release and beta software. If you don't have MacsBug installed and encounter a user break, the application is likely to crash with an error -10; with MacsBug installed, MacsBug will take over your system just like a system error, but will show the cause as a user break along with (sometimes) a message from the programmer. You can often just press Command-G to get out of a user break, but you should report the user break to the developer as a bug. However, if you hit an annoying one and you're trying to get work done, you can use the DX command to tell MacsBug to ignore user breaks: DX OFF turns user breaks off, DX ON turns user breaks on, and DX NOW tells you whether user breaks are enabled or disabled without changing their status. If you turn user breaks off, MacsBug turns them back on again when you restart your machine.
Thanks Heaps -- Each application running on your Mac stores windows, dialogs, documents, and other data in an area of RAM called its application heap. The size of a heap varies with the amount of memory allocated to an application. The system also has a heap, and it's the only one the Mac OS can resize on the fly. To change the size of an application heap, you must quit the program, change its memory settings in its Get Info window, then re-launch the program. This is one of the reasons proponents of other operating systems say the Mac OS has a weak memory model.
Heaps are divided into blocks, which can either be free (unused), relocatable (in use, but movable), or locked (in use and unmovable). Blocks in use can also be marked as purgeable, meaning that the application would prefer the data stay in RAM, but it can be released (purged) if the program needs more free memory. Each block of memory begins with a header containing some information about the memory block.
An application heap is a little like a disk in that it can become fragmented. As a program uses and releases memory (say, opening and closing documents), both free and occupied blocks of memory can become scattered throughout the heap. If the blocks are relocatable, the application re-organizes them to create larger areas of free space - just like optimizing a hard drive. If the blocks are locked, however, they can't be moved and the application may not be able to handle requests for large blocks of memory (say, to open a big document), even though there might be enough total free memory for the request.
Given this, you might wonder why programs ever use locked blocks. The reasons vary, but a good example is playing a movie. If the memory block containing a movie could be moved at any instant, the application would constantly have to check whether the memory had moved, which would destroy performance. By being able to guarantee the block won't move, the program can concentrate on playing the movie, then (in theory) give back the memory when its done. Some applications use more locked memory than others, but all applications use some.
Heaps can also become corrupted, usually when a program puts more data into a block than it was intended to hold. When this happens, it usually overwrites the header of the next block, and the Mac's Memory Manager loses track of that next block. The consequences can range from unnoticeable to disastrous, depending on the nature of that next block of memory.
If you'd like a program that graphically displays areas of an application's heap (and can peer into heap blocks), check out Joshua Golub's ZoneRanger, a 517K download from Metrowerks's Web site. It's a little unstable under recent versions of the Mac OS, but it's useful and educational.
MacsBug can tell you heaps about your heaps.
HT - The HT (heap total) command displays information about the current application's heap, including the amounts of free, relocatable, locked, and purgeable memory. HT provides results in hexadecimal and decimal numbers, expressed in bytes: you can use this command to see a bit of what's happening behind the scenes. If a program reports it's running low on memory but the HT command shows a large amount of free RAM is available, then the heap is probably seriously fragmented. You can try quitting and relaunching the application. If the problem persists, however, allocating more memory to the program may not solve the problem, since large areas of memory can be fragmented just as easily as smaller ones. (Of course, if a program complains it doesn't have enough memory and HT shows there truly isn't much memory available, then increasing the application's memory allocation should help.)
HZ and HX - The heap total command, HT, works only on the current heap. How do you get information on a heap belonging to a different application? First, you need information about the other heaps, available via the HZ (heap zones) command. HZ lists all the heaps, complete with the names of the applications to which they belong. Each item on HZ's listing begins with a decimal number, starting with #1. You can use these numbers with the HX (heap exchange) command to switch to a particular heap. So, if HZ indicated Nisus Writer's heap was #9 on my machine, I could type HX #9 to switch to Nisus Writer's heap regardless of which application was running when MacsBug was invoked. Once I'd done that, the HT command would show me information about Nisus Writer's heap.
HC - The HC (heap check) command tells MacsBug to check if the current application heap is corrupted; you can use HC ALL to check all heaps at once. You might try this if an application is behaving oddly but not crashing. If the HC command reports a heap is corrupted, things may get worse quickly: save all your work and quit the application. Note that this command can be fooled into thinking a heap is corrupted if MacsBug is invoked while an application is shuffling blocks around using the Memory Manager. There are ways you can tell MacsBug to keep running until a safe moment, but it's usually simpler to leave MacsBug using G (or Command-G), wait a second, then re-enter MacsBug to see if the problem persists. If you're curious, look up the WNE and WNEPPC (only available in recent versions of MacsBug) commands in MacsBug's help.
Logging Problems -- Because MacsBug is so good at uncovering information about your current application and the state of your Macintosh, it's useful for folks who are testing or evaluating software, as well as for software programmers. The only difficulty is determining what information is relevant when you're reporting a bug.
Fortunately, the folks who make MacsBug have made this easy for you. The StdLog command, as the name implies, creates a text file with a standardized log of information developers commonly need when they're investigating a bug. These logs are pretty big (usually about 20K), and contain the results of several MacsBug commands, including many discussed here. When you use the StdLog command, the log appears as a text file named StdLog on the desktop. If you use the StdLog command again, the information will be appended to any existing file named StdLog, rather than overwriting it.
Unless you're already in contact with the program's developer, I don't recommend sending a standard log via email as a bug report. Instead, describe the bug succinctly, and indicate you've made a MacsBug log of the problem, which you can send they like. Hang on to the file. Some developers will disagree with me, but, having handled my share of bug reports received via email, large reports with attachments are more awkward than concise notes. Frankly, if a program is in public testing, there should be few new bugs turning up. It's not particularly useful for a developer to receive dozens of log files about a problem that's already known and possibly already fixed.
Another Break Point -- In the next part of this article, we'll take a quick look at using MacsBug to restart machines automatically in the event of a crash. If you'd like more information about MacsBug, check out Apple's MacsBug Reference and Debugging Guide, available in Acrobat PDF format. Although it hasn't been updated since MacsBug 6.2 in 1991, this guide still offers detailed information on the inner workings of Macintosh memory management, plus traps, disassembly, and much more.
In addition, the weekly journal MWJ published a lengthy two-part article earlier this year called MacsBug for Non-Programmers, which discusses several MacsBug features not covered here, including analyzing heaps and both displaying and searching memory. Both parts are reprinted on Ted Landau's MacFixIt site. If you can't get enough insightful Macintosh news, sign up for a free, no-obligation, three-week trial subscription to MWJ in time for their Mac OS 8.5 coverage, or download some free sample issues.
Non-profit, non-commercial publications and Web sites may reprint or link to articles if full credit is given. Others please contact us. We do not guarantee accuracy of articles. Caveat lector. Publication, product, and company names may be registered trademarks of their companies. TidBITS ISSN 1090-7017.
Previous Issue | Search TidBITS | TidBITS Home Page | Next Issue