• On TechRepublic: The most disturbing geek movie
advertisement
April 15, 2004 12:49 AM PDT

mac.column.ted: Manuals and monopolies

by CNET staff
Ted Landau
April 2004

Manuals and monopolies

When you have to go a month between columns, sometimes you find you have more than one topic you'd like to cover. This month is one of those times. Rather than pick one and drop one, I decided to go with both.

 

Bring back the manuals

The other week I started a long overdue and dreaded task -- cleaning out the storage area of my basement. In one corner I found about a dozen or so unlabeled boxes. Most of them contained stuff that no longer held any interest to me. But one contained an unexpected surprise: a collection of manuals for Macintosh software dating back to the original MacWrite and MacPaint, Multiplan, FullPaint, Word, Excel, PageMaker and more.

I took a pause from my clean sweep of the basement to browse through these relics of another age -- one last look before sending these manuals to their final resting place. Aside from being an exercise in nostalgia (which I suppose is still appropriate as this 20th anniversary year of the Mac continues), I came away impressed with the breadth and depth of coverage contained in these often large books. As one example, Microsoft's Excel originally shipped with a whole collection of manuals, including one called Excel Reference which listed every function that you could enter in Excel, how each worked and what it did. A Macintosh Reference manual (that shipped with all Macs back around 1990) was over 400 pages long; it covered all basics of the Mac OS plus much that went beyond the basics. Then there was the collection of three HyperCard manuals (which also shipped with every Mac back in the early 90's), with a combined total of yet another 400+ pages. All in all, I calculated that a typical Mac once shipped with over 1000 pages of printed documentation; the combined total of Word and Excel documentation was more than another 1000.

{MacFixIt_StoryBox}

In contrast, my 15" PowerBook shipped with a 130 page Getting Started manual, and a couple of brief pamphlets: grand total less than 200 pages. The documentation for an iMac or iBook these days is even skimpier. The total documentation that accompanies iLife '04 amounts to an 8 page pamphlet with the ironic title "Making the most of iLife '04." Are they serious? Eight pages is all you need to read to make the "most" of five of the more content-rich software programs ever designed for the home consumer market?

I don't mean to single Apple out here. Almost all major vendors have pretty much followed suit. That Excel Reference manual I mentioned a few paragraphs ago? It no longer ships with Excel (at least not as part of the Office package I have). In fact, Office ships with virtually no printed documentation at all. I also recently purchased the Adobe Premium Creative Suite (a super bargain at the educational discount price of less the $400, assuming you qualify). It came with just a skimpy "Design Guide" (although there is more extensive documentation included on the CDs).

So what happened? Why did these manuals vanish over the years? There are several commonly accepted theories, and they are probably all at least partially true -- although, in my view, none of them justify the result:

    No one reads the manuals anyway. In fact, being able to successfully use a Mac without reading any manuals is considered part of the allure of the Mac. So why bother making them? While most users can indeed get work done on a Mac without ever checking a manual, they will be unaware of many noteworthy features that do not typically get found just by exploring. Probably half the Mac tips that are posted on various Web sites are sufficiently basic that they should have been included in material that came with the software. You shouldn't need to go to a Web site to find them. Here are two quick examples regarding Mac OS X:

      What's the difference between dragging a document and Command-dragging? The documentation that comes with your Mac does not say.

      What's a Safe Boot and why do it? Don't expect the Getting Started guide that came with your Mac to reveal this useful tip.

    In my experience, Adobe software (such as Photoshop and GoLive) is perhaps the worst case scenario. Granted, Adobe's products are laden with high-end features designed for professionals, but almost nothing about how they work is self-evident. Even with the aid of the software's built-in help, it often takes me several tries to figure out how to do the most basic tasks. Adobe's products scream for decent documentation.

    More generally, despite the common folklore about users not wanting to read manuals, there is clearly a healthy interest in printed documentation. As I recall, David Pogue's "Missing Manual" book on Mac OS X was the number one best selling computer book of the year -- not just Mac computer book, but any computer book!

    Printed manuals are expensive. Vendors eliminated them to save money. Printed documentation adds two significant costs for a vendor: the cost of producing and printing the manual and the cost of packaging and shipping the manual. Paying someone to write the manual is usually small potatoes in comparison, but is still more than zero. Eliminating all of these costs obviously helps increase profit margins. This is almost certainly the driving force behind why printed manuals are on the endangered species list. Some vendors (as in the Adobe example I mentioned earlier) at least produce a manual and include it as a PDF file on the software's CD. I can also attest that Apple's Final Cut Express similarly comes with decent on-CD documentation. Other products do not bother with even this minimal support.

    Not that a PDF manual is a completely adequate substitute for printed documentation. For starters, reading a manual on a screen is not as convenient as browsing through a hard copy. You can't quickly thumb back and forth between two chapters, for example. Yes, you can print these PDF files, but you wind up bearing a significant expense to get a stack of paper that is much bulkier than a book. And if the manual includes color, your print out won't show it unless you want to pay more for the manual than for the software itself!

    You can use Web-based or "built-in" Help files instead of a manual. An application's Help command certainly has its value. When you want a quick answer to a common question, nothing is faster (assuming the quality of the Help files are sufficient, which is not always the case). For example, the other day I wanted to do a mail merge in Word using an Excel file as the database. It had been years since I had done this, so I went to Word's Help files for assistance. They came through, and I was soon on my way.

    But the same arguments against on-CD manuals apply to Help files as well. Plus Help files are typically much briefer (often too much briefer) than either printed or on-CD documentation. And if you just want to explore the features of your software, with no specific question in mind, the Help format is far from ideal. Personally, if I have well-written printed documentation, I can enjoy reading it almost from cover-to-cover. (OK, I admit I am not typical here!) There is no way that online help can duplicate this.

    You can buy a book if you really want a printed manual. As someone who has written books about the Mac, I would certainly not argue against the value of third-party books as a supplement to manuals that come with software. But buying a book should not be a requirement to get the minimum information the vendor should provide. In any case, shelling out an additional 40 dollars or more for every significant piece of software you own can become prohibitively expensive. If vendors are determined to eliminate manuals from their software package, they could at least include a coupon to get a discount on any related book.

Now that I think about it, maybe I won't part with all of the manuals I found in my basement -- especially as I don't hold out much hope for software publishers reversing their current direction. For starters, the Excel reference looks like it could still be useful today. Perhaps vendors need to hear more complaints from users before they consider a shift in policy. If so, consider this column to be my submission to the complaint department.

 

Microsoft's monopoly and the European Union

As you have probably heard (check here if you haven't), the European Union (EU) hit Microsoft last month with a $613 million fine. By itself, that probably won't bother the company all that much. What potentially really hurts (assuming Microsoft loses its appeals) is that the EU also required Microsoft to create a version of Windows minus its Windows Media software. Why? Because by bundling its media player with Windows, the EU claimed that Microsoft was blocking legitimate third-party competition for media software (with Real Player and QuickTime Player the most often cited alternatives). This same logic, the EU warned, might be applied to other Microsoft products in the future, if it perceives a similar artificial dominance gained by Microsoft's monopoly of the market.

This all got me thinking of a statement I made in my column last month: "If Apple had Microsoft's overall market share, it might be Apple that the DOJ was investigating for monopoly-like practices."

Indeed, Apple bundles QuickTime Player with its Macs. No other player is included. So how is this any different from what Microsoft is doing? Or isn't it really different at all?

I believe it is different - for two significant reasons.

    Apple's hardware division is not complaining. Complaints about Microsoft's practices come not only from the vendors that make the competing media player software but from hardware PC makers. The reason behind the hardware vendors' complaints is summarized in the following quote from a consumer organization's document published in 2001:

      Microsoft insists on equal or superior location for its products if a competitor is shown on the desktop. Further, Microsoft insists on being paid for all the programs, regardless of whether the computer manufacturer wants to use them all.

    Microsoft has further been accused of threatening to prevent PC makers from installing Windows at all if a blacklisted competing software product was included on the Desktop.

    With Apple, there are no such conflicts with hardware vendors. As the only hardware vendor for its OS software, Apple could only complain to itself about what software comes or does not come with its hardware.

    Size matters. Of course, third-party software vendors can still complain about Apple's policies. And they often do. But here is where Apple's measly sub-5% market share comes to its rescue, at least from a legal perspective. Essentially, the presumption is that if Apple does something that most vendors see as unfair, the vendors can choose not to write for the Mac platform at all - and go elsewhere instead (as in Windows). As long as there is an "elsewhere" to go, let the free market reign. If Apple's policies turn out to be unwise, it is ultimately Apple that will suffer the most, not the third party vendors. Apple itself admitted as much in this year's annual report to stockholders:

      The Company's future performance is dependent upon support from third party software developers. If third-party software applications cease to be developed, then customers may choose not to buy the Company's products. [For example,] if customers choose not to purchase the Company's products because Internet Explorer is not available on the Macintosh platform,...the Company's net sales...could be materially adversely affected.

Still, within the confines of Apple's market share, one could argue that Apple's behavior does represent something akin to what Microsoft does. And when I look at it that way, I admit to having some sympathy for Microsoft's position. I mean, if the situation was reversed, and Apple was the dominant player, would I really want to prevent Apple from including QuickTime Player on all Macs (and, even worse, including Real Player instead)? Would I prefer if iTunes did not ship with each Mac? I don't think so.

But I can't work up too much sympathy for Microsoft here. What really irks me about Microsoft's behavior is its incessant drive for dominance over everything. I mean, how much less money would Microsoft have today if Netscape was still the dominant Web browser? Why does Microsoft feel compelled to challenge Google for search engine supremacy? And how bad would it be for Microsoft's bottom line if iTunes became a defacto standard for PCs? Especially since all the software in question is "free"? Well, there is money to be made even with free software -- such as the advertising revenue that Google attracts. But Microsoft's goals here are not always about money -- at least not in the short run. Microsoft's concern is more often about control. If Microsoft's browser dominates the market, it can control how Web developers design their sites. How? Well, if a designer doesn't follow Microsoft's rules, such that the site does not work with Explorer, Explorer users will be unable to browse the site. And if many sites only work well with Explorer, users will be reluctant to shift to another browser. The current war over music media dominance is similarly about control. Control translates into money in the long run. For my money, however, Microsoft already controls enough. The music media war is one that I hope Apple wins.

 

Utility of the month: Preferential Treatment

You're having some odd problem -- such as a failure to print in Safari. You think it's due to a corrupt preferences (.plist) file. But you are not sure which file is the culprit. Is it a .plist file for Safari, Printer Setup Utility, or some process more general to the OS itself? You can use trial-and-error to figure this out. Or you can use Preferential Treatment. It's essentially a more user-friendly GUI for the plutil command (as used in Terminal). It tells you if a .plist file is not a valid XML file. This won't detect all possible forms of corruption, but it's a good starting point. And be sure to check out the included Help file for much useful background information (and no, I did not expect a printed manual to come with this shareware utility!).

 

Ted Landau is the creator of MacFixIt and author of the soon-to-be-published Mac OS X Help Line (Peachpit, 2004). Check it out at www.macosxhelpline.com.

This is the latest in a series of monthly mac.column.ted articles by Ted Landau. To see a list of previous columns, click here. To send comments regarding this column directly to Ted, click here.

Resources

  • here
  • my column last month
  • document
  • Preferential Treatment
  • www.macosxhelpline.com
  • click here
  • click here
  • More from Mac Musings
  • Recent posts from MacFixIt
    iTunes 10 user interface sees some minor changes
    Apple seeds iOS 4.1 Gold Master to developers
    Possible fix for Harman Kardon iSub problems with PowerPC Macs
    Precautions to take before installing iTunes 10
    A reminder on how to reset your Mac's system password
    Mail messages appearing blank
    Adobe Lightroom update brings direct Facebook publishing; Camera Raw 6.2 released
    Weekly troubleshooting utilities update
    Add a Comment (Log in or register) Showing 1 of 2 pages (29 Comments)
    by totidimalanta April 15, 2004 2:56 AM PDT
    The computer industry, hardware and software alike, seem to conduct their
    business this way: "We will have to forego the printing of manuals and give
    you PDF files instead. In return, we'll charge you the cost of the manuals. That
    way we'll make double the profit."
    Reply to this comment
    by RBK1958 April 15, 2004 5:36 AM PDT
    Yes, the printed manuals are history. Yes, by not producing them the
    companies make more profit. But, by not taking the time for production
    of the manuals they are also able to get their products to market faster,
    in smaller packages, and with less eventual waste in the landfills of the
    world.
    Reply to this comment
    by zehspoon April 15, 2004 5:36 AM PDT
    <class="merchant"><span>&#62;</span><div class="datestamp"><i>This is a reply to a previous comment by RBK1958</i></div></class><br />
    &lt;But, by not taking the time for production of the manuals they are
    also able to get their products to market faster, in smaller
    packages, and with less eventual waste in the landfills of the
    world.&gt;

    I noticed that the boxes are still as large as they were and the
    companies are using embossing. Embossing costs far more than
    regular printing. Embossing has to use a die made out of materials
    that don't go well in landfills either. Then again, if we keep paper
    out of the landfills it gives more room for things that DON'T
    decompse, like CRT screens, Motherboards, Disk drives, etc.
    Reply to this comment
    by nyip14 April 15, 2004 5:36 AM PDT
    <class="merchant"><span>&#62;&#62;</span><div class="datestamp"><i>This is a reply to a previous comment by zehspoon</i></div></class><br />
    That's true. I would tend to blame this on the user/buyer. Can you imagine spending $999 for software that just comes in a CD size envelope? Size matters, I'm afraid. The big glossy box gives buyers the illusion that they're getting some value for their money.
    Reply to this comment
    by sturner--2008 April 15, 2004 5:36 AM PDT
    <class="merchant"><span>&#62;</span><div class="datestamp"><i>This is a reply to a previous comment by RBK1958</i></div></class><br />
    The real trouble with this thinking is that the user ultimatly loses out. Help files do not fill the void left by not having a manual. The example? Try doing anything in Word or Excel that is complex. You will eventually find that there is a gap of knowledge that the Help files do not address. Either they are too focused, or to diffuse in their approach.

    I have used thier written manuals, and they were adequate to a new user or power user's questions.

    In the Technical Writing industry, of which I am a member, Microsoft documentation, Help files in particular, are known as technically correct, but totally useless documents.
    Reply to this comment
    by Dave K April 15, 2004 9:26 AM PDT
    Since the days of the Mac Plus, my fellow Mac users always asked how I knew
    so much about Macs and Mac software. I never shared my "secret"- that I
    actually bothered to read the manuals! As one of my professors used to say,
    RTFM!!

    So, I too mourned the demise of printed documentation. Online
    documentation is NEVER an acceptable substitute.

    At the same time though, this has created a void that has been more than
    filled by some GREAT 3rd party manuals. In particular, David Pogue's
    "Missing Manual" series.

    So, in the end, I guess I could say that printed documentation has actually
    improved. It does cost more, so the trade-off value is up to the user.

    Dave
    Reply to this comment
    by ljocampo April 15, 2004 9:26 AM PDT
    <class="merchant"><span>&#62;</span><div class="datestamp"><i>This is a reply to a previous comment by Dave K</i></div></class><br />
    Never say never... w3c apache open source to name a few.
    Reply to this comment
    by Lou Zer April 15, 2004 9:43 AM PDT
    I think a valid point here, though, is that all these great manuals are sitting in your basement. After a read or two, they're just space wasters.

    On top of that, with large numbers of users in a company, getting manuals for everyone can be considered overkill.
    Reply to this comment
    by ted1--2008 April 15, 2004 9:43 AM PDT
    <class="merchant"><span>&#62;</span><div class="datestamp"><i>This is a reply to a previous comment by Lou Zer</i></div></class><br />
    The manuals are in my basement because they refer to now obsolete or
    out-of-date software, not because I used them once or twice and then
    dumped them.

    I still have two shelves by my desk that contain manuals and books for
    software that I currently use.

    Still, I agree that giving manuals to all users, when only a percentage of
    the users will actually ever read the manual, is a valid argument against
    wide distribution of manuals. Maybe my coupon suggestion is the
    answer in this case.

    Ted Landau
    Reply to this comment
    by ted1--2008 April 15, 2004 9:43 AM PDT
    <class="merchant"><span>&#62;</span><div class="datestamp"><i>This is a reply to a previous comment by Lou Zer</i></div></class><br />
    The manuals are in my basement because they refer to now obsolete or
    out-of-date software, not because I used them once or twice and then
    dumped them.

    I still have two shelves by my desk that contain manuals and books for
    software that I currently use.

    Still, I agree that giving manuals to all users, when only a percentage of
    the users will actually ever read the manual, is a valid argument against
    wide distribution of manuals. Maybe my coupon suggestion is the
    answer in this case.

    Ted Landau
    Reply to this comment
    by nyip14 April 15, 2004 9:43 AM PDT
    <class="merchant"><span>&#62;</span><div class="datestamp"><i>This is a reply to a previous comment by Lou Zer</i></div></class><br />
    Hmmm, let me present a slightly different view.

    1. For one thing, some (lucky) manuals don't become obsolete - such as the Excel reference. Excel functions have not changed much and aren't likely to change.

    2. Giving users PDF soft copies is fine; except that many people end up printing them anyway. So either way, they end up with printed manuals, but they cost more to print on their laser printer, and don't save any trees.
    Reply to this comment
    by sturner--2008 April 15, 2004 9:43 AM PDT
    <class="merchant"><span>&#62;</span><div class="datestamp"><i>This is a reply to a previous comment by Lou Zer</i></div></class><br />
    In most companies you are now expected to know the application and not need a manual. This is difficult when you have a new application loaded on your machine, and you have never used it before.

    The IT department may have, at one time confiscated all manuals for software that they installed, and kept them in a central location. The effect was the same as today when the Software companies don't ship a manual. The user is left clueless.

    Try learning an application by discovery, with only the pitiful excuses for Help files that come with the program.

    I've done that for Microsoft Project. It is not a pleasant experience.
    Reply to this comment
    by MacFinn April 15, 2004 9:59 AM PDT
    On manuals: InDesign CS (and every version since 1.0) ships with a pretty
    good, thick printed manual. As to how good it really is, I don't know, haven't
    read it, just searched for some specific info.
    But to the main point: MS Windows Media Player vs. Quicktime player. There's
    a big difference. Apple ships all Macs with Safari, Quicktime Player etc. But
    the user can (and does) install any browser, player whatever and OS X doesn't
    interfere, you really can use any browser/player as the default. Try that in
    Windows. It's almost impossible not to use WMP at all. Just try getting rid of
    Explorer and you'll see.
    To me, that's a big difference!
    Reply to this comment
    by ted1--2008 April 15, 2004 9:59 AM PDT
    <class="merchant"><span>&#62;</span><div class="datestamp"><i>This is a reply to a previous comment by MacFinn</i></div></class><br />
    True enough. To be fair, I have found that you can install the alternatives
    on a PC and use them well enough. Getting rid of the MS software,
    however, is indeed a problem. And getting it not to be the default can be
    a problem as well (although I have used Windows so rarely in the last
    year or so that I honestly don't recall exactly how difficult that may be).

    - Ted Landau
    Reply to this comment
    by ljocampo April 15, 2004 10:59 AM PDT
    On Manuals... Gosh I'm sure glad the print versions are gone. Everytime I
    moved I had more weight in outdated manuals than in furniture. I'll go
    one step further... thanks for online software distribution. Now I don't
    have to wait days to get the program and I can buy it at 3 in the
    morning. These conveniences to me surely out-weigh the loss of the
    manuals.

    On Monopolies... Microsoft and Apple are both in this category. But
    there are big differences in how they choose to exercise their power. It
    comes down to choice. Apple does give you a choice in software and
    doesn't interfere because it balances its profit margin with hardware.
    Microsoft has never given anyone a choice with respect to its
    technologies, unless forced to, but then
    again it doesn't have the hardware asset to fall back on.

    That said, I hate Mircosoft with such a passion, I keep a Bill Gates voodo
    doll on my desk with needles and all, and can't wait for the global open-
    source inititive to send Mircosoft packing its bags.

    ljocampo
    Reply to this comment
    by John Sawyer April 15, 2004 2:52 PM PDT
    On manuals: Maybe there should be some middle ground. Many of my Mac repair clients ask me where they can get a good book on the Mac OS; I tell them many Mac stores and bookstores. It illustrates that many people want manuals, and will probably use them too. So, commercial software should always come with a decent, not-too-thick printed manual that explains how to use all the commands in the program, but not a superthick one which goes into every final detail about the program. If the user wants a more thorough manual, Ted's idea about a coupon is a good one, but maybe the coupon could also be for a manual from the software publisher too. The trouble with this is (and none of these solutions is going to be perfect), is that most people will complain if they have to spend extra money, even at a discount, for a manual they feel should have been included in the original purchase price.
    Reply to this comment
    by fungiblemac April 15, 2004 3:15 PM PDT
    On manuals: I've been learning about MySQL and PHP, and thrown in a bit of
    HTML. The MySQL comes with a PDF manual; the PHP and HTML with HTML
    manuals. Which is easiest to browse for examples and details? MySQL, by far
    - because of Preview, which is the best single app in Panther. The Search box
    is fantastic. (Plus MySQL has a very, very good manual, even if it is 869
    pages.)
    I don't miss the paper manuals. I prefer stuff as PDFs now, given Preview.

    As for monopolies - the point made that you can remove Safari etc is a good
    one. But the reality is that it's the monopoly position, or more precisely the
    *abuse* of that position, that bugs people. It's not - repeat, not - illegal to
    have a monopoly in anything - including desktop operating systems. It *is*
    illegal to abuse that monopoly to dominate other sectors, which is what
    Microsoft has done repeatedly.
    If Apple could get into that position, we could start the whole debate again.
    But it's a non-issue while people have choice. And always remember that
    monopolies are legal. Only extending them unfairly isn't.

    Charles
    Reply to this comment
    by dontspammeplease April 15, 2004 3:31 PM PDT
    Here at my office we have a high speed Xerox Docucolor laser printer. We run
    a huge volume through this device and as a result get charged about 10ยข/
    page for color, and 2ยข/page for black and white prints. These prices are FAR
    below what you'd get at Kinko's or a similar location.

    At these prices, it would cost between $20 and $100 to print a 1,000 page
    manual. (About the size of Photoshop's manual.) Truly a prohibitive cost,
    particularly if you're buying an upgrade (which is usually only about $150).

    Online help is fantastic, and I use Excel's online function reference all the
    time (and in many ways prefer it to a printed version of the same, due to its
    searchability). But to LEARN a program, nothing beats a good manual. The
    hours I spent reading Photoshop's manuals has helped my career immensely.

    These days it's considered normal to seek training classes and to be called a
    Dummy or worse until you spend inordinate amounts of time and money
    learning new computer skills. Given this, is it any wonder people don't want
    to read manuals? They've been quite specifically trained to NOT help
    themselves!

    However, this does support a thriving industry in computer training... Perhaps
    that's not a terrible thing after all...
    Reply to this comment
    by hamarkus April 15, 2004 4:27 PM PDT
    On manuals, isn't more choice usually a good thing? Having only to pay for a manual when you want one should be a positive thing. I'm thinking of the situation where you can order a manual from the software developer.

    Although this might be more costly for the individual user who orders the manual because of the additional handling and shipping cost, overall integrated costs over all users probably are lower.
    Reply to this comment
    by taylore April 15, 2004 6:05 PM PDT
    I agree with the adage that no one reads manuals. The only time you read a
    manual is when you're stuck, so you're looking for some very specific help,
    probably in a short how-to format.

    After you've learned the first 10 programs, bought several computers, etc
    you've got a dead forest stacked on your shelf and you generally have to
    burrow through it to find the one you want, plus figure out what keyword
    they used in the index to describe what you want to know about, and then
    navigate there and see if it really is what you want. Basically a lot more hassle
    than the ease of typing in a keyword search in a search box.

    Panther's Preview can show you keywords on the entire manual in a couple of
    seconds. Adobe packages quite excellent html help with their current crop of
    programs. MS has that weird little Banana PC Jr... they're all a high speed way
    to get a how-to, imho. Kudos to the other guy who mentioned Panther
    Preview. Can't emphasize enough how cool it is!
    Reply to this comment
    Showing 1 of 2 pages (29 Comments)