Re: Suggestion for improvement..

Robert Knutsson <[email protected]> Wed, 11 Feb 2026 17:47:18 +0100
Newsgroups gmane.comp.freedesktop.xcb
Message-ID <CABCcBL-J6ZA0JfpgS-48m0JhUW66cP1By1dHQSSHVdE0k89dpw@mail.gmail.com>
--000000000000adf0d2064a8f2080
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

I can=E2=80=99t speak for why the request in question is t documented, but =
in
general as the documentation part of the XML protocol descriptors was a
later addition (roughly 10 years after the initial implementation if memory
serves), it=E2=80=99s a matter of someone just doing the work and migrating=
 any
existing documentation or writing new.

Glad you found what you where looking for.

If you feel important documentation is missing do create a merge request,
that=E2=80=99s the only way it will ever be improved

Regards,
Robert


ons 11 feb. 2026 kl. 17:33 skrev Michael Jensen <[email protected]
>:

> ya, google's ai has now provided an answer that at least seems plausible.
> I suppose that's why you don't get more complaints, nobody uses the manua=
l
> anymore?
>
> On Tue, Feb 10, 2026 at 1:17=E2=80=AFPM Michael Jensen <mikethe1wheelnut@=
gmail.com>
> wrote:
>
>> Greetings..
>>
>> The Arch website tells me to contact you if I have any suggestions for
>> improvement.
>> Such suggestions are not hard to come by when there are large numbers of
>> things listed as: "TODO: NOT YET DOCUMENTED"
>>
>> The one I am particularly interested in is "exposures", from this page:
>> https://man.archlinux.org/man/xcb_clear_area.3.en
>>
>> I assume that this is not documented because people assume that it is
>> obvious.  Or people are using ai to scour the web for the info.  I guess
>> I'll try that next, seeing as an ordinary search doesn't seem to be
>> working.  I can find the "official documentation" just fine..
>>
>> -Michael..
>>
>

--000000000000adf0d2064a8f2080
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"auto">I can=E2=80=99t speak for why the request in question is =
t documented, but in general as the documentation part of the XML protocol =
descriptors was a later addition (roughly 10 years after the initial implem=
entation if memory serves), it=E2=80=99s a matter of someone just doing the=
 work and migrating any existing documentation or writing new.</div><div di=
r=3D"auto"><br></div><div dir=3D"auto">Glad you found what you where lookin=
g for.</div><div dir=3D"auto"><br></div><div dir=3D"auto">If you feel impor=
tant documentation is missing do create a merge request, that=E2=80=99s the=
 only way it will ever be improved=C2=A0=C2=A0</div><div dir=3D"auto"><br><=
/div><div dir=3D"auto">Regards,</div><div dir=3D"auto">Robert</div><div dir=
=3D"auto"><br></div><div><br><div class=3D"gmail_quote gmail_quote_containe=
r"><div dir=3D"ltr" class=3D"gmail_attr">ons 11 feb. 2026 kl. 17:33 skrev M=
ichael Jensen &lt;<a href=3D"mailto:[email protected]">mikethe1whe=
[email protected]</a>&gt;:<br></div><blockquote class=3D"gmail_quote" style=
=3D"margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;=
padding-left:1ex;border-left-color:rgb(204,204,204)"><div dir=3D"ltr">ya, g=
oogle&#39;s ai has now provided an answer that at least seems plausible.=C2=
=A0 I suppose that&#39;s why you don&#39;t get more complaints, nobody uses=
 the manual anymore?</div><br><div class=3D"gmail_quote"><div dir=3D"ltr" c=
lass=3D"gmail_attr">On Tue, Feb 10, 2026 at 1:17=E2=80=AFPM Michael Jensen =
&lt;<a href=3D"mailto:[email protected]" target=3D"_blank">mikethe=
[email protected]</a>&gt; wrote:<br></div><blockquote class=3D"gmail_quot=
e" style=3D"margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-styl=
e:solid;padding-left:1ex;border-left-color:rgb(204,204,204)"><div dir=3D"lt=
r"><div>Greetings..</div><div><br></div><div>The Arch website tells me to c=
ontact you if I have any suggestions for improvement.</div><div>Such sugges=
tions are not hard to come by when there are large numbers of things listed=
 as: &quot;TODO: NOT YET DOCUMENTED&quot;</div><div><br></div><div>The one =
I am particularly interested in is &quot;exposures&quot;, from this page: <=
a href=3D"https://man.archlinux.org/man/xcb_clear_area.3.en" target=3D"_bla=
nk">https://man.archlinux.org/man/xcb_clear_area.3.en</a></div><div><br></d=
iv><div>I assume that this is not documented because people assume that it =
is obvious.=C2=A0 Or people are using ai to scour the web for the info.=C2=
=A0 I guess I&#39;ll try that next, seeing as an ordinary search doesn&#39;=
t seem to be working.=C2=A0 I can find the &quot;official documentation&quo=
t; just fine..</div><div><br></div><div>-Michael..</div></div>
</blockquote></div>
</blockquote></div></div>

--000000000000adf0d2064a8f2080--