JavaDoc generation fails on some systems

[schlosna]

What happened?

JavaDoc is failing to generate on system using default US-ASCII encoding

> Task :tritium-registry:javadoc FAILED
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:114: error: unmappable character (0xE2) for encoding US-ASCII
        /* "A common feature of the above techniques???indeed, the key technique that
                                                    ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:114: error: unmappable character (0x80) for encoding US-ASCII
        /* "A common feature of the above techniques???indeed, the key technique that
                                                     ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:114: error: unmappable character (0x94) for encoding US-ASCII
        /* "A common feature of the above techniques???indeed, the key technique that
                                                      ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:115: error: unmappable character (0xE2) for encoding US-ASCII
         * allows us to track the decayed weights efficiently???is that they maintain
                                                             ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:115: error: unmappable character (0x80) for encoding US-ASCII
         * allows us to track the decayed weights efficiently???is that they maintain
                                                              ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:115: error: unmappable character (0x94) for encoding US-ASCII
         * allows us to track the decayed weights efficiently???is that they maintain
                                                               ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:116: error: unmappable character (0xE2) for encoding US-ASCII
         * counts and other quantities based on g(ti ??? L), and only scale by g(t ??? L)
                                                     ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:116: error: unmappable character (0x88) for encoding US-ASCII
         * counts and other quantities based on g(ti ??? L), and only scale by g(t ??? L)
                                                      ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:116: error: unmappable character (0x92) for encoding US-ASCII
         * counts and other quantities based on g(ti ??? L), and only scale by g(t ??? L)
                                                       ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:116: error: unmappable character (0xE2) for encoding US-ASCII
         * counts and other quantities based on g(ti ??? L), and only scale by g(t ??? L)
                                                                                   ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:116: error: unmappable character (0x88) for encoding US-ASCII
         * counts and other quantities based on g(ti ??? L), and only scale by g(t ??? L)
                                                                                    ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:116: error: unmappable character (0x92) for encoding US-ASCII
         * counts and other quantities based on g(ti ??? L), and only scale by g(t ??? L)
                                                                                     ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:117: error: unmappable character (0xE2) for encoding US-ASCII
         * at query time. But while g(ti ???L)/g(t???L) is guaranteed to lie between zero
                                         ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:117: error: unmappable character (0x88) for encoding US-ASCII
         * at query time. But while g(ti ???L)/g(t???L) is guaranteed to lie between zero
                                          ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:117: error: unmappable character (0x92) for encoding US-ASCII
         * at query time. But while g(ti ???L)/g(t???L) is guaranteed to lie between zero
                                           ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:117: error: unmappable character (0xE2) for encoding US-ASCII
         * at query time. But while g(ti ???L)/g(t???L) is guaranteed to lie between zero
                                                  ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:117: error: unmappable character (0x88) for encoding US-ASCII
         * at query time. But while g(ti ???L)/g(t???L) is guaranteed to lie between zero
                                                   ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:117: error: unmappable character (0x92) for encoding US-ASCII
         * at query time. But while g(ti ???L)/g(t???L) is guaranteed to lie between zero
                                                    ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:118: error: unmappable character (0xE2) for encoding US-ASCII
         * and one, the intermediate values of g(ti ??? L) could become very large. For
                                                    ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:118: error: unmappable character (0x88) for encoding US-ASCII
         * and one, the intermediate values of g(ti ??? L) could become very large. For
                                                     ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:118: error: unmappable character (0x92) for encoding US-ASCII
         * and one, the intermediate values of g(ti ??? L) could become very large. For
                                                      ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:122: error: unmappable character (0xE2) for encoding US-ASCII
         * new values of (ti ??? L) become large, and potentially exceed the capacity of
                             ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:122: error: unmappable character (0x88) for encoding US-ASCII
         * new values of (ti ??? L) become large, and potentially exceed the capacity of
                              ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:122: error: unmappable character (0x92) for encoding US-ASCII
         * new values of (ti ??? L) become large, and potentially exceed the capacity of
                               ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:127: error: unmappable character (0xE2) for encoding US-ASCII
         * can therefore multiply each value based on L by a factor of exp(?????(L??? ??? L)),
                                                                           ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:127: error: unmappable character (0x88) for encoding US-ASCII
         * can therefore multiply each value based on L by a factor of exp(?????(L??? ??? L)),
                                                                            ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:127: error: unmappable character (0x92) for encoding US-ASCII
         * can therefore multiply each value based on L by a factor of exp(?????(L??? ??? L)),
                                                                             ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:127: error: unmappable character (0xCE) for encoding US-ASCII
         * can therefore multiply each value based on L by a factor of exp(?????(L??? ??? L)),
                                                                              ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:127: error: unmappable character (0xB1) for encoding US-ASCII
         * can therefore multiply each value based on L by a factor of exp(?????(L??? ??? L)),
                                                                               ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:127: error: unmappable character (0xE2) for encoding US-ASCII
         * can therefore multiply each value based on L by a factor of exp(?????(L??? ??? L)),
                                                                                  ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:127: error: unmappable character (0x80) for encoding US-ASCII
         * can therefore multiply each value based on L by a factor of exp(?????(L??? ??? L)),
                                                                                   ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:127: error: unmappable character (0xB2) for encoding US-ASCII
         * can therefore multiply each value based on L by a factor of exp(?????(L??? ??? L)),
                                                                                    ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:127: error: unmappable character (0xE2) for encoding US-ASCII
         * can therefore multiply each value based on L by a factor of exp(?????(L??? ??? L)),
                                                                                      ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:127: error: unmappable character (0x88) for encoding US-ASCII
         * can therefore multiply each value based on L by a factor of exp(?????(L??? ??? L)),
                                                                                       ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:127: error: unmappable character (0x92) for encoding US-ASCII
         * can therefore multiply each value based on L by a factor of exp(?????(L??? ??? L)),
                                                                                        ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:129: error: unmappable character (0xE2) for encoding US-ASCII
         * landmark L??? (and then use this new L??? at query time). This can be done with
                     ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:129: error: unmappable character (0x80) for encoding US-ASCII
         * landmark L??? (and then use this new L??? at query time). This can be done with
                      ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:129: error: unmappable character (0xB2) for encoding US-ASCII
         * landmark L??? (and then use this new L??? at query time). This can be done with
                       ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:129: error: unmappable character (0xE2) for encoding US-ASCII
         * landmark L??? (and then use this new L??? at query time). This can be done with
                                                 ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:129: error: unmappable character (0x80) for encoding US-ASCII
         * landmark L??? (and then use this new L??? at query time). This can be done with
                                                  ^
/Users/davids/Documents/dev/tritium/tritium-registry/src/main/java/com/palantir/tritium/metrics/registry/LockFreeExponentiallyDecayingReservoir.java:129: error: unmappable character (0xB2) for encoding US-ASCII
         * landmark L??? (and then use this new L??? at query time). This can be done with
                                                   ^
41 errors

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':tritium-registry:javadoc'.
> Javadoc generation failed. Generated Javadoc options file (useful for troubleshooting): '/Users/davids/Documents/dev/tritium/tritium-registry/build/tmp/javadoc/javadoc.options'

What did you want to happen?

JavaDoc succeeds by explicitly specifying expected UTF-8 encoding