Announcing November 2006 Sandcastle CTP
The November 2006 CTP version for Sandcastle is now available for download at https://www.microsoft.com/downloads/details.aspx?FamilyId=E82EA71D-DA89-42EE-A715-696E3A4873B2&displaylang=en. Our sincere thanks to the Sandcastle user community and to Eric Woodruff for providing us with valuable feedback.
What's new in this version:
- Support for the following nDoc custom tags:
- <overloads>
- <preliminary>
- <threadsafety>
- <note
- Generating Friendly HTM names (A new transform "AddFriendlyFilenames.xsl" has been provided)
- Exclude (Ripping) Namespace, types and members (Configured through MrefBuilder.config)
- VS 2005 transforms support for FireFox
Changes in this version:
1. Moved cpref_reflection folder from Examples to Data directory
2. Consistent versioning (2.2.00) of all assemblies and executables in ProductionTools folder
3. All assemblies and executable are now under a flat structure in ProductionTools folder
4. Updated Sandcastle.config files for Prototype and VS2005 to reflect the above changes
Issues Fixed in this Version:
- Modify config files to make sure the assembly and reflection data is correct
- VS2005 style and other minor isssues.
- Common documentation for overloaded methods
- Generate freindly HTM names from Sandcastle
- System.NullReferenceException related to interface implementation
- Support custom tags in Sandcastle
- Mrefbuilder incorrectly lists parameter type for generic class
- Bug in mshelp: link keyowrd prevending Sandcastle generated HxS integration in Visual Studio
I would love to hear your feedback about this CTP.
Anand...
Comments
Anonymous
November 10, 2006
PingBack from http://nzeemin.wordpress.com/2006/11/11/sandcastle-november-ctp-2/Anonymous
November 11, 2006
la CTP de Novembre de Sandcastle est disponible . Au menu : What's new in this version: Support for theAnonymous
November 12, 2006
Anand has released yet a new version of the Sandcastle CTP . The November CTP has a couple of fixes andAnonymous
November 12, 2006
I have just released an updated version of the MSBuild script for Sandcastle. It's now found on a dedicated CodePlex site. You can download it from here: http://www.codeplex.com/Release/ProjectReleases.aspx?ProjectName=MSBuildSandcastle&ReleaseId=1029Anonymous
November 12, 2006
I need to generate documents in east Asia languages,such as Chinese. But when generating chm, the transforms output is encoded as iso-8859-1,so it doesn't work. I have to modify ReflectionToChmContents.xsl,ReflectionToChmIndex.xsl and ReflectionToChmProject.xsl to change xsl:output encoding="iso-8859-1" to encoding="utf-8". and it works now.Anonymous
November 12, 2006
I tried and changing ‘iso-8859-1’ to ‘utf-8’ does not work for me, Chinese characters are not displayed correctly. I have to use ‘gb2132’ (simplified Chinese) and do modification to ReflectionToChmProjects.xsl as below. <!--<xsl:text>Language=0x409 English (United States)
</xsl:text>--> <xsl:text>Language=0x804 Chinese(PRC) 
</xsl:text> Anand..Anonymous
November 13, 2006
I am having some problems with the generated .chm file. When viewing the contents I keep getting some scripting error saying "CookieDataStore is not defined". What am I doing wrong? Thank you.Anonymous
November 14, 2006
Hi, Could you provide a detailed way to exclude(Ripping) specific types and members? I need this for documenting classes that inherit and have the browsable attribute set to false on specific properties. I looked in the MRefBuilder.config but could not deduce what was needed. Thanks in advance. :)Anonymous
November 15, 2006
I'm running into troubles with MRefBuilder - I'm trying to use it in a NANT script similar to how Diederik Kros documented at http://www.codeproject.com/useritems/ccnetsandcastle.asp. The crux of the problem is that MrefBuilder seems to not be recognizing the /dep: argument I'm passing to it. My call looks like: C:Program FilesSandcastleproductiontoolsmrefbuilder.exe D:DailyFramework/Main/Project1/bin/debug/.dll D:DailyFramework/Main/Project1/bin/debug/.exe /out:reflection.org1.xml /dep:D:DailyFramework[BUILDMACHINE] Daily - Create docsSandcastleWorkingDirdependencies*.dll MRefBuilder is not finding the dependency files I've copied to the folder specified. If I put the dependency files in the source folder (D:DailyFramework/Main/Project1/bin/debug/), MRefBuilder executes fine. Any idea what's going on?Anonymous
November 23, 2006
Everything seems good but in the end my chm files are blank. Can anyone help? Thanks.Anonymous
November 23, 2006
CWeiss & Firedog, Please contact me via email. You can send an email through the "email" tab at the top of this page and I will be happy to help. Anand..Anonymous
December 06, 2006
The comment has been removedAnonymous
December 06, 2006
John, I got your email and will respond. There is no change in the functionality and HTM files are always generated before getting them compiled into a CHM. Anand..Anonymous
December 06, 2006
NDOC had a feature where if you had a dummy class named NamespaceDoc.cs, it would use the <summary> triple slash comments that appear there as the header documentation for the namespace it utilizes in the generated documentation. Is there a way to get the 2006 November CTP to do this as it is, or via a configuration change, or xml file change? If not is this functionality planned for the future?Anonymous
December 06, 2006
Please see this post. You can achieve this by editing your comments.xml file or by passing a seperate file during build. Anand..Anonymous
December 06, 2006
Forgot to include the post. Please see http://forums.microsoft.com/MSDN/ShowPost.aspx?PostID=958310&SiteID=1