'Re: Documentation's modification'

[prev in list] [next in list] [prev in thread] [next in thread] 

List:       koffice-devel
Subject:    Re: Documentation's modification
From:       Cyrille Berger <cberger () cberger ! net>
Date:       2009-01-26 14:42:59
Message-ID: 200901261542.59768.cberger () cberger ! net
[Download RAW message or body]

[Attachment #2 (multipart/alternative)]

On Sunday 25 January 2009, Lugagne Jérémy wrote:
> Hi,
>
> I'm working on koffice and i must use KoXml but some information wasn't
> easy to find.

Not sure if you are aware, but KoXml mimicks Qt's XML API. So if you need to 
know how to use KoXml, I would suggest to read Qt's API documentation.

> So I propose you one modification in the KoXmlDocument's
> documentation. Add a sentence like :
> "To find all child elements whitout text nodes, use
> KoXml::forEachElement( KoXmlElement e, KoXmlNode parent )."

If you keep in mind what I just said, the following:
 * To find all child elements with a given name, use
 * QDomElement e;
 * forEachElement( e, parent )

is quiet clear that you are going to iterate over {Q|Ko}DomElement, which 
exclude text node.

-- 
Cyrille Berger

[Attachment #5 (text/html)]

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" \
"http://www.w3.org/TR/REC-html40/strict.dtd"><html><head><meta name="qrichtext" \
content="1" /><style type="text/css">p, li { white-space: pre-wrap; \
}</style></head><body style=" font-family:'DejaVu Sans'; font-size:9pt; \
font-weight:400; font-style:normal;">On Sunday 25 January 2009, Lugagne Jérémy \
wrote:<br> &gt; Hi,<br>
&gt;<br>
&gt; I'm working on koffice and i must use KoXml but some information wasn't<br>
&gt; easy to find.<br>
<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; \
margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; \
-qt-user-state:0;"><br></p>Not sure if you are aware, but KoXml mimicks Qt's XML API. \
So if you need to know how to use KoXml, I would suggest to read Qt's API \
documentation.<br> <p style="-qt-paragraph-type:empty; margin-top:0px; \
margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; \
text-indent:0px; -qt-user-state:0;"><br></p>&gt; So I propose you one modification in \
the KoXmlDocument's<br> &gt; documentation. Add a sentence like :<br>
&gt; "To find all child elements whitout text nodes, use<br>
&gt; KoXml::forEachElement( KoXmlElement e, KoXmlNode parent )."<br>
<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; \
margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; \
                -qt-user-state:0;"><br></p>If you keep in mind what I just said, the \
                following:<br>
 * To find all child elements with a given name, use<br>
 * QDomElement e;<br>
 * forEachElement( e, parent )<br>
<p style="-qt-paragraph-type:empty; margin-top:0px; margin-bottom:0px; \
margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px; \
-qt-user-state:0;"><br></p>is quiet clear that you are going to iterate over \
{Q|Ko}DomElement, which exclude text node.<br> <p style="-qt-paragraph-type:empty; \
margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; \
-qt-block-indent:0; text-indent:0px; -qt-user-state:0;"><br></p>-- <br> Cyrille \
Berger</p></body></html>

_______________________________________________
koffice-devel mailing list
koffice-devel@kde.org
https://mail.kde.org/mailman/listinfo/koffice-devel

[prev in list] [next in list] [prev in thread] [next in thread] 