Sometimes you are including code in your example that must not be translated to other languages. A perfect example of this is the documentation of vertx-unit, because some part a really specific to Java (integration with junit) and does not need to be translated into JavaScript or Groovy. In addition, only the java version should be used in the generated documentation.
For support this feature we could add a translate=false attribute to the @Source annotation. When this attribute is found, the Java version of the code is used regardless the current language.
cescoffier
commented
9 years ago
Sometimes you are including code in your example that must not be translated to other languages. A perfect example of this is the documentation of vertx-unit, because some part a really specific to Java (integration with junit) and does not need to be translated into JavaScript or Groovy. In addition, only the java version should be used in the generated documentation.
For support this feature we could add a
translate=falseattribute to the@Sourceannotation. When this attribute is found, the Java version of the code is used regardless the current language.