Update: Add Time and EpochTime specification documentation.

The time specification markup is generated with the assistance of:
  fss_basic_list_read time.txt +Q -cn "Time Specification" | iki_read +Q -w -WWWWWWWWWWWWWWW bold '<strong class="strong">' '</strong>' italic '<em class="em">' '</em>' character '<code class="code">' '</code>' code '<code class="code">' '</code>' unicode '<code class="code">' '</code>' block '<pre class="preserve">' '</pre>' script '<pre class="preserve">' '</pre>' file '<a href="fll/specifications/fss/REPLACE" class="link">' '</a>' ABI '<abbr title="Application Binary Interface">' '</abbr>' API '<abbr title="Application Programming Interface">' '</abbr>' ASCII '<abbr title="American Standard Code for Information Interchange">' '</abbr>' EOF '<abbr title="End of File">' '</abbr>' FLL '<abbr title="Featureless Linux Library">' '</abbr>' FSS '<abbr title="Featureless Settings Specification">' '</abbr>' UTC '<abbr title="Coordinated Universal Time">' '</abbr>' -rrrrrrr ABI ABI API API ASCII ASCII EOF EOF FLL FLL FSS FSS UTC UTC

diff --git a/fll/specifications.html b/fll/specifications.html
index d510ff12a33e7c5091f3a04bb8d949f651876bc9..3cf2644b6d85a7e27755ed75be52d37db383a135 100644 (file)
--- a/fll/specifications.html
+++ b/fll/specifications.html
@@ -120,6 +120,12 @@
             <a href="fll/specifications/iki/iki-0002.html" class="nav-text link"><div>IKI-0002</div><div>(Simple Script)</div></a>
           </div>
           <div class="nav-item block">
+            <a href="fll/specifications.html#other" class="nav-text link">Other</a>
+          </div>
+          <div class="nav-item block">
+            <a href="fll/specifications/other/time.html" class="nav-text link">Time and EpochTime</a>
+          </div>
+          <div class="nav-item block">
             <a href="fll/specifications.html#completeness_theorem" class="nav-text link">Completeness Theorem</a>
           </div>
           <div class="nav-item block">
@@ -145,7 +151,7 @@
 
             <div class="section-content">
               <p class="p">
-                The Featureless Linux Library defines several standards for use in this project. Many of these standards are defined via the Featureless Settings Specifications. Most of these are focused on settings files (configuration files) but are written general enough to support a wide range of uses. The original project that the <abbr title="Featureless Linux Library">FLL</abbr> project is built around is the <em class="em">Featureless Make</em> program, also called <strong class="strong">Fake</strong>. The <strong class="strong">Fake</strong> program is a great example on how the <abbr title="Featureless Settings Specifications">FSS</abbr> are intended to be used.
+                The <strong class="strong">Featureless Linux Library</strong> defines several standards for use in this project. Many of these standards are defined via the Featureless Settings Specifications. Most of these are focused on settings files (configuration files) but are written general enough to support a wide range of uses. The original project that the <abbr title="Featureless Linux Library">FLL</abbr> project is built around is the <em class="em">Featureless Make</em> program, also called <strong class="strong">Fake</strong>. The <strong class="strong">Fake</strong> program is a great example on how the <abbr title="Featureless Settings Specifications">FSS</abbr> are intended to be used.
               </p>
               <p class="p">
                 The standards are not limited to those defined in the <abbr title="Featureless Settings Specifications">FSS</abbr>. There are the <em class="em">IKI</em> standards (which is not an acronym). The term <em class="em">IKI</em> plays off of the term <em class="em">Wiki</em>. The <em class="em">IKI</em> standard is intended to have simpler syntax than a <em class="em">Wiki</em> syntax and is used in several <abbr title="Featureless Linux Library">FLL</abbr> projects and even inside standards defined by <abbr title="Featureless Settings Specifications">FSS</abbr>.
@@ -300,8 +306,8 @@ Object_2 This is multiple\" Contents and the trailing quote does not need to be
               <p class="p">
                 Unless otherwise specified, comments are designated by the pound symbol <code class="code">#</code> but only if only white space is to the left of the pound or the pound <code class="code">#</code> is at the start of the line.
                 There is no support for inline comments.
-                Unless otherwise specified, the start comment may be delimited by <code class="code">" in the same manner as Objects and Contents are.
-                This delimit only applies to the start of a comment (the pound code:</code>#" character) as there is no terminating character for a comment (other than a newline <code class="code">\n</code>).
+                Unless otherwise specified, the start comment may be delimited by <code class="code">\</code> in the same manner as Objects and Contents are.
+                This delimit only applies to the start of a comment (the pound <code class="code">#</code> character) as there is no terminating character for a comment (other than a newline <code class="code">\n</code>).
                 A line containing a valid comment is in its entirety ignored.
                 This means that if there is white space before the designation symbol (the pound <code class="code">#</code> character) then that white space is ignored.
               </p>
@@ -456,6 +462,24 @@ Contents would be:
             </div>
           </section>
 
+          <section id="other" class="section">
+            <header class="section-header header separate">
+              <h2 class="section-title h h2">Other</h2>
+            </header>
+
+            <div class="section-content">
+              <p class="p">
+                The <abbr title="Featureless Settings Specifications">FSS</abbr> and the <strong class="strong">IKI</strong> are not the only standards provided by the <abbr title="Featureless Linux Library">FLL</abbr>.
+              </p>
+              <p class="p">
+                The following are other specifications that are provided:
+              </p>
+              <ul>
+                <li><a href="fll/specifications/other/time.html" class="link">Time and EpochTime</a></li>
+              </ul>
+            </div>
+          </section>
+
           <section id="completeness_theorem" class="section">
             <header class="section-header header separate">
               <h2 class="section-title h h2">Completeness Theorem</h2>

diff --git a/fll/specifications/other/time.html b/fll/specifications/other/time.html
new file mode 100644 (file)
index 0000000..46b8b99
--- /dev/null
+++ b/fll/specifications/other/time.html
@@ -0,0 +1,341 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <title>FLL - Specifications - Time and EpochTime</title>
+
+    <base href="../../../">
+
+    <meta charset="UTF-8">
+    <meta name="author" content="Kevin Day">
+    <meta name="description" content="Featurless Linux Library Specifications">
+    <meta name="keywords" content="Kevin Day, Kevux, FLL, Featureless, Linux, Library, Distribution, Open-Source, specification, standard, Time, EpochTime">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+    <link type="text/css" rel="stylesheet" media="all" href="css/kevux.css">
+    <link type="text/css" rel="stylesheet" media="only screen" href="css/kevux-screen.css">
+    <link type="text/css" rel="stylesheet" media="only screen and (min-device-width:501px)" href="css/kevux-screen-desktop.css">
+    <link type="text/css" rel="stylesheet" media="only screen and (max-device-width:500px)" href="css/kevux-screen-mobile.css">
+    <link type="text/css" rel="stylesheet" media="only screen and (min-device-width:1201px)" href="css/kevux-screen-large.css">
+    <link type="text/css" rel="stylesheet" media="only screen and (min-device-width:501px) and (max-device-width:1200px)" href="css/kevux-screen-normal.css">
+    <link type="text/css" rel="stylesheet" media="only screen and (min-device-width:251px) and (max-device-width:500px)" href="css/kevux-screen-small.css">
+    <link type="text/css" rel="stylesheet" media="only screen and (max-device-width:250px)" href="css/kevux-screen-tiny.css">
+    <link type="text/css" rel="stylesheet" media="only print" href="css/kevux-print.css">
+    <link type="text/css" rel="stylesheet" media="only print and (orientation:landscape)" href="css/kevux-print-landscape.css">
+    <link type="text/css" rel="stylesheet" media="only print and (orientation:portrait)" href="css/kevux-print-portrait.css">
+
+    <link rel="canonical" href="fll/specifications/other/time.html">
+    <link type="image/x-icon" rel="icon" href="images/kevux.ico">
+    <link type="image/x-icon" rel="shortcut" href="images/kevux.ico">
+    <link type="text/html" rel="license" href="licenses.html">
+  </head>
+
+  <body id="kevux" class="kevux no-js fll specifications">
+    <div role="banner" class="header-block">
+      <header class="header-section header">
+        <div class="header-site">Kevux Systems and Software</div>
+      </header>
+
+      <div class="nav-block">
+        <nav id="kevux-site-nav" class="nav-menu">
+          <div class="nav-item"><a href="news.html" class="nav-text link">News</a></div>
+          <div class="nav-item"><a href="distributions.html" class="nav-text link">Distributions</a></div>
+          <div class="nav-item active"><a href="fll.html" class="nav-text link">FLL</a></div>
+          <div class="nav-item"><a href="projects.html" class="nav-text link">Projects</a></div>
+          <div class="nav-item"><a href="documentation.html" class="nav-text link">Documentation</a></div>
+        </nav>
+      </div>
+    </div>
+
+    <div class="content-block">
+      <div id="nav-expanded" class="nav-block">
+        <nav id="kevux-document-nav" class="nav-menu">
+          <div class="nav-item block back">
+            <a href="fll/specifications.html" class="nav-text link back">Back</a>
+          </div>
+          <div class="nav-item block highlight unlink">
+            <div class="nav-text notice">FLL Specification</div>
+            <div class="nav-text unlink">Time and EpochTime</div>
+          </div>
+          <div class="nav-item block">
+            <a href="fll/specifications/other/time.html#time" class="nav-text link">Time</a>
+          </div>
+          <div class="nav-item block">
+            <a href="fll/specifications/other/time.html#epochtime" class="nav-text link">EpochTime</a>
+          </div>
+          <div class="nav-item block ellipses">
+            <a href="fll/specifications/other/time.html#nav-expanded" class="nav-text link open" title="Expand Menu">…</a>
+            <a href="fll/specifications/other/time.html" class="nav-text link close">Collapse Menu</a>
+          </div>
+        </nav>
+      </div>
+
+      <div role="document" class="main-block">
+        <main class="main">
+          <header class="section-header header">
+            <h1 class="section-title h h1">Featureless Linux Library Specification</h1>
+          </header>
+
+          <section id="time_epochtime" class="section">
+            <header class="section-header header">
+              <h2 class="section-title h h2">Time and EpochTime</h2>
+            </header>
+
+            <div class="section-content">
+              <p class="p">
+                There are two units of <strong class="strong">Time</strong>, the first is simply called <strong class="strong">Time</strong> and the second is called <strong class="strong">EpochTime</strong>.
+              </p>
+              <p class="p">
+                Both <strong class="strong">Time</strong> and <strong class="strong">EpochTime</strong> are measured without the year but may contain a year to designate the point in the counting begins.
+                These are both represented by a single 64-bit (unsigned) integer.
+                The default timezone is always <abbr title="Coordinated Universal Time">UTC</abbr>.
+              </p>
+              <p class="p">
+                The common form is intended as the non-technical form that is form common use.
+                This may have a negative value or be more than 64-bit digits long.
+                This is simply not expected to be interpreted as a unit of time on a computer (but nothing stops it from being interpreted).
+              </p>
+              <p class="p">
+                The technical forms are limit to 64-bit unsigned for technical use but should technology advance to a point where larger bits are needed then this allows for that.
+                The systems should expect 64-bit and larger bits would have to become common before something larger than 64-bit is the expected or assumed default.
+                Negative signs can be allowed but they must not prevent the full use of the 64-bit.
+                The implementation of how this is done is left to the implementer except that the signs are immediately to the left of the digit.
+                For example <code class="code">2022:-5</code> would be 5 units after the start of the year 2022.
+                Because the negative is allowed, so must the positive character (such as <code class="code">2022:+5</code>).
+                A positive value is the default interpretation when no sign is valid.
+              </p>
+            </div>
+          </section>
+
+          <section id="time" class="section">
+            <header class="section-header header separate">
+              <h2 class="section-title h h2">Time</h2>
+            </header>
+
+            <div class="section-content">
+              <p class="p">
+                The unit of time called <strong class="strong">Time</strong> is counted increments of a nanosecond, or 10^-9 seconds.
+                A unit of <strong class="strong">Time</strong> is, therefore, equivalent to a nanosecond.
+                The default year for <strong class="strong">Time</strong> is the current year.
+              </p>
+              <p class="p">
+                The unit <strong class="strong">Time</strong> has two technical forms and one common form, with the year and without the year.
+              </p>
+              <p class="p">
+                Key:
+              </p>
+              <ul>
+                <li><code class="code">\s</code> = White space.</li>
+                <li><code class="code">\d</code> = The digits used to represent time (a digit).</li>
+                <li><code class="code">*</code> = Zero or more occurrences.</li>
+                <li><code class="code">+</code> = One or more occurrences.</li>
+                <li><code class="code">:</code> = A single colon <code class="code">:</code> (<code class="code">U+003A</code>).</li>
+                <li><code class="code">"</code> = A single double-quote <code class="code">"</code> (<code class="code">U+003A</code>).</li>
+              </ul>
+              <p class="p">
+                The common form of <strong class="strong">Time</strong>:
+              </p>
+              <p class="p">
+                Before Structure:
+              </p>
+              <ul>
+                <li><code class="code"></code></li>
+              </ul>
+              <p class="p">
+                Structure:
+              </p>
+              <ul>
+                <li><code class="code">\s*\d+\s*\U*\s*</code></li>
+              </ul>
+              <p class="p">
+                After Structure:
+              </p>
+              <ul>
+                <li><code class="code"></code></li>
+              </ul>
+              <p class="p">
+                Example:
+              </p>
+              <ul>
+                <li><code class="code">86400</code></li>
+                <li><code class="code">86400 T</code></li>
+                <li><code class="code">86400 Time</code></li>
+              </ul>
+              <p class="p">
+                The first technical form of <strong class="strong">Time</strong>:
+              </p>
+              <p class="p">
+                Before Structure:
+              </p>
+              <ul>
+                <li><code class="code"></code></li>
+              </ul>
+              <p class="p">
+                Structure:
+              </p>
+              <ul>
+                <li><code class="code">\s*\d+:\d+\s*\U*\s*</code></li>
+              </ul>
+              <p class="p">
+                After Structure:
+              </p>
+              <ul>
+                <li><code class="code"></code></li>
+              </ul>
+              <p class="p">
+                Example:
+              </p>
+              <ul>
+                <li><code class="code">2022:86400</code></li>
+                <li><code class="code">2022:86400 T</code></li>
+                <li><code class="code">2022:86400 Time</code></li>
+                <li><code class="code">2022:86400 MT</code></li>
+                <li><code class="code">2022:86400 MegaTime</code></li>
+              </ul>
+              <p class="p">
+                The second technical form of <strong class="strong">Time</strong>:
+              </p>
+              <p class="p">
+                Before Structure:
+              </p>
+              <ul>
+                <li><code class="code"></code></li>
+              </ul>
+              <p class="p">
+                Structure:
+              </p>
+              <ul>
+                <li><code class="code">\s*:\d+\s*\U*\s*</code></li>
+              </ul>
+              <p class="p">
+                After Structure:
+              </p>
+              <ul>
+                <li><code class="code"></code></li>
+              </ul>
+              <p class="p">
+                Example:
+              </p>
+              <ul>
+                <li><code class="code">:86400</code></li>
+                <li><code class="code">:86400 T</code></li>
+                <li><code class="code">:86400 Time</code></li>
+                <li><code class="code">:86400 MT</code></li>
+                <li><code class="code">:86400 MegaTime</code></li>
+              </ul>
+            </div>
+          </section>
+
+          <section id="epochtime" class="section">
+            <header class="section-header header separate">
+              <h2 class="section-title h h2">EpochTime</h2>
+            </header>
+
+            <div class="section-content">
+              <p class="p">
+                The unit of time called <strong class="strong">EpochTime</strong> is counted increments of a second, or 10^-9 seconds.
+                A unit of <strong class="strong">EpochTime</strong> is, therefore, equivalent to a second.
+                The default year for <strong class="strong">EpochTime</strong> is the <strong class="strong">UNIX Epoch</strong>, sometimes called <strong class="strong">Unix time</strong>.
+              </p>
+              <p class="p">
+                The unit <strong class="strong">EpochTime</strong> has two technical forms and one common form, with the year and without the year.
+              </p>
+              <p class="p">
+                The common form of <strong class="strong">EpochTime</strong>:
+              </p>
+              <p class="p">
+                Before Structure:
+              </p>
+              <ul>
+                <li><code class="code"></code></li>
+              </ul>
+              <p class="p">
+                Structure:
+              </p>
+              <ul>
+                <li><code class="code">\s*\d+\s*\U*\s*</code></li>
+              </ul>
+              <p class="p">
+                After Structure:
+              </p>
+              <ul>
+                <li><code class="code"></code></li>
+              </ul>
+              <p class="p">
+                Example:
+              </p>
+              <ul>
+                <li><code class="code">86400</code></li>
+                <li><code class="code">86400 ET</code></li>
+                <li><code class="code">86400 EpochTime</code></li>
+                <li><code class="code">86400 MET</code></li>
+                <li><code class="code">86400 MegaEpochTime</code></li>
+              </ul>
+              <p class="p">
+                The first technical form of <strong class="strong">EpochTime</strong>:
+              </p>
+              <p class="p">
+                Before Structure:
+              </p>
+              <ul>
+                <li><code class="code"></code></li>
+              </ul>
+              <p class="p">
+                Structure:
+              </p>
+              <ul>
+                <li><code class="code">\s*\d+::\d+\s*\U*\s*</code></li>
+              </ul>
+              <p class="p">
+                After Structure:
+              </p>
+              <ul>
+                <li><code class="code"></code></li>
+              </ul>
+              <p class="p">
+                Example:
+              </p>
+              <ul>
+                <li><code class="code">2022::86400</code></li>
+                <li><code class="code">2022::86400 ET</code></li>
+                <li><code class="code">2022::86400 EpochTime</code></li>
+                <li><code class="code">2022::86400 MET</code></li>
+                <li><code class="code">2022::86400 MegaEpochTime</code></li>
+              </ul>
+              <p class="p">
+                The second technical form of <strong class="strong">Time</strong>:
+              </p>
+              <p class="p">
+                Before Structure:
+              </p>
+              <ul>
+                <li><code class="code"></code></li>
+              </ul>
+              <p class="p">
+                Structure:
+              </p>
+              <ul>
+                <li><code class="code">\s*:\d+\s*\U*\s*</code></li>
+              </ul>
+              <p class="p">
+                After Structure:
+              </p>
+              <ul>
+                <li><code class="code"></code></li>
+              </ul>
+              <p class="p">
+                Example:
+              </p>
+              <ul>
+                <li><code class="code">::86400</code></li>
+                <li><code class="code">::86400 ET</code></li>
+                <li><code class="code">::86400 EpochTime</code></li>
+                <li><code class="code">::86400 MET</code></li>
+                <li><code class="code">::86400 MegaEpochTime</code></li>
+              </ul>
+            </div>
+          </section>
+        </main>
+      </div>
+    </div>
+  </body>
+</html>