Skip navigation
Currently Being Moderated

Remove an unused map ID - Does Not Work, Documentation Innacurate

Jul 16, 2012 3:45 PM

I am using TCS 3.5 on Windows XP Pro. We're linking FM books to RH for online help output. I'm listing this in the FM Integration section for that reason, but this seems like it could possibly be a standalone RH problem, too.


I've been creating map files in RH and everything was going well until I tried cleaning out the unused map IDs. The topic alias markers I create in FM work well and do port over. However, if I edit the marker in FM and update the linked files in RH, the new marker shows up in the map file -- but so do all of the old ones.


I thought that wouldn't be a problem when I found the "Remove an unused Map ID" function under the "Project Set-Up/Map Files." It seemed like it magically worked once and now not at all.


I have tried every variation you can imagine with the process. I both edited and deleted the markers in FM, but I still cannot clean them out with this function. I also found that the map file must be "unlocked" and verified that in the properties setting, as well.


Part of what I find strange is that the documentation for this function does not match up with I see in RH9. Maybe this is documentation for an older version of RH (see below)


At any rate, this is a huge problem, because I cannot have the map files littered with unusued map IDs, nor is it realistic to do this work manually, especially given the size of our books.


Remove an unused map ID

Your map files must be unlocked to use this option. To remove unused map IDs:

  • Expand the Context-Sensitive Help folder in the Project Set-up pod. 
  • Right-click the Map Files folder. 
  • Select Edit.
  • Do the following:
    Map Files
    Select the map files from which to remove unused map IDs.
    Select All
    Click to remove unused map IDs from all map files.
    Clear All
    Click to deselect all map files and not remove unused map IDs
  • Currently Being Moderated
    Jul 17, 2012 6:12 AM   in reply to Douglas_Campbell

    What happens if you remove all Map IDs and do a Force Update All – provided you’ve removed the markers from the FM source, you should only get the markers you want being converted.

    Mark as:
  • Currently Being Moderated
    Jul 18, 2012 5:51 AM   in reply to Douglas_Campbell

    Ah I see now - there's definitely a typo on this page ( d11aff59c571-7ff9.html). The third point should be to select "Remove Unused MapIDs" not "Edit" - then the rest of the topic makes sense. I'll try to figure out how to bring it to someone's attention - it used to be as easy as just offering a comment on the page; now I think it generates a new forum thread by default.


    But you're saying that doing this isn't cleaning out the unused ones after all? If that's the case then you should file a bug report here - and link to this thread.


    As a quick workaround, you can clean out a map file really easily by just opening the .h map file in Notepad and deleting the contents - it's just a text file.

    Mark as:
  • Currently Being Moderated
    Jul 18, 2012 12:13 PM   in reply to Douglas_Campbell

    Seems pretty clear to me -


    "Do the following:


    Map Files

    Select the map files from which to remove unused map IDs."

    if you only have one map file you should see the default BSSCDefault.h one listed and selected. If you've got a number of them, use the Clear All or Select All to uncheck or select them all.


    If you closed the project, got out of RH and opened up the BSSCDEfault.h file in Notepad, then cleared all the "define" entries out, saved it and closed Notepad, then started RH back up and did a Force Update All, it should repopulate it with only the markers in your FM source. Did that not happen?


    I can't offer you too much advice because I'm an "import from FM" guy myself - linking wasn't working for me due to my FM content's structure. I only need to manually delete a few Map ID entries now because most of my topics have been completed in FM. Our application doesn't remove many screens ever, so having to take away CSH links doesn't really happen; I'm usually adding more - I'm not sure why there'd be that much "churn" in CSH markers in the FM source in your case.


    The main philosophy in FM to RH integration is to do all the work in FM and try to do as little as possible in RH.

    Mark as:
  • Currently Being Moderated
    Jul 19, 2012 5:54 AM   in reply to Douglas_Campbell

    Being able to select multiple lines in the Edit Map IDs screen would be great - I strongly urge you to submit it as a wishlist item (more submissions of the same item help get things bumped up the dev list) at


    I'm slightly confused by the issue you raise with emptying out the .h file - "it would only pull over a single topic alias..." - I didn't think it was possible to use more than one type of marker in FM to indicate CSH to the RH project. The Conversion Settings > Edit FM > Other screen just asks for 1 Context Sensitive Help Marker. What does your Conversion Settings screen look like?

    Mark as:
  • Currently Being Moderated
    Jul 20, 2012 10:55 AM   in reply to Douglas_Campbell

    Wishlist items do show up each release – there’s a whole team of Adobe engineers working on changes. If you really want to get plugged in to what’s changing, join the Adobe pre-release program and do a bit of beta testing; there you have direct conversations with the TCS team engineers.


    The marker issue just sounds like a bug – you should contact Adobe Support with that one.

    Mark as:
  • Currently Being Moderated
    Jul 20, 2012 12:32 PM   in reply to Douglas_Campbell

    No they don’t pay anything as far as I know – those questions sound new; I wasn’t asked them at all.

    Mark as:

More Like This

  • Retrieving data ...

Bookmarked By (0)

Answers + Points = Status

  • 10 points awarded for Correct Answers
  • 5 points awarded for Helpful Answers
  • 10,000+ points
  • 1,001-10,000 points
  • 501-1,000 points
  • 5-500 points