

Languages & Devhelp:

Current Situation:

language files used by phpmole:

(1)Language : The general configuration file 
    includes keywords1-4, 
    
(2)Language.html : The list of keywords5 for Language =html

(3)php_functions : a list of phpfunctions and their short descriptions
    used by tooltips editing.

(4)devhelp : includes a list of functions in it..



Ideally all this should be merged into a simpler system:

Master Language file - lists Languages and their relative manual pages:

eg. 
'C' language - would reference the Glib/GTK libraries.. devhelp files etc.
'PHP' language - would reference 'PHP', 'PHP-GTK', apd, imagic, PEAR? devhelp files 


DEVHELP
Then the individual devhelp would have to be modified to include:
    'function/method summaries = eg. the 'php_functions' stuff..

Devhelp files need breaking up - php & phpgtk are far to big!!!

either this or a better loading method is needed :
    at present, we parse the whole file and build a array of objects, linked together with ids.
    

other options include:
    parse the data into a gdbm database?
    
-----------------------------
Where is this data used:

Language::get_keywords($language) // used by the parse to highlight words
Language::get_short_desc($language,$kw) // used to show short description
Language::get_url($language,$kw) // used to show help page on a keyword.

/* help tree */
Language::get_books() // list of top level books
Language::get_sub_chapters($book, [$id] ) // list of chapters in book or sub chapters (id)
Language::get_book_language() // what programming language does the book relate to?


Overview info.
books_base:
filename:name \t baseurl

seperate dbm files for each book
 


HTML_phpgtk_keywords_shortdesc
keyword:desc

HTML_phpgtk_keywords_link
keyword:link

HTML_phpgtk_book_tree
id:(ids of children)

HTML_phpgtk_book_pages
id:name \t link

 


Hence from this: process would be?

build database = parse all data and 





Changes required!!!!



