What's new in August 2006 Sandcastle CTP
August 2006 Sandcastle CTP is currently available at https://www.microsoft.com/downloads/details.aspx?FamilyID=e82ea71d-da89-42ee-a715-696e3a4873b2&DisplayLang=en. Here is a summary of what's new in this CTP version:
- Firefox support for Sandcasltle generated HTMs
- 3 different link options (local, Index and MSDN) in sandcastle.config file.
- /internal+- option in MrefBuilder enables documentation of private APIs to be produced for the internal consumption of development teams
- Support for multi-dimensional arrays
- Support for CHM Index and root node. Additional transforms are added to CHM generation process to accomplish this.
- Support for all C# tags and html style elements in code comments
- Abilty to use environment variables in config files
- Changes to syntax for XSLTransform
Note: Sandcastle users should take note that, as part of the resolution of the XslTransform crash bug, the syntax for XslTransform has changed. To specify an XSLT you use the /xsl option, and to specify multiple XSLTs you specify multiple /xsl options. Thus the old syntax
XslTransform AddOverloads.xsl reflection.org | XslTransform AddGuidFileNames.xsl /out:reflection.xml
Has now become:
XslTransform /xsl:AddOverloads.xsl /xsl:AddGuidFileNames.xsl reflection.org /out:reflection.xml
Or, if you prefer:
XslTransform /xsl:AddOverloads.xsl,AddGuidFileNames.xsl reflection.org /out:reflection.xml
Environment variables are expanded on all input strings. XslTransform no longer supports pipelining.
Bug Fixes:
The following bugs have been fixed for this CTP.
- BuildAssembler /? shows the usage as “TocBuilder” and incorrect information.
- XslTransform with no cmd line parameters crashes.
- Sandcastle.config file would support environment variables for all paths instead of just some of them.
- Typo: Info: ResolveReferenceLinksComponent: Preparing to querry MSDN topic URL web service. “querry” should be “query”.
- Error: An error occured while performing the transofmation. The error message is:… “transofmation” should be “transformation”.
- BuildAssembler: System.Null referenceException being thrown and tool dies for MREF build.
- Exception tag from XML comments are not being populated in .chm file.
- Sandcastle: CHM compile warnings should be fixed.
- Sandcastle: Buildassembler is throwing exception and the resulting CHM has several issues.
- Sandcastle losing encoding for localization builds.
- Typos in various "error" messages.
- Protected members are treated as public and C++ set methods for properties are documented with an extra comma
- Sandcastle:Lists are not documented correctly
- Sandcastle: Extra brackets in front of every parameter name
- Sandcastle - System.NullReferenceException related to interface implementation
- Sandcastle: BuildAssembler has a problem with multi-dimensional arrays
- Sandcastle: Types are missing
- Unhandled exception thrown by XslTransform
- Sandcastle is dropping the <paramref name=”blah”/> text
- BuildAssembler throws exception during attempt to overwrite a read-only file
- Sandcastle: Generated htm files are missing reflection information.
- Enable use of environment variables within Manifold BuildAssembler .config files
- Sandcastle: Issue with interfaces inheriting from generic interfaces.
- Sandcastle transforms does not process all XML elements from code comments
- BuildAssembler throws exception when processing WinSDK dlls
Comments
- Anonymous
August 27, 2006
What's new in August 2006 Sandcastle CTP Sandcastle blog- August 2006 Sandcastle CTP should be available - Anonymous
August 27, 2006
I have updated the MSBuild script for Sandcastle to work with this latest version of the CTP:
http://blog.ljusberg.com/2006/08/sandcastle-august-ctp-released.html
/Anders - Anonymous
August 28, 2006
The team behind Microsoft Sandcastle released a new CTP of Sandcastle yesterday. A couple of changes - Anonymous
August 28, 2006
La CTP d'Août 2006 de Sandcastle est disponible.
Au menu, des améliorations comme :
le support des... - Anonymous
August 28, 2006
OK, so maybe you've seen it already. But with the demise of NDoc for .Net 2.0 there is, to me at least, - Anonymous
August 29, 2006
You may recall a release in July of the first Sandcastle CTP (Sandcastle - Documenting Managed Class... - Anonymous
August 29, 2006
http://www.microsoft.com/downloads/details.aspx?FamilyID=e82ea71d-da89-42ee-a715-696e3a4873b2&amp;DisplayLang=en&nbsp;(달라진... - Anonymous
August 30, 2006
I use danish characters in my code documentation. These characters do not show correct in the .htm or .chm files. How do I set localization?
SteffenJ - Anonymous
August 30, 2006
Steffen,
Could you email me you comment XML file with DAnish charecters? I would like to debug to see what the issue is. Thanks.
Anand.. - Anonymous
August 31, 2006
Hi Anand.
Where can I find your email address?
I have made an example file but if possible, you can try to use the ALT key and the numeric keyboard with these codes:
æ ALT+145 Æ ALT+146
ø ALT+155 Ø ALT+157
å ALT+134 Å ALT+143
Thanks very much
SteffenJ - Anonymous
August 31, 2006
Thanks Steffen. You can use the "Email" link at the top of this web page to reach me. My address is AramATMicrosoftDotCom.
Anand.. - Anonymous
September 03, 2006
Hi again.
I have downloaded Sandcastle Help File Gui from http://forums.microsoft.com/MSDN/ShowPost.aspx?PostID=641182&SiteID=1
It has a Language property that can be set to Danish/Denmark and that solves my problem.
Thanks for your help
SteffenJ - Anonymous
September 16, 2006
The team behind Microsoft Sandcastle released a new CTP of Sandcastle yesterday. A couple of changes - Anonymous
September 26, 2006
For a long time, whenever I spent time with C# customers, I would invariably get asked, "How do I create... - Anonymous
November 11, 2006
La CTP d'Août 2006 de Sandcastle est disponible . Au menu, des améliorations comme : le support des tableaux