This is an automated email from the ASF dual-hosted git repository.
joshtynjala pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/royale-docs.git
The following commit(s) were added to refs/heads/master by this push:
new 9b2dc1e compiler-options: added allow-abstract-classes,
allow-private-constructors, allow-import-aliases, strict-identifier-names,
js-vector-emulation-class, jsx-factory, source-map-source-root,
export-*-symbols prevent-rename-*-symbols, and all other prevent-rename
granular options
9b2dc1e is described below
commit 9b2dc1e1c208b1fb959b3e6870bcb2d9a7c95b76
Author: Josh Tynjala <[email protected]>
AuthorDate: Mon Nov 23 13:49:47 2020 -0800
compiler-options: added allow-abstract-classes, allow-private-constructors,
allow-import-aliases, strict-identifier-names, js-vector-emulation-class,
jsx-factory, source-map-source-root, export-*-symbols prevent-rename-*-symbols,
and all other prevent-rename granular options
---
compiler/compiler-options.md | 514 +++++++++++++++++++++++++++++++++++++++++--
1 file changed, 496 insertions(+), 18 deletions(-)
diff --git a/compiler/compiler-options.md b/compiler/compiler-options.md
index 00a3adc..b00a451 100644
--- a/compiler/compiler-options.md
+++ b/compiler/compiler-options.md
@@ -26,16 +26,26 @@ List of available compiler options
## Contents
+**General compiler options**
+* [allow-abstract-classes](#allow-abstract-classes)
+* [allow-private-constructors](#allow-abstract-constructors)
+* [allow-import-aliases](#allow-import-aliases)
+* [strict-identifier-names](#strict-identifier-names)
+
**JavaScript compiler options**
* [html-output-filename](compiler/compiler-options.html#html-output-filename)
* [html-template](compiler/compiler-options.html#html-template)
* [js-compiler-option](compiler/compiler-options.html#js-compiler-option)
*
[js-default-initializers](compiler/compiler-options.html#js-default-initializers)
+*
[js-dynamic-access-unknown-members](compiler/compiler-options.html#js-dynamic-access-unknown-members)
* [js-define](compiler/compiler-options.html#js-define)
* [js-load-config](compiler/compiler-options.html#js-load-config)
* [js-output](compiler/compiler-options.html#js-output)
+*
[js-vector-emulation-class](compiler/compiler-options.html#js-vector-emulation-class)
+* [jsx-factory](compiler/compiler-options.html#jsx-factory)
* [remove-circulars](compiler/compiler-options.html#remove-circulars)
* [source-map](compiler/compiler-options.html#source-map)
+*
[source-map-source-root](compiler/compiler-options.html#source-map-source-root)
* [targets](compiler/compiler-options.html#targets)
* [warn-public-vars](compiler/compiler-options.html#warn-public-vars)
* [show-binding-warnings](compiler/compiler-options.html#show-binding-warnings)
@@ -43,12 +53,64 @@ List of available compiler options
**Reduce output size**
You can use these options to reduce the size of your compiled application:
-* [public symbols](compiler/compiler-options.html#public-symbols)
-* [prevent renaming public
symbols](compiler/compiler-options.html#prevent-public-symbol-rename)
-* [prevent renaming internal
symbols](compiler/compiler-options.html#prevent-internal-symbol-rename)
-* [prevent renaming public static
methods](compiler/compiler-options.html#prevent-public-static-method-rename)
+* [export-public-symbols](compiler/compiler-options.html#export-public-symbols)
+*
[export-protected-symbols](compiler/compiler-options.html#export-protected-symbols)
+*
[export-internal-symbols](compiler/compiler-options.html#export-internal-symbols)
+*
[prevent-rename-public-symbols](compiler/compiler-options.html#prevent-rename-public-symbols)
+ *
[prevent-rename-public-static-methods](compiler/compiler-options.html#prevent-rename-public-static-methods)
+ *
[prevent-rename-public-instance-methods](compiler/compiler-options.html#prevent-rename-public-instance-methods)
+ *
[prevent-rename-public-static-variables](compiler/compiler-options.html#prevent-rename-public-static-variables)
+ *
[prevent-rename-public-instance-variables](compiler/compiler-options.html#prevent-rename-public-instance-variables)
+ *
[prevent-rename-public-static-accessors](compiler/compiler-options.html#prevent-rename-public-static-accessors)
+ *
[prevent-rename-public-instance-accessors](compiler/compiler-options.html#prevent-rename-public-instance-accessors)
+*
[prevent-rename-protected-symbols](compiler/compiler-options.html#prevent-rename-protected-symbols)
+ *
[prevent-rename-protected-static-methods](compiler/compiler-options.html#prevent-rename-protected-static-methods)
+ *
[prevent-rename-protected-instance-methods](compiler/compiler-options.html#prevent-rename-protected-instance-methods)
+ *
[prevent-rename-protected-static-variables](compiler/compiler-options.html#prevent-rename-protected-static-variables)
+ *
[prevent-rename-protected-instance-variables](compiler/compiler-options.html#prevent-rename-protected-instance-variables)
+ *
[prevent-rename-protected-static-accessors](compiler/compiler-options.html#prevent-rename-protected-static-accessors)
+ *
[prevent-rename-protected-instance-accessors](compiler/compiler-options.html#prevent-rename-protected-instance-accessors)
+*
[prevent-rename-internal-symbols](compiler/compiler-options.html#prevent-rename-internal-symbols)
+ *
[prevent-rename-internal-static-methods](compiler/compiler-options.html#prevent-rename-internal-static-methods)
+ *
[prevent-rename-internal-instance-methods](compiler/compiler-options.html#prevent-rename-internal-instance-methods)
+ *
[prevent-rename-internal-static-variables](compiler/compiler-options.html#prevent-rename-internal-static-variables)
+ *
[prevent-rename-internal-instance-variables](compiler/compiler-options.html#prevent-rename-internal-instance-variables)
+ *
[prevent-rename-internal-static-accessors](compiler/compiler-options.html#prevent-rename-internal-static-accessors)
+ *
[prevent-rename-internal-instance-accessors](compiler/compiler-options.html#prevent-rename-internal-instance-accessors)
+
+## General compiler options
+
+### allow-abstract-classes {#allow-abstract-classes}
+
+Determines if the `abstract` modifier may be used with classes. For more
details, see [Abstract Classes in
ActionScript](features/actionscript/abstract-classes.html).
+
+```sh
+-compiler.allow-abstract-classes
+```
+
+### allow-private-constructors {#allow-private-constructors}
+Determines if the `private` namespace may be used with class constructors. For
more details, see [Private Constructors in
ActionScript](features/actionscript/private-constructors.html).
+```sh
+-compiler.allow-private-constructors
+```
+
+### allow-import-aliases {#allow-import-aliases}
+
+Determines if alias syntax for for imported symbols is allowed or not.
+
+```sh
+-compiler.allow-import-aliases
+```
+
+### strict-identifier-names {#strict-identifier-names}
+
+Determines if names of identifiers must follow the strict rules of
ActionScript 3.0, or if they may use the looser rules introduced in ECMAScript
5. Defaults to `false`.
+
+```sh
+-compiler.strict-identifier-names
+```
## JavaScript compiler options
@@ -104,6 +166,20 @@ Note that some reflection utility functions require this
to be set to true in or
<additionalCompilerOptions>-js-default-initializers=true;</additionalCompilerOptions>
```
+### js-dynamic-access-unknown-members {#js-dynamic-access-unknown-members}
+
+If the definition of a member cannot be resolved at compile time, emit dynamic
access instead of normal member access. Ensures that dynamic members aren't
renamed.
+
+```sh
+-compiler.js-dynamic-access-unknown-members
+```
+
+#### Maven configuration:
+
+```xml
+<additionalCompilerOptions>-js-dynamic-access-unknown-members=true;</additionalCompilerOptions>
+```
+
### js-define {#js-define}
Defines a global constant at compile time for the JavaScript output. May be a
boolean, number, string, or expression.
@@ -161,6 +237,34 @@ The path where the generated JavaScript output should be
saved, if your are also
Use instead `outputDirectory`in `configuration` xml node
+### js-vector-emulation-class {#js-vector-emulation-class}
+
+A custom implemention to use instead of default emulation of the AVM2 `Vector`
typed collection.
+
+```sh
+-compiler.js-vector-emulation-class=com.example.MyVectorClass
+```
+
+#### Maven configuration:
+
+```xml
+<additionalCompilerOptions>-js-vector-emulation-class=com.example.MyVectorClass;</additionalCompilerOptions>
+```
+
+### jsx-factory {#jsx-factory}
+
+Customize the factory to use for JSX syntax. Defaults to `React.createElement`.
+
+```sh
+-compiler.jsx-factory=_jsx
+```
+
+#### Maven configuration:
+
+```xml
+<additionalCompilerOptions>-jsx-factory=_jsx;</additionalCompilerOptions>
+```
+
### remove-circulars {#remove-circulars}
Tells the Apache Royale compiler to remove circular dependencies in the
generated JavaScript, where possible.
@@ -189,6 +293,20 @@ Emits a source map in the debug build for each
ActionScript file. The default va
<additionalCompilerOptions>-source-map=true;</additionalCompilerOptions>
```
+### source-map-source-root {#source-map-source-root}
+
+Sets a custom value for the `sourceRoot` property in the generated source map
files. This option will be ignored if the `source-map` compiler option is
`false`.
+
+```sh
+-compiler.source-map-source-root=my/custom/path
+```
+
+#### Maven configuration:
+
+```xml
+<additionalCompilerOptions>-source-map-source-root=my/custom/path;</additionalCompilerOptions>
+```
+
### targets {#targets}
Specifies the target format of the code generated by the Apache Royale
compiler. You can specify multiple targets.
@@ -213,7 +331,7 @@ The compiler supports the following values for "targets":
### warn-public-vars {#warn-public-vars}
-Enables or disables warnings about using public variables.
+Enables or disables warnings about using public variables when it may be
considered dangerous to use them.
```sh
-compiler.warn-public-vars
@@ -240,21 +358,381 @@ Set to false to remove all binding warnings.
```
-## Reduce output size ##
+## Reduce size of release builds
+
+The following compiler options may be used to reduce the output size of
JavaScript release builds. However, using these options may also prevent
certain coding patterns in ActionScript and JavaScript from working correctly,
so use with caution.
+
+There are two main ways to reduce the size of a release build:
+
+- **Disable exported symbols.** When a symbol is _exported_, it may be
accessed by external JavaScript `<script>` elements in the same page. If a
symbol is not exported, and it is not referenced elsewhere in the Royale
project, the compiler may determine that it is "dead code" that should be
removed from a release build.
+
+- **Allow renaming of symbols.** When a symbol is not allowed to be renamed in
a release build, it may be accessed using dynamic string access, such as
`object["myProperty"]`. If a symbol is not prevented from being renamed, the
compiler may determine that it can change the name of the symbol to a shorter
value to reduce the size of the release build. If a symbol is renamed, dynamic
string access will not be possible without knowing the new name of the symbol.
+
+### Export public symbols {#export-public-symbols}
+
+In a release build, determines if symbols in the `public` namespace will be
exported or not. The default value is `true`.
+
+```sh
+-export-public-symbols=false
+```
+
+#### Maven configuration:
+
+```xml
+<additionalCompilerOptions>-export-public-symbols=false;</additionalCompilerOptions>
+```
+
+### Export protected symbols {#export-protected-symbols}
+
+In a release build, determines if symbols in the `protected` namespace will be
exported. The default value is `false`.
+
+```sh
+-export-protected-symbols=true
+```
+
+#### Maven configuration:
+
+```xml
+<additionalCompilerOptions>-export-protected-symbols=true;</additionalCompilerOptions>
+```
+
+### Export internal symbols {#export-internal-symbols}
+
+In a release build, determines if symbols in the `internal` namespace will be
exported. The default value is `false`.
+
+```sh
+-export-internal-symbols=true
+```
+
+#### Maven configuration:
+
+```xml
+<additionalCompilerOptions>-export-internal-symbols=true;</additionalCompilerOptions>
+```
+
+### Prevent renaming of public symbols {#prevent-rename-public-symbols}
+
+In a release build, determines if symbols in the `public` namespace may be
renamed or not. The default value is `true`.
+
+```sh
+-prevent-rename-public-symbols=false
+```
+
+#### Maven configuration:
+
+```xml
+<additionalCompilerOptions>-prevent-rename-public-symbols=false;</additionalCompilerOptions>
+```
+
+#### Related options:
+
+When `prevent-rename-public-symbols` option is `true`, one or more the
following options may be set to `false` to allow renaming of certain specific
subsets of public symbols.
+
+-
[`prevent-rename-public-static-methods`](#prevent-rename-public-static-methods)
+-
[`prevent-rename-public-instance-methods`](#prevent-rename-public-instance-methods)
+-
[`prevent-rename-public-static-variables`](#prevent-rename-public-static-variables)
+-
[`prevent-rename-public-instance-variables`](#prevent-rename-public-instance-variables)
+-
[`prevent-rename-public-static-accessors`](#prevent-rename-public-static-accessors)
+-
[`prevent-rename-public-instance-accessors`](#prevent-rename-public-instance-accessors)
+
+### Prevent renaming of protected symbols {#prevent-rename-protected-symbols}
+
+In a release build, determines if symbols in the `protected` namespace may be
renamed or not. The default value is `true`.
+
+```sh
+-prevent-rename-protected-symbols=false
+```
+
+#### Maven configuration:
+
+```xml
+<additionalCompilerOptions>-prevent-rename-protected-symbols=false;</additionalCompilerOptions>
+```
+
+#### Related options:
+
+When `prevent-rename-protected-symbols` option is `true`, one or more the
following options may be set to `false` to allow renaming of certain specific
subsets of protected symbols.
+
+-
[`prevent-rename-protected-static-methods`](#prevent-rename-protected-static-methods)
+-
[`prevent-rename-protected-instance-methods`](#prevent-rename-protected-instance-methods)
+-
[`prevent-rename-protected-static-variables`](#prevent-rename-protected-static-variables)
+-
[`prevent-rename-protected-instance-variables`](#prevent-rename-protected-instance-variables)
+-
[`prevent-rename-protected-static-accessors`](#prevent-rename-protected-static-accessors)
+-
[`prevent-rename-protected-instance-accessors`](#prevent-rename-protected-instance-accessors)
+
+### Prevent renaming of internal symbols {#prevent-rename-internal-symbols}
+
+In a release build, determines if symbols in the `internal` namespace may be
renamed or not. The default value is `true`.
+
+```sh
+-prevent-rename-internal-symbols=false
+```
+
+#### Maven configuration:
+
+```xml
+<additionalCompilerOptions>-prevent-rename-internal-symbols=false;</additionalCompilerOptions>
+```
+
+#### Related options:
+
+When `prevent-rename-internal-symbols` option is `true`, one or more the
following options may be set to `false` to allow renaming of certain specific
subsets of internal symbols.
+
+-
[`prevent-rename-internal-static-methods`](#prevent-rename-internal-static-methods)
+-
[`prevent-rename-internal-instance-methods`](#prevent-rename-internal-instance-methods)
+-
[`prevent-rename-internal-static-variables`](#prevent-rename-internal-static-variables)
+-
[`prevent-rename-internal-instance-variables`](#prevent-rename-internal-instance-variables)
+-
[`prevent-rename-internal-static-accessors`](#prevent-rename-internal-static-accessors)
+-
[`prevent-rename-internal-instance-accessors`](#prevent-rename-internal-instance-accessors)
+
+### Prevent renaming of public static methods
{#prevent-rename-public-static-methods}
+
+In a release build, determines if static methods in the `public` namespace may
be renamed or not. The default value is `true`. This option will be ignored if
the `prevent-rename-public-symbols` compiler option is `false`.
+
+```sh
+-prevent-rename-public-static-methods=false
+```
+
+#### Maven configuration:
+
+```xml
+<additionalCompilerOptions>-prevent-rename-static-methods=false;</additionalCompilerOptions>
+```
+
+### Prevent renaming of public instance methods
{#prevent-rename-public-instance-methods}
+
+In a release build, determines if instance (non-static) methods in the
`public` namespace may be renamed or not. The default value is `true`. This
option will be ignored if the `prevent-rename-public-symbols` compiler option
is `false`.
+
+```sh
+-prevent-rename-public-instance-methods=false
+```
+
+#### Maven configuration:
+
+```xml
+<additionalCompilerOptions>-prevent-rename-public-instance-methods=false;</additionalCompilerOptions>
+```
+
+### Prevent renaming of public static variables
{#prevent-rename-public-static-variables}
+
+In a release build, determines if static variables in the `public` namespace
may be renamed or not. The default value is `true`. This option will be ignored
if the `prevent-rename-public-symbols` compiler option is `false`.
+```sh
+-prevent-rename-public-static-variables=false
+```
+
+#### Maven configuration:
+
+```xml
+<additionalCompilerOptions>-prevent-rename-static-variables=false;</additionalCompilerOptions>
+```
+
+### Prevent renaming of public instance variables
{#prevent-rename-public-instance-variables}
+
+In a release build, determines if instance (non-static) variables in the
`public` namespace may be renamed or not. The default value is `true`. This
option will be ignored if the `prevent-rename-public-symbols` compiler option
is `false`.
+
+```sh
+-prevent-rename-public-instance-variables=false
+```
+
+#### Maven configuration:
+
+```xml
+<additionalCompilerOptions>-prevent-rename-public-instance-variables=false;</additionalCompilerOptions>
+```
+
+### Prevent renaming of public static accessors
{#prevent-rename-public-static-accessors}
+
+In a release build, determines if static accessors (getters and setters) in
the `public` namespace may be renamed or not. The default value is `true`. This
option will be ignored if the `prevent-rename-public-symbols` compiler option
is `false`.
+
+```sh
+-prevent-rename-public-static-accessors=false
+```
+
+#### Maven configuration:
+
+```xml
+<additionalCompilerOptions>-prevent-rename-static-accessors=false;</additionalCompilerOptions>
+```
+
+### Prevent renaming of public instance accessors
{#prevent-rename-public-instance-accessors}
+
+In a release build, determines if instance (non-static) accessors (getters and
setters) in the `public` namespace may be renamed or not. The default value is
`true`. This option will be ignored if the `prevent-rename-public-symbols`
compiler option is `false`.
+
+```sh
+-prevent-rename-public-instance-accessors=false
+```
+
+#### Maven configuration:
+
+```xml
+<additionalCompilerOptions>-prevent-rename-public-instance-accessors=false;</additionalCompilerOptions>
+```
+
+### Prevent renaming of protected static methods
{#prevent-rename-protected-static-methods}
+
+In a release build, determines if static methods in the `protected` namespace
may be renamed or not. The default value is `true`. This option will be ignored
if the `prevent-rename-protected-symbols` compiler option is `false`.
+
+```sh
+-prevent-rename-protected-static-methods=false
+```
+
+#### Maven configuration:
+
+```xml
+<additionalCompilerOptions>-prevent-rename-static-methods=false;</additionalCompilerOptions>
+```
+
+### Prevent renaming of protected instance methods
{#prevent-rename-protected-instance-methods}
+
+In a release build, determines if instance (non-static) methods in the
`protected` namespace may be renamed or not. The default value is `true`. This
option will be ignored if the `prevent-rename-protected-symbols` compiler
option is `false`.
+
+```sh
+-prevent-rename-protected-instance-methods=false
+```
+
+#### Maven configuration:
+
+```xml
+<additionalCompilerOptions>-prevent-rename-protected-instance-methods=false;</additionalCompilerOptions>
+```
+
+### Prevent renaming of protected static variables
{#prevent-rename-protected-static-variables}
+
+In a release build, determines if static variables in the `protected`
namespace may be renamed or not. The default value is `true`. This option will
be ignored if the `prevent-rename-protected-symbols` compiler option is `false`.
+
+```sh
+-prevent-rename-protected-static-variables=false
+```
+
+#### Maven configuration:
+
+```xml
+<additionalCompilerOptions>-prevent-rename-static-variables=false;</additionalCompilerOptions>
+```
+
+### Prevent renaming of protected instance variables
{#prevent-rename-protected-instance-variables}
+
+In a release build, determines if instance (non-static) variables in the
`protected` namespace may be renamed or not. The default value is `true`. This
option will be ignored if the `prevent-rename-protected-symbols` compiler
option is `false`.
+
+```sh
+-prevent-rename-protected-instance-variables=false
+```
+
+#### Maven configuration:
+
+```xml
+<additionalCompilerOptions>-prevent-rename-protected-instance-variables=false;</additionalCompilerOptions>
+```
+
+### Prevent renaming of protected static accessors
{#prevent-rename-protected-static-accessors}
+
+In a release build, determines if static accessors (getters and setters) in
the `protected` namespace may be renamed or not. The default value is `true`.
This option will be ignored if the `prevent-rename-protected-symbols` compiler
option is `false`.
+
+```sh
+-prevent-rename-protected-static-accessors=false
+```
+
+#### Maven configuration:
+
+```xml
+<additionalCompilerOptions>-prevent-rename-static-accessors=false;</additionalCompilerOptions>
+```
+
+### Prevent renaming of protected instance accessors
{#prevent-rename-protected-instance-accessors}
+
+In a release build, determines if instance (non-static) accessors (getters and
setters) in the `protected` namespace may be renamed or not. The default value
is `true`. This option will be ignored if the
`prevent-rename-protected-symbols` compiler option is `false`.
+
+```sh
+-prevent-rename-protected-instance-accessors=false
+```
+
+#### Maven configuration:
+
+```xml
+<additionalCompilerOptions>-prevent-rename-protected-instance-accessors=false;</additionalCompilerOptions>
+```
+
+### Prevent renaming of internal static methods
{#prevent-rename-internal-static-methods}
+
+In a release build, determines if static methods in the `internal` namespace
may be renamed or not. The default value is `true`. This option will be ignored
if the `prevent-rename-internal-symbols` compiler option is `false`.
+
+```sh
+-prevent-rename-internal-static-methods=false
+```
+
+#### Maven configuration:
+
+```xml
+<additionalCompilerOptions>-prevent-rename-static-methods=false;</additionalCompilerOptions>
+```
+
+### Prevent renaming of internal instance methods
{#prevent-rename-internal-instance-methods}
+
+In a release build, determines if instance (non-static) methods in the
`internal` namespace may be renamed or not. The default value is `true`. This
option will be ignored if the `prevent-rename-internal-symbols` compiler option
is `false`.
+
+```sh
+-prevent-rename-internal-instance-methods=false
+```
+
+#### Maven configuration:
-### public symbols {#public-symbols}
-information not yet available
-`-export-public-symbols=false`
+```xml
+<additionalCompilerOptions>-prevent-rename-internal-instance-methods=false;</additionalCompilerOptions>
+```
+
+### Prevent renaming of internal static variables
{#prevent-rename-internal-static-variables}
+
+In a release build, determines if static variables in the `internal` namespace
may be renamed or not. The default value is `true`. This option will be ignored
if the `prevent-rename-internal-symbols` compiler option is `false`.
+
+```sh
+-prevent-rename-internal-static-variables=false
+```
+
+#### Maven configuration:
+
+```xml
+<additionalCompilerOptions>-prevent-rename-static-variables=false;</additionalCompilerOptions>
+```
+
+### Prevent renaming of internal instance variables
{#prevent-rename-internal-instance-variables}
+
+In a release build, determines if instance (non-static) variables in the
`internal` namespace may be renamed or not. The default value is `true`. This
option will be ignored if the `prevent-rename-internal-symbols` compiler option
is `false`.
+
+```sh
+-prevent-rename-internal-instance-variables=false
+```
+
+#### Maven configuration:
-### prevent renaming public symbols {#prevent-public-symbol-rename}
-information not yet available
-`-prevent-rename-protected-symbols=false`
+```xml
+<additionalCompilerOptions>-prevent-rename-internal-instance-variables=false;</additionalCompilerOptions>
+```
+
+### Prevent renaming of internal static accessors
{#prevent-rename-internal-static-accessors}
+
+In a release build, determines if static accessors (getters and setters) in
the `internal` namespace may be renamed or not. The default value is `true`.
This option will be ignored if the `prevent-rename-internal-symbols` compiler
option is `false`.
+
+```sh
+-prevent-rename-internal-static-accessors=false
+```
-### prevent renaming internal symbols {#prevent-internal-symbol-rename}
-information not yet available
-`-prevent-rename-internal-symbols=false`
+#### Maven configuration:
-### prevent renaming public static methods
{#prevent-public-static-method-rename}
-information not yet available
-`-prevent-rename-public-static-methods=false`
+```xml
+<additionalCompilerOptions>-prevent-rename-static-accessors=false;</additionalCompilerOptions>
+```
+
+### Prevent renaming of internal instance accessors
{#prevent-rename-internal-instance-accessors}
+
+In a release build, determines if instance (non-static) accessors (getters and
setters) in the `internal` namespace may be renamed or not. The default value
is `true`. This option will be ignored if the `prevent-rename-internal-symbols`
compiler option is `false`.
+
+```sh
+-prevent-rename-internal-instance-accessors=false
+```
+
+#### Maven configuration:
+
+```xml
+<additionalCompilerOptions>-prevent-rename-internal-instance-accessors=false;</additionalCompilerOptions>
+```
\ No newline at end of file
