Adventure Game Studio

AGS Support => Advanced Technical Forum => Topic started by: SSH on Tue 02/09/2003 15:12:17

Title: Suggestion: Better help file index
Post by: SSH on Tue 02/09/2003 15:12:17
It seems that lots of people are having trouble finding pre-existing functions in the help file index and getting RTFMed as a result.
For example, search for walkbehind and you get 3 topics: Character functions, Object functions and Room/Screen functions. It would be better if you got 1 topic for each function that has "walkbehind" in the name or description, not to mention the part of then room tutorial where walkbehinds are done.
Title: Re:Suggestion: Better help file index
Post by: Pumaman on Tue 02/09/2003 19:28:02
The help file is a bit of a hack, I have to admit. I'll see what I can do about sorting it out, but as you can probably appreciate it's not my highest of priorities.
Title: Re:Suggestion: Better help file index
Post by: Gilbert on Wed 03/09/2003 04:04:35
Actually there's something that's a bit annoying in the script function reference part. As some of the functions can, in fact, belong to two categories. For example:

AreCharObjColliding() can belong to both the "character" and "object" related sections (it's now only in char section)

That makes it difficult to look for functions sometimes. However it may not be an good idea to have duplicated functions in different sections either. I have no proposal about it at the moment.
Title: Re:Suggestion: Better help file index
Post by: SSH on Wed 03/09/2003 12:04:45
I'm sure that there would be plenty of volunteers to re-do the help file if you were to ask for help (e.g. me, but I have no idea about creating Help files  :( )
Title: Re:Suggestion: Better help file index
Post by: Pumaman on Thu 04/09/2003 21:18:54
The thing is that at the moment the help file is automatically generated from a text document, so it's a bit more complicated than it first appears.
Title: Re:Suggestion: Better help file index
Post by: SSH on Fri 05/09/2003 11:11:22
Funnily enough, the keywords are already in there and work fine when you click on the "See alsos" at the bottom of a function ref, but they're just not in the index!
Title: Re:Suggestion: Better help file index
Post by: Pumaman on Fri 05/09/2003 18:05:50
It's because each section (like "Hotspot functions") is a single page in the help file, and the full text search just returns the name of the page that it found the match on, not the name of the sub-section with the match.