diff --git a/web/documentation/index.html b/web/documentation/index.html index 1578987d..556ad86d 100644 --- a/web/documentation/index.html +++ b/web/documentation/index.html @@ -90,7 +90,7 @@
-

Documentation for version 0.9

+

Documentation for version 0.10

@@ -1825,7 +1825,7 @@

The CDB wizard is located in the Coati section in the VS menu bar. Note that the option is only useable if a solution containing at least one C/C++ project is loaded.

-
+
@@ -1856,26 +1856,26 @@

Once the CDB was successfully created it can be found in the specified target directory. From this CDB you can create a Coati project as described above.

- + Settings

Network settings and logging options can be changed in the plugin's Tools/Options entry.

-
- +
+
- +

- +
-
- +
+
- +

- + @@ -1891,34 +1891,34 @@

The plugin offers optional file logging. Should you ever have problems with the plugin we recommend to turn logging on. This will help to pinpoint and resolve the issue faster.

Logs will be created in ..\AppData\Local\Coati Software\Plugins\VS folder. A new log file will be created every time you restart VS and logging is enabled.

- +
-
- +
+
- +

Note that the logs will include project- and file names as well as directories specific to your project. If you wish to keep this informatin secret you can use log obfuscation.

Project- and file names as well as directories will be replaced by an alphanumeric sequence. The sequence has the form a0, b0, c0,..., a1, b1, c1,.... Note that after switching on obfuscation, already logged data will not be obfuscated retroactively. No log files will be send to Coati Software automatically. You can check any file you may want to send us for sensible information before sending it.

A dictionary, mapping obfuscated names to original names, will be created in your log folder if log obfuscation is switched on. When during the support process we refer to project items by their obfuscated name you can still make sense of it. Do not send the dictionary to anybody else.

- +

Lastly, log messages are also displayed in the VS output window. This is tied to file logging and is not en- or disabled separately.

-
- +
+
- +

IDE Communication Protocol

Coati's IDE plugins communicate with Coati via sockets, using TCP. Coati implements a number of messages to provide an interface for the plugins.

This chapter explains the general structure of those messages, followed by a list of possible message types.

- +

Message Structure

- +

The basic structure of the messages used by Coati plugins consists of a prefix to identify the message type, followed by no, one, or multiple parameters and ends with an 'end-of-message' token. Parameters and tokens are seperated by a 'divider' token.

- +
Option Description
@@ -1930,20 +1930,20 @@
Name Token Description
endOfMessage <EOM> Helps to determine the end of a message
- +

Messages have the following form:

- +

messageType<<parameter<<...<<parameter<EOM>

- +

Message Types

- +

Coati does implement a number of message types that can be used by Coati plugins. In the following is a list of the messages that Coati may send to plugins and messages that may be sent by a plugin to Coati.

- +

Note that you can chose which messages you want to implement. Coati will not make problems if you chose to ignore certain messages.

- + Incoming messages

These messages may be received by a plugin.

- + @@ -1954,10 +1954,10 @@
Message Parameters Description
ping Coati may send a ping to determine if anybody is listening. Respond with a ping message yourself. Coati will not respond to this message.
- + Outgoing messages

Your plugin may send these messages to Coati.

- + @@ -1968,7 +1968,7 @@
Message Parameters Description
ping Your plugin may send this message to Coati to tell it it's listening.
- +