This file is indexed.

/usr/share/doc/libui-gxmlcpp-dev/README is in libui-gxmlcpp-dev 1.4.3-2build1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
This is the UI C++ wrapper for libxml.

Abstract
========

"ui-gxmlcpp" is a high-level C++ wrapper around libxml2 and
libxslt. It might be a choice for if your needs are some subset
of:

 - XML DOM Tree parsing.
 - Basic read/write support from/to trees via XPath.
 - Serialization.
 - Stylesheets and stylesheet translation support.
 - XMLSchema and RelaxNG validation.

If your needs are "lower-level" (e.g., proper DOM tree API
support or SAX parsing), "gdome2" or "xml++" will be the right
choices.

Upgrading from 1.0
==================

Update to compatibility code
----------------------------

This should be the first step if you upgrade your code. Source code
upgrading should be rather trivial, and everything is expected to work
as before.

Preliminaries
.............
You might want to use s.th. like

AC_DEFINE(UI_GXMLCPP_IGNORE_DEPRECATED, [], [Remove this and update your code, moron!])

to get rid of the include warnings -- but, rather just update your
code to the new interface. You will have to link against both,
ui-gxmlcpp and ui-gxmlcpp-compat-1.0.

Exceptions
..........

There is no XMLException.hpp include any more. Just remove those
lines.

All catch() blocks must be updated. If you did catch a specific
exception, replace it with s.th like

catch (UI::GXML::CLASS::Exception const & e)
{
	std::cerr << e.what() << std::endl; // or whatever
}

You can also just use a generic catch:

catch (UI::GXML::Exception const & e)
{
	std::cerr << e.what() << std::endl; // or whatever
}


Update to the new interface
---------------------------

The new interface is rather a rewrite. Try to get smart thru the
doxygen docs ;).

However, some often used things can be updated 1 to 1:

Replacing XMLTree with Tree
...........................
OLD                            NEW
getValue()                     getContent().
getXML(xpath)                  dump(xpath).
getSiblingXML(xpath)           dump(xpath + "/*").
addTag(...)                    addChild(...)