API Notation Syntax for Atom
This is a grammar for api notation, a simple notation I've been using for annotating module APIs in specs and other documents.
Installing
From Command Line
code --install-extension rbdr.api-notation
From GUI
Open the Extension Manager from Palette Manager
- Press
⌘⇧Pon OSX or⌃⇧Pon Windows/Linux to open the palette manager - Look for `Install Ext4ensions
Open the Package Manager from Preferences
- Go to
Code -> Preferences -> Extensionsmenu item
Install it
- Search for
api-notationin the search bar - Click Install
Usage
Open a .api file, or set it as your syntax.
API Notation Reference
The most recent reference as of now is in this textt file, 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
<xx> 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.
