This is the mail archive of the libc-alpha@sourceware.org mailing list for the glibc project.
Index Nav: | [Date Index] [Subject Index] [Author Index] [Thread Index] | |
---|---|---|
Message Nav: | [Date Prev] [Date Next] | [Thread Prev] [Thread Next] |
Other format: | [Raw text] |
In general, the probe names are prefixed by the function they're contained within. This seemed reasonable to me. The alternate would be to prefix them all with "malloc" or something similar to denote the subsystem they're contained within. I've got no strong opinions, so if you'd prefer subsystem prefixing, I'd go along with that happily.Of the primary maintainers, Carlos has done the malloc-related reviews lately. So I'd like him to sign off on the choices of probe locations, names, and parameters. Jeff's review seems to give some helpful rationale for some of the choices, though I didn't see him mention the parameters.
Then let's go with this, probes in their own chapter or appendix. If we logically group them, that would tend to argue that the prefix would follow from the group rather than the function where the probe lives.I'm certainly all for higher-quality documentation for probes, and I agree that those two .txt files are not stellar. However, I really do not like the idea of dead conditional sections in the manual sources. If you want to use Texinfo for this documentation (which of course is a perfectly fine choice) then I think it should be in separate files.
Index Nav: | [Date Index] [Subject Index] [Author Index] [Thread Index] | |
---|---|---|
Message Nav: | [Date Prev] [Date Next] | [Thread Prev] [Thread Next] |