1 2 3 4 5 6 7 8 9 10 11
12 13 14
15 package xdc.bld;
16
17 /*!
18 * ======== ITarget3 ========
19 * Extension of the interface {@link xdc.bld.ITarget3}.
20 *
21 * This interface contains some common structures and config parameters
22 * shared by several packages that contain targets.
23 */
24 metaonly interface ITarget3 inherits ITarget2 {
25 /*!
26 * ======== rawVersion ========
27 * The raw version string from the compiler
28 *
29 * @a(Readonly) This value is automatically computed by the XDC Build
30 * Engine by executing the `{@link #getRawVersion()}` function after
31 * `package.bld` completes but prior to generating `package.mak`.
32 */
33 config String rawVersion;
34
35 /*!
36 * ======== getRawVersion ========
37 * Get a target-specific raw compiler version string
38 *
39 * This function is called during makefile generation to obtain a
40 * target-specific raw compiler version string.
41 *
42 * @a(returns)
43 * This function returns a string, typically provided by the compiler
44 * itself, that identifies the version of the compiler referenced by
45 * `{@link #rootDir}`.
46 *
47 * @a(throws) `Error` exceptions are thrown for fatal errors.
48 */
49 String getRawVersion();
50 }
51
52 53 54
55