Add examples to Bang section

Author: Arano-kai

README.md

@@ -142,7 +142,7 @@ Nice visual cheatsheet from the [article](https://clementc.github.io/blog/2018/0
 
 ### Bang(!) - The History Expansion
 Bash also has some handy features that use the ! (bang) to allow you to do some funky stuff with bash commands.<br>
-General notation is `'![event][:word[:modifier]]'`.<br>
+General notation is `'![event][:word[:modifier[:modifier]...]]'`.<br>
 You may ommit word separator `':'`, if the word designator begins with a `'^'`, `'$'`, `'*'`, `'-'`, or `'%'`.<br>
 If a word designator is supplied without an event specification, the previous command is used as the event.<br>
 After the optional word designator, you can add a sequence of one or more modifiers, each preceded by a `':'`.<br>
@@ -164,6 +164,15 @@ After the optional word designator, you can add a sequence of one or more modifi
     <td>Refer to command line <i><b>n</b></i>.</td>
     <td>
 <pre>
+$ history
+1 echo foo bar baz
+2 history
+$ !1
+#Print command that will be saved in history
+#+and executed
+echo foo bar baz
+#Actual execution
+foo bar baz
 </pre>
     </td>
   </tr>
@@ -172,6 +181,14 @@ After the optional word designator, you can add a sequence of one or more modifi
     <td>Refer to the command <i><b>n</b></i> lines back.</td>
     <td>
 <pre>
+$ history
+1 echo foo
+2 echo bar
+3 echo baz
+4 history
+$ !-3
+echo bar
+bar
 </pre>
     </td>
   </tr>
@@ -180,6 +197,11 @@ After the optional word designator, you can add a sequence of one or more modifi
     <td>Refer to the previous command. This is a synonym for ‘!-1’.</td>
     <td>
 <pre>
+$ echo foo bar baz
+foo bar baz
+$ !!
+echo foo bar baz
+foo bar baz
 </pre>
     </td>
   </tr>
@@ -188,6 +210,13 @@ After the optional word designator, you can add a sequence of one or more modifi
     <td>Refer to the most recent command preceding the current position in the history list starting with <i><b>string</b></i>.</td>
     <td>
 <pre>
+$printf '%s\n' foo
+foo
+$ echo bar
+bar
+$ !pri
+printf '%s\n' foo
+foo
 </pre>
     </td>
   </tr>
@@ -196,14 +225,30 @@ After the optional word designator, you can add a sequence of one or more modifi
     <td>Refer to the most recent command preceding the current position in the history list containing <i><b>string</b></i>. The trailing ‘?’ may be omitted if the <i><b>string</b></i> is followed immediately by a newline.</td>
     <td>
 <pre>
+$printf '%s\n' foo
+foo
+$ echo bar
+bar
+$ !?ntf
+printf '%s\n' foo
+foo
+$ !?bar
+echo bar
+bar
 </pre>
     </td>
   </tr>
   <tr>
     <td>^<i>string1</i>^<i>tring2</i>^</td>
     <td>Quick Substitution. Repeat the last command, replacing <i><b>string1</b></i> with <i><b>string2</b></i>. Equivalent to `!!:s/string1/string2`.</td>
     <td>
+    For more info, refer to `s/old/new/` in <b>Modifiers</b> section.
 <pre>
+$ echo foo
+foo
+$ ^echo^printf '%s\n'^
+printf '%s\n' foo
+foo
 </pre>
     </td>
   </tr>
@@ -212,6 +257,13 @@ After the optional word designator, you can add a sequence of one or more modifi
     <td>Repeat entire command line before this event.</td>
     <td>
 <pre>
+$ echo foo; echo bar; !#echo baz
+echo foo; echo bar; echo foo; echo bar; echo baz
+foo
+bar
+foo
+bar
+baz
 </pre>
     </td>
   </tr>
@@ -223,6 +275,11 @@ After the optional word designator, you can add a sequence of one or more modifi
     <td>The 0th word. For many applications, this is the command word.</td>
     <td>
 <pre>
+$ echo foo
+foo
+$ !:0
+echo
+
 </pre>
     </td>
   </tr>
@@ -231,6 +288,11 @@ After the optional word designator, you can add a sequence of one or more modifi
     <td>The <i><b>n</b></i>th word.</td>
     <td>
 <pre>
+$ echo foo bar baz
+foo bar baz
+$ echo !:2
+echo bar
+bar
 </pre>
     </td>
   </tr>
@@ -239,14 +301,24 @@ After the optional word designator, you can add a sequence of one or more modifi
     <td>The first argument; that is, word 1.</td>
     <td>
 <pre>
+$ echo foo bar baz
+foo bar baz
+$ echo !^
+echo foo
+foo
 </pre>
     </td>
   </tr>
   <tr>
-    <td>\$</td>
+    <td><pre>$</pre></td>
     <td>The last argument.</td>
     <td>
 <pre>
+$ echo foo bar baz
+foo bar baz
+$ echo !$
+echo baz
+baz
 </pre>
     </td>
   </tr>
@@ -255,6 +327,22 @@ After the optional word designator, you can add a sequence of one or more modifi
     <td>The word matched by the most recent `?string?` search</td>
     <td>
 <pre>
+$ echo foo
+foo
+$ printf '%s\n' bar
+bar
+$ !?ch
+echo foo
+foo
+$ !% baz
+echo baz
+baz
+$ !?bar
+printf '%s\n' bar
+bar
+$ echo !%
+echo bar
+bar
 </pre>
     </td>
   </tr>
@@ -263,6 +351,14 @@ After the optional word designator, you can add a sequence of one or more modifi
     <td>A range of words; `-y` abbreviates `0-y`.</td>
     <td>
 <pre>
+$ echo foo bar baz
+foo bar baz
+$ echo !:2-3
+echo bar baz
+bar baz
+$ !:-1
+echo bar
+bar
 </pre>
     </td>
   </tr>
@@ -271,6 +367,13 @@ After the optional word designator, you can add a sequence of one or more modifi
     <td>All of the words, except the 0th. This is a synonym for `1-$`. It is not an error to use `*` if there is just one word in the event - the empty string is returned in that case.</td>
     <td>
 <pre>
+$ echo foo bar baz
+foo bar baz
+$ printf '%s\n' !*
+printf '%s\n' foo bar baz
+foo
+bar
+baz
 </pre>
     </td>
   </tr>
@@ -279,6 +382,12 @@ After the optional word designator, you can add a sequence of one or more modifi
     <td>Abbreviates `x-$`</td>
     <td>
 <pre>
+$ echo foo bar baz
+foo bar baz
+$ printf '%s\n' !:2*
+printf '%s\n' bar baz
+bar
+baz
 </pre>
     </td>
   </tr>
@@ -287,6 +396,13 @@ After the optional word designator, you can add a sequence of one or more modifi
     <td>Abbreviates `x-$` like `x*`, but omits the last word.</td>
     <td>
 <pre>
+$ echo foo bar baz
+foo bar baz
+$ printf '%s\n' !:0-
+printf '%s\n' echo foo bar
+echo
+foo
+bar
 </pre>
     </td>
   </tr>
@@ -295,41 +411,64 @@ After the optional word designator, you can add a sequence of one or more modifi
   </tr>
   <tr>
     <td>p</td>
-    <td>Print the new command but do not execute it.</td>
+    <td>Print the new command but do not execute it.<br>Printed command is saved in history, so you can use <kbd>Ctrl+p</kbd> to re-enter it in current prompt.</td>
     <td>
 <pre>
+$ echo foo bar baz
+foo bar baz
+$ !:p
+#Printed, but not executed
+echo foo bar baz
+$ !:*:p
+foo bar baz
 </pre>
     </td>
   </tr>
   <tr>
     <td>h</td>
-    <td>Remove a trailing pathname component, leaving only the head (Actually, remove all after last `/`).</td>
+    <td>Remove a trailing pathname component, leaving only the head (Actually, remove all after last `/`, including).</td>
     <td>
 <pre>
+$ echo foo /example/path/bar.txt baz
+foo /example/path/bar.txt baz
+$ !:p:h
+echo foo /example/path
 </pre>
     </td>
   </tr>
   <tr>
     <td>t</td>
-    <td>Remove all leading pathname components, leaving the tail (Actually, remove all before last `/`).</td>
+    <td>Remove all leading pathname components, leaving the tail (Actually, remove all before last `/`, including).</td>
     <td>
 <pre>
+$ echo foo /example/path/bar.txt baz
+foo /example/path/bar.txt baz
+$ !:p:t
+bar.txt baz
 </pre>
     </td>
   </tr>
   <tr>
     <td>r</td>
-    <td>Remove a trailing suffix of the form `.suffix`, leaving the basename (Actually, remove all after last `.`).</td>
+    <td>Remove a trailing suffix of the form `.suffix`, leaving the basename (Actually, remove all after last `.`, including).</td>
     <td>
 <pre>
+$ echo foo /example/path/bar.txt baz
+foo /example/path/bar.txt baz
+$ !:p:r
+echo foo /example/path/bar
 </pre>
     </td>
   </tr>
   <tr>
     <td>e</td>
-    <td>Remove all but the trailing suffix (Actually, remove all before last `.`).</td>
+    <td>Remove all but the trailing suffix (Actually, remove all before last `.`, including).</td>
     <td>
 <pre>
+$ echo foo /example/path/bar.txt baz
+foo /example/path/bar.txt baz
+$ !:p:e
+txt baz
 </pre>
     </td>
   </tr>
@@ -338,6 +477,10 @@ After the optional word designator, you can add a sequence of one or more modifi
     <td>Quote the substituted words, escaping further substitutions.</td>
     <td>
 <pre>
+$ echo foo 'bar baz'
+foo bar baz
+$ !:p:q
+'echo foo '\'bar baz'\'''
 </pre>
     </td>
   </tr>
@@ -346,6 +489,10 @@ After the optional word designator, you can add a sequence of one or more modifi
     <td>Quote the substituted words as with ‘q’, but break into words at spaces, tabs, and newlines.</td>
     <td>
 <pre>
+$ echo foo 'bar baz'
+foo bar baz
+$ !:p:x
+'echo' 'foo' ''\'bar' 'baz'\'''
 </pre>
     </td>
   </tr>
@@ -354,6 +501,10 @@ After the optional word designator, you can add a sequence of one or more modifi
     <td>Substitute <i><b>new</b></i> for the first occurrence of <i><b>old</b></i> in the event line. Any delimiter may be used in place of `/`. The delimiter may be quoted in <i><b>old</b></i> and <i><b>new</b></i> with a single backslash. If `&` appears in <i><b>new</b></i>, it is replaced by <i><b>old</b></i>. A single backslash will quote the `&`. The final delimiter is optional if it is the last character on the input line.</td>
     <td>
 <pre>
+$ echo foo bar
+foo bar
+$ !:p:s/foo/baz
+echo baz bar
 </pre>
     </td>
   </tr>
@@ -362,6 +513,14 @@ After the optional word designator, you can add a sequence of one or more modifi
     <td>Repeat the previous substitution.</td>
     <td>
 <pre>
+$ echo foo bar
+foo bar
+$ !:p:s/foo/baz
+echo baz bar
+$ printf '%s\n' foo
+foo
+$ !:p:&
+printf '%s\n' baz
 </pre>
     </td>
   </tr>
@@ -370,13 +529,17 @@ After the optional word designator, you can add a sequence of one or more modifi
     <td>Cause changes to be applied over the entire event line. Used in conjunction with `s`, as in gs/old/new/, or with `&`.</td>
     <td>
 <pre>
+$ echo foo bar foo
+foo bar foo
+$ !:p:gs/foo/baz
+echo baz bar baz
 </pre>
     </td>
   </tr>
   <tr>
     <td>G</td>
     <td>Apply the following ‘s’ modifier once to each word in the event.</td>
-    <td>
+    <td>Result is same as in `g` modifier
 <pre>
 </pre>
     </td>