update document with images

README.md

@@ -44,27 +44,40 @@ this code produces the output like:
 However, if the arguments are colored by ANSI sequence,
 
     printf("| %-5s | %-5s | %-5s |\n",
-           "\e[31mRed\e[m", "\e[32mGreen\e[m", "\e[34mBlue\e[m");
+           "\e[31mRed\e[m", "\e[32;3mGreen\e[m", "\e[34;3;4mBlue\e[m");
 
 this code produces undesirable result:
 
     | Red | Green | Blue |
 
-This is still better because it is readable, but if the result is
-shorter than the original string, for example, "%.3s", the result will
-be disastrous.
+<div>
+    <p><img width="750" src="https://raw.githubusercontent.com/tecolicom/Text-ANSI-Printf/master/images/bad.png">
+</div>
+
+This is still better because the output is readable, but if the result
+is shorter than the original string, for example, "%3.3s", the result
+will be disastrous.
 
 `ansi_printf` can be used to properly format colored text.
 
     use Text::ANSI::Printf 'ansi_printf';
     ansi_printf("| %-5s | %-5s | %-5s |\n",
-           "\e[31mRed\e[m", "\e[32;3mGreen\e[m", "\e[34;3;4mBlue\e[m");
+                "\e[31mRed\e[m", "\e[32;3mGreen\e[m", "\e[34;3;4mBlue\e[m");
+
+<div>
+    <p><img width="750" src="https://raw.githubusercontent.com/tecolicom/Text-ANSI-Printf/master/images/good.png">
+</div>
 
 It does not matter if the result is shorter than the original text.
 Next code produces `[R] [G] [B]` in proper color.
 
+    use Text::ANSI::Printf 'ansi_printf';
     ansi_printf("[%.1s] [%.1s] [%.1s]\n",
-           "\e[31mRed\e[m", "\e[32;3mGreen\e[m", "\e[34;3;4mBlue\e[m");
+                "\e[31mRed\e[m", "\e[32;3mGreen\e[m", "\e[34;3;4mBlue\e[m");
+
+<div>
+    <p><img width="750" src="https://raw.githubusercontent.com/tecolicom/Text-ANSI-Printf/master/images/shorten.png">
+</div>
 
 # RELATED TOOLS
 

lib/Text/ANSI/Printf.pm

@@ -87,27 +87,50 @@ this code produces the output like:
 However, if the arguments are colored by ANSI sequence,
 
     printf("| %-5s | %-5s | %-5s |\n",
-           "\e[31mRed\e[m", "\e[32mGreen\e[m", "\e[34mBlue\e[m");
+           "\e[31mRed\e[m", "\e[32;3mGreen\e[m", "\e[34;3;4mBlue\e[m");
 
 this code produces undesirable result:
 
+=begin text
+
     | Red | Green | Blue |
 
-This is still better because it is readable, but if the result is
-shorter than the original string, for example, "%.3s", the result will
-be disastrous.
+=end text
+
+=begin html
+
+<p><img width="750" src="https://raw.githubusercontent.com/tecolicom/Text-ANSI-Printf/master/images/bad.png">
+
+=end html
+
+This is still better because the output is readable, but if the result
+is shorter than the original string, for example, "%3.3s", the result
+will be disastrous.
 
 C<ansi_printf> can be used to properly format colored text.
 
     use Text::ANSI::Printf 'ansi_printf';
     ansi_printf("| %-5s | %-5s | %-5s |\n",
-           "\e[31mRed\e[m", "\e[32;3mGreen\e[m", "\e[34;3;4mBlue\e[m");
+                "\e[31mRed\e[m", "\e[32;3mGreen\e[m", "\e[34;3;4mBlue\e[m");
+
+=begin html
+
+<p><img width="750" src="https://raw.githubusercontent.com/tecolicom/Text-ANSI-Printf/master/images/good.png">
+
+=end html
 
 It does not matter if the result is shorter than the original text.
 Next code produces C<[R] [G] [B]> in proper color.
 
+    use Text::ANSI::Printf 'ansi_printf';
     ansi_printf("[%.1s] [%.1s] [%.1s]\n",
-           "\e[31mRed\e[m", "\e[32;3mGreen\e[m", "\e[34;3;4mBlue\e[m");
+                "\e[31mRed\e[m", "\e[32;3mGreen\e[m", "\e[34;3;4mBlue\e[m");
+
+=begin html
+
+<p><img width="750" src="https://raw.githubusercontent.com/tecolicom/Text-ANSI-Printf/master/images/shorten.png">
+
+=end html
 
 =head1 RELATED TOOLS
 
@@ -120,7 +143,6 @@ follows.
 
     use Text::ANSI::Printf 'ansi_printf';
     use Term::ANSIColor::Concise 'ansi_color';
-
     ansi_printf("| %-5s | %-5s | %-5s |\n",
                 ansi_color("R", "Red", "GI", "Green", "BIU", "Blue"));