Re: Suggestion for improvement..
Michael Jensen <[email protected]> Thu, 12 Feb 2026 08:34:35 -0500
| Newsgroups | gmane.comp.freedesktop.xcb |
|---|---|
| Message-ID | <CAEbY5PE11uxpimt-p=KtBUs3gpebbnkQji0QxfHWrRXpBMHkmQ@mail.gmail.com> |
--0000000000005e292f064aa08dc5 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable This is very interesting. For the record, could you clarify what you are referring to when you say: "the Protocol doc". I can, of course, google this, and have, but throwing darts at search results links, and hoping that I hit the one you have in mind, is not a good way to hit the bulls-eye. On Thu, Feb 12, 2026 at 2:17=E2=80=AFAM Bart Massey <[email protected]> wrote= : > The other things to keep in mind is that the XCB API is an extremely thin > layer on top of the X Protocol. Generally the Protocol doc will tell you > everything you need to know to use an XCB request. > > On Wed, Feb 11, 2026, 08:47 Robert Knutsson <[email protected]> wrote: > >> I can=E2=80=99t speak for why the request in question is t documented, b= ut in >> general as the documentation part of the XML protocol descriptors was a >> later addition (roughly 10 years after the initial implementation if mem= ory >> serves), it=E2=80=99s a matter of someone just doing the work and migrat= ing 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 manual anymore? >>> >>> On Tue, Feb 10, 2026 at 1:17=E2=80=AFPM Michael Jensen < >>> [email protected]> 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 gue= ss >>>> 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.. >>>> >>> --0000000000005e292f064aa08dc5 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable <div dir=3D"ltr">This is very interesting.=C2=A0 For the record, could you = clarify what you are referring to when you say: "the Protocol doc"= ;.=C2=A0 I can, of course, google this, and have, but throwing darts at sea= rch results links, and hoping that I hit the one you have in mind, is not a= good way to hit the bulls-eye.</div><br><div class=3D"gmail_quote gmail_qu= ote_container"><div dir=3D"ltr" class=3D"gmail_attr">On Thu, Feb 12, 2026 a= t 2:17=E2=80=AFAM Bart Massey <<a href=3D"mailto:[email protected]">bart@c= s.pdx.edu</a>> wrote:<br></div><blockquote class=3D"gmail_quote" style= =3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding= -left:1ex"><div dir=3D"auto">The other things to keep in mind is that the X= CB API is an extremely thin layer on top of the X Protocol. Generally the P= rotocol doc will tell you everything you need to know to use an XCB request= .</div><br><div class=3D"gmail_quote"><div dir=3D"ltr" class=3D"gmail_attr"= >On Wed, Feb 11, 2026, 08:47 Robert Knutsson <<a href=3D"mailto:zybreak@= gmail.com" target=3D"_blank">[email protected]</a>> wrote:<br></div><blo= ckquote class=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;border-left= :1px solid rgb(204,204,204);padding-left:1ex"><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 addit= ion (roughly 10 years after the initial implementation if memory serves), i= t=E2=80=99s a matter of someone just doing the work and migrating any exist= ing documentation or writing new.</div><div dir=3D"auto"><br></div><div dir= =3D"auto">Glad you found what you where looking for.</div><div dir=3D"auto"= ><br></div><div dir=3D"auto">If you feel important documentation is missing= do create a merge request, that=E2=80=99s the only way it will ever be imp= roved=C2=A0=C2=A0</div><div dir=3D"auto"><br></div><div dir=3D"auto">Regard= s,</div><div dir=3D"auto">Robert</div><div dir=3D"auto"><br></div><div><br>= <div class=3D"gmail_quote"><div dir=3D"ltr" class=3D"gmail_attr">ons 11 feb= . 2026 kl. 17:33 skrev Michael Jensen <<a href=3D"mailto:mikethe1wheelnu= [email protected]" rel=3D"noreferrer" target=3D"_blank">[email protected]= m</a>>:<br></div><blockquote class=3D"gmail_quote" style=3D"margin:0px 0= px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div = dir=3D"ltr">ya, google's ai has now provided an answer that at least se= ems plausible.=C2=A0 I suppose that's why you don't get more compla= ints, nobody uses the manual anymore?</div><br><div class=3D"gmail_quote"><= div dir=3D"ltr" class=3D"gmail_attr">On Tue, Feb 10, 2026 at 1:17=E2=80=AFP= M Michael Jensen <<a href=3D"mailto:[email protected]" rel=3D"n= oreferrer" target=3D"_blank">[email protected]</a>> wrote:<br><= /div><blockquote class=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;bo= rder-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir=3D"ltr"><di= v>Greetings..</div><div><br></div><div>The Arch website tells me to contact= you if I have any suggestions for improvement.</div><div>Such suggestions = are not hard to come by when there are large numbers of things listed as: &= quot;TODO: NOT YET DOCUMENTED"</div><div><br></div><div>The one I am p= articularly interested in is "exposures", from this page: <a href= =3D"https://man.archlinux.org/man/xcb_clear_area.3.en" rel=3D"noreferrer" t= arget=3D"_blank">https://man.archlinux.org/man/xcb_clear_area.3.en</a></div= ><div><br></div><div>I assume that this is not documented because people as= sume that it is obvious.=C2=A0 Or people are using ai to scour the web for = the info.=C2=A0 I guess I'll try that next, seeing as an ordinary searc= h doesn't seem to be working.=C2=A0 I can find the "official docum= entation" just fine..</div><div><br></div><div>-Michael..</div></div> </blockquote></div> </blockquote></div></div> </blockquote></div> </blockquote></div> --0000000000005e292f064aa08dc5--