From: Ben Beltran Date: Sat, 5 Sep 2015 20:07:42 +0000 (-0500) Subject: Adds placeholder readme X-Git-Url: https://git.r.bdr.sh/rbdr/api-notation.tmLanguage/commitdiff_plain/190aa87edc7ddae6df2fc9b619d63df24ce75cdd Adds placeholder readme --- 190aa87edc7ddae6df2fc9b619d63df24ce75cdd diff --git a/README.md b/README.md new file mode 100644 index 0000000..c84c451 --- /dev/null +++ b/README.md @@ -0,0 +1,47 @@ +# API Notation Syntax for TextMate & Sublime Text + +This is a syntax for api notation, a simple notation I've been using for +annotating module APIs in specs and other documents. + +## Installing + +???? + +## API Notation Reference + +The most recent reference as of now is in this [gist][api-reference], so +check that to be sure. But here's a reproduction of the notation. + +``` +NameOfClass.WithPossibleNamespace + + class property + - instance property + ~> listened events (socket) + +> listened events (class/module) + -> listened events (instance) + <~ dispatched events (socket) + <+ dispatched events(class/module) + <- dispatched events (instance) + :: class method + # instance method + +Other symbols + => returns +->() callback return +[xx] optional + data type + +Recommended order: class first, then sockets, then instance. Internally: +Properties, events, methods. + +// Anything after two forward slashes is a comment +``` + +## How does it look like? + +Like this. + +![Like this.][api-example] + +[api-reference]: https://gist.github.com/benbeltran/4694c46fcec131468e34 +[api-example]: ????