From b047f4882aaa5aa1045e9d150b09203d519acae2 Mon Sep 17 00:00:00 2001
From: Aleksander Czajczynski <hb@fki.pl>
Date: Fri, 31 May 2024 11:55:04 +0200
Subject: [PATCH] 2024-05-31 11:55 UTC+0200 Aleksander Czajczynski (hb fki.pl) 
  * doc/en/rdddb.txt     ! update DBAPPEND( [<lUnlockAll>=.t.] ) documentation
 regarding       the default value and action of the parameter

---
 ChangeLog.txt    |  5 +++++
 doc/en/rdddb.txt | 18 +++++++++---------
 2 files changed, 14 insertions(+), 9 deletions(-)

diff --git a/ChangeLog.txt b/ChangeLog.txt
index 49a41e9eca..b2c61aa44a 100644
--- a/ChangeLog.txt
+++ b/ChangeLog.txt
@@ -7,6 +7,11 @@
    Entries may not always be in chronological/commit order.
    See license at the end of file. */
 
+2024-05-31 11:55 UTC+0200 Aleksander Czajczynski (hb fki.pl)
+  * doc/en/rdddb.txt
+    ! update DBAPPEND( [<lUnlockAll>=.t.] ) documentation regarding
+      the default value and action of the parameter
+
 2024-05-31 11:49 UTC+0200 Aleksander Czajczynski (hb fki.pl)
   * contrib/rddmisc/arrayrdd.prg
     ! group of fixes contributed in #355 by @VarenL:
diff --git a/doc/en/rdddb.txt b/doc/en/rdddb.txt
index bf2adbe8b1..edba6d908d 100644
--- a/doc/en/rdddb.txt
+++ b/doc/en/rdddb.txt
@@ -103,11 +103,11 @@
    $ONELINER$
       Appends a new record to a database file.
    $SYNTAX$
-      dbAppend( [<lLock>] ) --> NIL
+      dbAppend( [<lUnlockAll>] ) --> lSuccess
    $ARGUMENTS$
-      <lLock> Toggle to release record locks
+      <lUnlockAll> Toggle to release record locks
    $RETURNS$
-      dbAppend() always returns NIL
+      dbAppend() returns a logical true (.T.) if append was successful
    $DESCRIPTION$
       This function add a new record to the end of the database
       in the selected or aliased work area. All fields in that
@@ -122,13 +122,13 @@
       operation: It attempts to lock the newly added record. If
       the database file is currently locked or if a locking assignment
       is made to `LastRec() + 1`, NetErr() will return a logical true (.T.)
-      immediately after the dbAppend() function. This function does
-      not unlock the locked records.
+      immediately after the dbAppend() function. Also by default this
+      function does unlock previously locked records.
 
-      If <lLock> is passed a logical true (.T.) value, it will
-      release the record locks, which allows the application to maintain
-      multiple record locks during an appending operation. The
-      default for this parameter is a logical false (.F.).
+      If <lUnlockAll> is passed a logical true (.T.) value, it will
+      release the record locks. The default for this parameter is
+      a logical true (.T.). To maintain multiple record locks during
+      an appending operation explicitly specify logical false (.F.).
    $EXAMPLES$
       LOCAL cName := "Harbour", nAge := 15
       USE test