[dba-VB] Getting TextReader from strings...

Gustav Brock Gustav at cactus.dk
Fri Jun 27 06:24:23 CDT 2008


Hi Shamil

That looks very promising, thank you!

So, as:

 - Sandcastle is used internally to build .Net Framework documentation 

I guess this, as an example, is what these guys have used:

  http://www.e-conomic.com/apidocs/Documentation/index.html 

/gustav


>>> shamil at smsconsulting.spb.ru 27-06-2008 13:09 >>>
<<<
...the XML commenting method I haven't used yet...
>>>
Hi Gustav,

That should be easy for you to adapt I guess:

Download SandCastle:

http://www.microsoft.com/downloads/details.aspx?FamilyId=E82EA71D-DA89-42EE-A715-696E3A4873B2&displaylang=en 

- start VS2005/VS2008;
- create sample project;
- add some code with XML comments (watch how VS helps to set cross-refs while you are typing comments - all these crossrefs will be later "automagically" used by SandCastle while generating online help);
- right-click on project entry in VS solution explorer - select 'Properties' from popup-menu;
- select [Build] tab;
- check 'Xml documentation file' checkbox;
- (re)build assembly;
- start D:\Program Files\Sandcastle\Examples\generic\SandcastleGui.exe;
- you'll get Sandcastle main form opened;
- make sure presentation style combo-box on the right-hand side is set to vs2005;
- add assembly file - [Add] button of top listbox;
- add generated comments file .xml (it will be in the same folder where your assembly is located) - [Add] button of middle listbox;
- click [Build] button in the bottom - SandCastle is a "heavy beast" - it will take a while for it to generated .chm help even for a small sample project;
- when Sandcastle build finishes go to D:\Program Files\Sandcastle\Examples\{YourAssemblyName}\vs2005\chm\{YourAssemblyName}.chm and enjoy your professionally looking code help file...

This Help generation can be automated - there are quite some scripts
installed with SandCastle but I haven't used them yet...

SandCastle is a really huge "beast" with many features including preparing
any kind of documentation - see these links:

http://www.codeplex.com/SandcastleStyles 

http://www.codeplex.com/Release/ProjectReleases.aspx?ProjectName=SandcastleStyles&ReleaseId=14068 

--
Shamil

-----Original Message-----
From: dba-vb-bounces at databaseadvisors.com 
[mailto:dba-vb-bounces at databaseadvisors.com] On Behalf Of Gustav Brock
Sent: Friday, June 27, 2008 1:42 PM
To: dba-vb at databaseadvisors.com 
Subject: Re: [dba-VB] Getting TextReader from strings...

Hi Shamil

> I do not argue, OK? :)

OK, that's also how I understood your comments. 

I see your point. There's a big difference between code modules like that of
Rocky's with 2000 lines and a series of small functions and classes where
all variables and methods and properties are given names which clearly
indicate the purpose.

Unfortunately, the XML commenting method I haven't used yet ...

/gustav





More information about the dba-VB mailing list