Hello! When compiling a [fairly large] help project with lots of keywords, I get error HXC3031: Error HXC3031: A group of keywords for a single Help link or KTable exceeds 4,096 bytes. Unfortunately, the error is not very descriptive as it doesn't say anything about where to look for the source of the problem. Is there any explanation or additional info regarding this error? Google gives absolutely no information, unfortunately. With best regards, Eugene Mayevski.
Sounds similar to an MS HHelp 1.x error. If you forgot to add a <title> tag to the header of each HTML document the compiler would automatically generate keywords until the limit was exceeded. Make sure you have all the appropriate title tags and XML data islands. eg.. <xml> <MSHelp:RLTitle Title="Link displayed in Dynamic Help window"/> Rob "Eugene Mayevski" wrote in message news:eahM%23WEwFHA.1032@TK2MSFTNGP12.phx.gbl... > Hello! > > When compiling a [fairly large] help project with lots of keywords, I get > error HXC3031: > > Error HXC3031: A group of keywords for a single Help link or KTable > exceeds > 4,096 bytes. > > Unfortunately, the error is not very descriptive as it doesn't say > anything > about where to look for the source of the problem. Is there any > explanation > or additional info regarding this error? Google gives absolutely no > information, unfortunately. > > With best regards, > Eugene Mayevski. >
Hello! You wrote on Sat, 24 Sep 2005 01:37:20 -0700: RCM> Sounds similar to an MS HHelp 1.x error. RCM> If you forgot to add a <title> tag to the header of each RCM> HTML document the compiler would automatically RCM> generate keywords until the limit was exceeded. RCM> Make sure you have all the appropriate title tags and XML data RCM> islands. Thank you for the tip. I did see some warning in the log, related to missing title tag, so you are possible right. With best regards, Eugene Mayevski
Hello! You wrote to Rob Chandler [MVP] on Sat, 24 Sep 2005 14:08:47 +0300: RCM>> Make sure you have all the appropriate title tags and XML data RCM>> islands. EM> Thank you for the tip. I did see some warning in the log, related to EM> missing title tag, so you are possible right. Title XML tag as the one below is present in every HTML file. .... <MSHelp:TOCTitle Title="ElAuthenticodeVerifier.Signatures property"/> <MSHelp:RLTitle Title="ElAuthenticodeVerifier.Signatures property"/> .... However the problem is still present. Can the problem be caused by the fact, that certain keywords, such as <MSHelp:Keyword Index="K" Term="class"/> are present in too much HTML files (say 20-50)? With best regards, Eugene Mayevski
Hello! You wrote to Eugene Mayevski on Wed, 28 Sep 2005 10:34:51 +0300: EM> However the problem is still present. Can the problem be caused by the EM> fact, that certain keywords, such as EM> <MSHelp:Keyword Index="K" Term="class"/> EM> are present in too much HTML files (say 20-50)? Yes, this was the reason. It's really a pity since it can block creation of large files (our documentation for the components contains about 2500 HTML files already and the number is growing. Many files have common keywords (such as "constructor") and this will cause problems in future. With best regards, Eugene Mayevski
Right. So when you think about why would you want so many topics hooked up to a single keyword anyway? Its not going to really help the user is it? Attributes and Filters are different of course... you can have all files using the same atribute. Rob "Eugene Mayevski" wrote in message news:O6z9ouAxFHA.720@TK2MSFTNGP10.phx.gbl... > Hello! > You wrote to Eugene Mayevski on Wed, 28 Sep 2005 10:34:51 +0300: > > EM> However the problem is still present. Can the problem be caused by the > EM> fact, that certain keywords, such as > EM> <MSHelp:Keyword Index="K" Term="class"/> > EM> are present in too much HTML files (say 20-50)? > > Yes, this was the reason. It's really a pity since it can block creation > of > large files (our documentation for the components contains about 2500 HTML > files already and the number is growing. Many files have common keywords > (such as "constructor") and this will cause problems in future. > > With best regards, > Eugene Mayevski >
Hello! You wrote on Wed, 28 Sep 2005 11:19:32 -0700: RCM> Right. So when you think about why would you want so RCM> many topics hooked up to a single keyword anyway? RCM> Its not going to really help the user is it? RCM> Attributes and Filters are different of course... you can RCM> have all files using the same atribute. At the moment the question is rather theoretical, but if the word "constructor" is used in many topics (and you can imagine such situation with a library, that contains many components), then we face a problem. Of course now we will have to review our keywords in order to avoid such situation in future ... With best regards, Eugene Mayevski
Eugene I want to come back to your post (maybe I like having the last word :). Search is what is used when a user wants to find words in every file. Keywords are usually specially crafted by the author to help users find relavent pages. To make a keyword point to every page wont help the user. If the user wants to type in say "Baldness" (something close to my heart) they want to find the top 1-10 topics (pages) that you have marked with keywords to help user quickly find their info. In the future more emphasis will be given to finding info via search results (like google). Keywords probably being used to elevate a topic in the search results, or to mark a topic for keyword lookup for contextual help. Rob > At the moment the question is rather theoretical, but if the word > "constructor" is used in many topics (and you can imagine such situation > with a library, that contains many components), then we face a problem. Of > course now we will have to review our keywords in order to avoid such > situation in future ... > > With best regards, > Eugene Mayevski >
