example of using resulting ast

[phamdt]

i've just installed the plugin and it's not clear to me as to how to use the ast file resulting from the parse command. specifically, i see the following warnings:

warning: (3)  unable to parse additional parameter traits, expected '([required | optional], [<type>], [`<example value>`])', e.g. '(optional, string, `Hello World`)' :21574:234
warning: (6)  empty response message-body :25880:13

while the error text is simple enough to understand, it's not clear where i'm looking for each one. it would be helpful then to provide some explanation of the warnings/errors and provide an example error/explanation in the read me.

[phamdt]

also, yes, i did make guesses as to where the errors might be using all of the given numbers and checking with the line numbers in sublime. no indication in code related to messages and in the apiary.io interface, warnings do not show up at all.

[zdne]

@phamdt those numbers are as follows :: you can easily see number of selected characters in SublimeText. However I suggest to use SublimeLinter to see it right in the editing window.

[phamdt]

thanks! i'm guessing you meant :selectedCharCount:somethingElseIStillDoNotGet. the selected chars was enough to find it. also, i did end up installing SublimeLinter and its related packages. for some reason the above two errors disappeared after doing so. regardless, i still think a brief explanation/example in the read me would be helpful.

[zdne]

:)

It is quite simple, albeit it does not look like. Let me illustrate:

---

Where :52:11 means starting at character with index 52 and spanning across next 11 characters (see the first screenshot).

In Snow Crash an error / warning report can span across multiple non-continous blocks of blueprint source text. That is why this string can be something "crazy" like :103:11;118:8;130:14;148:18 (:index:size;index:size ..).

Hope it is a lot clearer now. If you find a good formulation for this that can be put into the README file I will be happy to merge such a PR.