Todd V. Jonker
Todd V. Jonker
Several things have gone wrong with the documentation surfaced at https://www.javadoc.io/doc/com.amazon.ion/ion-java/latest/index.html * The entire [`com.amazon.ion.impl`](https://www.javadoc.io/static/com.amazon.ion/ion-java/1.9.6/com/amazon/ion/impl/package-summary.html) package tree should not be publicly documented. * Any class prefixed `_Private_` should not be...
(Isolating a defect identified amidst #226) The reader is computing incorrect line numbers inside multi-line structs and lists (but not sexps). The following test case illustrates: ``` import static com.amazon.ion.util.Spans.currentSpan;...
DO NOT MERGE! For illustration only. I updated most (if not all) of the examples in the spec to illustrate how separators work as a replacement for argument groups. I've...
One fundamental capability of Ion 1.0 is that any document can be transcoded between text and binary without access to any shared symbol tables, even without evaluating local symbol table...
Many sections are hand-wavy about this since it's not yet determined in detail.
I forgot how to use terms I defined many years ago. The new content misuses "local symbol table" in place of "current symbol table". The legacy spec is clear that...
This aligns with my understanding. However, I was confused by the prior statement that: > to a large degree, it's as if .... `macro_table` clauses all have `$ion` as their...
Follow-up TODO from #219
> Macro types are significantly different from the other types. Assuming we add return-type specifiers (it's been accepted in concept but not written up), the modifier here is effectively double-bookkeeping...
It's unclear whether this macro is useful and what its arguments should be. * https://github.com/amazon-ion/ion-docs/pull/249/files#r1222134984