Home All Groups Group Topic Archive Search About

How to generate an HTML from XML documentation tags

Author
28 Aug 2006 12:40 PM
Water Cooler v2
Having documented your C# code with the XML tags for documentation, how
do you then generate a HTML help file (.chm) for it?

I am talking about code decoration tags such as:

///<summary>
///</summary>

etc.

Author
28 Aug 2006 12:56 PM
Kevin Spencer
You use an XSL transform to transform the XML comments to HTML. Then you may
compile the result to .chm if you wish.

--
HTH,

Kevin Spencer
Microsoft MVP
Chicken Salad Surgery

It takes a tough man to make a tender chicken salad.


Show quote
"Water Cooler v2" <wtr_***@yahoo.com> wrote in message
news:1156768836.243303.316310@m73g2000cwd.googlegroups.com...
> Having documented your C# code with the XML tags for documentation, how
> do you then generate a HTML help file (.chm) for it?
>
> I am talking about code decoration tags such as:
>
> ///<summary>
> ///</summary>
>
> etc.
>
Author
28 Aug 2006 1:02 PM
Water Cooler v2
Thanks, Kevin. Can you please point me to a good XSL tutorial online?
Google turns up many but I am not sure which one covers:

1. The essentials only, leaving out fluff
2. Does it at a rapid pace
Author
28 Aug 2006 2:49 PM
Kevin Spencer
No problem. The MSDN Library has an excellent reference:

http://msdn.microsoft.com/library/en-us/xmlsdk/html/678bcd68-cbbb-4be5-9dd2-40f94488a1cf.asp?frame=true

Also, you may not be aware of the XSL editing tools in Visual Studio 2005
(they are not obvious). When you open an XSL document in Visual Studio 2005,
it opens inthe XSLT Editor. This editor has intellisense that enables you to
see errors immediately, auto-complete, and even debug your XSL with
step-through debugging.

--
HTH,

Kevin Spencer
Microsoft MVP
Chicken Salad Surgery

It takes a tough man to make a tender chicken salad.


Show quote
"Water Cooler v2" <wtr_***@yahoo.com> wrote in message
news:1156770165.409719.134810@m73g2000cwd.googlegroups.com...
> Thanks, Kevin. Can you please point me to a good XSL tutorial online?
> Google turns up many but I am not sure which one covers:
>
> 1. The essentials only, leaving out fluff
> 2. Does it at a rapid pace
>
Author
28 Aug 2006 1:10 PM
Simon Dahlbacka
Water Cooler v2 wrote:
> Having documented your C# code with the XML tags for documentation, how
> do you then generate a HTML help file (.chm) for it?

you look at the "sandcastle" project from microsoft or at ndoc, or some
of the commercially available products..

AddThis Social Bookmark Button