What's new in September 2006 Sandcastle CTP
September 2006 Sandcastle CTP is now available at Microsoft download center. Here is a summary of what's new in this CTP version:
- Visual Studio 2005 look and feel transforms.
- State of Syntax tab persists across topics in HxS build.
- Transforms for hiding explicit interface implementations.
- Index and keyword generation in HxS build. To generate Index and keyword for HxS build please modify sandcastle.config. Under the transformation step in sandcastle.config, change
<argument name=”metadata” value=”false” />
to
<argument name=”metadata” value=”true” />
Note: We are providing VS 2005 transforms under Presentation/VS2005 folder and the transforms shipped with the previous versions under Presentation/Prototype folder. For building VS2005 format please use sandcastle.config file from C:\Program Files\Sandcastle\Presentation\vs2005\Configuration folder as it uses shared content from C:\Program Files\Sandcastle\Presentation\vs2005\Content and transforms from C:\Program Files\Sandcastle\Presentation\vs2005\Transforms
Known issues:
- State of syntax tab do not persist across topics in CHM build. We will provide a hot fix for CHM after the release of September CTP.
- In C:\Program Files\Sandcastle\Presentation\vs2005 folder please modify the following:
- Edit CopyHavana.bat and change the path Prototype to vs2005.
- Edit test.hhp under C:\Program Files\Sandcastle\Presentation\vs2005\Chm folder and change the value icons to art.
- Edit test.hxf under C:\Program Files\Sandcastle\Presentation\vs2005\Hxs folder and changes icons to art.
- See Also section not generated for builds with VS 2005 look and feel. Please remove the xml comments for the following section in main_sandcastle.xsl for VS 2005 transforms under C:\Program Files\Sandcastle\Presentation\vs2005\Transforms:
<!-- see also -->
<!--<xsl:call-template name="seeAlsoSection" />-->
Bug Fixes:
The following bugs have been fixed for this CTP:
- Sandcastle transforms does not process all XML elements from code comments
- MrefBuilder: Display friendly log message when "comments" are missing in config file
- Bugs in documenting lists
- F-keywords are not generated by the HxS
- Exception tag from XML comments are not being populated in .chm file
- Lists are not documented properly
- Buildassembler generates indexoutofrangeexception
- Visaul bug for R:Project
- August CTP and Inherited Interface Implementations
- Overloads do not display properly in Contents-tab
- August CTP: Problem with attributed fields
- Mrefbuilder crash on several VS dlls
- Syntax tab selection does not persist across topics
- Issues with localized XML files
- HHC file name not supported with extended characters
- C++ set methods for properties are still documented with an extra comma.
- The <seealso> tag seems to work just like the <see> tag.
- The parameters just look like an empty constructor in the HTML
- August CTP : <c> tag not working
- Attributes on methods
- Aug CTP: <seealso> tag not working
- Generic types are not displayed in method declaration
- Return-only generic type parameter not listed in doc
- Where clause not part of the doc
Cheers
Anand..
Comments
Anonymous
September 30, 2006
Sandcastle : What's new in September 2006 Sandcastle CTP 8월부터 CTP를 공개했던 SandCastle이 9월에도 CTP가 나왔습니다....Anonymous
September 30, 2006
September2006 Sandcastle CTP will be available by tomorrow (October 1, 2006)at Microsft download center.Anonymous
October 01, 2006
What is the diference with this?
http://www.microsoft.com/downloads/details.aspx?FamilyID=e82ea71d-da89-42ee-a715-696e3a4873b2&DisplayLang=enAnonymous
October 01, 2006
Ezequiel,
It appears the "msi" is still not updated. It say's the date piblished is August 27, 2006. This will be updated to today's date as soon as the new bits are available.
I will let you know as soon as it's updated.
Anand.Anonymous
October 02, 2006
Anand, How to generate the list of all members with the VS2005 presentation? Is it missing in this release or I am forgetting a build step? Thank you. GaelAnonymous
October 02, 2006
The comment has been removedAnonymous
October 03, 2006
The comment has been removedAnonymous
October 04, 2006
The comment has been removedAnonymous
October 04, 2006
I had the problem when I used the AddRoot.xsl style sheet. It disappeared when i removed this transform.Anonymous
October 05, 2006
We are providing a refresh to our September CTP which will resolve the See also and other VS2005 transforms issue. Also AddRoot.xsl transform step is not necessary and I will update the blog post accordingly. Anand.Anonymous
October 07, 2006
If you want the icons for Collapse and Expand to render edit C:Program FilesSandcastleProductionTransformsReflectionToChmProject.xsl and change <xsl:text>icons*.gif
</xsl:text> to <xsl:text>art*.gif
</xsl:text>Anonymous
October 29, 2006
NAnt is an open source software tool for automating software build processes. It is based on Apache Ant