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 <<a href=3D"mailto:[email protected]">mikethe1whe= [email protected]</a>>:<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's ai has now provided an answer that at least seems plausible.=C2= =A0 I suppose that's why you don'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 = <<a href=3D"mailto:[email protected]" target=3D"_blank">mikethe= [email protected]</a>> 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: "TODO: NOT YET DOCUMENTED"</div><div><br></div><div>The one = I am particularly interested in is "exposures", 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'll try that next, seeing as an ordinary search doesn'= t seem to be working.=C2=A0 I can find the "official documentation&quo= t; just fine..</div><div><br></div><div>-Michael..</div></div> </blockquote></div> </blockquote></div></div> --000000000000adf0d2064a8f2080--