PR# 19918 Folder name typo

Problem Report Summary
Submitter: karsten_heusser
Category: EiffelParse
Priority: Low
Date: 2024/04/27
Class: Installation
Severity: Non-critical
Number: 19918
Release: 23.09
Confidential: No
Status: Closed
Responsible:
Environment: win
Synopsis: Folder name typo

Description
In the ES distribution, there is a folder name called 'library\text\parser\xml\parser\contants'.
This should probably be 'library\text\parser\xml\parser\con[s]tants'.

BTW, is this the currently recommended library to read and process XML files?
Or is it parser\xml\tree? Or do I need both? Is there any documentation
on how to produce an object structure from an XML file and vice versa?

Thanks for your advice. Best,
Karsten
To Reproduce

										
Problem Report Interactions
From:karsten_heusser    Date:2024/04/29    Status: Closed    Download   
Thank you, Jocelyn, for your comments.

Although helpful, example code is not a sufficient replacement
for library documentation. It takes too much time and effort
to infer the 'why' from the 'how'.

Best regards,
Karsten

From:jfiat_es    Date:2024/04/29    Status: Closed    Download   
Thanks, the typo is now fixed.

There are mainly two known libraries to parse and manipulate XML content with Eiffel.
Eiffel XML, and Gobo XML, the implementation are different but it is easy to go from one to the other (mostly using XML_  vs XM_ prefix).
I would recommend Eiffel XML for simplicity.

When parsing XML content, either you want to discover as it goes  (using callbacks), or parse all and work on the object tree directly (XML_DOCUMENT, XML_ELEMENT, ... and so on).

I was not able to find proper documentation, however you can look at  library\text\parser\xml\tests\test_xml.e used for testing, and it has a few common usages, including the "test_xml_parser" .
Also see XML_CALLBACKS_DOCUMENT