[Chameleon] possible errors in the description of tags, other ambiguities

[Maciej Sieczka]

Folks,

I really need help with this. Since there are many people successfully
using Chameleon, why can't my basic (but valid and casuing real
troubles to me) questions be answered by anyone? Please read below.
Thanks in advance.

Maciej Sieczka wrote:
> Maciej Sieczka wrote:
> 
>> I noticed possible errors in the description of tags in chameleon.xml
>> and cwc2.xml. See:
>>
>> cwc2.xml, service_instance_path:
>>
>> It's description reads: "This is the URL to chameleon.php". Isn't this
>> a copy/paste typo from chameleon.xml web_server_path tag by any chance?
>> What should it be pointing at? An absolute filesystem path or an URL
>> according to my Apache settings?
> 
> As there's been no reply, does that mean that everybody agrees that
> both service_instance_path/cwc2.xml and web_server_path/chameleon.xml
> should be pointing at the same "URL to chameleon.php"? If so, why does
> the Chameleon instalation that comes with FGS has only it's
> web_server_path/chameleon.xml set to "/chameleon/", while it's
> service_instance_path/cwc2.xml points at the "/cwc2/"?
> 
>> chameleon.xml, wms_parse_file:
>>
>> "Leave empty to use the Chameleon C module if available (faster and
>> brand new) or the built in PHP parser (slower and obsolete)."
>>
>> This doens't make sense to me. It says, AIUI, that if I leave it empty,
>> either the C module, if available, or the PHP parser will be used. So
>> why do I need to put anything here? Do I? The exact question is: if my
>> full path to wmsparse is
>> "/home/etc/chameleon/htdocs/common/wmsparse/wmsparse", shall I put it
>> here like this or not?
> 
> Am I the only one who finds this description unclear?
> 
>> Also, the descriptions of the following tags in the cwc2.xml do not
>> make it clear if these are supposed to be absolute filesystem paths or
>> URLs according to my web server settings:
>>
>> server_data_path
>> default_context
>> default_template
>> context_root
>> template_root
>> fontlist_file
>> symbol_file
> 
> It would really be much help for beginners if tag's descriptions made
> it clear if the paths are supposed to be URIs, URLs or
> relative/absolute filesystem paths.
> 
>> Also, the Instalation Guide on [1] is not up-to-date with current
>> Chameleon directory structure. And I'm not sure if I adapt it to the
>> current one properly.
>>
>> [1]http://chameleon.maptools.org/help/viewer.phtml
> 
> Since 2.6 is comming, are there any plans to update the documentation?
> 
> Thanks for any help and answers.

Maciek