adding 4.6.18 to the Manual

d0vgan · Nov 14, 2024 · 88a409f · 88a409f
1 parent 7a722bc
commit 88a409f
Show file tree

Hide file tree

Showing 13 changed files with 81 additions and 6 deletions.
diff --git a/NppExec_src.txt b/NppExec_src.txt
@@ -17,6 +17,7 @@ docs\NppExec_Manual\*.css
 docs\NppExec_Manual\*.hhc
 docs\NppExec_Manual\*.hhp
 docs\NppExec_Manual\*.js
+docs\NppExec_Manual\images\*.png
 NppExec\ConsoleIcon.*
 NppExec\NppExec*.dev
 NppExec\NppExec*.vcproj

diff --git a/docs/NppExec_Manual.chm b/docs/NppExec_Manual.chm
diff --git a/docs/NppExec_Manual/4.6.14.html b/docs/NppExec_Manual/4.6.14.html
@@ -85,7 +85,7 @@ <h3>4.6.14. Notepad++ as a Clipboard Monitor</h3>
   <pre> </pre>
 </blockquote>
 
-<p>See also: Clipboard, keystrokes and much more <a href="4.6.8.html">[4.6.8]</a>.</p>
+<p>See also: Clipboard, keystrokes and much more <a href="4.6.8.html">[4.6.8]</a>; NppExec's Console as a Log Viewer <a href="4.6.18.html">[4.6.18]</a>.</p>
 
 <blockquote>
   <pre> </pre>

diff --git a/docs/NppExec_Manual/4.6.18.html b/docs/NppExec_Manual/4.6.18.html
@@ -0,0 +1,57 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<HTML lang="en">
+<HEAD>
+<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252">
+<link href="style.css" rel="stylesheet" type="text/css">
+<title>4.6.18. NppExec's Console as a Log Viewer</title>
+<script src="show_matches.js" type="text/javascript"></script>
+</HEAD>
+<BODY>
+<h3>4.6.18. NppExec's Console as a Log Viewer</h3>
+
+<p><em>[the idea was originally proposed by mischlrebl as &quot;show and reload file content periodically&quot; here: https://github.com/d0vgan/nppexec/issues/101]</em></p>
+
+<p>[ mischlrebl: ]</p>
+<blockquote>
+  <p>I am wondering if it is possible to watch and track a log file in the Console - like the &quot;Monitoring (tail -f)&quot; function in Notepad++?</p>
+  <p>It would be very handy to work with split screen on the files and to see the messages below.</p>
+</blockquote>
+
+<p>[ DV: ]</p>
+<blockquote>
+  <p>The closest built-in command in NppExec is <i>con_load</i>, though it loads an entire file into the Console window.</p>
+  <p>To achieve your goal, you may probably run some external log viewer/watcher implemented as a console application in NppExec's Console.</p>
+  <p>This version of <code>tail</code> works good in NppExec's Console: https://github.com/JavaScriptDude/cygtail </p>
+  <p>On the cygtail's project page, click the <code>&lt;&gt;Code</code> button and then click <code>Download ZIP</code> there.</p>
+  <p>After downloading and extracting the binaries, this command will do the job:</p>
+  <blockquote>
+    <pre>tail -f log.txt</pre>
+  </blockquote>
+</blockquote>
+
+<blockquote>
+  <pre> </pre>
+</blockquote>
+
+<p>As I had never thought about NppExec in terms of log viewing, I asked mischlrebl for more details of this use-case. And here are the resulting images that speak for themselves:</p>
+
+<p> </p>
+
+<img src="images/4_6_18_Console_Highlight_Filters.png">
+
+<p> </p>
+
+<img src="images/4_6_18_NppExec_Console.png">
+
+<blockquote>
+  <pre> </pre>
+</blockquote>
+
+<p>See also: Clipboard, keystrokes and much more <a href="4.6.8.html">[4.6.8]</a>; Notepad++ as a Clipboard Monitor <a href="4.6.14.html">[4.6.14]</a>.</p>
+
+<blockquote>
+  <pre> </pre>
+</blockquote>
+
+</BODY>
+</HTML>
diff --git a/docs/NppExec_Manual/4.6.8.html b/docs/NppExec_Manual/4.6.8.html
@@ -20,7 +20,7 @@ <h3>4.6.8. Clipboard, keystrokes and much more</h3>
 </ul>
 <p>The list of such useful programs can go on and on - and the main idea here is the ability of &quot;communication&quot; between these programs and NppExec. As you can use different tools with different parameters and then retrieve and process the produced output, there theoretically is no limit of what you can achieve by this approach. This reminds us the section <a href="3.1.html">[3.1]</a>: &quot;So, generally speaking, NppExec is a tool&quot; - and what this tool can do for you depends on how you use it. So use it wisely :)</p>
 
-<p>See also: Working with the Notepad++ 'Replace' dialog <a href="4.6.13.html">[4.6.13]</a>; Notepad++ as a Clipboard Monitor <a href="4.6.14.html">[4.6.14]</a>.</p>
+<p>See also: Working with the Notepad++ 'Replace' dialog <a href="4.6.13.html">[4.6.13]</a>; Notepad++ as a Clipboard Monitor <a href="4.6.14.html">[4.6.14]</a>; NppExec's Console as a Log Viewer <a href="4.6.18.html">[4.6.18]</a>.</p>
 
 </BODY>
 </HTML>
diff --git a/docs/NppExec_Manual/About.html b/docs/NppExec_Manual/About.html
@@ -41,6 +41,7 @@ <h3>About</h3>
         <li>3.0 - August 2023 (4.6.14, 4.6.15 and 4.8.3 added; 4.6.3, 4.6.4, 4.7.1 and NppExec_Guide updated)</li>
         <li>3.1 - September 2023 (2.4, 3.7, 3.8.4, 4.1, 4.6.4 and 4.7.3 updated; 4.6.16 and 4.6.17 added)</li>
         <li>3.2 - January 2024 (FAQ added)</li>
+        <li>3.3 - ... (4.6.18 added)</li>
       </ul></td>
   </tr>
   <tr>

diff --git a/docs/NppExec_Manual/NppExec_Guide.html b/docs/NppExec_Manual/NppExec_Guide.html
@@ -387,5 +387,11 @@ <h3>Guide: Using NppExec to compile sources with associated compilers</h3>
   <pre> </pre>
 </blockquote>
 
+<p>See also: NppExec's Console as a Log Viewer <a href="4.6.18.html">[4.6.18]</a>.</p>
+
+<blockquote>
+  <pre> </pre>
+</blockquote>
+
 </BODY>
 </HTML>
diff --git a/docs/NppExec_Manual/NppExec_Manual.hhc b/docs/NppExec_Manual/NppExec_Manual.hhc
@@ -209,6 +209,10 @@
 				<param name="Name" value="4.6.17. Modify selected text and save to file">
 				<param name="Local" value="4.6.17.html">
 				</OBJECT>
+			<LI> <OBJECT type="text/sitemap">
+				<param name="Name" value="4.6.18. NppExec's Console as a Log Viewer">
+				<param name="Local" value="4.6.18.html">
+				</OBJECT>
 		</UL>
 		<LI> <OBJECT type="text/sitemap">
 			<param name="Name" value="4.7. Compiling">

diff --git a/docs/NppExec_Manual/images/4_6_18_Console_Highlight_Filters.png b/docs/NppExec_Manual/images/4_6_18_Console_Highlight_Filters.png
diff --git a/docs/NppExec_Manual/images/4_6_18_NppExec_Console.png b/docs/NppExec_Manual/images/4_6_18_NppExec_Console.png
diff --git a/docs/NppExec_Manual/index.html b/docs/NppExec_Manual/index.html
@@ -67,6 +67,7 @@ <h3>NppExec Manual: Index</h3>
     <li><a href="4.6.15.html">4.6.15. Triggering certain actions while saving a file</a></li>
     <li><a href="4.6.16.html">4.6.16. Open a file basing on the text selected in the editor</a></li>
     <li><a href="4.6.17.html">4.6.17. Modify selected text and save to file</a></li>
+    <li><a href="4.6.18.html">4.6.18. NppExec's Console as a Log Viewer</a></li>
   </ul>
   <li>4.7. Compiling</li>
   <ul>

diff --git a/docs/NppExec_Manual/toc.html b/docs/NppExec_Manual/toc.html
@@ -86,6 +86,7 @@ <h3>NppExec Manual: Index</h3>
     <li><a target="content" href="4.6.15.html">4.6.15. Triggering certain actions while saving a file</a></li>
     <li><a target="content" href="4.6.16.html">4.6.16. Open a file basing on the text selected in the editor</a></li>
     <li><a target="content" href="4.6.17.html">4.6.17. Modify selected text and save to file</a></li>
+    <li><a target="content" href="4.6.18.html">4.6.18. NppExec's Console as a Log Viewer</a></li>
   </ul>
   </li>
   <li>4.7. Compiling