some new chapters.

Signed-off-by: Kristof Szabados <Kristof.Szabados@ericsson.com>

usrguide/java_referenceguide/10-code_coverage_of_ttcn-3_modules.adoc

+= Code Coverage of TTCN-3 Modules
+
+Measuring Code Coverage directly from TITAN is not yet supported on the Java side.

usrguide/java_referenceguide/11-the_ttcn-3_debugger.adoc

+= The TTCN-3 Debugger
+:toc:
+:table-number: 42
+
+
+Debugging TTCN-3 directly from TITAN is not yet supported on the Java side.

usrguide/java_referenceguide/12-tips_&_troubleshooting.adoc

+= Tips & Troubleshooting
+:toc:
+
+This chapter deals with various topics, which could not have been assigned to any of the previous chapters.
+
+== Type Aliasing
+
+Type aliasing in TTCN–3 means that you can assign an alternative name to an existing type. The syntax is similar to a subtype definition, but the subtype restriction tag (value list or length restriction) is missing.
+
+`type MyType MyAlternativeName;`
+
+The type aliasing is implemented in the test executor, and it translates this TTCN–3 definition to a Java class extension.
+
+`public static class MyAlternativeName extends MyType { }`
+
+`public static class MyAlternativeName_template extends MyType_template { }`
+
+To keep in line with the C side, a semantic error will be reported when a port allows sending or receiving both of the types.
+
+As a work-around to this problem you can repeat the definition of the original type using the alternative name instead of type aliasing. In this case two differently named, but identical classes will be generated and the polymorphism problem will not occur.
+
+[[reusing-logged-values-or-templates-in-ttcn-3-code]]
+== Reusing Logged Values or Templates in TTCN–3 Code
+
+Writing templates can be time-consuming task. To save some time and work, you can use the logs of the messages already sent or received to write templates.
+
+If you would like to use a logged value in TTCN–3 code, then using the `logformat` utility (see the section 13.3 of the TITAN User Guide [13] about this utility) you have to follow these steps:
+
+. Start a text editor and open the (formatted) log file and the TTCN–3 source file.
+. Select and copy the desired value from the log file.
+. Paste the value at the corresponding position in the TTCN–3 code.
+. Finally, make the following changes:
++
+* The enumerated values are followed by their numerical equivalents within parentheses. Delete them including the parentheses.
++
+* If an octetstring value contains only visible ASCII characters, then the hexadecimal octetstring notation is followed by its character string representation between quotation marks and parentheses. Delete the character string (including the parentheses).
++
+* If a `record`, `set`, `record of` or `set of` value contains no fields or elements, then the logformat utility changes the value from `{}` to `{(empty)}` in the log. Delete the word (empty) (including parentheses).
+
+[[using-the-ttcn-3-preprocessing-functionality]]
+== Using the TTCN-3 Preprocessing Functionality
+
+NOTE: This feature, as preprocessors in general, should be avoided if not absolutely necessary.
+
+The Designer has some support for preprocessing preprocessable files according to the rules of the C preprocessor.
+
+The options governing how preprocessable files inside a project are preprocessed can be set via right clicking on the project and selecting "Properties"/"TITAN Java Project Properties" and in the window that appears on the "TTCN-3 Preprocessor" page and its sub-pages.
+
+* On the `Symbols (define, undefine)` page it is possible to define or undefine symbols that will be available for the preprocessor.
+
+* On the `Include directories` page it is possible to set a list of folders which will be used to find `#includ` -ed files, during preprocessing.
+
+Tips for using the preprocessor:
+
+* Don't. The preprocessor feature should only be used when absolutely necessary.
+
+** Several preprocessor features are used to generate or hide parts of the source code. This can make it harder for people to understand the code. Makes the use of advanced refactoring features unsafe.
+
+** The extra cost of preprocesing adds to the duration of the build process.
+
+** As several preprocessing feature are used to hide information from the tools, and external factors (like environmental variables, files included from outside) can have an effect on the result ... any modification will trigger a preprocessing of all the `.ttcnpp` files, the semantic checking of all modules directly or indirectly importing them, and probably the re-generation of the affected modules.
+
+* On the Java side there is no intermediate file generated as all of the processing steps are done in-memory for performance reasons.
+
+There are minor issues when precompiling TTCN-3 code with the preprocessor, these are resulting from the differences between the C and TTCN-3 languages. Tips for writing the `.ttcnpp` files:
+
+* Do not define the B, O and H macros, these letters are used as part of the bitstring, octetstring and hexstring tokens in TTCN-3, but the preprocessor will replace them.
+
+* There are some predefined macros in the preprocessor which will be always replaced, do not use any TTCN-3 identifier identical to these. These macros start with double underscore followed by uppercase letters. Some of the most common macros which might be useful:
+
+** – *FILE* This macro expands to the name of the current input file, in the form of a C string constant.
+** – *LINE* This macro expands to the current input line number, in the form of a decimal integer constant.
+** – *DATE* This macro expands to a string constant that describes the date on which the preprocessor is being run.
+** – *TIME* This macro expands to a string constant that describes the time at which the preprocessor is being run.
+
+When writing preprocessor directives keep in mind that within the directive the C preprocessor syntax is in use, not the TTCN-3. Operators such as `defined` or || can be used.
+
+Watch out for macro pitfalls, some well known are: side effects, misnesting, and operator precedence problems.

usrguide/java_referenceguide/6-compiling_ttcn3_and_asn1_modules.adoc

@@ -31,7 +31,7 @@ Disables the generation of RAW encoder/decoder routines for all TTCN–3 types.
 * `Disable attribute validation (-0)`
 +
 Disables the validation of with attributes.
-WARNING: This option should only be used temporarily and only by people transferring projects from other TTCN-3 tool vendors. As the attribute validation is turned off, users will not be notified of invalid attributes, or errors within attibutes.
+WARNING: This option should only be used temporarily and only by people transferring projects from other TTCN-3 tool vendors. As the attribute validation is turned off, users will not be notified of invalid attributes, or errors within attributes.
 
 * `Add source line info for logging  (-L)`
 +

usrguide/java_referenceguide/7-the_run-time_configuration_file.adoc

+= The Run-time Configuration File
+:toc:
+:table-number: 12
+
+In general the Java side supports the exact same configuration file format and options in the same way as the C side does, described in chapter 7 of <<13-references.adoc#_27, [27]>>.
+There are some features, that are not yet supported on the Java side:
+
+* LoggerPlugins within the LOGGING section are not yet supported. The section is read correctly, but such plugins are not loaded during runtime.
+* EXTERNAL_COMMANDS section is not yet supported. The section is read correctly, but the scripts set there will not be executed during runtime.
+* In MAIN_CONTROLLER section the `UnixSocketsEnabled` feature is not supported. Java does not seem to offer support for this feature.
+* It is also not yet possible to configure the logging options dynamically.

usrguide/java_referenceguide/JavaReferenceGuide.adoc

@@ -55,13 +55,11 @@ ifdef::env-github,backend-html5[]
 * link:4-ttcn3_language_extensions.adoc[TTCN–3 Language Extensions]
 * link:5-supported_asn1_constructs_and_limitations.adoc[Supported ASN.1 Constructs and Limitations]
 * link:6-compiling_ttcn3_and_asn1_modules.adoc[Compiling TTCN–3 and ASN.1 Modules]
-////
 * link:7-the_run-time_configuration_file.adoc[The Run-time Configuration File]
-* link:8-the_titan_project_descriptor_file.adoc[The TITAN Project Descriptor File]
-* link:9-xsd_to_ttcn-3_converter.adoc[XSD to TTCN-3 Converter]
 * link:10-code_coverage_of_ttcn-3_modules.adoc[Code Coverage of TTCN-3 Modules]
 * link:11-the_ttcn-3_debugger.adoc[The TTCN-3 Debugger]
 * link:12-tips_&_troubleshooting.adoc[Tips & Troubleshootings]
+////
 * link:2-test_ports.adoc[Test Ports]
 * link:3-logger_plug-ins.adoc[Logger Plug-ins]
 * link:4-encoding_and_decoding.adoc[Encoding and Decoding]
@@ -79,13 +77,11 @@ include::2-ttcn-3_limitations_in_this_version.adoc[leveloffset=+1]
 include::4-ttcn3_language_extensions.adoc[leveloffset=+1]
 include::5-supported_asn1_constructs_and_limitations.adoc[leveloffset=+1]
 include::6-compiling_ttcn3_and_asn1_modules.adoc[leveloffset=+1]
+include::7-the_run-time_configuration_file.adoc[leveloffset=+1]
+include::10-code_coverage_of_ttcn-3_modules.adoc[leveloffset=+1]
+include::11-the_ttcn-3_debugger.adoc[leveloffset=+1]
+include::12-tips_&_troubleshooting.adoc[leveloffset=+1]
 ////
-//include::7-the_run-time_configuration_file.adoc[leveloffset=+1]
-//include::8-the_titan_project_descriptor_file.adoc[leveloffset=+1]
-//include::9-xsd_to_ttcn-3_converter.adoc[leveloffset=+1]
-//include::10-code_coverage_of_ttcn-3_modules.adoc[leveloffset=+1]
-//include::11-the_ttcn-3_debugger.adoc[leveloffset=+1]
-//include::12-tips_&_troubleshooting.adoc[leveloffset=+1]
 //include::2-test_ports.adoc[leveloffset=+1]
 //include::3-logger_plug-ins.adoc[leveloffset=+1]
 //include::4-encoding_and_decoding.adoc[leveloffset=+1]