Problem using "Version Builder" plugin in v1.9.1.0

Topics: User Forum
Aug 11, 2010 at 8:42 PM
Edited Aug 11, 2010 at 9:01 PM

We are using SHFB to build the documentation for the Windows Live SDK here at Microsoft and have ran into an issue with Version Builder. We want to use SHFB in combination with the latest public release of Sandcastle, but when we try to build our doc project using the same settings that worked in v1.8.0.3, the following error occurs:

Info: ResolveReferenceLinksComponent2: Instantiating component.

Info: ResolveReferenceLinksComponent2: Creating MSDN URL resolver.

Info: ResolveReferenceLinksComponent2: Searching directory 'D:\Sandcastle_System\Sandcastle\Data\Reflection' for targets files of the form '*.xml'.

Info: ResolveReferenceLinksComponent2: Searching directory 'D:\Sandcastle_System\Projects\Microsoft.Live\Help\Working' for targets files of the form 'reflection.xml'.

Info: ResolveReferenceLinksComponent2: Loaded 203934 reference targets.

Info: MSHCComponent: Instantiating component.

Info: SaveComponent: Instantiating component.

Info: BuildAssembler: Building topic N:Microsoft.Live

Warn: ResolveReferenceLinksComponent2: Unknown reference link target 'contact'.

Warn: ResolveReferenceLinksComponent2: Invalid reference link target 'contact'.

Warn: ResolveReferenceLinksComponent2: Unknown reference link target 'contact'.

Warn: ResolveReferenceLinksComponent2: Invalid reference link target 'contact'.

Warn: ResolveReferenceLinksComponent2: Unknown reference link target 'contact'.

Warn: ResolveReferenceLinksComponent2: Invalid reference link target 'contact'.

Info: BuildAssembler: Building topic T:Microsoft.Live.AboutYouProfile

BUILDASSEMBLER : error : TransformComponent: A error ocurred while executing the transform '', on line 0, at position 0. The error message was: The variable or parameter 'omitVersionInformation' is either not defined or it is out of scope.

Last step completed in 00:01:34.6100

-------------------------------

SHFB: Error BE0043: Unexpected error detected in last build step. See output above for details.

Has anyone else out there ran into an issue using Version Builder in this latest release? Thanks in advance, your help is greatly appreciated!

Dominic F. Ferraro

Build Engineer

Microsoft Corporation 

Coordinator
Aug 12, 2010 at 2:42 AM

The missing parameter is a bug in the Sandcastle transformation.  The latest Sandcastle Styles patch contains the fix for it.

Eric

 

Aug 16, 2010 at 10:52 PM

Thanks Eric. We’ll give this a try.

Dominic

Jan 14, 2011 at 4:45 PM

this error ocorred with me. Why yours not update the software. Create a new version.

Coordinator
Jan 14, 2011 at 8:17 PM

The Sandcastle tools are not part of SHFB and I won't just patch anyone's Sandcastle install since they may not want to use the patch or cannot use the patch without following internal protocols for evaluating such things before introducing them into their build environment.  They may also have altered or patched Sandcastle in some other way and overwriting it with the patch would cause them to lose their changes without warning.  As such, if you want it, you need to install it separately.

Eric