Update from maxtek6/hyperpage@0829896

Author: johnpatek

public/docs/hyperpage/doxygen_crawl.html

@@ -39,6 +39,8 @@
 <a href="index.html#autotoc_md3"/>
 <a href="index.html#autotoc_md4"/>
 <a href="index.html#autotoc_md5"/>
+<a href="index.html#autotoc_md6"/>
+<a href="index.html#autotoc_md7"/>
 <a href="namespacehyperpage.html"/>
 <a href="namespacehyperpage.html#aff9178552e147f16a5cb43a0b5d36878"/>
 <a href="namespacemembers.html"/>

public/docs/hyperpage/index.html

@@ -119,16 +119,33 @@ <h2 class="doxsection"><a class="anchor" id="autotoc_md3"></a>
 <h2 class="doxsection"><a class="anchor" id="autotoc_md4"></a>
 <span class="tt">hyperpack</span></h2>
 <p>Hyperpack is a command line utility used to create a hyperpage database file:</p>
-<div class="fragment"><div class="line">Usage: hyperpack [--help] [--output VAR] directory</div>
+<div class="fragment"><div class="line">Usage: hyperpack [--help] [--version] [--output VAR] [--verbose] directories...</div>
 <div class="line"> </div>
 <div class="line">Positional arguments:</div>
-<div class="line">  directory      Directory to scan for files to pack into the hyperpage database [required]</div>
+<div class="line">  directories    Directories to scan for files to pack into the hyperpage database [nargs: 1 or more] [required]</div>
 <div class="line"> </div>
 <div class="line">Optional arguments:</div>
 <div class="line">  -h, --help     shows help message and exits</div>
+<div class="line">  -v, --version  prints version information and exits</div>
 <div class="line">  -o, --output   Output file for the hyperpage database [nargs=0..1] [default: &quot;hyperpage.db&quot;]</div>
-</div><!-- fragment --><p>It will iterate through a given directory, storing its files based on paths relative to the given directory. It will also detect the mime type and store the contents of each file.</p>
-<h2 class="doxsection"><a class="anchor" id="autotoc_md5"></a>
+<div class="line">  -v, --verbose  Show detailed output information</div>
+</div><!-- fragment --><h2 class="doxsection"><a class="anchor" id="autotoc_md5"></a>
+Note on Overwriting</h2>
+<p>If two or more files share the same <b>relative subpath</b> (i.e., the same path within their respective parent directories), the file from the <b>rightmost directory</b> specified on the command line will overwrite the others in the final archive.</p>
+<p>Only <b>exact path matches</b> are considered conflicts — differing subdirectories or filenames will coexist as separate entries.</p>
+<h3 class="doxsection"><a class="anchor" id="autotoc_md6"></a>
+Example</h3>
+<p>Suppose you run: </p><div class="fragment"><div class="line">hyperpack -o output.hp dir1 dir2 dir3</div>
+</div><!-- fragment --><p> And the directories contain: </p><div class="fragment"><div class="line">dir1/Subdir1/index.html</div>
+<div class="line">dir2/Subdir2/index.html</div>
+<div class="line">dir3/Index.html</div>
+</div><!-- fragment --><p> These will result in three distinct files inside the archive: </p><div class="fragment"><div class="line">Subdir1/index.html</div>
+<div class="line">/Subdir2/index.html</div>
+<div class="line">/Index.html</div>
+</div><!-- fragment --><p> However, if two or more directories contain the same relative path, for example: </p><div class="fragment"><div class="line">dir1/public/index.html</div>
+<div class="line">dir2/public/index.html</div>
+</div><!-- fragment --><p> then the file from dir2 (the rightmost one) will overwrite the file from dir1 in the resulting archive entry: </p><div class="fragment"><div class="line">/public/index.html</div>
+</div><!-- fragment --> <h2 class="doxsection"><a class="anchor" id="autotoc_md7"></a>
 Documentation and Example</h2>
 <p>This is only intended to cover basic usage. For more info about the API, see the <a href="https://maxtek6.github.io/docs/hyperpage">docs</a>. To see how hyperpage is used in a basic use case, the <a href="https://github.com/maxtek6/hyperpage/tree/master/example">example</a> should be helpful. </p>
 </div></div><!-- PageDoc -->

public/docs/hyperpage/navtreedata.js

@@ -29,7 +29,10 @@ var NAVTREE =
     [ "Usage", "index.html#autotoc_md2", [
       [ "<span class=\"tt\">hyperpage</span>", "index.html#autotoc_md3", null ],
       [ "<span class=\"tt\">hyperpack</span>", "index.html#autotoc_md4", null ],
-      [ "Documentation and Example", "index.html#autotoc_md5", null ]
+      [ "Note on Overwriting", "index.html#autotoc_md5", [
+        [ "Example", "index.html#autotoc_md6", null ]
+      ] ],
+      [ "Documentation and Example", "index.html#autotoc_md7", null ]
     ] ],
     [ "Namespaces", "namespaces.html", [
       [ "Namespace List", "namespaces.html", "namespaces_dup" ],

public/docs/hyperpage/navtreeindex0.js

@@ -37,6 +37,8 @@ var NAVTREEINDEX0 =
 "index.html#autotoc_md3":[1,0],
 "index.html#autotoc_md4":[1,1],
 "index.html#autotoc_md5":[1,2],
+"index.html#autotoc_md6":[1,2,0],
+"index.html#autotoc_md7":[1,3],
 "namespacehyperpage.html":[2,0,0],
 "namespacehyperpage.html#aff9178552e147f16a5cb43a0b5d36878":[2,0,0,3],
 "namespacemembers.html":[2,1,0],

public/docs/hyperpage/search/all_0.js

@@ -1,5 +1,5 @@
 var searchData=
 [
   ['abstract_0',['abstract',['../classabstract.html',1,'']]],
-  ['and_20example_1',['Documentation and Example',['../index.html#autotoc_md5',1,'']]]
+  ['and_20example_1',['Documentation and Example',['../index.html#autotoc_md7',1,'']]]
 ];

public/docs/hyperpage/search/all_2.js

@@ -1,4 +1,4 @@
 var searchData=
 [
-  ['documentation_20and_20example_0',['Documentation and Example',['../index.html#autotoc_md5',1,'']]]
+  ['documentation_20and_20example_0',['Documentation and Example',['../index.html#autotoc_md7',1,'']]]
 ];

public/docs/hyperpage/search/all_3.js

@@ -1,4 +1,4 @@
 var searchData=
 [
-  ['example_0',['Documentation and Example',['../index.html#autotoc_md5',1,'']]]
+  ['example_0',['Example',['../index.html#autotoc_md7',1,'Documentation and Example'],['../index.html#autotoc_md6',1,'Example']]]
 ];

public/docs/hyperpage/search/all_8.js

@@ -1,4 +1,4 @@
 var searchData=
 [
-  ['page_0',['page',['../classhyperpage_1_1page.html',1,'hyperpage']]]
+  ['note_20on_20overwriting_0',['Note on Overwriting',['../index.html#autotoc_md5',1,'']]]
 ];

public/docs/hyperpage/search/all_9.js

@@ -1,6 +1,5 @@
 var searchData=
 [
-  ['reader_0',['reader',['../classhyperpage_1_1reader.html',1,'hyperpage::reader'],['../classhyperpage_1_1reader.html#a4e4d4baffb2b674b59216f54cd6ad488',1,'hyperpage::reader::reader()']]],
-  ['readme_2emd_1',['README.md',['../README_8md.html',1,'']]],
-  ['requirements_2',['Requirements',['../index.html#autotoc_md1',1,'']]]
+  ['on_20overwriting_0',['Note on Overwriting',['../index.html#autotoc_md5',1,'']]],
+  ['overwriting_1',['Note on Overwriting',['../index.html#autotoc_md5',1,'']]]
 ];

public/docs/hyperpage/search/all_a.js

@@ -1,4 +1,4 @@
 var searchData=
 [
-  ['store_0',['store',['../classhyperpage_1_1writer.html#a027c6b9de6186a02bd7c78f6ace82acf',1,'hyperpage::writer']]]
+  ['page_0',['page',['../classhyperpage_1_1page.html',1,'hyperpage']]]
 ];