Prime Time Freeware Manual: the Dossier Series 66
| Prime Time Freeware Manual: the Dossier Series | |
| author | (Various) |
| pages | (Various) |
| publisher | Dossier/Prime Time Freeware |
| rating | 8 |
| reviewer | doom |
| ISBN | (N/A) |
| summary | Free documentation worth paying for. |
You're all of course aware that there's a huge quantity of excellent technical material on-line about the free/open software that you use ... but how much of it have you actually read? Computer's being what they are -- noisy glowing bulky contraptions with awkward physical controls and displays with a resolution a fraction of paper publications -- most of us aren't inclined to read long works on line. So the next step is where you resolve to do printouts of some of the manuals... and then you discover how long they really are. Many a project can fill multiple looseleaf binders with a single-sided printout of its docs. But if you spend about half a day on it you can probably figure out how to get a nice double-sided printout in a smallish typeface and squeeze it all into a single looseleaf binder... which turns out to *still* be too bulky to want to carry around with you. RTFM is easier said ...
The solution to this is of course professionally printed editions of the manuals. These have been easy to get for GNU software for some time -- the GNU Project standardized on documentation in 'texinfo' format which they use to generate both their online documentation and a very good series of books.
But all that is free is not GNU, and filling that gap is one of the goals of the Dossier series, which uses some semi-automated procedures to generate high-quality, up-to-date hardcopy-on-demand publication.
Thus far they've got books out on the following topics (available on-line through the BSD Mall):
- C, etc.: Essential Tools
- Email: Exim 3
- Email: Mail and Sendmail
- File Systems: FreeBSD
- File Systems: RedHat
- Kernel: FreeBSD
- PostgreSQL: Programming
- PostgreSQL: Reference Manual
- PostgreSQL: Use and Administration
- Processes: FreeBSD
- Processes: RedHat
- Python: Library Reference
- Python: Miscellanea
- Security: Local System
- Security: Remote Access
- Text Processing: Essential Tools
- User Commands: FreeBSD
- User Commands: RedHat
Some of the prices might seem a little high for works based on free content (usually $30 to $35 per volume), but on the other hand these are for small press runs without much in the way of economies of scale going for them. And it certainly beats messing with doing print-outs yourself. (Though if you want to go that route, Dossier can help take the sting out of that process: they offer online access to PDF versions of these works, which is much more inexpensive than paying them to ship you bound volumes.)
When I first heard about Prime Time Freeware/Dossier, I immediately ordered the Postgresql documentation, a set which fills three volumes. At that time the only Postgresql book out was Bruce Momjian's which only covered up to version 7.0. At the speed the postgresql development team was working, having docs more than one release behind was definitely a problem (outer joins weren't even supported in 7.0!). I really appreciated having some books I could flip through that discussed the actual state of the software (and man, there are some weird features in there I didn't know about ... graphical data types so that you can try and use postgres as a backend to a CAD system?).
Next I started looking at the volume on "Text" (now renamed "Text Processing" ... which is a shame, in my opinion. I thought it was really funny putting "Text" on the same level as "C" and "Python"). This is a book I would have liked to have some years ago when I needed to understand troff/nroff for man-page hacking (the only time I ever bought one of those 4-inch-wide junk books the 80s were buried under was to get a copy of "UNIX UNLEASHED" because it had a table of *roff commands ... it still bugs me that I had to do that).
One of the things that struck me immediately about this "Text" volume though, was that there were some utilities discussed here that I'd never heard of before, e.g. a2ps which has some decent features for formatting docs for postscript printers. I'd never run across it before, in part because it wasn't installed by default on my RedHat 7.x box. It's a pretty funky command that does a bunch of things automagically that are sometimes hard to predict, but if you need printouts of some docs, I recommend giving a2ps a try for double-column duplex output -- but only if you can't get them from some place like Dossier (yet).
Rich Morin has been working on the problem of making it easier for users of open systems to get information about them for some time, hence The Meta Project, which thus far has resulted in "Meta Demo," aka the FreeBSD Browser. The Dossier series is a spin-off of this research in documenting open systems... check-out the Meta Project sometime. (I'd like to see that system browser extended to cover Linux, myself).
Slashdot welcomes readers' book reviews -- to see your own review here, read the book review guidelines, then visit the submission page.
I like it (Score:3, Interesting)
dead tree is bad (Score:0, Interesting)
Get with the program. Instead, donate your money to something useful, like a palm pilot, or a pocket or tablet pc. That way you are saving the environment as well as supporting a good cause (namely yourself).
Re:dead tree is bad, but... (Score:4, Interesting)
Perhaps the test is hpow long you're going to use the book.
Does anyone out there read books on PDA's? How do you find it compared to reading from the computer or reading from a dead-tree book?
Re:Split Opinion (Score:3, Interesting)
Re:dead tree is bad, but... (Score:5, Interesting)
I have nearly switched 100% to reading on my Sony Clie, and I prefer my trusty PDA for most reading tasks. For one thing you can fit a pile of books onto a 128M Media Stick. I also like being able to read in the dark, and I really like the fact that as long as I have my PDA I always have a book to read. I am convinced that for casual reading there is no better way to go than a PDA.
Computer documentation, on the other hand, is somewhat more difficult. I have several computer textbooks on my PDA including: "Structure and Interpretation of Computer Programs," "The Emacs Lisp Manual," and "The Zope Book" to name a few. In fact, most everything available at the Linux Documentation Project is available in Plucker format. However, with computer text you generally have to be at least somewhat careful with line wrapping. A lisp function that looks fine formatted at 80 chars a line probably doesn't look so hot when you only have 40 characters per line, and if the book includes pictures then you are even worse off. PDA screens (at least Palm-based PDA screens) are still too narrow and offer too poor of a resolution for books with pictures or source code listings (IMHO).
Go to Baen's web site [baen.com] and download David Drake and Eric Flint's Belisaurius series and read that instead.
The Meta Project - FreeBSD browser (Score:3, Interesting)
Here's a sample from the FreeBSD browser, showing a metric arseload of info about the vi [cfcl.com] command. This page includes pointers to the vi man page, lists of other programs that are really symlinks to vi (and their respective man pages), config files used by vi, and temp files created by vi: all just a click away.
Here's another FreeBSD browser page for
Unix is complex, it is hard to succinctly show the interelations between all of the many pieces. The FreeBSD browser is a really nice step in the right direction!
Advantages (Score:3, Interesting)
A few additions about the Dossier books (Score:3, Interesting)
The physical quality of the books is pretty good: they're roughly comparable to the trade paper backs that you get from O'Reilley or the Free Software Foundation.
I mentioned the pricing of the books, but neglected the pricing of the PDF subscription service: $15/year/volume gets you a subscription to the current PDFs based on the latest versions of the documentation. There are somewhat cheaper deals if you order more, e.g. the three Postgresql volumes I discuss are probably a "topical set", so a subscription to PDFs of all three of them would be $10 * 3 = $30/year.
I didn't talk about the PDF option much because personally I'm not that interested in it: I want pages trimmed and bound like a real book. But it's option you should know about to make your own decisions.
Does the cost of the PDF seem excessive? Well you know, if you think you can do better, no one is stopping you (if you haven't tried it yet: formatting on-line docs in a reasonable way for paper printout is probably harder than you think).
And in defense of my quasi-review here: what kind of review would be *preferable* for these kinds of books? The source material for them is out there on the web, you can go and skim it yourself... though probably you know what it's like, more or less. (However: don't just assume it's all man pages. The postgresql docs are considerably better fleshed out than that.) My take is: does it help to have the information in this form? What do you get out of it that you wouldn't get from having it on your hard drive (or on the web)? And in case it isn't clear, the point is that you tend to do a different kind of browsing with books than with computers, and so you learn about slightly different things.