Update Xml documentation after PostSharp injection

Robert Sirre's Avatar

Robert Sirre

23 May, 2013 01:03 PM

Could it be possible to render the Xml documentation after (or again after) PostSharp weaving has been performed?

Now the Attributes that have been applied using multicasting, that are persisted (and found via reflection) are still not mentioned in the documentation (processed by Sandcastle)

Maybe this is far fetched feature-request, but on the other hand if this is a done in a jiffy it would be cool.

  1. Support Staff 1 Posted by PostSharp Techn... on 31 May, 2013 01:46 PM

    PostSharp Technologies's Avatar

    Hi Robert,

    I don't understand why Sandcastle would not be able to reflect the custom attribute if it is persisted.

    I think a valid feature request would be to give the possibility for aspects to modify XML documentation.

    -gael

  2. 2 Posted by Robert Sirre on 31 May, 2013 03:53 PM

    Robert Sirre's Avatar

    In my head it might have been some thing to do with:

    step 1 : VS compiles the code and generates the xml files from which the documentation is derived.
    step 2 : PostSharp post-build step injects the code, but does not modify the xml file.

    I'm talking about multicast attributes here, so the attribute were not actually present in the source files in the first place. Postsharp attributes that wre present

  3. 3 Posted by Robert Sirre on 05 Jun, 2013 08:13 AM

    Robert Sirre's Avatar

    I'm sorry but I seem to have been mistaken, Sandcastle uses regular reflection and detects the persisted attributes just fine.

    I'm building the documentation on my release version of the project, and I had not built the project in release mode yet, as I was doing during the development, hence the debug mode.

    Nevermind the comments I made on the modifications to the Xml file, they only contain the XML documentation, and refer to the code structure at the most, nothing more.

    This issue can be closed.

  4. PostSharp Technologies closed this discussion on 07 Jun, 2013 03:38 PM.

Comments are currently closed for this discussion. You can start a new one.

Keyboard shortcuts

Generic

? Show this help
ESC Blurs the current field

Comment Form

r Focus the comment reply box
^ + ↩ Submit the comment

You can use Command ⌘ instead of Control ^ on Mac