From 9e24ea91f1d6b6e861038b2c27d1bd4ea4e8317d Mon Sep 17 00:00:00 2001
From: osm0sis <osm0sis@outlook.com>
Date: Sun, 16 Dec 2018 14:23:33 -0400
Subject: [PATCH] README: add replace_string scope + note re: extra
 device.name# entries

---
 README.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 760efc7..61ff560 100644
--- a/README.md
+++ b/README.md
@@ -25,7 +25,7 @@ is_slot_device=0;
 ramdisk_compression=auto;
 ```
 
-__do.devicecheck=1__ specified requires at least device.name1 to be present. This should match ro.product.device or ro.build.product for your device. There is support for as many device.name# properties as needed.
+__do.devicecheck=1__ specified requires at least device.name1 to be present. This should match ro.product.device or ro.build.product for your device. There is support for as many device.name# properties as needed. You may remove any empty ones that aren't being used.
 
 __do.modules=1__ will push the contents of the module directory to the same location relative to root (/) and apply 644 permissions.
 
@@ -46,7 +46,7 @@ split_boot
 unpack_ramdisk
 backup_file <file>
 restore_file <file>
-replace_string <file> <if search string> <original string> <replacement string>
+replace_string <file> <if search string> <original string> <replacement string> <scope>
 replace_section <file> <begin search string> <end search string> <replacement string>
 remove_section <file> <begin search string> <end search string>
 insert_line <file> <if search string> <before|after> <line match string> <inserted line>
@@ -71,6 +71,8 @@ __"if search string"__ is the string it looks for to decide whether it needs to
 
 Similarly, __"line match string"__ and __"line replace string"__ are the search strings that locate where the modification needs to be made for those commands, __"begin search string"__ and __"end search string"__ are both required to select the first and last lines of the script block to be replaced for _replace_section_, and __"mount match name"__ and __"fs match type"__ are both required to narrow the _patch_fstab_ command down to the correct entry.
 
+__"scope"__ may be specified as __"global"__ to force all instances of the string targeted by _replace_string_ to be replaced. Omitted or set to anything else and it will perform the default first-match replacement.
+
 __"before|after"__ requires you simply specify __"before"__ or __"after"__ for the placement of the inserted line, in relation to __"line match string"__.
 
 __"block|mount|fstype|options|flags"__ requires you specify which part (listed in order) of the fstab entry you want to check and alter.