diff --git a/README.md b/README.md index 8f7d665..5325e94 100644 --- a/README.md +++ b/README.md @@ -81,9 +81,11 @@ in memory for that run only — `build()` still never throws. **Resetting it.** Delete the `server-id:` line; the next start writes a new one. Or set your own value (letters, digits, `_`, `.`, `-`, starting with a -letter or digit; at most 255 characters). A `server-id:` line whose value is -anything else is ignored, and the next start appends a new one to the end of -the file. +letter or digit; at most 255 characters; bare or quoted). Only a `server-id:` +line that starts at column 0, outside the `tags:` block, counts, and the first +valid one wins. A `server-id:` line that is indented, inside `tags:`, or whose +value is anything else is ignored, and if no valid one is left, the next start +appends a new one to the end of the file. **Opting out.** Every [opt-out](#opting-out) below also stops the ID: a disabled client never generates one, never writes one, and sends nothing. @@ -278,7 +280,8 @@ Shade it into a plugin jar; it is one class. is JSON); `tags` always holds at least `version`, and `install` whenever the client has an [installation ID](#every-event-carries-a-random-server-id) and the event is under 32 tags, and the count of a -[coalesced](#repeated-events-are-coalesced) event also carries `coalesced`. The server assigns the +[coalesced](#repeated-events-are-coalesced) event also carries `coalesced` +unless the event already carries 32 tags. The server assigns the timestamp. A `201` is success; anything else is logged at `FINE` and dropped. Redirects are not followed. The body is streamed with a fixed length, so