docs/Lix/contributing/experimental-features/index.html

2349 lines
55 KiB
HTML

<!doctype html>
<html lang="en" class="no-js">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="description" content="Aux Documentation">
<meta name="author" content="Nixpkgs Aux, and Lix Contributors">
<link rel="canonical" href="https://docs.auxolotl.org/Lix/contributing/experimental-features/">
<link rel="prev" href="../cxx/">
<link rel="next" href="../hacking/">
<link rel="icon" href="../../../assets/aux-logo.svg">
<meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.29">
<title>What are experimental features? - Aux Docs</title>
<link rel="stylesheet" href="../../../assets/stylesheets/main.76a95c52.min.css">
<link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link rel="stylesheet" href="https://fonts.bunny.net/css?family=IBM+Plex+Sans:300,300i,400,400i,700,700i%7CIBM+Plex+Mono:400,400i,700,700i&display=fallback">
<style>:root{--md-text-font:"IBM Plex Sans";--md-code-font:"IBM Plex Mono"}</style>
<script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
<meta property="og:type" content="website" >
<meta property="og:title" content="What are experimental features? - Aux Docs" >
<meta property="og:description" content="Aux Documentation" >
<meta property="og:image" content="https://docs.auxolotl.org/assets/images/social/Lix/contributing/experimental-features.png" >
<meta property="og:image:type" content="image/png" >
<meta property="og:image:width" content="1200" >
<meta property="og:image:height" content="630" >
<meta property="og:url" content="https://docs.auxolotl.org/Lix/contributing/experimental-features/" >
<meta name="twitter:card" content="summary_large_image" >
<meta name="twitter:title" content="What are experimental features? - Aux Docs" >
<meta name="twitter:description" content="Aux Documentation" >
<meta name="twitter:image" content="https://docs.auxolotl.org/assets/images/social/Lix/contributing/experimental-features.png" >
</head>
<body dir="ltr" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="blue">
<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
<label class="md-overlay" for="__drawer"></label>
<div data-md-component="skip">
<a href="#what-are-experimental-features" class="md-skip">
Skip to content
</a>
</div>
<div data-md-component="announce">
</div>
<header class="md-header" data-md-component="header">
<nav class="md-header__inner md-grid" aria-label="Header">
<a href="../../.." title="Aux Docs" class="md-header__button md-logo" aria-label="Aux Docs" data-md-component="logo">
<img src="../../../assets/aux-logo.svg" alt="logo">
</a>
<label class="md-header__button md-icon" for="__drawer">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
</label>
<div class="md-header__title" data-md-component="header-title">
<div class="md-header__ellipsis">
<div class="md-header__topic">
<span class="md-ellipsis">
Aux Docs
</span>
</div>
<div class="md-header__topic" data-md-component="header-topic">
<span class="md-ellipsis">
What are experimental features?
</span>
</div>
</div>
</div>
<form class="md-header__option" data-md-component="palette">
<input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="blue" aria-label="Dark Mode" type="radio" name="__palette" id="__palette_0">
<label class="md-header__button md-icon" title="Dark Mode" for="__palette_1" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m17.75 4.09-2.53 1.94.91 3.06-2.63-1.81-2.63 1.81.91-3.06-2.53-1.94L12.44 4l1.06-3 1.06 3 3.19.09m3.5 6.91-1.64 1.25.59 1.98-1.7-1.17-1.7 1.17.59-1.98L15.75 11l2.06-.05L18.5 9l.69 1.95 2.06.05m-2.28 4.95c.83-.08 1.72 1.1 1.19 1.85-.32.45-.66.87-1.08 1.27C15.17 23 8.84 23 4.94 19.07c-3.91-3.9-3.91-10.24 0-14.14.4-.4.82-.76 1.27-1.08.75-.53 1.93.36 1.85 1.19-.27 2.86.69 5.83 2.89 8.02a9.96 9.96 0 0 0 8.02 2.89m-1.64 2.02a12.08 12.08 0 0 1-7.8-3.47c-2.17-2.19-3.33-5-3.49-7.82-2.81 3.14-2.7 7.96.31 10.98 3.02 3.01 7.84 3.12 10.98.31Z"/></svg>
</label>
<input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="indigo" data-md-color-accent="blue" aria-label="Light Mode" type="radio" name="__palette" id="__palette_1">
<label class="md-header__button md-icon" title="Light Mode" for="__palette_0" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 7a5 5 0 0 1 5 5 5 5 0 0 1-5 5 5 5 0 0 1-5-5 5 5 0 0 1 5-5m0 2a3 3 0 0 0-3 3 3 3 0 0 0 3 3 3 3 0 0 0 3-3 3 3 0 0 0-3-3m0-7 2.39 3.42C13.65 5.15 12.84 5 12 5c-.84 0-1.65.15-2.39.42L12 2M3.34 7l4.16-.35A7.2 7.2 0 0 0 5.94 8.5c-.44.74-.69 1.5-.83 2.29L3.34 7m.02 10 1.76-3.77a7.131 7.131 0 0 0 2.38 4.14L3.36 17M20.65 7l-1.77 3.79a7.023 7.023 0 0 0-2.38-4.15l4.15.36m-.01 10-4.14.36c.59-.51 1.12-1.14 1.54-1.86.42-.73.69-1.5.83-2.29L20.64 17M12 22l-2.41-3.44c.74.27 1.55.44 2.41.44.82 0 1.63-.17 2.37-.44L12 22Z"/></svg>
</label>
</form>
<script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
<label class="md-header__button md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
</label>
<div class="md-search" data-md-component="search" role="dialog">
<label class="md-search__overlay" for="__search"></label>
<div class="md-search__inner" role="search">
<form class="md-search__form" name="search">
<input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
<label class="md-search__icon md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
</label>
<nav class="md-search__options" aria-label="Search">
<button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
</button>
</nav>
</form>
<div class="md-search__output">
<div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
<div class="md-search-result" data-md-component="search-result">
<div class="md-search-result__meta">
Initializing search
</div>
<ol class="md-search-result__list" role="presentation"></ol>
</div>
</div>
</div>
</div>
</div>
<div class="md-header__source">
<a href="https://git.auxolotl.org/auxolotl/docs" title="Go to repository" class="md-source" data-md-component="source">
<div class="md-source__icon md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M16.777 0a2.9 2.9 0 1 1-2.529 4.322H12.91a4.266 4.266 0 0 0-4.265 4.195v2.118a7.076 7.076 0 0 1 4.147-1.42l.118-.002h1.338a2.9 2.9 0 0 1 5.43 1.422 2.9 2.9 0 0 1-5.43 1.422H12.91a4.266 4.266 0 0 0-4.265 4.195v2.319A2.9 2.9 0 0 1 7.222 24 2.9 2.9 0 0 1 5.8 18.57V8.589a7.109 7.109 0 0 1 6.991-7.108l.118-.001h1.338A2.9 2.9 0 0 1 16.778 0ZM7.223 19.905a1.194 1.194 0 1 0 0 2.389 1.194 1.194 0 0 0 0-2.389Zm9.554-10.464a1.194 1.194 0 1 0 0 2.389 1.194 1.194 0 0 0 0-2.39Zm0-7.735a1.194 1.194 0 1 0 0 2.389 1.194 1.194 0 0 0 0-2.389Z"/></svg>
</div>
<div class="md-source__repository">
auxolotl/docs
</div>
</a>
</div>
</nav>
</header>
<div class="md-container" data-md-component="container">
<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
<div class="md-grid">
<ul class="md-tabs__list">
<li class="md-tabs__item">
<a href="../../.." class="md-tabs__link">
Aux Documentation Hub
</a>
</li>
<li class="md-tabs__item">
<a href="../../../TODO/" class="md-tabs__link">
TODO
</a>
</li>
<li class="md-tabs__item">
<a href="../../../Aux/" class="md-tabs__link">
Aux
</a>
</li>
<li class="md-tabs__item md-tabs__item--active">
<a href="../../" class="md-tabs__link">
Lix
</a>
</li>
<li class="md-tabs__item">
<a href="../../../NixOS/appstream/" class="md-tabs__link">
NixOS
</a>
</li>
<li class="md-tabs__item">
<a href="../../../Nixpkgs/" class="md-tabs__link">
Nixpkgs
</a>
</li>
</ul>
</div>
</nav>
<main class="md-main" data-md-component="main">
<div class="md-main__inner md-grid">
<div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
<label class="md-nav__title" for="__drawer">
<a href="../../.." title="Aux Docs" class="md-nav__button md-logo" aria-label="Aux Docs" data-md-component="logo">
<img src="../../../assets/aux-logo.svg" alt="logo">
</a>
Aux Docs
</label>
<div class="md-nav__source">
<a href="https://git.auxolotl.org/auxolotl/docs" title="Go to repository" class="md-source" data-md-component="source">
<div class="md-source__icon md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M16.777 0a2.9 2.9 0 1 1-2.529 4.322H12.91a4.266 4.266 0 0 0-4.265 4.195v2.118a7.076 7.076 0 0 1 4.147-1.42l.118-.002h1.338a2.9 2.9 0 0 1 5.43 1.422 2.9 2.9 0 0 1-5.43 1.422H12.91a4.266 4.266 0 0 0-4.265 4.195v2.319A2.9 2.9 0 0 1 7.222 24 2.9 2.9 0 0 1 5.8 18.57V8.589a7.109 7.109 0 0 1 6.991-7.108l.118-.001h1.338A2.9 2.9 0 0 1 16.778 0ZM7.223 19.905a1.194 1.194 0 1 0 0 2.389 1.194 1.194 0 0 0 0-2.389Zm9.554-10.464a1.194 1.194 0 1 0 0 2.389 1.194 1.194 0 0 0 0-2.39Zm0-7.735a1.194 1.194 0 1 0 0 2.389 1.194 1.194 0 0 0 0-2.389Z"/></svg>
</div>
<div class="md-source__repository">
auxolotl/docs
</div>
</a>
</div>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../.." class="md-nav__link">
<span class="md-ellipsis">
Aux Documentation Hub
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../TODO/" class="md-nav__link">
<span class="md-ellipsis">
TODO
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../../Aux/" class="md-nav__link">
<span class="md-ellipsis">
Aux
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" checked>
<div class="md-nav__link md-nav__container">
<a href="../../" class="md-nav__link ">
<span class="md-ellipsis">
Lix
</span>
</a>
<label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
<span class="md-nav__icon md-icon"></span>
</label>
</div>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="true">
<label class="md-nav__title" for="__nav_4">
<span class="md-nav__icon md-icon"></span>
Lix
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../glossary/" class="md-nav__link">
<span class="md-ellipsis">
Glossary
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../quick-start/" class="md-nav__link">
<span class="md-ellipsis">
Quick Start
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../Advanced-Topics/" class="md-nav__link">
<span class="md-ellipsis">
Advanced Topics
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../Command-Reference/" class="md-nav__link">
<span class="md-ellipsis">
Command Reference
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../Package-Management/" class="md-nav__link">
<span class="md-ellipsis">
Package Management
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../architecture/" class="md-nav__link">
<span class="md-ellipsis">
Architecture
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--active md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4_8" checked>
<div class="md-nav__link md-nav__container">
<a href="../" class="md-nav__link ">
<span class="md-ellipsis">
Contributing
</span>
</a>
<label class="md-nav__link " for="__nav_4_8" id="__nav_4_8_label" tabindex="0">
<span class="md-nav__icon md-icon"></span>
</label>
</div>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_4_8_label" aria-expanded="true">
<label class="md-nav__title" for="__nav_4_8">
<span class="md-nav__icon md-icon"></span>
Contributing
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../cli-guideline/" class="md-nav__link">
<span class="md-ellipsis">
CLI guideline
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../cxx/" class="md-nav__link">
<span class="md-ellipsis">
C++ style guide
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--active">
<input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
<label class="md-nav__link md-nav__link--active" for="__toc">
<span class="md-ellipsis">
What are experimental features?
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<a href="./" class="md-nav__link md-nav__link--active">
<span class="md-ellipsis">
What are experimental features?
</span>
</a>
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#when-should-a-new-feature-be-marked-experimental" class="md-nav__link">
<span class="md-ellipsis">
When should a new feature be marked experimental?
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#lifecycle-of-an-experimental-feature" class="md-nav__link">
<span class="md-ellipsis">
Lifecycle of an experimental feature
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#relation-to-the-rfc-process" class="md-nav__link">
<span class="md-ellipsis">
Relation to the RFC process
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#currently-available-experimental-features" class="md-nav__link">
<span class="md-ellipsis">
Currently available experimental features
</span>
</a>
<nav class="md-nav" aria-label="Currently available experimental features">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#xp-feature-auto-allocate-uids" class="md-nav__link">
<span class="md-ellipsis">
auto-allocate-uids
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-ca-derivations" class="md-nav__link">
<span class="md-ellipsis">
ca-derivations
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-cgroups" class="md-nav__link">
<span class="md-ellipsis">
cgroups
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-daemon-trust-override" class="md-nav__link">
<span class="md-ellipsis">
daemon-trust-override
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-dynamic-derivations" class="md-nav__link">
<span class="md-ellipsis">
dynamic-derivations
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-fetch-closure" class="md-nav__link">
<span class="md-ellipsis">
fetch-closure
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-flakes" class="md-nav__link">
<span class="md-ellipsis">
flakes
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-impure-derivations" class="md-nav__link">
<span class="md-ellipsis">
impure-derivations
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-nix-command" class="md-nav__link">
<span class="md-ellipsis">
nix-command
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-no-url-literals" class="md-nav__link">
<span class="md-ellipsis">
no-url-literals
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-parse-toml-timestamps" class="md-nav__link">
<span class="md-ellipsis">
parse-toml-timestamps
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-read-only-local-store" class="md-nav__link">
<span class="md-ellipsis">
read-only-local-store
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-recursive-nix" class="md-nav__link">
<span class="md-ellipsis">
recursive-nix
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-repl-automation" class="md-nav__link">
<span class="md-ellipsis">
repl-automation
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-repl-flake" class="md-nav__link">
<span class="md-ellipsis">
repl-flake
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="../hacking/" class="md-nav__link">
<span class="md-ellipsis">
Hacking
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../testing/" class="md-nav__link">
<span class="md-ellipsis">
Running tests
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../installation/" class="md-nav__link">
<span class="md-ellipsis">
Installation
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../language/" class="md-nav__link">
<span class="md-ellipsis">
Language
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../protocols/" class="md-nav__link">
<span class="md-ellipsis">
Protocols
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../release-notes/" class="md-nav__link">
<span class="md-ellipsis">
Release notes
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../../NixOS/appstream/" class="md-nav__link">
<span class="md-ellipsis">
NixOS
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../../Nixpkgs/" class="md-nav__link">
<span class="md-ellipsis">
Nixpkgs
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#when-should-a-new-feature-be-marked-experimental" class="md-nav__link">
<span class="md-ellipsis">
When should a new feature be marked experimental?
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#lifecycle-of-an-experimental-feature" class="md-nav__link">
<span class="md-ellipsis">
Lifecycle of an experimental feature
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#relation-to-the-rfc-process" class="md-nav__link">
<span class="md-ellipsis">
Relation to the RFC process
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#currently-available-experimental-features" class="md-nav__link">
<span class="md-ellipsis">
Currently available experimental features
</span>
</a>
<nav class="md-nav" aria-label="Currently available experimental features">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#xp-feature-auto-allocate-uids" class="md-nav__link">
<span class="md-ellipsis">
auto-allocate-uids
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-ca-derivations" class="md-nav__link">
<span class="md-ellipsis">
ca-derivations
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-cgroups" class="md-nav__link">
<span class="md-ellipsis">
cgroups
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-daemon-trust-override" class="md-nav__link">
<span class="md-ellipsis">
daemon-trust-override
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-dynamic-derivations" class="md-nav__link">
<span class="md-ellipsis">
dynamic-derivations
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-fetch-closure" class="md-nav__link">
<span class="md-ellipsis">
fetch-closure
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-flakes" class="md-nav__link">
<span class="md-ellipsis">
flakes
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-impure-derivations" class="md-nav__link">
<span class="md-ellipsis">
impure-derivations
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-nix-command" class="md-nav__link">
<span class="md-ellipsis">
nix-command
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-no-url-literals" class="md-nav__link">
<span class="md-ellipsis">
no-url-literals
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-parse-toml-timestamps" class="md-nav__link">
<span class="md-ellipsis">
parse-toml-timestamps
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-read-only-local-store" class="md-nav__link">
<span class="md-ellipsis">
read-only-local-store
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-recursive-nix" class="md-nav__link">
<span class="md-ellipsis">
recursive-nix
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-repl-automation" class="md-nav__link">
<span class="md-ellipsis">
repl-automation
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#xp-feature-repl-flake" class="md-nav__link">
<span class="md-ellipsis">
repl-flake
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-content" data-md-component="content">
<article class="md-content__inner md-typeset">
<h1 id="what-are-experimental-features">What are experimental features?</h1>
<p>This section describes the notion of <em>experimental features</em>, and how it fits into the big picture of the development of Lix.</p>
<div class="admonition warning">
<p class="admonition-title">Warning</p>
<p>This section has not been updated for Lix <em>development practices</em> and should not be considered authoritative with respect to those; see the Lix wiki for more up-to-date information as it gets written <a href="https://wiki.lix.systems/books/lix-contributors">https://wiki.lix.systems/books/lix-contributors</a>. The technical content on this page is correct.</p>
</div>
<p>Experimental features are considered unstable, which means that they can be changed or removed at any time.
Users must explicitly enable them by toggling the associated <a href="../../Command-Reference/conf-file/#conf-experimental-features">experimental feature flags</a>.
This allows accessing unstable functionality without unwittingly relying on it.</p>
<p>Experimental feature flags were first introduced in <a href="../../release-notes/rl-2.4/">Nix 2.4</a>.
Before that, Nix did have experimental features, but they were not guarded by flags and were merely documented as unstable.
This was a source of confusion and controversy.</p>
<h2 id="when-should-a-new-feature-be-marked-experimental">When should a new feature be marked experimental?</h2>
<p>A change in the Lix codebase should be guarded by an experimental feature flag if it is considered likely to be reverted or adapted in a backwards-incompatible manner after gathering more experience with it in practice.</p>
<p>Examples:</p>
<ul>
<li>Changes to the Nix language, such as new built-ins, syntactic or semantic changes, etc.</li>
<li>Changes to the command-line interface</li>
</ul>
<h2 id="lifecycle-of-an-experimental-feature">Lifecycle of an experimental feature</h2>
<p>Experimental features have to be treated on a case-by-case basis.
However, the standard workflow for an experimental feature is as follows:</p>
<ul>
<li>A new feature is implemented in a <em>pull request</em></li>
<li>It is guarded by an experimental feature flag that is disabled by default</li>
<li>The pull request is merged, the <em>experimental</em> feature ends up in a release<ul>
<li>Using the feature requires explicitly enabling it, signifying awareness of the potential risks</li>
<li>Being experimental, the feature can still be changed arbitrarily</li>
</ul>
</li>
<li>The feature can be <em>removed</em></li>
<li>The associated experimental feature flag is also removed</li>
<li>The feature can be declared <em>stable</em></li>
<li>The associated experimental feature flag is removed</li>
<li>There should be enough evidence of users having tried the feature, such as feedback, fixed bugs, demonstrations of how it is put to use</li>
<li>Maintainers must feel confident that:<ul>
<li>The feature is designed and implemented sensibly, that it is fit for purpose</li>
<li>Potential interactions are well-understood</li>
<li>Stabilising the feature will not incur an outsized maintenance burden in the future</li>
</ul>
</li>
</ul>
<p>The following diagram illustrates the process:</p>
<div class="highlight"><pre><span></span><code> .------.
| idea |
&#39;------&#39;
|
discussion, design, implementation
|
| .-------.
| | |
v v |
.--------------. review
| pull request | |
&#39;--------------&#39; |
| ^ | |
| | &#39;-------&#39;
.---&#39; &#39;----.
| |
merge user feedback,
| (breaking) changes
| |
&#39;---. .----&#39;
| |
v |
+--------------+
.---| experimental |----.
| +--------------+ |
| |
decision to stabilise decision against
| keeping the feature
| |
v v
+--------+ +---------+
| stable | | removed |
+--------+ +---------+
</code></pre></div>
<h2 id="relation-to-the-rfc-process">Relation to the RFC process</h2>
<p>Experimental features and <a href="https://github.com/NixOS/rfcs/">RFCs</a> both allow approaching substantial changes while minimizing the risk.
However they serve different purposes:</p>
<ul>
<li>An experimental feature enables developers to iterate on and deliver a new idea without committing to it or requiring a costly long-running fork.
It is primarily an issue of <em>implementation</em>, targeting Nix developers and early testers.</li>
<li>The goal of an RFC is to make explicit all the implications of a change:
Explain why it is wanted, which new use-cases it enables, which interface changes it requires, etc.
It is primarily an issue of <em>design</em> and <em>communication</em>, targeting the broader community.</li>
</ul>
<p>This means that experimental features and RFCs are orthogonal mechanisms, and can be used independently or together as needed.</p>
<h2 id="currently-available-experimental-features">Currently available experimental features</h2>
<h3 id="xp-feature-auto-allocate-uids"><code>auto-allocate-uids</code></h3>
<p>Allows Nix to automatically pick UIDs for builds, rather than creating
<code>nixbld*</code> user accounts. See the <a href="#conf-auto-allocate-uids"><code>auto-allocate-uids</code></a> setting for details.</p>
<h3 id="xp-feature-ca-derivations"><code>ca-derivations</code></h3>
<p>Allow derivations to be content-addressed in order to prevent
rebuilds when changes to the derivation do not result in changes to
the derivation's output. See
<a href="../../language/advanced-attributes/#adv-attr-__contentAddressed">__contentAddressed</a>
for details.</p>
<h3 id="xp-feature-cgroups"><code>cgroups</code></h3>
<p>Allows Nix to execute builds inside cgroups. See
the <a href="#conf-use-cgroups"><code>use-cgroups</code></a> setting for details.</p>
<h3 id="xp-feature-daemon-trust-override"><code>daemon-trust-override</code></h3>
<p>Allow forcing trusting or not trusting clients with
<code>nix-daemon</code>. This is useful for testing, but possibly also
useful for various experiments with <code>nix-daemon --stdio</code>
networking.</p>
<h3 id="xp-feature-dynamic-derivations"><code>dynamic-derivations</code></h3>
<p>Allow the use of a few things related to dynamic derivations:</p>
<ul>
<li>
<p>"text hashing" derivation outputs, so we can build .drv
files.</p>
</li>
<li>
<p>dependencies in derivations on the outputs of
derivations that are themselves derivations outputs.</p>
</li>
</ul>
<h3 id="xp-feature-fetch-closure"><code>fetch-closure</code></h3>
<p>Enable the use of the <a href="../../language/builtins/#builtins-fetchClosure"><code>fetchClosure</code></a> built-in function in the Nix language.</p>
<h3 id="xp-feature-flakes"><code>flakes</code></h3>
<p>Enable flakes. See the manual entry for <a href="../../Command-Reference/New-CLI/nix3-flake/"><code>nix
flake</code></a> for details.</p>
<h3 id="xp-feature-impure-derivations"><code>impure-derivations</code></h3>
<p>Allow derivations to produce non-fixed outputs by setting the
<code>__impure</code> derivation attribute to <code>true</code>. An impure derivation can
have differing outputs each time it is built.</p>
<p>Example:</p>
<div class="highlight"><pre><span></span><code>derivation {
name = &quot;impure&quot;;
builder = /bin/sh;
__impure = true; ## mark this derivation as impure
args = [ &quot;-c&quot; &quot;read -n 10 random &lt; /dev/random; echo $random &gt; $out&quot; ];
system = builtins.currentSystem;
}
</code></pre></div>
<p>Each time this derivation is built, it can produce a different
output (as the builder outputs random bytes to <code>$out</code>). Impure
derivations also have access to the network, and only fixed-output
or other impure derivations can rely on impure derivations. Finally,
an impure derivation cannot also be
<a href="#xp-feature-ca-derivations">content-addressed</a>.</p>
<p>This is a more explicit alternative to using <a href="../../language/builtin-constants/#builtins-currentTime"><code>builtins.currentTime</code></a>.</p>
<h3 id="xp-feature-nix-command"><code>nix-command</code></h3>
<p>Enable the new <code>nix</code> subcommands. See the manual on
<a href="../../Command-Reference/New-CLI/nix/"><code>nix</code></a> for details.</p>
<h3 id="xp-feature-no-url-literals"><code>no-url-literals</code></h3>
<p>Disallow unquoted URLs as part of the Nix language syntax. The Nix
language allows for URL literals, like so:</p>
<div class="highlight"><pre><span></span><code>$ nix repl
Welcome to Nix 2.15.0. Type :? for help.
nix-repl&gt; http://foo
&quot;http://foo&quot;
</code></pre></div>
<p>But enabling this experimental feature will cause the Nix parser to
throw an error when encountering a URL literal:</p>
<div class="highlight"><pre><span></span><code>$ nix repl --extra-experimental-features &#39;no-url-literals&#39;
Welcome to Nix 2.15.0. Type :? for help.
nix-repl&gt; http://foo
error: URL literals are disabled
at «string»:1:1:
1| http://foo
| ^
</code></pre></div>
<p>While this is currently an experimental feature, unquoted URLs are
being deprecated and their usage is discouraged.</p>
<p>The reason is that, as opposed to path literals, URLs have no
special properties that distinguish them from regular strings, URLs
containing parameters have to be quoted anyway, and unquoted URLs
may confuse external tooling.</p>
<h3 id="xp-feature-parse-toml-timestamps"><code>parse-toml-timestamps</code></h3>
<p>Allow parsing of timestamps in builtins.fromTOML.</p>
<h3 id="xp-feature-read-only-local-store"><code>read-only-local-store</code></h3>
<p>Allow the use of the <code>read-only</code> parameter in <a href="../../Command-Reference/New-CLI/nix3-help-stores/#local-store">local store</a> URIs.</p>
<h3 id="xp-feature-recursive-nix"><code>recursive-nix</code></h3>
<p>Allow derivation builders to call Nix, and thus build derivations
recursively.</p>
<p>Example:</p>
<div class="highlight"><pre><span></span><code>with import &lt;nixpkgs&gt; {};
runCommand &quot;foo&quot;
{
buildInputs = [ nix jq ];
NIX_PATH = &quot;nixpkgs=${&lt;nixpkgs&gt;}&quot;;
}
&#39;&#39;
hello=$(nix-build -E &#39;(import &lt;nixpkgs&gt; {}).hello.overrideDerivation (args: { name = &quot;recursive-hello&quot;; })&#39;)
mkdir -p $out/bin
ln -s $hello/bin/hello $out/bin/hello
&#39;&#39;
</code></pre></div>
<p>An important restriction on recursive builders is disallowing
arbitrary substitutions. For example, running</p>
<div class="highlight"><pre><span></span><code>nix-store -r /nix/store/kmwd1hq55akdb9sc7l3finr175dajlby-hello-2.10
</code></pre></div>
<p>in the above <code>runCommand</code> script would be disallowed, as this could
lead to derivations with hidden dependencies or breaking
reproducibility by relying on the current state of the Nix store. An
exception would be if
<code>/nix/store/kmwd1hq55akdb9sc7l3finr175dajlby-hello-2.10</code> were
already in the build inputs or built by a previous recursive Nix
call.</p>
<h3 id="xp-feature-repl-automation"><code>repl-automation</code></h3>
<p>Makes the repl not use readline/editline, print ENQ (U+0005) when ready for a command, and take commands followed by newline.</p>
<h3 id="xp-feature-repl-flake"><code>repl-flake</code></h3>
<p>Allow passing <a href="../../Command-Reference/New-CLI/nix/#installables">installables</a> to <code>nix repl</code>, making its interface consistent with the other experimental commands.</p>
</article>
</div>
<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
</div>
</main>
<footer class="md-footer">
<div class="md-footer-meta md-typeset">
<div class="md-footer-meta__inner md-grid">
<div class="md-copyright">
<div class="md-copyright__highlight">
Licenced MIT
</div>
Made with
<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
Material for MkDocs
</a>
</div>
<div class="md-social">
<a href="https://git.auxolotl.org/auxolotl/docs" target="_blank" rel="noopener" title="Aux Docs Repo" class="md-social__link">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M16.777 0a2.9 2.9 0 1 1-2.529 4.322H12.91a4.266 4.266 0 0 0-4.265 4.195v2.118a7.076 7.076 0 0 1 4.147-1.42l.118-.002h1.338a2.9 2.9 0 0 1 5.43 1.422 2.9 2.9 0 0 1-5.43 1.422H12.91a4.266 4.266 0 0 0-4.265 4.195v2.319A2.9 2.9 0 0 1 7.222 24 2.9 2.9 0 0 1 5.8 18.57V8.589a7.109 7.109 0 0 1 6.991-7.108l.118-.001h1.338A2.9 2.9 0 0 1 16.778 0ZM7.223 19.905a1.194 1.194 0 1 0 0 2.389 1.194 1.194 0 0 0 0-2.389Zm9.554-10.464a1.194 1.194 0 1 0 0 2.389 1.194 1.194 0 0 0 0-2.39Zm0-7.735a1.194 1.194 0 1 0 0 2.389 1.194 1.194 0 0 0 0-2.389Z"/></svg>
</a>
<a href="https://forum.aux.computer/" target="_blank" rel="noopener" title="Aux Forum" class="md-social__link">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12.103 0C18.666 0 24 5.485 24 11.997c0 6.51-5.33 11.99-11.9 11.99L0 24V11.79C0 5.28 5.532 0 12.103 0zm.116 4.563a7.395 7.395 0 0 0-6.337 3.57 7.247 7.247 0 0 0-.148 7.22L4.4 19.61l4.794-1.074a7.424 7.424 0 0 0 8.136-1.39 7.256 7.256 0 0 0 1.737-7.997 7.375 7.375 0 0 0-6.84-4.585h-.008z"/></svg>
</a>
<a href="https://wiki.auxolotl.org/" target="_blank" rel="noopener" title="Aux Wiki" class="md-social__link">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17.801 13.557c.148.098.288.202.417.313 1.854 1.6 3.127 4.656 2.582 7.311-1.091-.255-5.747-1.055-7.638-3.383-.91-1.12-1.366-2.081-1.569-2.885a5.65 5.65 0 0 0 .034-.219c.089.198.197.35.313.466.24.24.521.335.766.372.304.046.594-.006.806-.068l.001.001c.05-.015.433-.116.86-.342.325-.173 2.008-.931 3.428-1.566Zm-7.384 1.435C9.156 16.597 6.6 18.939.614 18.417c.219-1.492 1.31-3.019 2.51-4.11.379-.345.906-.692 1.506-1.009.286.168.598.332.939.486 2.689 1.221 3.903 1.001 4.89.573a1.3 1.3 0 0 0 .054-.025 6.156 6.156 0 0 0-.096.66Zm4.152-.462c.38-.341.877-.916 1.383-1.559-.389-.15-.866-.371-1.319-.591-.598-.29-1.305-.283-2.073-.315a4.685 4.685 0 0 1-.804-.103c.014-.123.027-.246.038-.369.062.104.673.057.871.057.354 0 1.621.034 3.074-.574 1.452-.608 2.55-1.706 3.022-3.225.474-1.52.22-3.091-.168-3.952-.169.709-1.453 2.381-1.926 2.871-.473.489-2.381 2.296-2.972 2.921-.7.74-.688.793-1.332 1.302-.202.19-.499.402-.563.53.027-.338.039-.675.027-.997a7.653 7.653 0 0 0-.032-.523c.322-.059.567-.522.567-.861 0-.224-.106-.247-.271-.229.075-.894.382-3.923 1.254-4.281.218.109.831.068.649-.295-.182-.364-.825-.074-1.081.266-.28.374-.956 2.046-.92 4.324-.113.014-.174.033-.322.033-.171 0-.321-.04-.433-.05.034-2.275-.714-3.772-.84-4.169-.12-.375-.491-.596-.781-.596-.146 0-.272.056-.333.179-.182.363.459.417.677.308.706.321 1.156 3.519 1.254 4.277-.125-.006-.199.035-.199.233 0 .311.17.756.452.843a.442.442 0 0 0-.007.03s-.287.99-.413 2.189a4.665 4.665 0 0 1-.718-.225c-.714-.286-1.355-.583-2.019-.566-.664.018-1.366.023-1.804-.036-.438-.058-.649-.15-.649-.15s-.234.365.257 1.075c.42.607 1.055 1.047 1.644 1.18.589.134 1.972.18 2.785-.377.16-.109.317-.228.459-.34a8.717 8.717 0 0 0-.013.626c-.289.753-.571 1.993-.268 3.338 0-.001.701-.842.787-2.958.006-.144.009-.271.01-.383.052-.248.103-.518.148-.799.072.135.151.277.234.413.511.842 1.791 1.37 2.383 1.49.091.019.187.032.285.038Zm-1.12.745c-.188.055-.445.1-.713.059-.21-.031-.45-.11-.655-.316-.169-.168-.312-.419-.401-.789a9.837 9.837 0 0 0 .039-.82l.049-.243c.563.855 1.865 1.398 2.476 1.522.036.008.072.014.109.02l-.013.009c-.579.415-.76.503-.891.558Zm6.333-2.818c-.257.114-4.111 1.822-5.246 2.363.98-.775 3.017-3.59 3.699-4.774 1.062.661 1.468 1.109 1.623 1.441.101.217.09.38.096.515a.57.57 0 0 1-.172.455Zm-9.213 1.62a1.606 1.606 0 0 1-.19.096c-.954.414-2.126.61-4.728-.571-2.023-.918-3.024-2.157-3.371-2.666.476.161 1.471.473 2.157.524.282.021.703.068 1.167.125.021.209.109.486.345.829l.001.001c.451.651 1.134 1.119 1.765 1.262.622.141 2.083.182 2.942-.407a3.12 3.12 0 0 0 .132-.093l.001.179a6.052 6.052 0 0 0-.221.721Zm5.512-1.271a17.49 17.49 0 0 1-1.326-.589c.437.042 1.054.083 1.692.108-.121.162-.244.323-.366.481Zm.932-1.26c-.12.17-.245.343-.373.517-.241.018-.478.03-.709.038a29.05 29.05 0 0 1-.741-.048c.608-.065 1.228-.252 1.823-.507Zm.22-.315c-.809.382-1.679.648-2.507.648-.472 0-.833.018-1.139.039v.001c-.324-.031-.665-.039-1.019-.054a3.555 3.555 0 0 1-.152-.009c.102-.002.192-.006.249-.006.363 0 1.662.034 3.151-.589 1.508-.632 2.645-1.773 3.136-3.351.37-1.186.31-2.402.086-3.312.458-.336.86-.651 1.147-.91.501-.451.743-.733.848-.869.199.206.714.864.685 2.138-.036 1.611-.606 3.187-1.501 4.154a9.099 9.099 0 0 1-1.321 1.132 11.978 11.978 0 0 0-.644-.422l-.089-.055-.051.091c-.184.332-.5.825-.879 1.374ZM4.763 5.817c-.157 1.144.113 2.323.652 3.099.539.776 2.088 2.29 3.614 2.505.991.14 2.055.134 2.055.134s-.593-.576-1.114-1.66c-.521-1.085-.948-2.104-1.734-2.786-.785-.681-1.601-1.416-2.045-1.945-.444-.53-.59-.86-.59-.86s-.656.175-.838 1.513Zm14.301 4.549a9.162 9.162 0 0 0 1.3-1.12c.326-.352.611-.782.845-1.265 1.315.145 2.399.371 2.791.434 0 0-.679 1.971-3.945 3.022l-.016-.035c-.121-.26-.385-.594-.975-1.036Zm-11.634.859a8.537 8.537 0 0 1-.598-.224c-1.657-.693-2.91-1.944-3.449-3.678-.498-1.601-.292-3.251.091-4.269.225.544.758 1.34 1.262 2.01a3.58 3.58 0 0 0-.172.726c-.163 1.197.123 2.428.687 3.24.416.599 1.417 1.62 2.555 2.193-.128.002-.253.003-.376.002Zm-1.758-.077c-.958-.341-1.901-.787-2.697-1.368C-.07 7.559 0 6.827 0 6.827s1.558-.005 3.088.179c.03.126.065.251.104.377.557 1.791 1.851 3.086 3.562 3.803l.047.019a4.254 4.254 0 0 1-.267-.026h-.001c-.401-.053-.595-.135-.595-.135l-.157-.069-.092.144-.017.029Zm6.807-1.59c.086.017.136.058.136.145 0 .197-.242.5-.597.597l-.01-.161a.887.887 0 0 0 .283-.243c.078-.099.142-.217.188-.338Zm-1.591.006c.033.1.076.197.129.282.061.097.134.18.217.24l-.021.083c-.276-.093-.424-.293-.424-.466 0-.078.035-.119.099-.139Zm-.025-.664c-.275-.816-.795-2.022-1.505-2.179-.296.072-.938.096-.691-.145.246-.24 1.085-.048 1.283.217.145.194.744.806 1.011 1.737l.032.227a.324.324 0 0 0-.13.143Zm1.454-.266c.251-.99.889-1.639 1.039-1.841.197-.265 1.036-.457 1.283-.217.247.241-.395.217-.691.145-.69.152-1.2 1.296-1.481 2.109a.364.364 0 0 0-.067-.059.37.37 0 0 0-.092-.043l.009-.094Zm4.802-2.708a9.875 9.875 0 0 1-.596.705c-.304.315-1.203 1.176-1.963 1.916.647-.955 1.303-1.806 2.184-2.376.123-.08.249-.161.375-.245Z"/></svg>
</a>
</div>
</div>
</div>
</footer>
</div>
<div class="md-dialog" data-md-component="dialog">
<div class="md-dialog__inner md-typeset"></div>
</div>
<script id="__config" type="application/json">{"base": "../../..", "features": ["content.tooltips", "search.highlight", "navigation.tabs", "navigation.indexes", "navigation.prune"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
<script src="../../../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
</body>
</html>