Share via

Announcing November 2006 Sandcastle CTP

  • Article

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:

  1. Support for the following nDoc custom tags:
    1. <overloads>
    2. <preliminary>
    3. <threadsafety>
    4. <note
  2. Generating Friendly HTM names (A new transform "AddFriendlyFilenames.xsl" has been provided)
  3. Exclude (Ripping) Namespace, types and members (Configured through MrefBuilder.config)
  4. 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:

  1. Modify config files to make sure the assembly and reflection data is correct
  2. VS2005 style and other minor isssues.
  3. Common documentation for overloaded methods
  4. Generate freindly HTM names from Sandcastle
  5. System.NullReferenceException related to interface implementation
  6. Support custom tags in Sandcastle
  7. Mrefbuilder incorrectly lists parameter type for generic class
  8. 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 the

  • Anonymous
    November 12, 2006
    Anand has released yet a new version of the Sandcastle CTP . The November CTP has a couple of fixes and

  • Anonymous
    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=1029

  • Anonymous
    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)&#x0a;</xsl:text>--> <xsl:text>Language=0x804 Chinese(PRC) &#x0a;</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 removed

  • Anonymous
    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