fixed GSA writing, added always-edit button and search in file and for file

GsaEditor/bin/Debug/net8.0/GsaEditor.Core.xml

@@ -67,7 +67,9 @@
         </member>
         <member name="T:GsaEditor.Core.IO.GsaIndexReader">
             <summary>
-            Parses .idx NML index files (XML-compatible format) into a list of <see cref="T:GsaEditor.Core.IO.GsaIndexEntry"/>.
+            Parses .idx NML index files into a list of <see cref="T:GsaEditor.Core.IO.GsaIndexEntry"/>.
+            NML is the engine's own tag syntax (&lt;Name=value&gt; blocks, see <see cref="T:GsaEditor.Core.IO.GsaIndexWriter"/>),
+            not standard XML.
             </summary>
         </member>
         <member name="M:GsaEditor.Core.IO.GsaIndexReader.Read(System.String)">
@@ -80,13 +82,33 @@
         <member name="T:GsaEditor.Core.IO.GsaIndexWriter">
             <summary>
             Writes a .idx NML index file from a <see cref="T:GsaEditor.Core.Models.GsaArchive"/>.
-            The index file is XML-compatible and lists each entry with its alias, compression method,
-            sizes, and data offset for fast lookup without a full sequential scan.
+            The NML format is the engine's own tag syntax (NOT standard XML):
+            <code>
+            &lt;Version=1.0&gt;
+            &lt;Index=
+                &lt;Entry=
+                    &lt;ID="path/in/archive"&gt;
+                    &lt;CompLen=123&gt;
+                    &lt;Len=456&gt;
+                    &lt;Offset=789&gt;
+                    &lt;Method="Zlib"&gt;
+                &gt;
+            &gt;
+            </code>
+            Tab indentation, LF line endings, no BOM. Method is "Zlib" or "Raw".
+            The engine parses this file to locate entries, so the format must match exactly.
+            </summary>
+        </member>
+        <member name="F:GsaEditor.Core.IO.GsaIndexWriter.BootstrapAlias">
+            <summary>
+            The engine's bootstrap script is loaded by sequential archive scan and is
+            deliberately absent from the shipped index files, so it is skipped here too.
             </summary>
         </member>
         <member name="M:GsaEditor.Core.IO.GsaIndexWriter.Write(GsaEditor.Core.Models.GsaArchive,System.String)">
             <summary>
             Writes the index file for the given archive to the specified path.
+            Entry offsets must be up to date (i.e. call after <see cref="M:GsaEditor.Core.IO.GsaWriter.Write(GsaEditor.Core.Models.GsaArchive,System.String)"/>).
             </summary>
             <param name="archive">The archive whose entries will be indexed.</param>
             <param name="filePath">The output .idx file path.</param>
@@ -149,6 +171,12 @@
         <member name="F:GsaEditor.Core.IO.GsaWriter.MAGIC_NARD">
             <summary>Magic word for the NARD (enhanced) format.</summary>
         </member>
+        <member name="F:GsaEditor.Core.IO.GsaWriter.TERMINATOR">
+            <summary>
+            End-of-archive terminator written where the next entry's alias length would be.
+            The engine's sequential reader stops when it hits this invalid length.
+            </summary>
+        </member>
         <member name="M:GsaEditor.Core.IO.GsaWriter.Write(GsaEditor.Core.Models.GsaArchive,System.String)">
             <summary>
             Writes the archive to the specified file path.