Hello everybody,
I want to generate a documentation for my project. So far as I know, this requires to use the compiler online, with the -doc option :
CSC *.cs -doc:docfile.xml
Thanks to a german site I learned about the colon character, otherwise I only had "incorrect syntax".
But with this syntax, every reference has to be declared on the command line.
I have to explore the possibilities to have the references stored for several uses of the command.
In the help I see "@<file> : Read response file for more options"
And I presume a folder can be given for several references, for a shorter command line.
Does anyone have enough experience on that to be quicker than I for that exploration ?
__
A little more precise : in the project I have this reference
<PackageReference Include="Microsoft.AspNetCore.App" />
So, in the references folder of the project, I find Swashbuckle.AspNetCore (4.0.1), then I depress F4, then in the path property I find
C:\Users\(user)\.nuget\packages\swashbuckle.aspnetcore\4.0.1
With the file explorer I find the path of the dll in that folder, and I put this in options.txt :
-reference:AspNetCore=C:\Users\(user)\.nuget\packages\swashbuckle.aspnetcore\4.0.1\lib\netstandard2.0\Swashbuckle.AspNetCore.dll -reference:Microsoft.AspNetCore=C:\Users\(user)\.nuget\packages\swashbuckle.aspnetcore\4.0.1\lib\netstandard2.0\Swashbuckle.AspNetCore.dll
I am said that Microsoft.AspNetCore is not a valid identifier, so I suppress the second line.
Then, amongst all the messages relating to other references, I get this :
Program.cs(7,17): error CS0234: The type or namespace name 'AspNetCore' does not exist in the namespace 'Microsoft' (are you missing an assembly reference?)
Hum, there is also a Microsoft.AspNetCore.App reference, with path :
C:\Users\(user)\.nuget\packages\microsoft.aspnetcore.app\2.1.6
in which I find no dll (it seems only paths to dll files are accepted).
And I have to admit a certain perplexity.