changeset 89:629be330f92b

doc/User-oriented-commands: pb-restore documented
author Mychaela Falconia <falcon@freecalypso.org>
date Wed, 17 Feb 2021 17:39:26 +0000
parents ae831b21ef77
children 8a714fe98aa9
files doc/User-oriented-commands
diffstat 1 files changed, 11 insertions(+), 5 deletions(-) [+]
line wrap: on
line diff
--- a/doc/User-oriented-commands	Wed Feb 17 07:16:31 2021 +0000
+++ b/doc/User-oriented-commands	Wed Feb 17 17:39:26 2021 +0000
@@ -234,15 +234,21 @@
 This command dumps the specified range of records from a potentially large
 phonebook.
 
+pb-restore PBNAME filename
+
+This command reads a phonebook data file in the format described in the
+SIM-data-formats document and uploads it into the named SIM phonebook.  Every
+record in the SIM phonebook is overwritten with an UPDATE RECORD command; those
+record indices which do not appear in the data file being restored get blank
+records (0xFF in every byte) written into them.
+
 pb-update PBNAME filename
 
 This command reads a phonebook data file in the format described in the
 SIM-data-formats document and uploads it into the named SIM phonebook, writing
-each record from the data file into the SIM with an UPDATE RECORD command.
-
-Please note that this command does NOT include a built-in erase of those SIM
-phonebook record positions which are not covered by the data file being uploaded
-- any non-blank records in those positions will retain their previous content.
+only those record indices which appear in the data file - each record from the
+data file gets written into the SIM with an UPDATE RECORD command, while all
+other record locations remain untouched.
 
 pb-update-imm PBNAME rec phone-number [alpha-tag]