4 Replies Latest reply on Aug 25, 2011 6:27 AM by DavidHutchinson

    [MERGE FILES] section of HHP file

    NL_Derek-GsBV5a Level 1
      We are trying to merge several HTML Help projects, and have everything working except for one thing. The [MERGE FILES] section of the HHP file is incorrect, which means that the Index and Search functions do not work fully.

      When we generate the CHM files the [MERGE FILES] section of the HHP file seems to be overwritten with data from section <mergedhelpfiles> in the XPJ file; but the filenames from the XPJ are converted into absolute paths in the HHP and thus the resulting CHM is not portable. If there are no entries in the <mergedhelpfiles> section of the XPJ file then the [MERGED FILES] section of the HHP is deleted.

      Does anyone know the relationship between these two sections? We are using Robohelp 7.02.001 under Windows XP, not on a network drive.
        • 1. Re: [MERGE FILES] section of HHP file
          RoboColum(n) Level 5
          It is not unknown for the [MERGE FILES] section of the HHP file to get out of sync in previous versions. I can't really speak for RH7. You could try renaming the project's CPD file, manually amend the HHP file and reopen the master project and compile.
          • 2. Re: [MERGE FILES] section of HHP file
            NL_Derek-GsBV5a Level 1
            Thanks for the idea Colum, but I had already tried zapping the CPD (Causes Problems Daily).
            Others have had this problem; see for example this post which suggests editing the HHP and recompiling.

            Robohelp only updates the HHP when it thinks a real change has been made; that is why double-compiling works. But that is not an option for automated generation. BTW we do not use source control.
            • 3. Re: [MERGE FILES] section of HHP file
              NL_Derek-GsBV5a Level 1
              Progress report; we have half a solution. I edited the HHP file to use filenames rather than paths, deleted the XPJ and CPD files, and then recreated the project from the HHP file. Of course I then had to remake my conditional build tags and single source layouts, but it worked. That is, both the XPJ and the HHP have filenames rather than paths in the merge section. Further, if I remove the [MERGE FILES] section of the HHP, it is restored with the data from the XPJ.

              But (I said "half a solution") when we use batch compiling (Robohelp's rhcl command) it all ends in tears. Robohelp converts the HHP file to use absolute paths before compiling. If I then do a compile from within Robohelp, the HHP file is restored to filenames.

              Can anyone help further?
              • 4. Re: [MERGE FILES] section of HHP file
                DavidHutchinson Level 1

                I solved this problem by making sure that the source folder for the parent Help file includes the latest child Help files. This resolved this problem for me. If you write new content in a child chm file that is not in the parent's source folder when the parent is built, the new content will not be found.


                So, make sure the latest child1.chm, child2.chm, child3.chm etc files are in the parent's source folder. That fixed it for me. No need to delete the XPJ file, CBD file etc. You do need to make sure that the [MERGE FILES] section in the HHP file does not include the paths though.