api-doc-tools icon indicating copy to clipboard operation
api-doc-tools copied to clipboard

Support creating a msxml for a single assembly

Open mattleibow opened this issue 6 years ago • 4 comments

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

mattleibow avatar Mar 08 '18 21:03 mattleibow

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

joelmartinez avatar Mar 22 '18 18:03 joelmartinez

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.

mattleibow avatar Mar 22 '18 18:03 mattleibow

Ahh, yes that is a completely great point … definitely worth an enhancement

joelmartinez avatar Mar 22 '18 19:03 joelmartinez

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.

mattleibow avatar Mar 22 '18 19:03 mattleibow