G'Day Michelle,
On Mon, Mar 03, 2008 at 03:29:15PM -0800, Michelle Olson wrote:
> Brendan Gregg - Sun Microsystems wrote:
> >On Mon, Mar 03, 2008 at 02:17:31PM -0800, Michelle Olson wrote:
> >
> >>Brendan Gregg - Sun Microsystems wrote:
> >>
> >>>G'Day,
> >>>
> >>>On Mon, Mar 03, 2008 at 02:37:53PM +1100, Janice Gelb wrote:
> >>>
> >>>
> >>>>docs-discuss-request at opensolaris.org wrote:
> >>>>
> >>>>
> >>>>>I'd like to propose a project to work on backporting the Solaris
> >>>>>Dynamic Tracing Guide changes from the wiki to XML, so we can provide
> >>>>>PDF for DTrace practitioners.
> >>>>>
> >>>>>
> >>>Michelle, maybe you meant this anyway, but wouldn't the value here be
> >>>that of providing updated versions of the DTrace Guide to match specific
> >>>updates of Solaris 10? Simply generating PDFs can/should be doable from
> >>>wikis.sun.com.
> >>>
> >>>
> >>Not that I'm aware of, but feel free to send a PDF along if you have it.
> >>FWIU, we are not updating this book for S10 updates, but I could be
> >>wrong about that.
> >>
> >
> >Login to wikis.sun.com, then use "Info" -> "Export As: PDF". It seems
> >to only do one page at a time - maybe I don't know how to drive it
> >properly. :)
> >
> Um, no, that is the best you get from wikis.sun.com, hence this
> backporting project.
wikis.sun.com is Atlassian Confluence, a commercial product which
I /guess/ Sun pays for. If there is a missing feature that is desired,
I'd be hitting up the confluence forums to see what the developers
have to say.
I didn't get that far, having a quick look in their docs:
http://confluence.atlassian.com/display/DOC/Confluence+to+PDF
So it can export the whole DTrace Guide as a single PDF:
http://wikis.sun.com/spaces/doexportspace.action?key=DTrace
It took the "Exporting Space - In Progress" page about 5 minutes to
complete the export, during which it looks like it isn't doing much
(in case anyone is wondering).
The output is a 313 page PDF contating the entire DTrace Guide. The first
few pages aren't as polished as a docs.sun.com PDF, but the rest of
the guide looks great (thanks to Jon for tweaking the style). I noticed
a few formatting bugs that can easily be fixed in the wiki.
Was there any requirement other than PDF export that the dtrace-docs
project is addressing?
Brendan
--
Brendan
[CA, USA]
