Hi Brendan, I answered you too quickly about the stable links in my last post. We do have stable 'deep links' on docs.sun.com. So, you can target http://docs.sun.com/doc/819-3620/chp-script for example and link directly to the scripting chapter, and as long as the chapter ID = chp-script it will persist.
We can also target http://docs.sun.com/doc/819-3620/chp-script-3 and link directly to the third sect1 in the scripting chapter. Cool thing about the new dtrace-doc repo, it makes it really easy to just view the SolBook tagging, which is how I found the chapter and section ids, check it out: http://www.opensolaris.org/sc/src/dtrace-doc/DTrace-Doc Thanks, Michelle 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. :) > > >>> >>> >>>>> Paul Echeverri and myself will be the initial >>>>> leaders, but we welcome help from anyone interested to keep the XML >>>>> sources up-to-date! This project will be called dtrace-doc and will host >>>>> a mercurial repository of the current XML sources. >>>>> >>>>> >>>>> >>>> You might also want to check with Paul to see whether all >>>> previous editorial and structural suggestions have been >>>> incorporated into the current SGML/XML source. If not, >>>> hopefully that incorporation can coincide with the >>>> incorporation of the wiki changes. >>>> >>>> >>> Do we have SGML ID based URLs yet for the DTrace Guide chapters? There >>> are places such as /usr/demo/dtrace where this would be handy. >>> >>> >> Right, Mike P has asked about this too, best thing to do now is point to >> the part number, which is most stable, http://docs.sun.com/doc/819-3620 >> > > Rightio - thanks. > > Brendan > >
