git.r.bdr.sh - rbdr/api-notation.tmLanguage/blob - README.md

   1 # API Notation Syntax for Sublime Text
   2
   3 This is a syntax for api notation, a simple notation I've been using for
   4 annotating module APIs in specs and other documents.
   5
   6 It could work for TextMate since it's a tmLanguage file. But you need to
   7 create a tmBundle and god knows what else. So for now, just Sublime.
   8 Sorry.
   9
  10 ## Installing
  11
  12 ????
  13
  14 ## API Notation Reference
  15
  16 The most recent reference as of now is in this [gist][api-reference], so
  17 check that to be sure. But here's a reproduction of the notation.
  18
  19 ```
  20 NameOfClass.WithPossibleNamespace
  21    + class property
  22    - instance property
  23   ~> listened events (socket)
  24   +> listened events (class/module)
  25   -> listened events (instance)
  26   <~ dispatched events (socket)
  27   <+ dispatched events(class/module)
  28   <- dispatched events (instance)
  29   :: class method
  30    # instance method
  31
  32 Other symbols
  33   => returns
  34 ->() callback return
  35 [xx] optional
  36 <xx> data type
  37
  38 Recommended order: class first, then sockets, then instance. Internally:
  39 Properties, events, methods.
  40
  41 // Anything after two forward slashes is a comment
  42 ```
  43
  44 ## How does it look like?
  45
  46 Like this.
  47
  48 ![Like this.][api-example]
  49
  50 [api-reference]: https://gist.github.com/benbeltran/4694c46fcec131468e34
  51 [api-example]: https://i.imgur.com/ogBqI7O.png