api-doc-tools
api-doc-tools copied to clipboard
Support creating a msxml for a single assembly
Right now, mdoc generates a xml file with ALL the types in it. But, if I have a docs folder that contains combined assembly docs:
/docs
|- index.xml
|- ns-SkiaSharp.xml
|- ns-HarfBuzzSharp.xml
|- SkiaSharp
| |- SKCanvas.xml
| |- ...
|- HarfBuzzSharp
|- Blob.xml
|- ...
This will output a large file with everything. It would be great to be able to say:
mdoc export --assembly SkiaSharp SkiaSharp.xml
Actually, I'm just now realizing that this feature is already built-in!! :P The actual invocation is:
mdoc export-msxdoc path/to/SkiaSharp/ecmaxml
By not including the -out
parameter (which would be the XML file output), it simply creates an XML file for every AssemblyInfo
contained in the XML repository
The problem with that is that it writes to the current directory, which may be anywhere. Maybe we could check to see if the out is a directory (or ends with a slash) and then write to that folder.
Ahh, yes that is a completely great point … definitely worth an enhancement
But, I am doing this as part of my MSMuild tasks, so I can easily set the working directory. This seems to be good. Thanks for pointing it out.