0 Replies Latest reply on Nov 12, 2009 9:24 AM by Dee70

    cshelp.txt RoboHelp 8 Issue

    Dee70 Level 1

      This issue will be of interest to you if you are using RoboHelp 8 and you create field-level help using the Context Sensitive Text-Only Topics editor.

       

      We recently uncovered an issue in RoboHelp 8 with the compiling of the context-sensitive help. During the compiling process, the first entry in the cshelp.txt file is not being converted from the topic ID to the map number. The field-level help for the first entry does not work as a result.

       

      As an example, let's say this is how my cshelp.txt file looks when I open it in Notepad:

       

      .topic example
      Field definition for example here.

       

      .topic another_example
      Field definition another_example here.

       

      .topic yet_another_example
      Field definition for yet_another_example here.


      After compiling the help project, the resulting cshelp.txt file (which you can view by decompiling the .chm file and then opening the resulting cshelp.txt file) should show that the topic IDs have been replaced with the associated map number (taken from the cshelp.h file). For example, you should see something like this:

       

      .topic 24
      Field definition for example here.

       

      .topic 48
      Field definition another_example here.

       

      .topic 35
      Field definition for yet_another_example here.

       

      What is happening now in RoboHelp 8 though is this:

       

      .topic example
      Field definition for example here.

       

      .topic 48
      Field definition another_example here.

       

      .topic 35
      Field definition for yet_another_example here.

       

      As you can see, the compile process is skipping that first entry in the file, and as a result, the field-level help for the first entry will not work.

       

      Our current workaround for this is that just before compiling the help project, we open the cshelp.txt file in Notepad and add a placeholder field-level entry at the top of the file. For example:

       

      .topic placeholder
      This is a placeholder for the cshelp.txt file bug.

       

      .topic example
      Field definition for example here.

       

      .topic another_example
      Field definition another_example here.

       

      .topic yet_another_example
      Field definition for yet_another_example here.


      After doing that, then when you view the cshelp.txt file post compile/decompile you would see:

       

      .topic placeholder
      This is a placeholder for the cshelp.txt file bug.

       

      .topic 24
      Field definition for example here.

       

      .topic 48
      Field definition another_example here.

       

      .topic 35
      Field definition for yet_another_example here.


      All of your real field-level help will have the map numbers as needed, and the placeholder text is left as is.

       

      I have submitted this as a bug to Adobe (http://www.adobe.com/cfusion/mmform/index.cfm?name=wishform ). Hope you find this helpful.