An unsurprisingly common request on the DTrace discussion forum has been for updated documentation. People have been — on the whole — very pleased with the Solaris Dynamic Tracing Guide that we worked hard to produce, but I readily admit that we haven’t been nearly as diligent in updating it. OK: we haven’t updated it at all.
But we have been updating DTrace itself, adding new variables and functions, tacking on new features, adding new providers, and fixing bugs. But unless you’ve been scraping our putback logs, or reading between the lines on the discussion forum, these features haven’t necessarily been obvious. To that end, I’ve scraped the putback logs, and tried to tease out some of the bigger features, and put them all on the DTrace Change Log. We’ll try to keep this up to date so you can see what features are in the build of Solaris Nevada you’re running or the Solaris 10 release.
This is probably going to be handy in its own right and ameliorate the documentation gap, but we do still need to update the documentation. I’m torn between keeping it in SGML (or converting it to XML), and converting it to a wiki. The former has the disadvantage of being overly onerous to update (witness the complete lack of updates), while the latter prevents us from releasing it in printed form (unless someone knows of a tool that can turn a wiki into a book). If anyone from the community is interested in working on this project, it would be a tremendous help to every DTrace user and developer.
Technorati Tags: DTrace OpenSolaris
3 Responses
I’ve got a fair amount of experience wrangling XML and SGML (c.f., huge amounts of work on the FreeBSD Handbook), so when my Ultra 40 arrives I’ll make a point of looking over the docs.
Please break them out by update release as well.
Hey Adam!
We’ve been using MoinMoin[1] wiki for a while now and AFAIK, there’s a menu option which allows you to export given wiki page to DocBook file. Getting DocBook working might be a little bit of a challenge (for me anyway), but it could be something worth trying.
Another option is to write your documents in reStructuredText[2] markup (MoinMoin understands that too) and it’s possible to generate LaTeX from it and then PDFs etc. It’s my favorite.
[1] MoinMoin
[2] reStructuredText
Cheers,
Tomas