documentation - How can I find out what's causing differences in generated Sandcastle docs? -

documentation - How can I find out what's causing differences in generated Sandcastle docs? -

in noda time, generate our documentation using sandcastle , shfb. commit documentation source repository - because makes easy view latest (and historical) docs.

i'm primary developer project, utilize 2 computers - , unfortunately, @ moment they're building different documentation though they're both updated same source.

the 2 computers same in every of import way can think of:

sandcastle 2.7.2.0 shfb 1.9.6.0 vs 2012 professional (both reported version 11.0.50727.1 in "programs", both "version 11.0.51106.01 update 1" in "about" page) latest version of local help content .net framework 4.5 (and no local help content other framework versions)

steps taken ensure clean build:

deleted shfb cache folder (c:\users\jon\appdata\local\ewsoftware\sandcastle help file builder\cache) deleted folder documentation generated into deleted user settings file related shfb project file deleted symbol cache in visual studio

still differences remain. appear limited documentation inherited msdn itself, in particular object.finalize.

version 1 (generated on machine "chubby"):

<div class="summary">allows object seek free resources , perform other cleanup operations before reclaimed garbage collection.</div>

version 2 (generated on machine "sandy"):

<div class="summary">allows <a href="http://msdn2.microsoft.com/en-us/library/e5kfa45b" target="_blank"> object</a> effort free resources , perform other cleanup operations before <a href="http://msdn2.microsoft.com/en-us/library/e5kfa45b" target="_blank">object</a> reclaimed garbage collection.</div>

both link same msdn documentation, looks version 1 (no links object).

looking @ few of changed files, alter consistent , restricted member.

where might sandcastle getting documentation from, , how can both computers behave same way?

edit: 1 more fragment of info - after cleaning cache , rebuilding docs on both machines, there 3 files in shfb cache directory:

reflection.cache has same size on both machines msdnurl.cache has same size on both machines .netframework_4.0.0319_e8879a28.cache has size 13,377,733 bytes on chubby, , 13,337,949 bytes on sandy

edit: important progress! i've found difference coming from...

the file c:\windows\microsoft.net\framework\v2.0.50727\en\mscorlib.xml:

on chubby 8,005,263 bytes date of 12th dec 2011, , has non-linked text finalize on sandy 9,740,370 bytes date of 31st august 2009, , has text finalize includes links

on both machines, mscorlib.dll same size (4,550,656 bytes) , has modified date of 13th september 2012.

but how can them same? difference come from? (service packs?)

edit: okay, version in c:\windows reddish herring - it's version in c:\program files (x86)\reference assemblies\microsoft\framework that's blame. i'm going see if can find out why might different between installations...

a couple of ideas considering recent edits, although agree bit shooting in dark...

i utilize tool "beyond compare" compare .net framework files , xml files on both machines ("folder compare" profile). favour binary level comparing sure... if both of machines local, should fast.

you can seek run mark russinovich's process monitor ( http://live.sysinternals.com/procmon.exe ) on both machines , run documentation building process. way, see files beingness read , involved in help file building process, , coming from... lot of output show happens in system; may want disable registry , network monitoring, leave file monitoring, , exclude process unrelated documentation building process.

i'm not help generation expert, think text comes xml files, may want set filter on showing xml files well.

if can identify files involved, might have re-create them 1 machine on other.

documentation sandcastle finalize shfb