According to Nathan's comments for the Slapi_Counter edits in bug 458190, the new write-up for Slapi_Counter includes the private definition. The public header (slapi-plugin.h) doesn't have any of this detail in it. For example: #include "slapi-plugin.h" typedef struct Slapi_Counter { PRUint64 value; #ifndef ATOMIC_64BIT_OPERATIONS Slapi_Mutex *mutex; #endif } Slapi_Counter; We should add something similar to the Syntax sections for other opaque structures, such as the Slapi_PBlock.
Changing the status from "new" to "assigned."
Setting to block the DS9 docs tracking bug.
Reassigning to Tomas.
It is not worth showing all the fields in the slapi structures. Plus, there are some reasons we'd better not to do so. 1) The fields are not meant to access directly. Only the API info to access them should be provided. 2) The fields could be updated frequently by debugging or implementing new features. Having a snapshot of the structure syntax should be rather harmful. Hence, closing this bug with WONTFIX. (Acked by Nathan. Thanks!!)
Another part of this, is that in the future, I'm going to hide and mask these. You should never access struct internals, only the functions related to them.