G'Day Michelle, It was good to see you - sorry about hours of AV woes!
So there may be a solution for linking to the DTrace Guide (and in fact, all docs.sun.com content) linking, http://docs.sun.com/app/docs?q=solaris+dynamic+tracing+guide&s=t that gets pretty close; both versions are on there. Problems, 1. the search terms are still active, causing the red-circle icons of relevance, and continue to search for those words once I start reading the guide, eg, "Search results for: solaris dynamic tracing guide No matches found" 2. is this guarenteed to show the newest first? Picture, http://docs.sun.com/app/docs?q=solaris+dynamic+tracing+guide&s=nt so rather than "s=t", it is "s=nt" (or whatever), and the docs.sun.com cgi program is updated to do a title search but to sort by date and to drop the search terms to prevent continual matching. Then, we can all use stable URLs forever! (assuming the document titles don't change greatly). of course, I'm assuming that the docs.sun.com cgi program is one that can be altered, and that someone knows how; and isn't some old inscruitable legacy-ware that no one understands. ... Some background on DTrace Topics - which I'm sure will cross paths with the docs people at some point. The DTrace Topics wiki is an interesting documentation project (still in its infancy; http://www.solarisinternals.com/dtrace). Wikis are good for engineers, as we can dump rough content easily, and then ask talented documentation people to clean up the style, spelling, wording, flow, diagrams, etc. :) And, if a well-meaning documentation person reworded something such that it became wrong (which has happened to me plenty of times - including with the Prentice Hall editors), then the engineer can simply recorrect afterwards. It would be nice to have docs.sun.com guides as wikis (which only select users could edit), but I'm already aware that this requires shifting the mindset of some very stubborn Sun staff (who probably have 4 or 5 digit Sun IDs). It would be nice to have a wiki on OpenSolaris, but that isn't happening soon. Richard has a very good wiki running on SolarisInternals, which is gathing many pages not related to internals or performance (eg, the very popular ZFS Best Practices Gudie). It is where the engineers are starting to hang out. Once we have a lot more popular content on there, I may start a thread on docs-discuss to see if I can enlist help from documentation people to restyle the content. So anyway, the DTrace Topics wiki is an interesting experiment in a future direction of documentation. As time goes on, it will be interesting to see if it really succeeds, and why, or if it really fails, and why... Brendan -- Brendan [CA, USA]
