add documentation of Pdefine
@@ -1099,8 +1099,10 @@ The book element contains the location, filename, and extension of the file. The
\section element_compile /package/devices/family/.../compile
-Specify header files and preprocessor defines for programming. This element can occur on various levels.
-Multiple elements are allowed. The last occurrence in the hierarchy determines the actual define.
+Specify the CMSIS-Core compliant device header file and a device specific preprocessor define automatically included and set by the build tools.
+In case of devices embedding multiple processor cores, an additional core specific define can be specified. In this case the Pname attribute becomes mandatory.
+This element can occur on various levels. Multiple elements are allowed. The last occurrence in the hierarchy determines the effective
+include path and define. It is required that each device has an effective header and define.
\note
- In the example below, the device \b STM32F407IG will have a define \c STM32F407IG. Previous defines
@@ -1158,13 +1160,22 @@ Multiple elements are allowed. The last occurrence in the hierarchy determines t
</tr>
<tr>
<td>header</td>
- <td>C-header file with path relative to the installation.</td>
+ <td>CMSIS-Core compliant device header file with path relative to the pack's base folder.</td>
<td>xs:string</td>
- <td>optional</td>
+ <td>required</td>
</tr>
<tr>
<td>define</td>
- <td>C-file name with device specific preprocessor defines. The path is relative to the installation.</td>
+ <td>Device specific preprocessor define (macro). This macro is set in the pre-processor command line (-D\<macro>) and allows to
+ select device specific code during preprocessing of the application code, e.g. enabling/disabling device specific definitions in the device header file.</td>
+ <td>xs:string</td>
+ <td>required</td>
+ </tr>
+ <tr>
+ <td>Pdefine</td>
+ <td>This attribute can only be used for devices with multiple processor cores. It specifies a core specific preprocessor define (macro).
+ This macro is set in the pre-processor command line (-D\<macro>) and allows to select processor specific code during preprocessing
+ of the application code, e.g. enabling/disabling core specific definitions in the device header file.</td>
<td>xs:string</td>
<td>optional</td>
</tr>
