Filtering APIs using Sandcastle

  API filters in Sandcastle is a very useful feature and allows namespaces, types, and members to be removed or shown in the reflection XML file, and ultimately in the compiled docs. They can be set up so that only certain topics are dropped, or so that a parent type has all children hidden with…

4

Sandcastle Community Projects – Sandcastle Styles

  I talked about various community projects supporting Sandcastle in this blog http://blogs.msdn.com/sandcastle/archive/2007/06/21/sandcastle-customer-projects.aspx. I am very pleased to announce the release of Sandcastle Styles to this community project list. Dave Sexton of DocProject for Sandcastle wrote me the following: Hi Anand, I don’t know if anyone else notified you about this yet, but Sandcastle Styles…

0

Announcing October 2007 Sandcastle CTP Release

  I am excited to announce the availability of October 2007 CTP version for Sandcastle. The latest version is now available for download at http://www.microsoft.com/downloads/details.aspx?FamilyId=E82EA71D-DA89-42EE-A715-696E3A4873B2&displaylang=en. My sincere thanks to the Sandcastle user community for providing us with valuable feedback. What’s new in this version: 1.       Reflection data files: The reflection files (generated from .net framework 3.5,…

9

Part 2: Version Builder

  In my previous blog http://blogs.msdn.com/sandcastle/archive/2007/10/03/sandcastle-september-2007-release-versionbuilder.aspx I provided details about Version Builder. I had several questions (http://forums.microsoft.com/MSDN/ShowPost.aspx?PostID=2237661&SiteID=1) about this feature. Attached is an example of versionbuilder. Here are the steps to run it. Unzip it to “c:\program file\sandcastle\examples”; Run command to get version-specific reflection file: > runversionbuilder.bat  Run command to build chm: > build_sandcastle.bat vs2005 test; In…

1

Sandcastle September 2007 Release: VersionBuilder

  Sandcastle September 2007 release includes the VersionBuilder tool under \ProductionTools folder to provide support for documenting multiple versions of a project. The VersionBuilder tool generates a single reflection data file from multiple version-specific reflection files. The output reflection file can then be used in the Sandcastle build to generate reference documentation in which each…

3

September 2007 Sandcastle release: Generating Framework Reflection data for resolving links

  Sandcastle September 2007 release was shipped without the Framework reflection data. This allowed us to reduce the Sandcastle installer size to 1.5 MB. In our previous releases we shipped the reflection files under the \Data\Reflection folder. For the September release we expect the users to generate this information.   Why do we need this…

4

Announcing September 2007 Sandcastle Release

I am excited to announce the availability of September 2007 version for Sandcastle. The latest version is now available for download at http://www.microsoft.com/downloads/details.aspx?FamilyId=E82EA71D-DA89-42EE-A715-696E3A4873B2&displaylang=en. My sincere thanks to the Sandcastle user community for providing us with valuable feedback. What’s new in this version: CHMBuilder for CHM generation using Sandcastle. Please see http://blogs.msdn.com/sandcastle/archive/2007/09/13/building-chm-using-chmbuilder.aspx. New Hybrid design (Presentation…

10

CHM Localization and Unicode issues – dbcsFix.exe

In this thread (http://forums.microsoft.com/MSDN/ShowPost.aspx?PostID=2139818&SiteID=1) we discussed about the localization issues in CHM. With September Sandcastle release we have addressed the Unicode issues for CHMs built in East Asian languages. Here’s the problem:   1.    For localized CHMs the sources need to be in ANSI if the language’s characters don’t all map to Western-1252.   2.   …

6

Part 1: VS 2005 presentation changes in Sandcastle September Release

We have made several improvements to the VS 2005 presentation transforms for our September release of Sandcastle. Internally we call it the “hybrid” document design for Orcas. This new documentation presentation layer targets Visual Studio Developers who need to find information quickly and easily in our documentation that grows significantly with every Visual Studio/.NET Framework…

4

Building CHM using CHMBuilder

Please see my blog about Sandcastle September 2007 release. With this release, we plan on shipping a new tool called CHMBuilder for CHM generation using Sandcastle. What is CHMBuilder? CHMBuilder is an executable that will be shipped under the Production Tools folder of Sandcastle. The HXS generation process in Sandcastle works much better than the…

5