Sandcastle

Please post all questions and comments regarding Help & Manual 7 here.

Moderators: Alexander Halser, Tim Green

Post Reply
dcraggs
Posts: 20
Joined: Thu Oct 26, 2006 2:58 pm

Sandcastle

Unread post by dcraggs »

Hi,

Just wondering if Sandcastle import is working. Tried to import a project but getting issues with assemblies.

Error: Unresolved assembly reference: System.Text.RegularExpressions (System.Text.RegularExpressions, Version=0.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a) required by System

I did add the assembly and it's folder.

The project is using .NET 5.0.

If not is there a way I can import the XML comments file generated by visual studio?

Dave Craggs
User avatar
Tim Green
Site Admin
Posts: 23154
Joined: Mon Jun 24, 2002 9:11 am
Location: Bruehl, Germany
Contact:

Re: Sandcastle

Unread post by Tim Green »

Hi Dave,

Did you follow these instructions for setting up for Sandcastle import:

https://www.helpandmanual.com/help/hm_w ... astle.html
Regards,
Tim (EC Software Documentation & User Support)

Private support:
Please do not email or PM me with private support requests -- post to the forum directly.
dcraggs
Posts: 20
Joined: Thu Oct 26, 2006 2:58 pm

Re: Sandcastle

Unread post by dcraggs »

Yes I did. But the section Importing a Sandcastle project to a new project is very sparse on details.

Which dll's need to be added? and from where?

Dave Craggs
User avatar
Tim Green
Site Admin
Posts: 23154
Joined: Mon Jun 24, 2002 9:11 am
Location: Bruehl, Germany
Contact:

Re: Sandcastle

Unread post by Tim Green »

Hi Dave,

OK, I just wanted to make sure. I need to check with our Sandcastle developer now for details on this. It might take a little while as he's traveling at the moment. I'll let you know as soon as possible.

Just another check: I'm assuming you did install Sandcastle together with Help+Manual, correct? It comes bundled and it's best to use the included version if you can.
Regards,
Tim (EC Software Documentation & User Support)

Private support:
Please do not email or PM me with private support requests -- post to the forum directly.
User avatar
Tim Green
Site Admin
Posts: 23154
Joined: Mon Jun 24, 2002 9:11 am
Location: Bruehl, Germany
Contact:

Re: Sandcastle

Unread post by Tim Green »

Update: Michael comments that it looks as though your Sandcastle version just can't process all the components of your project. We recommend installing the version that is bundled with Help+Manual. Just get the current installer for HM7 here, run it again and make sure that you include Sandcastle in the components to install when you reach that screen.
Regards,
Tim (EC Software Documentation & User Support)

Private support:
Please do not email or PM me with private support requests -- post to the forum directly.
dcraggs
Posts: 20
Joined: Thu Oct 26, 2006 2:58 pm

Re: Sandcastle

Unread post by dcraggs »

Did that, still not working.

In Assemblies :
I added the project dll from the release bin folder.
Added the bin folder
Added C:\Program Files\dotnet\packs\Microsoft.NETCore.App.Ref\5.0.0\ref\net5.0\

Still getting the error

Error: Unresolved assembly reference: System.Text.RegularExpressions (System.Text.RegularExpressions, Version=0.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a) required by System

System.Text.RegularExpressions.dll is in the last folder.

Any more ideas?

Thanks

Dave Craggs
User avatar
Tim Green
Site Admin
Posts: 23154
Joined: Mon Jun 24, 2002 9:11 am
Location: Bruehl, Germany
Contact:

Re: Sandcastle

Unread post by Tim Green »

dcraggs wrote: Thu Mar 11, 2021 4:00 pm System.Text.RegularExpressions.dll is in the last folder.
OK, but did you explicitly add it to the assemblies Sandcastle is going to process, as shown here?:

https://www.helpandmanual.com/help/hm_a ... mport.html

It should be listed explicitly in the Assemblies: box.
Regards,
Tim (EC Software Documentation & User Support)

Private support:
Please do not email or PM me with private support requests -- post to the forum directly.
dcraggs
Posts: 20
Joined: Thu Oct 26, 2006 2:58 pm

Re: Sandcastle

Unread post by dcraggs »

No but I added the folder.

Explicitly added the DLL and ran it again same error.

Here is the full result

Prepare build process ...

Extract help&manual presentation files ...
Version of MrefBuilder.exe: 2.7.2.0

Copy Assemblies and Documentation files ...

Call Microsoft Reference Builder ...
MRefBuilder (v2.7.2.0)
Copyright ¸ 2006-2012, Microsoft Corporation, All Rights Reserved
Info: Loaded 213 assemblies for reflection and 0 dependency assemblies.
Error: Unresolved assembly reference: System.Text.RegularExpressions (System.Text.RegularExpressions, Version=0.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a) required by System

An Error occured. Please see log. Press "Close" to continue

Dave Craggs
User avatar
Tim Green
Site Admin
Posts: 23154
Joined: Mon Jun 24, 2002 9:11 am
Location: Bruehl, Germany
Contact:

Re: Sandcastle

Unread post by Tim Green »

Hi Dave,

Hmm... This is all a little odd. I just realized that that isn't a DLL used by your application at all, but one required by Sandcastle itself. It's also strange that it's referencing version 0.0.0.0, instead of the one it really needs. You definitely don't need to reference it as one of the assemblies for your application (unless your application is also using it).

I just discussed this with Michael and his feeling is that it may be a classic case of DLL Hell. I.e. that your system has a lot of copies of this DLL but the one that Sandcastle is finding, for whatever reason, is one that it's gagging on, for whatever reason. The easiest way to test all this would be to set up a clean Windows 10 virtual machine with Help+Manual, Sandcastle, Visual Studio and your application. If it all works there, and it probably will, that would be a strong indication that it's the wrong version of the DLL that Sandcastle is finding.
Regards,
Tim (EC Software Documentation & User Support)

Private support:
Please do not email or PM me with private support requests -- post to the forum directly.
dcraggs
Posts: 20
Joined: Thu Oct 26, 2006 2:58 pm

Re: Sandcastle

Unread post by dcraggs »

It is strange as the dll I have referenced is the one in the dependencies from the project.

I'm not totally sure why you the dll is needed at all, is not the XML file enough?

Dave
dcraggs
Posts: 20
Joined: Thu Oct 26, 2006 2:58 pm

Re: Sandcastle

Unread post by dcraggs »

Just did a search for that dll, I only have 243 on my system!!!

Think I may need to do a rebuild of my dev system!!

Dave
dcraggs
Posts: 20
Joined: Thu Oct 26, 2006 2:58 pm

Re: Sandcastle

Unread post by dcraggs »

Still getting issues

Tried a different project, getting

Error: Unresolved assembly reference: Newtonsoft.Json (Newtonsoft.Json, Version=6.0.0.0, Culture=neutral, PublicKeyToken=30ad4fe6b2a6aeed) required by System.Net.Http.Formatting

But the project is using Newtonsoft.Json v12.0.3

Dave
User avatar
Tim Green
Site Admin
Posts: 23154
Joined: Mon Jun 24, 2002 9:11 am
Location: Bruehl, Germany
Contact:

Re: Sandcastle

Unread post by Tim Green »

Hi Dave,

Is this still on the same computer or on a clean build with a fresh Windows installation? My guess is that you're going to continue to have problems until you do that.
Regards,
Tim (EC Software Documentation & User Support)

Private support:
Please do not email or PM me with private support requests -- post to the forum directly.
Post Reply