mshcMigrate.exe

Contents

1 About mshcMigrate
2 Further Information
3 Read Me First
4 System requirements
5 Download
6 Licensing
7 Support
1. 7.1 Support Groups
2. 7.2 Contact Us

About mshcMigrate

mshcMigrate was developed by The Helpware Group in partnership with Microsoft and allows you to migrate older help content (MS Help 2 and MS HTML Help 1.x) to MS Help Viewer format (the new format for MS Visual Studio 2010 help). It takes various inputs including projects files (.hxc and .hhp), compiled help files (.hxs and .chm), and help folders.

Outputs include .mshc/.cab help package files and .msha manifest files. The application includes several additional tools that allows you to test, install/uninstall, view the HelpLibManager.exe output log, perform API calls, and explore the help library data store.

The utility is part of Helpware's FAR HTML v5 product set which provides advanced meta tag editing and TOC/Index editing for MS Help Viewer projects. mshcMigrate however can be downloaded separately and is free for personal use (see mshcMigrate licensing for further detail).

Migrate features include:

Outputs to both .mshc and .cab help file formats.
Includes a .mshi Index file into the .cab if available.
Generates a .msha manifest file for installing.
Batch mode for unattended operation.
Rezip (Update) any folder to a .mshc help file.
What does migrate do?
Converts Index and TOC files to topic meta tags.
Converts embedded topic tags to topic meta tags.
Converts topic HTML source to the required XHTML format.
Converts link paths to topics, images, CSS & JS files.
Implements required MS Help Viewer 1.0 work-a-rounds.
Allows you to use Visual Studio 2010 branding or use your own JS and CSS via the SelfBranded meta tag.
Additional features include:
Manifest page: Create a .msha manifest file using one or multiple help files.
Help Library Manager page: Run the HLM application. Shows the various command line options. View the HLM event log.
Help Library Agent page: Test the various MS Help Viewer API calls. Test your help. A powerful aid for both authors and programmers.
Help Library Store page: This page rips through the meta data in the Help library data store and displays the content and location of all help packages installed on your PC. You can also view the source and decompile help files.

Further Information

Detailed information on MS Help Viewer 1.0 can be found on our Helpware web site

http://helpware.net/mshelp3/

Keeping up to date:

Read Me First

There are several bugs in MS Help Viewer 1.0 not fixed due to lack of time. Microsoft are working with vendors so we can implement work-a-rounds. You can see some of the problems that mshcMigrate is dealing with in the Help 1.0 Notebook. Please report any bugs found via discussion groups.

System requirements

Windows XP or greater.
.HxS decompile requires MS Help 2 (ie. VS 2002/2003/2005/2008 installed).
.NET Framework 2.0

Download

Please download mshcMigrate.exe from Visual Studio Gallery.

Current Version: 30-June-2011, 1.1 Build 67 -- See Change Notes

If you like mshcMigrate please leave a Rating or Review. If not, tell us why so we can fix it.

Beta drops. Try new features. Grab the Beta from the end of this page.

Currently no Beta.

Licensing

This migrate utility is 100% free: for personal use; for non-profit organizations; for testing purposes; for experimenting; as a learning aid; for infrequent use; for one-off conversions.

If used regularly to build commercial product we do expect the business to buy a license to help support this project. A license means email support for when you get stuck. Buying a license encourages us to keep the tool up to date as new versions come out.

Note that customers who own a copy of FAR HTML v5 are already licensed. If you are a licensed FAR HTML 5 user and have FAR 5 installed then the mshcMigrate about box will say "licensed".

The license is a "per user" license. So if user X owns a FAR HTML v5 license, then user X may install FAR and mshcMigrate on multiple machines and concurrently run all copies. Another user can run user X's FAR and mshcMigrate, as long as nobody else is operating FAR and mshcMigrate at the same time (ie. a single user license). Of course if you own a team, site or world license sharing is not an issue.

Please contact us if you need assistance.

Purchase mshcMigrate - Buy a license for mshcMigrate or FAR HTML 5.
License.txt File - How to enter your license codes.
End User License Agreement - For companies who need the legal stuff.

Support

If you own a mhcMigrate license, or a copy of FAR HTML v5 then you may contact us directly for support. Please try the public support groups first if possible.