diff options
author | Ander Conselvan de Oliveira <ander.conselvan.de.oliveira@intel.com> | 2012-04-30 13:27:52 +0300 |
---|---|---|
committer | Kristian Høgsberg <krh@bitplanet.net> | 2012-04-30 13:09:39 -0400 |
commit | 55aab92495692f453c04f5b99e67bcb77cd27e14 (patch) | |
tree | 9254a75cf8817e1f0b03365a36f18892fa22b34e /src | |
parent | 310d8d189d14eb6c29be205bf2c9e98187b2fa84 (diff) |
gbm: update documentation to reflect current behavior
Diffstat (limited to 'src')
-rw-r--r-- | src/gbm/main/gbm.c | 18 |
1 files changed, 10 insertions, 8 deletions
diff --git a/src/gbm/main/gbm.c b/src/gbm/main/gbm.c index c8e7ee70993..0b5b9ff0b70 100644 --- a/src/gbm/main/gbm.c +++ b/src/gbm/main/gbm.c @@ -389,10 +389,11 @@ gbm_surface_destroy(struct gbm_surface *surf) * * \param surf The surface * - * \return A newly allocated buffer object that should be released - * with gbm_surface_release_buffer() when no longer needed. This bo - * should not be destroyed using gbm_bo_destroy(). If an error occurs - * this function returns %NULL. + * \return A buffer object that should be released with + * gbm_surface_release_buffer() when no longer needed. The implementation + * is free to reuse buffers released with gbm_surface_release_buffer() so + * this bo should not be destroyed using gbm_bo_destroy(). If an error + * occurs this function returns %NULL. */ GBM_EXPORT struct gbm_bo * gbm_surface_lock_front_buffer(struct gbm_surface *surf) @@ -403,10 +404,11 @@ gbm_surface_lock_front_buffer(struct gbm_surface *surf) /** * Release a locked buffer obtained with gbm_surface_lock_front_buffer() * - * The bo is destroyed after a call to this function and returns the - * underlying buffer to the gbm surface. Releasing a bo will - * typically make gbm_surface_has_free_buffer() return 1 and thus - * allow rendering the next frame, but not always. + * Returns the underlying buffer to the gbm surface. Releasing a bo + * will typically make gbm_surface_has_free_buffer() return 1 and thus + * allow rendering the next frame, but not always. The implementation + * may choose to destroy the bo immediately or reuse it, in which case + * the user data associated with it is unchanged. * * \param surf The surface * \param bo The buffer object |