ShaDa File Format: Header, SearchPattern, SubString, and HistoryEntry Entries

19th chunk of `runtime/doc/starting.txt`

7d51d68978866b0f89c39411b616577c5c195a8cb06e0db70000000100000fa4

 (Header)          Map containing data that describes the generator
                       instance that wrote this ShaDa file.  It is ignored
                       when reading ShaDa files.  Contains the following data:
                       Key        Data ~
                       generator  Binary, software used to generate ShaDa
                                  file. Is equal to "nvim" when ShaDa file was
                                  written by Nvim.
                       version    Binary, generator version.
                       encoding   Binary, effective 'encoding' value.
                       max_kbyte  Integer, effective |shada-s| limit value.
                       pid        Integer, instance process ID.
                       `*`          It is allowed to have any number of
                                  additional keys with any data.
   2 (SearchPattern)   Map containing data describing last used search or
                       substitute pattern.  Normally ShaDa file contains two
                       such entries: one with "ss" key set to true (describes
                       substitute pattern, see |:substitute|), and one set to
                       false (describes search pattern, see
                       |search-commands|). "su" key should be true on one of
                       the entries.  If key value is equal to default then it
                       is normally not present.  Keys:
                       Key  Type     Default  Description ~
                       sm   Boolean  true     Effective 'magic' value.
                       sc   Boolean  false    Effective 'smartcase' value.
                       sl   Boolean  true     True if search pattern comes
                                              with a line offset.  See
                                              |search-offset|.
                       se   Boolean  false    True if |search-offset|
                                              requested to place cursor at
                                              (relative to) the end of the
                                              pattern.
                       so   Integer  0        Offset value. |search-offset|
                       su   Boolean  false    True if current entry was the
                                              last used search pattern.
                       ss   Boolean  false    True if current entry describes
                                              |:substitute| pattern.
                       sh   Boolean  false    True if |v:hlsearch| is on.
                                              With |shada-h| or 'nohlsearch'
                                              this key is always false.
                       sp   Binary   N/A      Actual pattern.  Required.
                       sb   Boolean  false    True if search direction is
                                              backward.
                       `*`    any      none     Other keys are allowed for
                                              compatibility reasons, see
                                              |shada-compatibility|.
   3 (SubString)       Array containing last |:substitute| replacement string.
                       Contains single entry: binary, replacement string used.
                       More entries are allowed for compatibility reasons, see
                       |shada-compatibility|.
   4 (HistoryEntry)    Array containing one entry from history.  Should have
                       two or three entries.  First one is history type
                       (unsigned integer), second is history line (binary),
                       third is the separator character (unsigned integer,
                       must be in interval [0, 255]).  Third item is only
                       valid for search history.  Possible history types are
                       listed in |hist-names|, here are the corresponding
                       numbers: 0 - cmd,

Title: ShaDa File Format: Header, SearchPattern, SubString, and HistoryEntry Entries

Summary

This section describes the structure and content of specific entry types found in a ShaDa file. It details the 'Header' entry's map, which identifies the generator instance, version, encoding, maximum size, and process ID. The 'SearchPattern' entry's map holds information about the last used search or substitute pattern, including magic, smartcase, offset, search direction, and the actual pattern. The 'SubString' entry contains the last substitute replacement string, while the 'HistoryEntry' contains an entry from history with type, line, and separator character.