This project has moved and is read-only. For the latest updates, please go here.

Build failed on MRefBuilder

Topics: User Forum
Oct 7, 2007 at 8:48 AM
Using the September CTP of Sandcastle and Production of SHFB I get this error:

Sandcastle Help File Builder GUI, version
Creating output and working folders...
Clearing working folder...
Finding tools...
Found Sandcastle in 'C:\Program Files\Sandcastle\'
Found HTML 1.x help compiler in 'C:\Program Files\HTML Help Workshop\'
Validating documentation assembly information...
Generating shared content files (en-US, English (United States))...
Creating Sandcastle configuration file...
No component configurations to merge
Last step completed in 00:00:00.0060
Copying documentation assembly dependencies...
No dependencies to copy
Last step completed in 00:00:00.0040
Generating API filter for MRefBuilder...
Last step completed in 00:00:00.0240

BUILD FAILED: 'utf-8" standalone="yes' is not a supported encoding name.
Parameter name: name

Oct 8, 2007 at 6:23 AM
Check your XML comments files or any Comments Only xml files in the Assemblies to Document list. It appears something isn't valid with one of them.

Oct 8, 2007 at 9:18 AM
Ok, that fixed it. Perhaps it would be a good idea to check for this situation and provider a better error message?

Unfortunately I'm now getting this error:

Generating table of content for HTML Help 1.x file...
C:\Program Files\EWSoftware\Sandcastle Help File Builder\Help\Working\Generate1xTOC.bat
XslTransform (v2.3.7930.6)
Copyright ¸ Microsoft 2005-2006
Info: Applying XSL transformation 'C:\Program Files\Sandcastle\ProductionTransforms\TocToChmContents.xsl'.

Unhandled Exception: System.IO.FileNotFoundException: Could not find file 'C:\Program Files\EWSoftware\Sandcastle Help File Builder\Help\Working\Output\html\.htm'.
File name: 'C:\Program Files\EWSoftware\Sandcastle Help File Builder\Help\Working\Output\html\.htm'
at System.IO.__Error.WinIOError(Int32 errorCode, String maybeFullPath)
at System.IO.FileStream.Init(String path, FileMode mode, FileAccess access, Int32 rights, Boolean useRights, FileShare share, Int32 bufferSize, FileOptions options, SECURITY_ATTRIBUTES secAttrs, String msgPath, Boolean bFromProxy)
at System.IO.FileStream..ctor(String path, FileMode mode, FileAccess access, FileShare share, Int32 bufferSize)
at System.Xml.XmlDownloadManager.GetStream(Uri uri, ICredentials credentials)
at System.Xml.XmlUrlResolver.GetEntity(Uri absoluteUri, String role, Type ofObjectToReturn)
at System.Xml.XmlTextReaderImpl.OpenUrlDelegate(Object xmlResolver)
at System.Threading.CompressedStack.runTryCode(Object userData)
at System.Runtime.CompilerServices.RuntimeHelpers.ExecuteCodeWithGuaranteedCleanup(TryCode code, CleanupCode backoutCode, Object userData)
at System.Threading.CompressedStack.Run(CompressedStack compressedStack, ContextCallback callback, Object state)
at System.Xml.XmlTextReaderImpl.OpenUrl()
at System.Xml.XmlTextReaderImpl.Read()
at System.Xml.XPath.XPathDocument.LoadFromReader(XmlReader reader, XmlSpace space)
at System.Xml.XPath.XPathDocument..ctor(String uri, XmlSpace space)
at System.Xml.XPath.XPathDocument..ctor(String uri)
at System.Xml.Xsl.CompiledQuery.Script1.getTitle(String fileName)
at <xsl:template match="topic">(XmlQueryRuntime {urn:schemas-microsoft-com:xslt-debug}runtime, XPathNavigator {urn:schemas-microsoft-com:xslt-debug}current)
at <xsl:template name="parentNode">(XmlQueryRuntime {urn:schemas-microsoft-com:xslt-debug}runtime, XPathNavigator {urn:schemas-microsoft-com:xslt-debug}current)
at <xsl:template name="parentNode">(XmlQueryRuntime {urn:schemas-microsoft-com:xslt-debug}runtime, XPathNavigator {urn:schemas-microsoft-com:xslt-debug}current)
at <xsl:template name="parentNode">(XmlQueryRuntime {urn:schemas-microsoft-com:xslt-debug}runtime, XPathNavigator {urn:schemas-microsoft-com:xslt-debug}current)
at <xsl:template match="/">(XmlQueryRuntime {urn:schemas-microsoft-com:xslt-debug}runtime, XPathNavigator {urn:schemas-microsoft-com:xslt-debug}current)
at Root(XmlQueryRuntime {urn:schemas-microsoft-com:xslt-debug}runtime)
at Execute(XmlQueryRuntime {urn:schemas-microsoft-com:xslt-debug}runtime)
at System.Xml.Xsl.XmlILCommand.Execute(Object defaultDocument, XmlResolver dataSources, XsltArgumentList argumentList, XmlSequenceWriter results)
at System.Xml.Xsl.XmlILCommand.Execute(Object defaultDocument, XmlResolver dataSources, XsltArgumentList argumentList, XmlWriter writer, Boolean closeWriter)
at System.Xml.Xsl.XmlILCommand.Execute(XmlReader contextDocument, XmlResolver dataSources, XsltArgumentList argumentList, XmlWriter results)
at System.Xml.Xsl.XslCompiledTransform.Transform(XmlReader input, XsltArgumentList arguments, XmlWriter results)
at Microsoft.Ddue.Tools.XslTransformer.Main(String[] args)
Last step completed in 00:00:05.0730

BUILD FAILED: Unexpected error in last build step. See output above for details.
Oct 8, 2007 at 4:09 PM
Edited Oct 8, 2007 at 4:11 PM
Download the Sandcastle Presentation File Patches from the Releases page and extract it to the Sandcastle installation folder (the CTP, not SHFB). There's a bug in the Prototype presentation style that causes the exception that you are seeing.