[PATCH v2 1/3] python: improve get/set_lvb documentation

[Benny Zlotnik]

- Specify lvb=True explicitly instead of mentioning the sanlock flag
- Document when data is written and visible

Signed-off-by: Benny Zlotnik <bzlotnik(a)redhat.com&gt;
---
 Changes in v2:
  Remove newline and missing newline

 python/sanlock.c | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/python/sanlock.c b/python/sanlock.c
index fbcabb1..8a45bff 100644
--- a/python/sanlock.c
+++ b/python/sanlock.c
@@ -1607,7 +1607,9 @@ Arguments\n\
 \n\
 Notes\n\
 \n\
-The resource must be acquired with the SANLK_ACQUIRE_LVB flag\n");
+The resource must be acquired with lvb=true.\n\
+The size of data is limited by the sector size (512/4K).\n\
+The new data is visible after the resource is released\n");
 static PyObject *
 py_set_lvb(PyObject *self __unused, PyObject *args, PyObject *keywds)
 {
@@ -1660,9 +1662,9 @@ Arguments\n\
 \n\
 Returns\n\
   data              data written with set_lvb\n\
-Notes\n\
 \n\
-The resource must be acquired with the SANLK_ACQUIRE_LVB flag\n");
+Notes\n\
+The resource must be acquired with lvb=True\n");
 static PyObject *
 py_get_lvb(PyObject *self __unused, PyObject *args, PyObject *keywds)
 {
-- 
2.28.0