Dnia poniedziałek, 17 stycznia 2011 o 14:47:04 Patrick Shanahan napisał(a): > * Krzysztof Żelechowski <[email protected]> [01-17-11 07:22]: > > 1. Chapters in libX11.html are not in TOC. That makes it hard to > > identify the chapter of a given section. > > 2. libX11.ps has no index. It should be on page 485 which does not exist. > > 3. XGContextFromGC is not described in its manual page. > > 4. libX11.html is one big document, which makes the scroll bar unreliable > > in TOC > > 5. Tables in libX11.html are replaced by missing images (e.g. /Window > > attribute value mask bits/ ) > > > > Please fix, > > You do realize you are dealing with *open-source* where no one is > responsible, but *everyone* is responsible.
This is not exactly true because open source projects have managers with write access. > You may get lucky and > another *interested* individual will take on the task, but you are just a > likely to effect a solution by attempting the solution yourself and > submitting it for use/approval. In short, I do. However, a community-submitted solution requires significantly more work (in terms of process and learning things) compared to the amount of work required of the project manager. > > Normally document writing is the lowest rung on the ladder and the > biggest failing in open-source. Coders speak a different language and as > a group are poor documenters as they write what they understand and not > what you understand. The items you note may not seem important to the > author or may be something he/she believes would be understood. > Of course. That is why they need to be bothered about such things by the users. (Observe that you can steer out of this dead end by publishing the material on a wiki.) BTW, the documentation available for X11 is generally quite decent. Cheers, Chris -- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
