Where to find Sandcastle source code?

May 21, 2008 at 8:31 PM
Hi,

I would like to submit a patch as well as investigate BuildAssembler crash. Anybody knows what happened to Sandcastle sources? SVN trunk is empty.

Regards,
Andy
Editor
May 21, 2008 at 11:03 PM
The source code for Sandcastle hasn't been released.  If you have a bug report, you can create a work item on the Issue Tracker tab at the top of the page.  Before you do that, you might want to post the details of your crash here.  It's possible one or more of us here have seen it already and may have a workaround.  For example, there's a well-known crash in BuildAssembler when using the root namespace container option.  A patch to one of the transformation files fixes it and is available at http://www.codeplex.com/SHFB (Presentation Style Patch).

Eric
May 22, 2008 at 4:45 PM
Thanks Eric,

Please take a look at ManagedReflectionWriter.GetVisibility() method.  In general it is incorrect to assume that any member that didn't fall into { public | family | assembly } categories must be a private member.  Please take a look at System.Reflection.MethodAttributes enum. As result MRefBuilder.exe crashes on any assembly generated by IKVM.

Regards,
Andy

EWoodruff wrote:
The source code for Sandcastle hasn't been released.  If you have a bug report, you can create a work item on the Issue Tracker tab at the top of the page.  Before you do that, you might want to post the details of your crash here.  It's possible one or more of us here have seen it already and may have a workaround.  For example, there's a well-known crash in BuildAssembler when using the root namespace container option.  A patch to one of the transformation files fixes it and is available at http://www.codeplex.com/SHFB (Presentation Style Patch).

Eric



May 22, 2008 at 6:51 PM


Regarding the failure:

BuildAssembler fails with the following exception:

Warn: SharedContentComponent: Missing shared content item. Tag:'include'; Id:'topictitle'.
Warn: SharedContentComponent: Missing shared content item. Tag:'include'; Id:'topictitle'.

Unhandled Exception: System.InvalidOperationException: Operation is not valid due to the current position of the navigator.
   at System.Xml.DocumentXPathNavigator.InsertAfter()
   at Microsoft.Ddue.Tools.SharedContentComponent.ResolveContent(XmlDocument document, XPathNavigator start)
   at Microsoft.Ddue.Tools.SharedContentComponent.ResolveContent(XmlDocument document, XPathNavigator start)
   at Microsoft.Ddue.Tools.SharedContentComponent.ResolveContent(XmlDocument document)
   at Microsoft.Ddue.Tools.SharedContentComponent.Apply(XmlDocument document, String key)
   at Microsoft.Ddue.Tools.BuildAssembler.Apply(IEnumerable`1 topics)
   at Microsoft.Ddue.Tools.BuildAssembler.Apply(String manifestFile)
   at Microsoft.Ddue.Tools.BuildAssemblerConsole.Main(String[] args)



EWoodruff wrote:
The source code for Sandcastle hasn't been released.  If you have a bug report, you can create a work item on the Issue Tracker tab at the top of the page.  Before you do that, you might want to post the details of your crash here.  It's possible one or more of us here have seen it already and may have a workaround.  For example, there's a well-known crash in BuildAssembler when using the root namespace container option.  A patch to one of the transformation files fixes it and is available at http://www.codeplex.com/SHFB (Presentation Style Patch).

Eric



Editor
May 22, 2008 at 8:33 PM
Edited May 22, 2008 at 8:36 PM
The failure you are seeing is caused by the root namespace container issue (http://www.codeplex.com/Sandcastle/WorkItem/View.aspx?WorkItemId=918).  Download the noted patch from the SHFB project site and extract into your Sandcastle installation folder and it will fix that issue.

The other issue regarding ManagedReflectionWriter is in MRefBuilder.exe.  You'll need to open a work item for that one.

Eric