[Bug 244951] Review Request: apr-api-docs - Apache Portable Runtime API documentation

[bugzilla at redhat.com]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug report.

Summary: Review Request: apr-api-docs - Apache Portable Runtime API documentation


https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=244951





------- Additional Comments From bojan at rexursive.com  2007-06-25 22:39 EST -------
This stuff:

http://apr.apache.org/docs/apr/1.2/group__apr__platform.html

Essentially, it explains what a particular macro/typedef is going to be on a
particular platform.

As you can see in the above URL, the values are i686 specific, because they've
been generated on my notebook. If someone else generated those, they would look
different. Confusing, just like the results we get with a random Fedora builder
- that's why my initial package was arch specific.

However, I do get Joe's point - although those things are there in the docs, it
is not something APR API users should use or rely on anyway, as this would
defeat the purpose of APR.

If you have a good idea as to how to munge those, let me know. We can also just
insert a comment up the top saying that API users should not rely on
implementation details, as they may vary from platform to platform.

-- 
Configure bugmail: https://bugzilla.redhat.com/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are on the CC list for the bug, or are watching someone who is.