How to generate an HTML from XML documentation tags

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.

Kevin
Mon Aug 28 07:56:19 CDT 2006

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.


"Water Cooler v2" <wtr_clr@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.
>

Water
Mon Aug 28 08:02:45 CDT 2006

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

Simon
Mon Aug 28 08:10:14 CDT 2006


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..

Kevin
Mon Aug 28 09:49:13 CDT 2006

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.


"Water Cooler v2" <wtr_clr@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
>