Si il n'est pas documenté, alors il n'est pas encore considéré comme stable, et ne dois donc pas être utilisé "normalement".
Bref, si on te suis, alors le libre n'a *jamais* de problemes de documentation. Si la doc n'est pas la, c'est que l'API / module /... n'est pas stable et qu'il faut pas l'utiliser... C'est un peu facile comme raisonnement mon cher.
La realite c'est que si cette interface est sujette a changements, la doc est sensee etre la pour le dire justement. Si cette interface ne doit vraiment pas etre utilisee, alors elle ne doit tout simplement pas apparaitre dans la doc(ou l'etre avec un gros signe "touche pas"). Tout le monde fait comme ca.
[^] # Re: HS
Posté par pasBill pasGates . En réponse au journal Microsoft Windows dans les ordinateurs : un autre argument que la vent liée ?. Évalué à 0.
Bref, si on te suis, alors le libre n'a *jamais* de problemes de documentation. Si la doc n'est pas la, c'est que l'API / module /... n'est pas stable et qu'il faut pas l'utiliser... C'est un peu facile comme raisonnement mon cher.
La realite c'est que si cette interface est sujette a changements, la doc est sensee etre la pour le dire justement. Si cette interface ne doit vraiment pas etre utilisee, alors elle ne doit tout simplement pas apparaitre dans la doc(ou l'etre avec un gros signe "touche pas"). Tout le monde fait comme ca.
Exemple classique : http://api.kde.org/3.5-api/kdelibs-apidocs/kdecore/html/clas(...)
KEntry KConfigGroup::lookupData ( const KEntryKey & _key ) const [virtual]
Looks up an entry in the config object's internal structure.
Classes that derive from KConfigBase will need to implement this method in a storage-specific manner.
Do not use this function, the implementation and return type are subject to change.