changeset 969:8cf7d41f2821

doc/User-phone-tools: document -e addition to fcup-smsend[mult]
author Mychaela Falconia <falcon@freecalypso.org>
date Fri, 01 Sep 2023 18:37:54 +0000
parents ec736c59845c
children 3efb8d20794e
files doc/User-phone-tools
diffstat 1 files changed, 14 insertions(+), 7 deletions(-) [+]
line wrap: on
line diff
--- a/doc/User-phone-tools	Fri Sep 01 17:32:54 2023 +0000
+++ b/doc/User-phone-tools	Fri Sep 01 18:37:54 2023 +0000
@@ -312,14 +312,20 @@
 		concatenated SMS reference number to be used.  The number can
 		be either decimal or hexadecimal with 0x prefix.
 
+-e		Allow message body input to use the same backslash escape
+		sequences that are emitted by sms-pdu-decode, described earlier
+		in this document.  Without this option, any backslash characters
+		present in the message body input are interpreted literally; to
+		embed a literal backslash with -e, enter it as \\.
+
 -q		Concatenated SMS quiet mode.  If -c is given without -q, the
 		tool prints a message on stdout indicating whether the message
 		was sent as single or concatenated, and in how many parts.
 		-q suppresses this additional output.
 
 -t		Use text mode instead of PDU mode on the AT command interface.
-		This option is incompatible with -c and with -U, and introduces
-		other restrictions listed above.
+		This option is incompatible with -c, with -e and with -U; it
+		also introduces some other restrictions listed above.
 
 -u		By default, if the message body input contains any 8-bit
 		characters, they are interpreted as ISO 8859-1.  With -u they
@@ -327,9 +333,10 @@
 		for GSM7 output encoding, and it is implemented by converting
 		the input first from UTF-8 to 8859-1, and then from 8859-1 to
 		GSM7 - thus all UTF-8 input characters must fall into the
-		8859-1 repertoire, and it is not currently possible to send
-		GSM7-encoded messages containing the few Greek letters or the
-		Euro currency symbol allowed by GSM 03.38 encoding.
+		8859-1 repertoire, and the only way to send GSM7-encoded
+		messages containing the few Greek letters or the Euro currency
+		symbol allowed by GSM 03.38 encoding is to use backslash escapes
+		with -e.
 
 -U		Send message in UCS-2 encoding instead of GSM7.  Any 8-bit
 		characters in the message body input are interpreted as UTF-8,
@@ -363,7 +370,7 @@
 ===============
 
 As an alternative to sending concatenated SMS, one can use the fcup-smsendmult
-utility to send several single (no UDH) messages in one batch.  This utlity
+utility to send several single (no UDH) messages in one batch.  This utility
 supports both text and PDU modes (PDU mode is still the preferred default when
 it can be used), and when PDU mode is used, it supports both GSM7 and UCS-2
 output encodings just like fcup-smsend.  The messages to be sent are read from
@@ -377,7 +384,7 @@
 
 <dest addr><white space><message body>
 
--t, -u, -U, -w and -W command line options are unchanged from fcup-smsend.
+-e, -t, -u, -U, -w and -W command line options are unchanged from fcup-smsend.
 
 This fcup-smsendmult method of sending batched SMS was originally envisioned as
 an alternative to concatenated SMS for crippled hw targets that couldn't support