.NET Namespace Generation
Assume the following directory structure:
cluster root class A directory d1 class B directory d2 class C
List of Settings
At this level you can specify the following:
- .NET Namespace (NN): Namespace in which all classes will be put in.
- Use Cluster Name as Namespace (UCNN): If specified, cluster name will be part of the namespace.
- Use Recursive Cluster Name as Namespace (URCNN): If specified, then the path to the class will be part of the namespace.
- .NET Naming Convention: Updates unchanged Eiffel classes and clusters names to follow the .NET naming convention.
To make things clearer here is all the possible combinations for the first three options and their results:
- NN set to N: N.A, N.B and N.C
- UCNN set to True: root.A, root.B and root.C
- URCNN set to True: A, d1.B and d2.C
- UCNN and URCNN set to True: root.A, root.d1.B and root.d2.C
- NN set to N:
- UCNN set to True: N.root.A, N.root.B and N.root.C
- URCNN set to True: N.A, N.d1.B and N.d2.C
- UCNN and URCNN set to True: N.root.A, N.root.d1.B and N.root.d2.C
At this level you can only specify the namespace of the cluster. When set, it will ignore the UCNN option set at the target where the cluster belongs.
For example setting the namespace for cluster root to be DotnetRoot will result in:
- NN set to N: N.DotnetRoot.A, N.DotnetRoot.B and N.DotnetRoot.C
- UCNN set to True: DotnetRoot.A, DotnetRoot.B and DotnetRoot.C
- URCNN set to True: DotnetRoot.A, DotnetRoot.d1.B and DotnetRoot.d2.C
- UCNN and URCNN set to True: DotnetRoot.A, DotnetRoot.d1.B and DotnetRoot.d2.C
- NN set to N:
- UCNN set to True: N.DotnetRoot.A, N.DotnetRoot.B and N.DotnetRoot.C
- URCNN set to True: N.DotnetRoot.A, N.DotnetRoot.d1.B and N.DotnetRoot.d2.C
- UCNN and URCNN set to True: N.DotnetRoot.A, N.DotnetRoot.d1.B and N.DotnetRoot.d2.C
Mixing With Libraries
Once options are set at a library level, they cannot be overridden. The compiler will use the library settings to generate the namespaces. This is why the option is non-functioning/disallowed for library, precompile or assembly nodes in the configuration file.
Suppose we have the following system:
target a library l1 library l2 library l3 target library l2 library l3
If both target a and library l2 were to specify a different namespace, it would be hard to know which one should take precedence. Let's assume it is a, then if library l2 relies on a certain namespace for l3 then library l2 might stop working properly, which would be bad.