[dtrace-discuss] dtrace language reference

Michael Shapiro
Mon, 14 May 2007 22:59:57 -0000

> Guys, it really *isn''t* all there.  I''ve got a couple of
bugs in
> already on finding the definitions of various pragmas; I just looked
> and the section Jon mentioned doesn''t ... well, to start with it
> doesn''t exist in the docs.sun.com version, but the two sections
that
> seem MECE and to sum to it don''t really say anything about
comments
> either --- although there are examples of C slash-star comments.  But
> then there are things that look like sharp comments, but I know by
> experimentation that they work as comments sometimes and other not.
> (I was misled by the similarity to Awk to think it was a sharp-comment
> language instead of a C comment language.)
>
> I guess the underlying point here is that it''d be nice if there
were a
> syntax summary somewhere.

Comments are described in Chapter 1 in the examples, but I guess we need
to call that out more explicitly.  In terms of syntax reference, Chapters
1-10 are effectively the complete reference.  Please file bugs on things
that are omitted, and our apologies.  In terms of a "syntax summary"
not
sure what you''re looking for -- list of examples?  A copy of the
grammar?
Maybe if you give us a quick sketch of what you think would be helpful
we can try to incorporate that into the web site and/or DTrace guide.

-Mike

--
Mike Shapiro, Solaris Kernel Development. blogs.sun.com/mws/