improve docs

core/src/stored/stored_conf.cc

@@ -172,8 +172,8 @@ static ResourceItem dev_items[] = {
   {"RequiresMount", CFG_TYPE_BIT, ITEM(res_dev, cap_bits), CAP_REQMOUNT, CFG_ITEM_DEFAULT, "off", NULL, NULL},
   {"OfflineOnUnmount", CFG_TYPE_BIT, ITEM(res_dev, cap_bits), CAP_OFFLINEUNMOUNT, CFG_ITEM_DEFAULT, "off", NULL, NULL},
   {"BlockChecksum", CFG_TYPE_BIT, ITEM(res_dev, cap_bits), CAP_BLOCKCHECKSUM, CFG_ITEM_DEFAULT, "on", NULL, NULL},
-  {"AccessMode", CFG_TYPE_IODIRECTION, ITEM(res_dev, access_mode), 0, CFG_ITEM_DEFAULT, "readwrite", NULL, "Access mode specifies whether"
-  "this device can be used for reading, writing or for both modes."},
+  {"AccessMode", CFG_TYPE_IODIRECTION, ITEM(res_dev, access_mode), 0, CFG_ITEM_DEFAULT, "readwrite", NULL, "Access mode specifies whether "
+  "this device can be reserved for reading, writing or for both modes (default)."},
   {"AutoSelect", CFG_TYPE_BOOL, ITEM(res_dev, autoselect), 0, CFG_ITEM_DEFAULT, "true", NULL, NULL},
   {"ChangerDevice", CFG_TYPE_STRNAME, ITEM(res_dev, changer_name), 0, 0, NULL, NULL, NULL},
   {"ChangerCommand", CFG_TYPE_STRNAME, ITEM(res_dev, changer_command), 0, 0, NULL, NULL, NULL},

docs/manuals/source/manually_added_config_directive_descriptions/sd-device-AccessMode.rst.inc

@@ -1,7 +1,7 @@
-This parameter specifies for which access modes (i.e. reading or writing) this device can be reserved.
+The following values are valid:
 
--  readonly - this device can only be used for reading.
+-  readonly - this device can be reserved only for reading.
 
--  writeonly - this device can only be used for writing.
+-  writeonly - this device can be reserved only for writing.
 
--  readwrite - this device can be used for both reading and writing.
+-  readwrite - this device can be reserved for both reading and writing.