summaryrefslogtreecommitdiff
path: root/docs/archive/manpage_nixtamal-manifest.5.html
diff options
context:
space:
mode:
authorJohn Bargman2026-04-15 08:23:09 +0000
committerJohn Bargman2026-04-15 08:23:09 +0000
commitdb6b79edbfca3ab7049af2492acd567b099559f5 (patch)
treef54df4a8af70b057032e5af882bd6d1e6be87bf2 /docs/archive/manpage_nixtamal-manifest.5.html
parent4f877207787edd592687f338772d95c9ec2c7038 (diff)
downloadnixtaml-website-db6b79edbfca3ab7049af2492acd567b099559f5.tar
nixtaml-website-db6b79edbfca3ab7049af2492acd567b099559f5.tar.gz
nixtaml-website-db6b79edbfca3ab7049af2492acd567b099559f5.tar.bz2
nixtaml-website-db6b79edbfca3ab7049af2492acd567b099559f5.tar.lz
nixtaml-website-db6b79edbfca3ab7049af2492acd567b099559f5.tar.xz
nixtaml-website-db6b79edbfca3ab7049af2492acd567b099559f5.tar.zst
nixtaml-website-db6b79edbfca3ab7049af2492acd567b099559f5.zip
agentic ai; is so; fucking cool; omgmain
Diffstat (limited to 'docs/archive/manpage_nixtamal-manifest.5.html')
-rw-r--r--docs/archive/manpage_nixtamal-manifest.5.html1361
1 files changed, 1361 insertions, 0 deletions
diff --git a/docs/archive/manpage_nixtamal-manifest.5.html b/docs/archive/manpage_nixtamal-manifest.5.html
new file mode 100644
index 0000000..31314cc
--- /dev/null
+++ b/docs/archive/manpage_nixtamal-manifest.5.html
@@ -0,0 +1,1361 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <meta name="color-scheme" content="dark light">
+ <title>
+ Nixtamal Manifest(5)() | Nixtamal
+ </title>
+ <meta content="" name="robots">
+ <meta content="" name="author">
+ <meta content="" name="description">
+ <meta content="" name="keywords">
+ <title></title>
+ <meta name="generator" content="soupault">
+ <meta name="viewport" content="width=device-width,initial-scale=1">
+ <meta http-equiv="X-XSS-Protection" content="1;mode=block">
+ <meta http-equiv="X-Content-Type-Options" content="nosniff">
+ <meta http-equiv="Content-Security-Policy" content="default-src 'self';">
+ <meta http-equiv="Referrer-Policy" content="strict-origin-when-cross-origin">
+ <meta name="theme" content="crimson">
+ <link rel="icon" type="image/svg+xml" href="/asset/_hashed/nixtamal/image/nixtamal-logo-gmxzsw8388sf9paq05xws7an4hnl4nx0.svg">
+ <link rel="stylesheet" href="/asset/_hashed/nixtamal/style/font-j47xx20z5d89qpsl95nnbipkg6d25m6y.css">
+ <link rel="stylesheet" href="/asset/_hashed/sugilite256/chroma-light-yfrfnk1zyqm9dc67gaa5y67s0a6x40ji.css">
+ <link rel="stylesheet" href="/asset/_hashed/sugilite256/chroma-dark-s4ssx3zwz2w418zx7pkrqlwqmywgvahl.css" media="(prefers-color-scheme: dark)">
+ <link rel="stylesheet" href="/asset/_hashed/nixtamal/style/main-lmdn1rci18371fnrcqrwga636ip08irz.css">
+ <link rel="author" href="/humans.txt">
+ </head>
+ <body itemscope="" itemtype="https://schema.org/WebSite">
+ <link itemprop="url" href="https://toast.al/">
+ <meta itemprop="name" content="toastal">
+ <link itemprop="publisher" href="#Maker">
+ <div id="DocWrapper" class="DocWrapper">
+ <div class="Banner-wrapper">
+ <header id="Banner" class="Banner">
+ <pre role="none" class="Banner-flair">┏┓╻+╻ ╱┏┳┓┏┓┏┳┓┏┓╻
+┃┃┃┃┗━┓╹┃╹┣┫┃┃┃┣┫┃
+╹┗┛╹╱ ╹ ╹ ╹╹╹ ╹╹╹┗┛</pre>
+ <a href="/" class="SiteLogo" title="Home">
+ <svg viewbox="0 0 79.375 27.099415" class="SiteLogo-image" role="img" aria-labelledby="SiteLogo-desc">
+ <use href="/asset/_hashed/nixtamal/image/nixtamal-logo-gmxzsw8388sf9paq05xws7an4hnl4nx0.svg#logo">
+ <desc id="SiteLogo-desc">
+ Home
+ </desc>
+ </use>
+ </svg>
+ </a>
+ <nav id="Navigation" class="Banner-navigation Navigation Navigation--banner" aria-expanded="true">
+ <a class="Navigation-item" href="/install/">Install</a>
+ <a class="Navigation-item" href="/manpage/">Manpage</a>
+ <a class="Navigation-item" href="/changelog/">Changelog</a>
+ <a class="Navigation-item" href="/roadmap/">Roadmap</a>
+ <a class="Navigation-item" href="/cookbook/">Cookbook</a>
+ <a class="Navigation-item" href="/real-world-showcase/">Real-world showcase</a>
+
+ <a class="Navigation-item" href="/community/">Community</a>
+ <a class="Navigation-item" href="/faqs/"><abbr title="frequently asked questions">FAQs</abbr></a>
+ <a class="Navigation-item" href="/funding/">Funding</a>
+ </nav>
+ </header>
+ <hr class="Banner-separator">
+ </div>
+ <main id="Main" class="Main">
+ <div class="Headline">
+ <h1 itemprop="headline">
+ Nixtamal Manifest(5)()
+ </h1>
+ </div>
+ <div class="manual-text">
+ <section class="Sh">
+ <h2 class="Sh" id="Name">
+ <a class="permalink" href="#Name">Name</a>
+ </h2>
+ <p class="Pp">
+ Nixtamal Manifest(5) - Setting up for pinning down inputs
+ </p>
+ </section>
+ <section class="Sh">
+ <h2 class="Sh" id="Synopsis">
+ <a class="permalink" href="#Synopsis">Synopsis</a>
+ </h2>
+ <p class="Pp">
+ Nixtamal uses KDL for its manifest describing inputs. At the
+ highest level, this includes:
+ </p>
+ <div class="Bd-indent">
+ <ul class="Bl-bullet">
+ <li>
+ manifest version
+ </li>
+ <li>
+ default hashing algorithm
+ </li>
+ <li>
+ patches (optional)
+ </li>
+ <li>
+ list of inputs
+ </li>
+ </ul>
+ <div class="Bd-indent">
+ <div class="Bd-indent">
+ <div class="Bd-indent">
+ <ul class="Bl-bullet">
+ <li>
+ the input kind &amp; its specific attributes
+ </li>
+ <li>
+ a command to check if ‘fresh’
+ </li>
+ <li>
+ hashing information
+ </li>
+ <li>
+ patches to apply to the input
+ </li>
+ </ul>
+ </div>
+ <br>
+ </div>
+ <br>
+ </div>
+ <br>
+ </div>
+ <br>
+ <p class="Pp">
+ <b>Note:</b>
+ </p>
+ <div class="Bd-indent">
+ <div class="Bd-indent">
+ A KDL Schema file is shipped alongside this documentation
+ for use with schema-aware editors and validators. It can be found in the
+ installation directory under <b>share/nixtamal/manifest.kdl</b>.
+ </div>
+ <br>
+ </div>
+ <br>
+ </section>
+ <section class="Sh">
+ <h2 class="Sh" id="Default_manifest.kdl">
+ <a class="permalink" href="#Default_manifest.kdl">Default
+ manifest.kdl</a>
+ </h2>
+ <div class="Bd-indent">
+ <div class="Bd-indent">
+ <p class="Pp"></p>
+ <pre>version "0.5.0"
+inputs {
+
+ nixpkgs {
+
+ archive {
+
+ url "https://github.com/NixOS/nixpkgs/archive/{{fresh_value}}.tar.gz"
+
+ }
+
+ hash algorithm=SHA-256
+
+ fetch-time eval
+
+ fresh-cmd {
+
+ $ git ls-remote "https://github.com/NixOS/nixpkgs.git" --refs "refs/heads/nixos-unstable"
+
+ | cut -f1
+
+ }
+
+ }
+}
+</pre>
+ </div>
+ <br>
+ </div>
+ <br>
+ </section>
+ <section class="Sh">
+ <h2 class="Sh" id="Top-level_nodes">
+ <a class="permalink" href="#Top-level_nodes">Top-level
+ nodes</a>
+ </h2>
+ <div class="Bd-indent">
+ <dl class="Bl-tag">
+ <dt id="version">
+ <a class="permalink" href="#version"><b><b>version</b></b></a>
+ </dt>
+ <dd>
+ Version of the Nixtamal spec the <b>manifest.kdl</b> is using.
+ </dd>
+ <dt id="default">
+ <a class="permalink" href="#default"><b><b>default-hash-algorithm</b></b></a>
+ </dt>
+ <dd>
+ Hash algorithm to use by default for inputs when the input does not note
+ its hash algorithm. Defaults to <b>SHA-256</b>.
+ </dd>
+ <dt id="patches">
+ <a class="permalink" href="#patches"><b><b>patches</b></b></a>
+ </dt>
+ <dd>
+ Map of patches to be applied to inputs where the patch name should be
+ unique. Each patch has a URL (first argument). See Patches.
+ </dd>
+ <dt id="default~2">
+ <a class="permalink" href="#default~2"><b><b>default-fetch-time</b></b></a>
+ </dt>
+ <dd>
+ Default fetch time for inputs when not specified at the input level. Can
+ be <b>eval</b> (fetch during Nix evaluation using <b>builtins.fetch*</b>)
+ or <b>build</b> (fetch during build using <b>pkgs.fetch*</b>). Defaults to
+ <b>eval</b>.
+ </dd>
+ <dt id="inputs">
+ <a class="permalink" href="#inputs"><b><b>inputs</b></b></a>
+ </dt>
+ <dd>
+ Map of inputs to be pinned where the input+node name should be unique
+ &amp; will be used in the Nix output as well as logs &amp; errors. See
+ Input node.
+ </dd>
+ </dl>
+ </div>
+ <br>
+ </section>
+ <section class="Sh">
+ <h2 class="Sh" id="Fetch_Time">
+ <a class="permalink" href="#Fetch_Time">Fetch
+ Time</a>
+ </h2>
+ <p class="Pp">
+ Inputs can be fetched either during Nix evaluation or during build
+ time:
+ </p>
+ <div class="Bd-indent">
+ <dl class="Bl-tag">
+ <dt id="eval">
+ <a class="permalink" href="#eval"><b><b>eval</b></b></a>
+ </dt>
+ <dd>
+ Fetch the input during Nix evaluation using <b>builtins.fetch*</b>
+ functions. This is the default behavior and is suitable for inputs that
+ need to be available during evaluation, such as the bootstrap
+ Nixpkgs.
+ </dd>
+ <dt id="build">
+ <a class="permalink" href="#build"><b><b>build</b></b></a>
+ </dt>
+ <dd>
+ Fetch the input during build time using <b>pkgs.fetch*</b> functions. This
+ is suitable for most inputs and allows for better caching and parallel
+ fetching.
+ </dd>
+ </dl>
+ </div>
+ <br>
+ <p class="Pp">
+ The fetch time can be set globally using <b>default-fetch-time</b>
+ or per-input using the <b>fetch-time</b> property on <b>file</b>,
+ <b>archive</b>, and <b>git</b> input types.
+ </p>
+ <p class="Pp">
+ <b>Caution!:</b>
+ </p>
+ <div class="Bd-indent">
+ <div class="Bd-indent">
+ Inputs with patches cannot use <b>eval</b> fetch time, as
+ patches are applied during build time. The system will automatically enforce
+ this constraint.
+ </div>
+ <br>
+ </div>
+ <br>
+ </section>
+ <section class="Sh">
+ <h2 class="Sh" id="Patches">
+ <a class="permalink" href="#Patches">Patches</a>
+ </h2>
+ <p class="Pp">
+ Patches are defined at the top-level and can be applied to any
+ input. This allows defining a patch once and applying it to multiple
+ inputs.
+ </p>
+ <div class="Bd-indent">
+ <dl class="Bl-tag">
+ <dt id="url">
+ <a class="permalink" href="#url"><b><b>url</b></b></a>
+ </dt>
+ <dd>
+ Templated node URL or file reference for the patch. Supports
+ <b>https://</b>, <b>http://</b>, and <b>file://</b> URLs.
+ </dd>
+ <dt id="hash">
+ <a class="permalink" href="#hash"><b><b>hash</b></b></a>
+ </dt>
+ <dd>
+ Optional node for hash algorithm information. The <b>algorithm</b>
+ property will be used when prefetching, locking, &amp; for integrity
+ verification. The optional <b>expected</b> property may be used to assert
+ a known hash. If not specified, no hash verification is performed.
+ Defaults to the top-level <b>default-hash-algorithm</b> or
+ <b>SHA-256</b>.
+ </dd>
+ </dl>
+ </div>
+ <br>
+ </section>
+ <section class="Sh">
+ <h2 class="Sh" id="Input_node">
+ <a class="permalink" href="#Input_node">Input
+ node</a>
+ </h2>
+ <p class="Pp">
+ At a high level these should be seen as
+ </p>
+ <div class="Bd-indent">
+ <dl class="Bl-tag">
+ <dt id="prop:">
+ <a class="permalink" href="#prop:"><b>prop:
+ <i>frozen</i></b></a>
+ </dt>
+ <dd>
+ A boolean (<b>frozen=#true</b>) that prevents trying refresh or otherwise
+ get a new fresh value for this input.
+ </dd>
+ <dt>
+ <b>“kind”</b>
+ </dt>
+ <dd>
+ There are specific nodes for each different type of supported
+ fetchers/prefetchers: <b>file</b>, <b>archive</b>, <b>git</b>,
+ <b>darcs</b>, <b>pijul</b>, <b>fossil</b> (with more to come in the
+ future).
+ </dd>
+ <dt id="hash~2">
+ <a class="permalink" href="#hash~2"><b><b>hash</b></b></a>
+ </dt>
+ <dd>
+ An optional node for hash algorithm information for a input. The
+ <b>algorithm</b> property will be used when prefetching, locking, &amp;
+ for importing (which falls back to top-level <b>default-hash-algorithm</b>
+ or defined default <b>SHA-256</b>). The optional <b>expected</b> property
+ may be used to assert a known hash.
+ <p class="Pp">
+ <b>Caution!:</b>
+ </p>
+ </dd>
+ </dl>
+ <div class="Bd-indent">
+ <div class="Bd-indent">
+ The bootstrapping Nixpkgs pin (either manually set or
+ using <b>nixpkgs-nixtamal</b> or <b>nixpkgs</b> as defaults) <i>must</i> be
+ SHA-256 to be compatible with <b>builtins.fetchTarball</b>.
+ </div>
+ <br>
+ </div>
+ <br>
+ <dl class="Bl-tag">
+ <dt id="fresh">
+ <a class="permalink" href="#fresh"><b><b>fresh-cmd</b></b></a>
+ </dt>
+ <dd>
+ Command (with or without pipes using <b>$</b> &amp; <b>|</b> nodes) that
+ can shelled out to to return a string that will be locked as the fresh
+ command value which can be used both to prevent unnecessary prefectching,
+ but also for use in a Templated node.
+ </dd>
+ <dt id="patches~2">
+ <a class="permalink" href="#patches~2"><b><b>patches</b></b></a>
+ </dt>
+ <dd>
+ List of patch names (as arguments) to apply to this input. Patches are
+ defined at the top-level in the Patches section.
+ </dd>
+ </dl>
+ </div>
+ <br>
+ <section class="Ss">
+ <h3 class="Ss" id="File">
+ <a class="permalink" href="#File">File</a>
+ </h3>
+ <div class="Bd-indent">
+ <dl class="Bl-tag">
+ <dt id="prop:~2">
+ <a class="permalink" href="#prop:~2"><b>prop:
+ <b>fetch-time</b></b></a>
+ </dt>
+ <dd>
+ Property to set when to fetch this input: <b>eval</b> or <b>build</b>.
+ Defaults to the top-level <b>default-fetch-time</b> or <b>build</b>.
+ </dd>
+ <dt id="url~2">
+ <a class="permalink" href="#url~2"><b><b>url</b></b></a>
+ </dt>
+ <dd>
+ Templated node URL reference for the input
+ </dd>
+ <dt id="mirrors">
+ <a class="permalink" href="#mirrors"><b><b>mirrors</b></b></a>
+ </dt>
+ <dd>
+ Templated node URL mirror references for the input
+ </dd>
+ </dl>
+ </div>
+ <br>
+ </section>
+ <section class="Ss">
+ <h3 class="Ss" id="Archive">
+ <a class="permalink" href="#Archive">Archive</a>
+ </h3>
+ <div class="Bd-indent">
+ <dl class="Bl-tag">
+ <dt id="prop:~3">
+ <a class="permalink" href="#prop:~3"><b>prop:
+ <b>fetch-time</b></b></a>
+ </dt>
+ <dd>
+ Property to set when to fetch this input: <b>eval</b> or <b>build</b>.
+ Defaults to the top-level <b>default-fetch-time</b> or <b>build</b>.
+ </dd>
+ <dt id="url~3">
+ <a class="permalink" href="#url~3"><b><b>url</b></b></a>
+ </dt>
+ <dd>
+ Templated node URL reference for the input
+ </dd>
+ <dt id="mirrors~2">
+ <a class="permalink" href="#mirrors~2"><b><b>mirrors</b></b></a>
+ </dt>
+ <dd>
+ Templated node URL mirror references for the input
+ </dd>
+ </dl>
+ </div>
+ <br>
+ </section>
+ <section class="Ss">
+ <h3 class="Ss" id="Git">
+ <a class="permalink" href="#Git">Git</a>
+ </h3>
+ <div class="Bd-indent">
+ <dl class="Bl-tag">
+ <dt id="prop:~4">
+ <a class="permalink" href="#prop:~4"><b>prop:
+ <b>fetch-time</b></b></a>
+ </dt>
+ <dd>
+ Property to set when to fetch this input: <b>eval</b> or <b>build</b>.
+ Defaults to the top-level <b>default-fetch-time</b> or <b>build</b>.
+ </dd>
+ <dt id="repository">
+ <a class="permalink" href="#repository"><b><b>repository</b></b></a>
+ </dt>
+ <dd>
+ Templated node repository reference for the input
+ </dd>
+ <dt id="mirrors~3">
+ <a class="permalink" href="#mirrors~3"><b><b>mirrors</b></b></a>
+ </dt>
+ <dd>
+ Templated node repository mirror references for the input
+ <p class="Pp">
+ <b>Warning:</b>
+ </p>
+ </dd>
+ </dl>
+ <div class="Bd-indent">
+ <div class="Bd-indent">
+ Probably not yet supported upstream.
+ </div>
+ <br>
+ </div>
+ <br>
+ <dl class="Bl-tag">
+ <dt>
+ <b>"reference"</b>
+ </dt>
+ <dd>
+ <b>branch</b> <i>or</i> <b>tag</b> <i>or</i> <b>ref</b> node as the
+ reference point for getting stable reference. <b>tag</b> provides
+ convenience over using <b>ref</b> with full tag paths.
+ </dd>
+ <dt id="submodules">
+ <a class="permalink" href="#submodules"><b><b>submodules</b></b></a>
+ </dt>
+ <dd>
+ Leaf node for enabling submodules on a repository
+ </dd>
+ <dt id="lfs">
+ <a class="permalink" href="#lfs"><b><b>lfs</b></b></a>
+ </dt>
+ <dd>
+ Leaf node for enabling Git LFS on a repository
+ </dd>
+ </dl>
+ </div>
+ <br>
+ </section>
+ <section class="Ss">
+ <h3 class="Ss" id="Darcs">
+ <a class="permalink" href="#Darcs">Darcs</a>
+ </h3>
+ <div class="Bd-indent">
+ <dl class="Bl-tag">
+ <dt id="repository~2">
+ <a class="permalink" href="#repository~2"><b><b>repository</b></b></a>
+ </dt>
+ <dd>
+ Templated node repository reference for the input
+ </dd>
+ <dt id="mirrors~4">
+ <a class="permalink" href="#mirrors~4"><b><b>mirrors</b></b></a>
+ </dt>
+ <dd>
+ Templated node repository mirror references for the input
+ <p class="Pp">
+ <b>Note:</b>
+ </p>
+ </dd>
+ </dl>
+ <div class="Bd-indent">
+ <div class="Bd-indent">
+ Recently upstreamed. See:
+ &lt;https://github.com/NixOS/nixpkgs/pull/467172&gt;
+ </div>
+ <br>
+ </div>
+ <br>
+ <dl class="Bl-tag">
+ <dt>
+ <b>“reference”</b>
+ </dt>
+ <dd>
+ <b>context</b> <i>or</i> <b>tag</b> node as the reference point for
+ getting stable reference; in the case of Darcs, if neither is supplied a
+ <b>context</b> will be assumed &amp; copied from
+ <b>nix-prefetch-darcs</b>
+ </dd>
+ </dl>
+ </div>
+ <br>
+ </section>
+ <section class="Ss">
+ <h3 class="Ss" id="Pijul">
+ <a class="permalink" href="#Pijul">Pijul</a>
+ </h3>
+ <div class="Bd-indent">
+ <dl class="Bl-tag">
+ <dt id="remote">
+ <a class="permalink" href="#remote"><b><b>remote</b></b></a>
+ </dt>
+ <dd>
+ Templated node remote reference for the input
+ </dd>
+ <dt id="mirrors~5">
+ <a class="permalink" href="#mirrors~5"><b><b>mirrors</b></b></a>
+ </dt>
+ <dd>
+ Templated node remote mirror references for the input
+ <p class="Pp">
+ <b>Note:</b>
+ </p>
+ </dd>
+ </dl>
+ <div class="Bd-indent">
+ <div class="Bd-indent">
+ Recently upstreamed. See:
+ &lt;https://github.com/NixOS/nixpkgs/pull/467890&gt;
+ </div>
+ <br>
+ </div>
+ <br>
+ <dl class="Bl-tag">
+ <dt>
+ <b>“reference”</b>
+ </dt>
+ <dd>
+ <b>channel</b> <i>or</i> <b>state</b> <i>or</i> <b>change</b> (not
+ recommended) node as the reference point for getting stable reference; if
+ unsure, try <b>channel</b> <b>main</b>
+ </dd>
+ </dl>
+ </div>
+ <br>
+ </section>
+ <section class="Ss">
+ <h3 class="Ss" id="Fossil">
+ <a class="permalink" href="#Fossil">Fossil</a>
+ </h3>
+ <div class="Bd-indent">
+ <dl class="Bl-tag">
+ <dt id="repository~3">
+ <a class="permalink" href="#repository~3"><b><b>repository</b></b></a>
+ </dt>
+ <dd>
+ Templated node repository reference for the input
+ </dd>
+ <dt>
+ <b>“reference”</b>
+ </dt>
+ <dd>
+ <b>branch</b> <i>or</i> <b>tag</b> <i>or</i> <b>check-in</b> node as the
+ reference point for getting stable reference
+ </dd>
+ </dl>
+ </div>
+ <br>
+ </section>
+ </section>
+ <section class="Sh">
+ <h2 class="Sh" id="Templated_node">
+ <a class="permalink" href="#Templated_node">Templated
+ node</a>
+ </h2>
+ <p class="Pp">
+ Some nodes have values with string substitution via Jingoo
+ &lt;https://tategakibunko.github.io/jingoo/templates/templates.en.html&gt;,
+ which is probably overkill, but could give you flexibilty with <b>if</b>
+ statements. The templated nodes include:
+ </p>
+ <div class="Bd-indent">
+ <ul class="Bl-bullet">
+ <li>
+ <b>inputs &gt;&gt; file &gt; url</b>
+ </li>
+ <li>
+ <b>inputs &gt;&gt; file &gt; mirrors</b>
+ </li>
+ <li>
+ <b>inputs &gt;&gt; archive &gt; url</b>
+ </li>
+ <li>
+ <b>inputs &gt;&gt; archive &gt; mirrors</b>
+ </li>
+ <li>
+ <b>inputs &gt;&gt; git &gt; repository</b>
+ </li>
+ <li>
+ <b>inputs &gt;&gt; git &gt; mirrors</b>
+ </li>
+ <li>
+ <b>inputs &gt;&gt; darcs &gt; repository</b>
+ </li>
+ <li>
+ <b>inputs &gt;&gt; darcs &gt; mirrors</b>
+ </li>
+ <li>
+ <b>inputs &gt;&gt; pijul &gt; remote</b>
+ </li>
+ <li>
+ <b>inputs &gt;&gt; pijul &gt; mirrors</b>
+ </li>
+ <li>
+ <b>inputs &gt;&gt; fossil &gt; repository</b>
+ </li>
+ <li>
+ <b>inputs &gt;&gt; fresh-cmd &gt; $</b>
+ </li>
+ <li>
+ <b>inputs &gt;&gt; fresh-cmd &gt; |</b>
+ </li>
+ </ul>
+ </div>
+ <br>
+ <p class="Pp">
+ The input kind affects the values for substition:
+ </p>
+ </section>
+ <section class="Sh">
+ <h2 class="Sh" id="file">
+ <a class="permalink" href="#file">file</a>
+ </h2>
+ <table class="tbl" style="border-style: solid;">
+ <tbody>
+ <tr style="border-bottom-style: solid;">
+ <td style="border-right-style: solid;">
+ Key
+ </td>
+ <td style="border-right-style: solid;">
+ Type
+ </td>
+ <td>
+ Description
+ </td>
+ </tr>
+ <tr style="border-bottom-style: solid;">
+ <td style="border-right-style: solid;">
+ <b>name</b>
+ </td>
+ <td style="border-right-style: solid;">
+ string
+ </td>
+ <td>
+ input name
+ </td>
+ </tr>
+ <tr>
+ <td style="border-right-style: solid;">
+ <b>fresh_value</b>
+ </td>
+ <td style="border-right-style: solid;">
+ string nullable
+ </td>
+ <td>
+ fresh command return value
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ <section class="Sh">
+ <h2 class="Sh" id="archive">
+ <a class="permalink" href="#archive">archive</a>
+ </h2>
+ <table class="tbl" style="border-style: solid;">
+ <tbody>
+ <tr style="border-bottom-style: solid;">
+ <td style="border-right-style: solid;">
+ Key
+ </td>
+ <td style="border-right-style: solid;">
+ Type
+ </td>
+ <td>
+ Description
+ </td>
+ </tr>
+ <tr style="border-bottom-style: solid;">
+ <td style="border-right-style: solid;">
+ <b>name</b>
+ </td>
+ <td style="border-right-style: solid;">
+ string
+ </td>
+ <td>
+ input name
+ </td>
+ </tr>
+ <tr>
+ <td style="border-right-style: solid;">
+ <b>fresh_value</b>
+ </td>
+ <td style="border-right-style: solid;">
+ string nullable
+ </td>
+ <td>
+ fresh command return value
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ <section class="Sh">
+ <h2 class="Sh" id="git">
+ <a class="permalink" href="#git">git</a>
+ </h2>
+ <table class="tbl" style="border-style: solid;">
+ <tbody>
+ <tr style="border-bottom-style: solid;">
+ <td style="border-right-style: solid;">
+ Key
+ </td>
+ <td style="border-right-style: solid;">
+ Type
+ </td>
+ <td>
+ Description
+ </td>
+ </tr>
+ <tr style="border-bottom-style: solid;">
+ <td style="border-right-style: solid;">
+ <b>name</b>
+ </td>
+ <td style="border-right-style: solid;">
+ string
+ </td>
+ <td>
+ input name
+ </td>
+ </tr>
+ <tr style="border-bottom-style: solid;">
+ <td style="border-right-style: solid;">
+ <b>fresh_value</b>
+ </td>
+ <td style="border-right-style: solid;">
+ string nullable
+ </td>
+ <td>
+ fresh command return value
+ </td>
+ </tr>
+ <tr style="border-bottom-style: solid;">
+ <td style="border-right-style: solid;">
+ <b>branch</b>
+ </td>
+ <td style="border-right-style: solid;">
+ string nullable
+ </td>
+ <td>
+ branch name
+ </td>
+ </tr>
+ <tr style="border-bottom-style: solid;">
+ <td style="border-right-style: solid;">
+ <b>ref</b>
+ </td>
+ <td style="border-right-style: solid;">
+ string nullable
+ </td>
+ <td>
+ reference name
+ </td>
+ </tr>
+ <tr style="border-bottom-style: solid;">
+ <td style="border-right-style: solid;">
+ <b>datetime</b>
+ </td>
+ <td style="border-right-style: solid;">
+ string nullable
+ </td>
+ <td>
+ Datetime of latest revision
+ </td>
+ </tr>
+ <tr style="border-bottom-style: solid;">
+ <td style="border-right-style: solid;">
+ <b>lfs</b>
+ </td>
+ <td style="border-right-style: solid;">
+ bool
+ </td>
+ <td>
+ repository uses LFS
+ </td>
+ </tr>
+ <tr style="border-bottom-style: solid;">
+ <td style="border-right-style: solid;">
+ <b>submodules</b>
+ </td>
+ <td style="border-right-style: solid;">
+ bool
+ </td>
+ <td>
+ repository uses submodules
+ </td>
+ </tr>
+ <tr>
+ <td style="border-right-style: solid;">
+ <b>rev</b> / <b>revision</b>
+ </td>
+ <td style="border-right-style: solid;">
+ string nullable
+ </td>
+ <td>
+ latest revision
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ <section class="Sh">
+ <h2 class="Sh" id="darcs">
+ <a class="permalink" href="#darcs">darcs</a>
+ </h2>
+ <table class="tbl" style="border-style: solid;">
+ <tbody>
+ <tr style="border-bottom-style: solid;">
+ <td style="border-right-style: solid;">
+ Key
+ </td>
+ <td style="border-right-style: solid;">
+ Type
+ </td>
+ <td>
+ Description
+ </td>
+ </tr>
+ <tr style="border-bottom-style: solid;">
+ <td style="border-right-style: solid;">
+ <b>name</b>
+ </td>
+ <td style="border-right-style: solid;">
+ string
+ </td>
+ <td>
+ input name
+ </td>
+ </tr>
+ <tr style="border-bottom-style: solid;">
+ <td style="border-right-style: solid;">
+ <b>fresh_value</b>
+ </td>
+ <td style="border-right-style: solid;">
+ string nullable
+ </td>
+ <td>
+ fresh command return value
+ </td>
+ </tr>
+ <tr style="border-bottom-style: solid;">
+ <td style="border-right-style: solid;">
+ <b>context</b>
+ </td>
+ <td style="border-right-style: solid;">
+ string nullable
+ </td>
+ <td>
+ path to context file
+ </td>
+ </tr>
+ <tr style="border-bottom-style: solid;">
+ <td style="border-right-style: solid;">
+ <b>tag</b>
+ </td>
+ <td style="border-right-style: solid;">
+ string nullable
+ </td>
+ <td>
+ tag
+ </td>
+ </tr>
+ <tr style="border-bottom-style: solid;">
+ <td style="border-right-style: solid;">
+ <b>datetime</b>
+ </td>
+ <td style="border-right-style: solid;">
+ string nullable
+ </td>
+ <td>
+ datetime of latest patch
+ </td>
+ </tr>
+ <tr>
+ <td style="border-right-style: solid;">
+ <b>weak_hash</b>
+ </td>
+ <td style="border-right-style: solid;">
+ string nulla