From 93044d0f4c93f79c7f5e8dc7d14d6a5f0d4d422e Mon Sep 17 00:00:00 2001 From: Luke Bratch Date: Mon, 1 Nov 2010 17:32:42 +0000 Subject: Update documentation --- README | 16 ++++++++++------ blasms.c | 4 ++++ 2 files changed, 14 insertions(+), 6 deletions(-) diff --git a/README b/README index cc61cdf..049bccd 100644 --- a/README +++ b/README @@ -3,9 +3,9 @@ Usage: blasms sender-number send-date SMS content should be passed using stdin. blasms.conf is the configuration file and should be in the format: - default SYSTEM COMMANDS - CMD1 SYSTEM COMMANDS - CMD2 SYSTEM COMMANDS + default SYSTEMCOMMANDS + CMD1 SYSTEMCOMMANDS + CMD2 SYSTEMCOMMANDS etc. Where SYSTEM COMMANDS can be any command to be executed. The line starting @@ -18,8 +18,12 @@ are available, allowing for text replacement. The macros available are: %n - replaced with the sender-number %d - replaced with the send-date %s - replaced with the SMS content - %P - attempts to replace the second word in the SMS with a destination number\n" - from phonebook.conf - SMS not processed if entry not found\n" + %P - attempts to replace the second word in the SMS with a destination number + from phonebook.conf - SMS not processed if entry not found + %M - intepret the second word (i.e. after the command) of the SMS + as FILENAME, attempt to open the file "pending/FILENAME", treating + the first word of it as a number, attempting to look up its name, + and insert a colon between it and the rest of the file. An example blasms.conf might be: default echo \"SMS from %N at %d: %s\" @@ -32,7 +36,7 @@ Sender names are looked up in phonebook.conf, which should be in the format: An example phonebook.conf might be: +447777123456 John - +447713987654 Bill + +447713987654 Bill Billy With a default gnokii (at least with gnokii-0.6.29) apostrophes (') will be escaped. Removing this behaviour is desirble to blasms and does not cause diff --git a/blasms.c b/blasms.c index 08abcac..273002f 100644 --- a/blasms.c +++ b/blasms.c @@ -273,6 +273,10 @@ int main(int argc, char *argv[]) { " %%s - replaced with the SMS content\n" " %%P - attempts to replace the second word in the SMS with a destination number\n" " from phonebook.conf - SMS not processed if entry not found\n" + " %%M - intepret the second word (i.e. after the command) of the SMS\n" + " as FILENAME, attempt to open the file \"pending/FILENAME\", treating\n" + " the first word of it as a number, attempting to look up its name,\n" + " and insert a colon between it and the rest of the file.\n" "\n" "An example blasms.conf might be:\n" " default echo \\\"SMS from %%N at %%d: %%s\\\"\n" -- cgit v1.2.3