Add updated Catppuccin theme
This commit is contained in:
parent
0996546048
commit
e27ba9e2ac
@ -103,12 +103,12 @@ close(FH);
|
||||
# Copy md files to zsh manual mdbook src
|
||||
# First ensure it is empty
|
||||
my $cwd = getcwd();
|
||||
system("rm -rf $cwd/zsh_manual/src") == 0 or die "$?";
|
||||
mkdir("$cwd/zsh_manual/src") or die "$?";
|
||||
system("cp $mdbook_src_dir/* $cwd/zsh_manual/src/") == 0 or die "$?";
|
||||
system("rm -rf $cwd/zsh-manual/src") == 0 or die "$?";
|
||||
mkdir("$cwd/zsh-manual/src") or die "$?";
|
||||
system("cp $mdbook_src_dir/* $cwd/zsh-manual/src/") == 0 or die "$?";
|
||||
|
||||
# Replace ``` example with ```zsh for syntax highlighting
|
||||
@files = <$cwd/zsh_manual/src/*.md>;
|
||||
@files = <$cwd/zsh-manual/src/*.md>;
|
||||
foreach my $file (@files) {
|
||||
system("sed -i 's/``` example/```zsh/g' '$file'") == 0 or die "$?";
|
||||
}
|
||||
|
||||
11
zsh-guide/book.toml
Normal file
11
zsh-guide/book.toml
Normal file
@ -0,0 +1,11 @@
|
||||
[book]
|
||||
authors = ["Jeffrey Serio"]
|
||||
language = "en"
|
||||
multilingual = false
|
||||
src = "src"
|
||||
title = "Zsh Guide"
|
||||
|
||||
[output.html]
|
||||
additional-css = ["./theme/catppuccin.css"]
|
||||
default-theme = "mocha"
|
||||
preferred-dark-theme = "mocha"
|
||||
@ -1,18 +1,17 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
<title>Page not found - Zsh User's Guide</title>
|
||||
<title>Page not found - Zsh Guide</title>
|
||||
<base href="/">
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -32,18 +31,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -59,56 +60,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded affix "><a href="zshguide.html">A User's Guide to the Z-Shell</a></li><li class="chapter-item expanded "><a href="zshguide01.html"><strong aria-hidden="true">1.</strong> A short introduction</a></li><li class="chapter-item expanded "><a href="zshguide02.html"><strong aria-hidden="true">2.</strong> What to put in your startup files</a></li><li class="chapter-item expanded "><a href="zshguide03.html"><strong aria-hidden="true">3.</strong> Dealing with basic shell syntax</a></li><li class="chapter-item expanded "><a href="zshguide04.html"><strong aria-hidden="true">4.</strong> The Z-Shell Line Editor</a></li><li class="chapter-item expanded "><a href="zshguide05.html"><strong aria-hidden="true">5.</strong> Substitutions</a></li><li class="chapter-item expanded "><a href="zshguide06.html"><strong aria-hidden="true">6.</strong> Completion, old and new</a></li><li class="chapter-item expanded "><a href="zshguide07.html"><strong aria-hidden="true">7.</strong> Modules and other bits and pieces Not written</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -117,7 +121,7 @@
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<h1 class="menu-title">Zsh User's Guide</h1>
|
||||
<h1 class="menu-title">Zsh Guide</h1>
|
||||
|
||||
<div class="right-buttons">
|
||||
<a href="print.html" title="Print this book" aria-label="Print this book">
|
||||
@ -139,7 +143,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -169,24 +173,41 @@
|
||||
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
socket.onmessage = function (event) {
|
||||
if (event.data === "reload") {
|
||||
socket.close();
|
||||
location.reload();
|
||||
}
|
||||
};
|
||||
|
||||
window.onbeforeunload = function() {
|
||||
socket.close();
|
||||
}
|
||||
</script>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
|
Before Width: | Height: | Size: 434 KiB After Width: | Height: | Size: 434 KiB |
@ -4,14 +4,16 @@
|
||||
window.onunload = function () { };
|
||||
|
||||
// Global variable, shared between modules
|
||||
function playground_text(playground) {
|
||||
function playground_text(playground, hidden = true) {
|
||||
let code_block = playground.querySelector("code");
|
||||
|
||||
if (window.ace && code_block.classList.contains("editable")) {
|
||||
let editor = window.ace.edit(code_block);
|
||||
return editor.getValue();
|
||||
} else {
|
||||
} else if (hidden) {
|
||||
return code_block.textContent;
|
||||
} else {
|
||||
return code_block.innerText;
|
||||
}
|
||||
}
|
||||
|
||||
@ -66,7 +68,7 @@ function playground_text(playground) {
|
||||
}
|
||||
|
||||
// updates the visibility of play button based on `no_run` class and
|
||||
// used crates vs ones available on http://play.rust-lang.org
|
||||
// used crates vs ones available on https://play.rust-lang.org
|
||||
function update_play_button(pre_block, playground_crates) {
|
||||
var play_button = pre_block.querySelector(".play-button");
|
||||
|
||||
@ -166,7 +168,6 @@ function playground_text(playground) {
|
||||
.filter(function (node) {return node.classList.contains("editable"); })
|
||||
.forEach(function (block) { block.classList.remove('language-rust'); });
|
||||
|
||||
Array
|
||||
code_nodes
|
||||
.filter(function (node) {return !node.classList.contains("editable"); })
|
||||
.forEach(function (block) { hljs.highlightBlock(block); });
|
||||
@ -178,7 +179,7 @@ function playground_text(playground) {
|
||||
// even if highlighting doesn't apply
|
||||
code_nodes.forEach(function (block) { block.classList.add('hljs'); });
|
||||
|
||||
Array.from(document.querySelectorAll("code.language-rust")).forEach(function (block) {
|
||||
Array.from(document.querySelectorAll("code.hljs")).forEach(function (block) {
|
||||
|
||||
var lines = Array.from(block.querySelectorAll('.boring'));
|
||||
// If no lines were hidden, return
|
||||
@ -224,7 +225,7 @@ function playground_text(playground) {
|
||||
}
|
||||
|
||||
var clipButton = document.createElement('button');
|
||||
clipButton.className = 'fa fa-copy clip-button';
|
||||
clipButton.className = 'clip-button';
|
||||
clipButton.title = 'Copy to clipboard';
|
||||
clipButton.setAttribute('aria-label', clipButton.title);
|
||||
clipButton.innerHTML = '<i class=\"tooltiptext\"></i>';
|
||||
@ -257,7 +258,7 @@ function playground_text(playground) {
|
||||
|
||||
if (window.playground_copyable) {
|
||||
var copyCodeClipboardButton = document.createElement('button');
|
||||
copyCodeClipboardButton.className = 'fa fa-copy clip-button';
|
||||
copyCodeClipboardButton.className = 'clip-button';
|
||||
copyCodeClipboardButton.innerHTML = '<i class="tooltiptext"></i>';
|
||||
copyCodeClipboardButton.title = 'Copy to clipboard';
|
||||
copyCodeClipboardButton.setAttribute('aria-label', copyCodeClipboardButton.title);
|
||||
@ -288,6 +289,10 @@ function playground_text(playground) {
|
||||
var themeToggleButton = document.getElementById('theme-toggle');
|
||||
var themePopup = document.getElementById('theme-list');
|
||||
var themeColorMetaTag = document.querySelector('meta[name="theme-color"]');
|
||||
var themeIds = [];
|
||||
themePopup.querySelectorAll('button.theme').forEach(function (el) {
|
||||
themeIds.push(el.id);
|
||||
});
|
||||
var stylesheets = {
|
||||
ayuHighlight: document.querySelector("[href$='ayu-highlight.css']"),
|
||||
tomorrowNight: document.querySelector("[href$='tomorrow-night.css']"),
|
||||
@ -300,6 +305,13 @@ function playground_text(playground) {
|
||||
themePopup.querySelector("button#" + get_theme()).focus();
|
||||
}
|
||||
|
||||
function updateThemeSelected() {
|
||||
themePopup.querySelectorAll('.theme-selected').forEach(function (el) {
|
||||
el.classList.remove('theme-selected');
|
||||
});
|
||||
themePopup.querySelector("button#" + get_theme()).classList.add('theme-selected');
|
||||
}
|
||||
|
||||
function hideThemes() {
|
||||
themePopup.style.display = 'none';
|
||||
themeToggleButton.setAttribute('aria-expanded', false);
|
||||
@ -309,7 +321,7 @@ function playground_text(playground) {
|
||||
function get_theme() {
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch (e) { }
|
||||
if (theme === null || theme === undefined) {
|
||||
if (theme === null || theme === undefined || !themeIds.includes(theme)) {
|
||||
return default_theme;
|
||||
} else {
|
||||
return theme;
|
||||
@ -338,7 +350,7 @@ function playground_text(playground) {
|
||||
}
|
||||
|
||||
setTimeout(function () {
|
||||
themeColorMetaTag.content = getComputedStyle(document.body).backgroundColor;
|
||||
themeColorMetaTag.content = getComputedStyle(document.documentElement).backgroundColor;
|
||||
}, 1);
|
||||
|
||||
if (window.ace && window.editors) {
|
||||
@ -355,6 +367,7 @@ function playground_text(playground) {
|
||||
|
||||
html.classList.remove(previousTheme);
|
||||
html.classList.add(theme);
|
||||
updateThemeSelected();
|
||||
}
|
||||
|
||||
// Set theme
|
||||
@ -432,16 +445,17 @@ function playground_text(playground) {
|
||||
})();
|
||||
|
||||
(function sidebar() {
|
||||
var html = document.querySelector("html");
|
||||
var body = document.querySelector("body");
|
||||
var sidebar = document.getElementById("sidebar");
|
||||
var sidebarLinks = document.querySelectorAll('#sidebar a');
|
||||
var sidebarToggleButton = document.getElementById("sidebar-toggle");
|
||||
var sidebarToggleAnchor = document.getElementById("sidebar-toggle-anchor");
|
||||
var sidebarResizeHandle = document.getElementById("sidebar-resize-handle");
|
||||
var firstContact = null;
|
||||
|
||||
function showSidebar() {
|
||||
html.classList.remove('sidebar-hidden')
|
||||
html.classList.add('sidebar-visible');
|
||||
body.classList.remove('sidebar-hidden')
|
||||
body.classList.add('sidebar-visible');
|
||||
Array.from(sidebarLinks).forEach(function (link) {
|
||||
link.setAttribute('tabIndex', 0);
|
||||
});
|
||||
@ -450,20 +464,9 @@ function playground_text(playground) {
|
||||
try { localStorage.setItem('mdbook-sidebar', 'visible'); } catch (e) { }
|
||||
}
|
||||
|
||||
|
||||
var sidebarAnchorToggles = document.querySelectorAll('#sidebar a.toggle');
|
||||
|
||||
function toggleSection(ev) {
|
||||
ev.currentTarget.parentElement.classList.toggle('expanded');
|
||||
}
|
||||
|
||||
Array.from(sidebarAnchorToggles).forEach(function (el) {
|
||||
el.addEventListener('click', toggleSection);
|
||||
});
|
||||
|
||||
function hideSidebar() {
|
||||
html.classList.remove('sidebar-visible')
|
||||
html.classList.add('sidebar-hidden');
|
||||
body.classList.remove('sidebar-visible')
|
||||
body.classList.add('sidebar-hidden');
|
||||
Array.from(sidebarLinks).forEach(function (link) {
|
||||
link.setAttribute('tabIndex', -1);
|
||||
});
|
||||
@ -473,22 +476,16 @@ function playground_text(playground) {
|
||||
}
|
||||
|
||||
// Toggle sidebar
|
||||
sidebarToggleButton.addEventListener('click', function sidebarToggle() {
|
||||
if (html.classList.contains("sidebar-hidden")) {
|
||||
sidebarToggleAnchor.addEventListener('change', function sidebarToggle() {
|
||||
if (sidebarToggleAnchor.checked) {
|
||||
var current_width = parseInt(
|
||||
document.documentElement.style.getPropertyValue('--sidebar-width'), 10);
|
||||
if (current_width < 150) {
|
||||
document.documentElement.style.setProperty('--sidebar-width', '150px');
|
||||
}
|
||||
showSidebar();
|
||||
} else if (html.classList.contains("sidebar-visible")) {
|
||||
hideSidebar();
|
||||
} else {
|
||||
if (getComputedStyle(sidebar)['transform'] === 'none') {
|
||||
hideSidebar();
|
||||
} else {
|
||||
showSidebar();
|
||||
}
|
||||
hideSidebar();
|
||||
}
|
||||
});
|
||||
|
||||
@ -497,14 +494,14 @@ function playground_text(playground) {
|
||||
function initResize(e) {
|
||||
window.addEventListener('mousemove', resize, false);
|
||||
window.addEventListener('mouseup', stopResize, false);
|
||||
html.classList.add('sidebar-resizing');
|
||||
body.classList.add('sidebar-resizing');
|
||||
}
|
||||
function resize(e) {
|
||||
var pos = (e.clientX - sidebar.offsetLeft);
|
||||
if (pos < 20) {
|
||||
hideSidebar();
|
||||
} else {
|
||||
if (html.classList.contains("sidebar-hidden")) {
|
||||
if (body.classList.contains("sidebar-hidden")) {
|
||||
showSidebar();
|
||||
}
|
||||
pos = Math.min(pos, window.innerWidth - 100);
|
||||
@ -513,7 +510,7 @@ function playground_text(playground) {
|
||||
}
|
||||
//on mouseup remove windows functions mousemove & mouseup
|
||||
function stopResize(e) {
|
||||
html.classList.remove('sidebar-resizing');
|
||||
body.classList.remove('sidebar-resizing');
|
||||
window.removeEventListener('mousemove', resize, false);
|
||||
window.removeEventListener('mouseup', stopResize, false);
|
||||
}
|
||||
@ -542,33 +539,41 @@ function playground_text(playground) {
|
||||
firstContact = null;
|
||||
}
|
||||
}, { passive: true });
|
||||
|
||||
// Scroll sidebar to current active section
|
||||
var activeSection = document.getElementById("sidebar").querySelector(".active");
|
||||
if (activeSection) {
|
||||
// https://developer.mozilla.org/en-US/docs/Web/API/Element/scrollIntoView
|
||||
activeSection.scrollIntoView({ block: 'center' });
|
||||
}
|
||||
})();
|
||||
|
||||
(function chapterNavigation() {
|
||||
document.addEventListener('keydown', function (e) {
|
||||
if (e.altKey || e.ctrlKey || e.metaKey || e.shiftKey) { return; }
|
||||
if (window.search && window.search.hasFocus()) { return; }
|
||||
var html = document.querySelector('html');
|
||||
|
||||
function next() {
|
||||
var nextButton = document.querySelector('.nav-chapters.next');
|
||||
if (nextButton) {
|
||||
window.location.href = nextButton.href;
|
||||
}
|
||||
}
|
||||
function prev() {
|
||||
var previousButton = document.querySelector('.nav-chapters.previous');
|
||||
if (previousButton) {
|
||||
window.location.href = previousButton.href;
|
||||
}
|
||||
}
|
||||
switch (e.key) {
|
||||
case 'ArrowRight':
|
||||
e.preventDefault();
|
||||
var nextButton = document.querySelector('.nav-chapters.next');
|
||||
if (nextButton) {
|
||||
window.location.href = nextButton.href;
|
||||
if (html.dir == 'rtl') {
|
||||
prev();
|
||||
} else {
|
||||
next();
|
||||
}
|
||||
break;
|
||||
case 'ArrowLeft':
|
||||
e.preventDefault();
|
||||
var previousButton = document.querySelector('.nav-chapters.previous');
|
||||
if (previousButton) {
|
||||
window.location.href = previousButton.href;
|
||||
if (html.dir == 'rtl') {
|
||||
next();
|
||||
} else {
|
||||
prev();
|
||||
}
|
||||
break;
|
||||
}
|
||||
@ -580,19 +585,19 @@ function playground_text(playground) {
|
||||
|
||||
function hideTooltip(elem) {
|
||||
elem.firstChild.innerText = "";
|
||||
elem.className = 'fa fa-copy clip-button';
|
||||
elem.className = 'clip-button';
|
||||
}
|
||||
|
||||
function showTooltip(elem, msg) {
|
||||
elem.firstChild.innerText = msg;
|
||||
elem.className = 'fa fa-copy tooltipped';
|
||||
elem.className = 'clip-button tooltipped';
|
||||
}
|
||||
|
||||
var clipboardSnippets = new ClipboardJS('.clip-button', {
|
||||
text: function (trigger) {
|
||||
hideTooltip(trigger);
|
||||
let playground = trigger.closest("pre");
|
||||
return playground_text(playground);
|
||||
return playground_text(playground, false);
|
||||
}
|
||||
});
|
||||
|
||||
@ -667,13 +672,14 @@ function playground_text(playground) {
|
||||
}, { passive: true });
|
||||
})();
|
||||
(function controllBorder() {
|
||||
menu.classList.remove('bordered');
|
||||
document.addEventListener('scroll', function () {
|
||||
function updateBorder() {
|
||||
if (menu.offsetTop === 0) {
|
||||
menu.classList.remove('bordered');
|
||||
} else {
|
||||
menu.classList.add('bordered');
|
||||
}
|
||||
}, { passive: true });
|
||||
}
|
||||
updateBorder();
|
||||
document.addEventListener('scroll', updateBorder, { passive: true });
|
||||
})();
|
||||
})();
|
||||
@ -1,13 +1,5 @@
|
||||
/* CSS for UI elements (a.k.a. chrome) */
|
||||
|
||||
@import 'variables.css';
|
||||
|
||||
::-webkit-scrollbar {
|
||||
background: var(--bg);
|
||||
}
|
||||
::-webkit-scrollbar-thumb {
|
||||
background: var(--scrollbar);
|
||||
}
|
||||
html {
|
||||
scrollbar-color: var(--scrollbar) var(--bg);
|
||||
}
|
||||
@ -18,6 +10,19 @@ a > .hljs {
|
||||
color: var(--links);
|
||||
}
|
||||
|
||||
/*
|
||||
body-container is necessary because mobile browsers don't seem to like
|
||||
overflow-x on the body tag when there is a <meta name="viewport"> tag.
|
||||
*/
|
||||
#body-container {
|
||||
/*
|
||||
This is used when the sidebar pushes the body content off the side of
|
||||
the screen on small screens. Without it, dragging on mobile Safari
|
||||
will want to reposition the viewport in a weird way.
|
||||
*/
|
||||
overflow-x: clip;
|
||||
}
|
||||
|
||||
/* Menu Bar */
|
||||
|
||||
#menu-bar,
|
||||
@ -30,14 +35,14 @@ a > .hljs {
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
background-color: var(--bg);
|
||||
border-bottom-color: var(--bg);
|
||||
border-bottom-width: 1px;
|
||||
border-bottom-style: solid;
|
||||
border-block-end-color: var(--bg);
|
||||
border-block-end-width: 1px;
|
||||
border-block-end-style: solid;
|
||||
}
|
||||
#menu-bar.sticky,
|
||||
.js #menu-bar-hover-placeholder:hover + #menu-bar,
|
||||
.js #menu-bar:hover,
|
||||
.js.sidebar-visible #menu-bar {
|
||||
#menu-bar-hover-placeholder:hover + #menu-bar,
|
||||
#menu-bar:hover,
|
||||
html.sidebar-visible #menu-bar {
|
||||
position: -webkit-sticky;
|
||||
position: sticky;
|
||||
top: 0 !important;
|
||||
@ -49,7 +54,7 @@ a > .hljs {
|
||||
height: var(--menu-bar-height);
|
||||
}
|
||||
#menu-bar.bordered {
|
||||
border-bottom-color: var(--table-border-color);
|
||||
border-block-end-color: var(--table-border-color);
|
||||
}
|
||||
#menu-bar i, #menu-bar .icon-button {
|
||||
position: relative;
|
||||
@ -86,7 +91,7 @@ a > .hljs {
|
||||
display: flex;
|
||||
margin: 0 5px;
|
||||
}
|
||||
.no-js .left-buttons {
|
||||
html:not(.js) .left-buttons button {
|
||||
display: none;
|
||||
}
|
||||
|
||||
@ -102,7 +107,7 @@ a > .hljs {
|
||||
overflow: hidden;
|
||||
text-overflow: ellipsis;
|
||||
}
|
||||
.js .menu-title {
|
||||
.menu-title {
|
||||
cursor: pointer;
|
||||
}
|
||||
|
||||
@ -153,7 +158,7 @@ a > .hljs {
|
||||
}
|
||||
|
||||
.nav-wrapper {
|
||||
margin-top: 50px;
|
||||
margin-block-start: 50px;
|
||||
display: none;
|
||||
}
|
||||
|
||||
@ -166,23 +171,34 @@ a > .hljs {
|
||||
background-color: var(--sidebar-bg);
|
||||
}
|
||||
|
||||
.previous {
|
||||
float: left;
|
||||
}
|
||||
/* Only Firefox supports flow-relative values */
|
||||
.previous { float: left; }
|
||||
[dir=rtl] .previous { float: right; }
|
||||
|
||||
/* Only Firefox supports flow-relative values */
|
||||
.next {
|
||||
float: right;
|
||||
right: var(--page-padding);
|
||||
}
|
||||
[dir=rtl] .next {
|
||||
float: left;
|
||||
right: unset;
|
||||
left: var(--page-padding);
|
||||
}
|
||||
|
||||
/* Use the correct buttons for RTL layouts*/
|
||||
[dir=rtl] .previous i.fa-angle-left:before {content:"\f105";}
|
||||
[dir=rtl] .next i.fa-angle-right:before { content:"\f104"; }
|
||||
|
||||
@media only screen and (max-width: 1080px) {
|
||||
.nav-wide-wrapper { display: none; }
|
||||
.nav-wrapper { display: block; }
|
||||
}
|
||||
|
||||
/* sidebar-visible */
|
||||
@media only screen and (max-width: 1380px) {
|
||||
.sidebar-visible .nav-wide-wrapper { display: none; }
|
||||
.sidebar-visible .nav-wrapper { display: block; }
|
||||
#sidebar-toggle-anchor:checked ~ .page-wrapper .nav-wide-wrapper { display: none; }
|
||||
#sidebar-toggle-anchor:checked ~ .page-wrapper .nav-wrapper { display: block; }
|
||||
}
|
||||
|
||||
/* Inline code */
|
||||
@ -229,13 +245,13 @@ pre > .buttons :hover {
|
||||
background-color: var(--theme-hover);
|
||||
}
|
||||
pre > .buttons i {
|
||||
margin-left: 8px;
|
||||
margin-inline-start: 8px;
|
||||
}
|
||||
pre > .buttons button {
|
||||
cursor: inherit;
|
||||
margin: 0px 5px;
|
||||
padding: 3px 5px;
|
||||
font-size: 14px;
|
||||
padding: 4px 4px 3px 5px;
|
||||
font-size: 23px;
|
||||
|
||||
border-style: solid;
|
||||
border-width: 1px;
|
||||
@ -246,13 +262,40 @@ pre > .buttons button {
|
||||
transition-property: color,border-color,background-color;
|
||||
color: var(--icons);
|
||||
}
|
||||
|
||||
pre > .buttons button.clip-button {
|
||||
padding: 2px 4px 0px 6px;
|
||||
}
|
||||
pre > .buttons button.clip-button::before {
|
||||
/* clipboard image from octicons (https://github.com/primer/octicons/tree/v2.0.0) MIT license
|
||||
*/
|
||||
content: url('data:image/svg+xml,<svg width="21" height="20" viewBox="0 0 24 25" \
|
||||
xmlns="http://www.w3.org/2000/svg" aria-label="Copy to clipboard">\
|
||||
<path d="M18 20h2v3c0 1-1 2-2 2H2c-.998 0-2-1-2-2V5c0-.911.755-1.667 1.667-1.667h5A3.323 3.323 0 \
|
||||
0110 0a3.323 3.323 0 013.333 3.333h5C19.245 3.333 20 4.09 20 5v8.333h-2V9H2v14h16v-3zM3 \
|
||||
7h14c0-.911-.793-1.667-1.75-1.667H13.5c-.957 0-1.75-.755-1.75-1.666C11.75 2.755 10.957 2 10 \
|
||||
2s-1.75.755-1.75 1.667c0 .911-.793 1.666-1.75 1.666H4.75C3.793 5.333 3 6.09 3 7z"/>\
|
||||
<path d="M4 19h6v2H4zM12 11H4v2h8zM4 17h4v-2H4zM15 15v-3l-4.5 4.5L15 21v-3l8.027-.032L23 15z"/>\
|
||||
</svg>');
|
||||
filter: var(--copy-button-filter);
|
||||
}
|
||||
pre > .buttons button.clip-button:hover::before {
|
||||
filter: var(--copy-button-filter-hover);
|
||||
}
|
||||
|
||||
@media (pointer: coarse) {
|
||||
pre > .buttons button {
|
||||
/* On mobile, make it easier to tap buttons. */
|
||||
padding: 0.3rem 1rem;
|
||||
}
|
||||
|
||||
.sidebar-resize-indicator {
|
||||
/* Hide resize indicator on devices with limited accuracy */
|
||||
display: none;
|
||||
}
|
||||
}
|
||||
pre > code {
|
||||
display: block;
|
||||
padding: 1rem;
|
||||
}
|
||||
|
||||
@ -266,7 +309,7 @@ pre > code {
|
||||
}
|
||||
|
||||
pre > .result {
|
||||
margin-top: 10px;
|
||||
margin-block-start: 10px;
|
||||
}
|
||||
|
||||
/* Search */
|
||||
@ -277,8 +320,14 @@ pre > .result {
|
||||
|
||||
mark {
|
||||
border-radius: 2px;
|
||||
padding: 0 3px 1px 3px;
|
||||
margin: 0 -3px -1px -3px;
|
||||
padding-block-start: 0;
|
||||
padding-block-end: 1px;
|
||||
padding-inline-start: 3px;
|
||||
padding-inline-end: 3px;
|
||||
margin-block-start: 0;
|
||||
margin-block-end: -1px;
|
||||
margin-inline-start: -3px;
|
||||
margin-inline-end: -3px;
|
||||
background-color: var(--search-mark-bg);
|
||||
transition: background-color 300ms linear;
|
||||
cursor: pointer;
|
||||
@ -290,14 +339,17 @@ mark.fade-out {
|
||||
}
|
||||
|
||||
.searchbar-outer {
|
||||
margin-left: auto;
|
||||
margin-right: auto;
|
||||
margin-inline-start: auto;
|
||||
margin-inline-end: auto;
|
||||
max-width: var(--content-max-width);
|
||||
}
|
||||
|
||||
#searchbar {
|
||||
width: 100%;
|
||||
margin: 5px auto 0px auto;
|
||||
margin-block-start: 5px;
|
||||
margin-block-end: 0;
|
||||
margin-inline-start: auto;
|
||||
margin-inline-end: auto;
|
||||
padding: 10px 16px;
|
||||
transition: box-shadow 300ms ease-in-out;
|
||||
border: 1px solid var(--searchbar-border-color);
|
||||
@ -313,20 +365,23 @@ mark.fade-out {
|
||||
.searchresults-header {
|
||||
font-weight: bold;
|
||||
font-size: 1em;
|
||||
padding: 18px 0 0 5px;
|
||||
padding-block-start: 18px;
|
||||
padding-block-end: 0;
|
||||
padding-inline-start: 5px;
|
||||
padding-inline-end: 0;
|
||||
color: var(--searchresults-header-fg);
|
||||
}
|
||||
|
||||
.searchresults-outer {
|
||||
margin-left: auto;
|
||||
margin-right: auto;
|
||||
margin-inline-start: auto;
|
||||
margin-inline-end: auto;
|
||||
max-width: var(--content-max-width);
|
||||
border-bottom: 1px dashed var(--searchresults-border-color);
|
||||
border-block-end: 1px dashed var(--searchresults-border-color);
|
||||
}
|
||||
|
||||
ul#searchresults {
|
||||
list-style: none;
|
||||
padding-left: 20px;
|
||||
padding-inline-start: 20px;
|
||||
}
|
||||
ul#searchresults li {
|
||||
margin: 10px 0px;
|
||||
@ -339,7 +394,10 @@ ul#searchresults li.focus {
|
||||
ul#searchresults span.teaser {
|
||||
display: block;
|
||||
clear: both;
|
||||
margin: 5px 0 0 20px;
|
||||
margin-block-start: 5px;
|
||||
margin-block-end: 0;
|
||||
margin-inline-start: 20px;
|
||||
margin-inline-end: 0;
|
||||
font-size: 0.8em;
|
||||
}
|
||||
ul#searchresults span.teaser em {
|
||||
@ -362,13 +420,33 @@ ul#searchresults span.teaser em {
|
||||
background-color: var(--sidebar-bg);
|
||||
color: var(--sidebar-fg);
|
||||
}
|
||||
.sidebar-iframe-inner {
|
||||
--padding: 10px;
|
||||
|
||||
background-color: var(--sidebar-bg);
|
||||
padding: var(--padding);
|
||||
margin: 0;
|
||||
font-size: 1.4rem;
|
||||
color: var(--sidebar-fg);
|
||||
min-height: calc(100vh - var(--padding) * 2);
|
||||
}
|
||||
.sidebar-iframe-outer {
|
||||
border: none;
|
||||
height: 100%;
|
||||
position: absolute;
|
||||
top: 0;
|
||||
bottom: 0;
|
||||
left: 0;
|
||||
right: 0;
|
||||
}
|
||||
[dir=rtl] .sidebar { left: unset; right: 0; }
|
||||
.sidebar-resizing {
|
||||
-moz-user-select: none;
|
||||
-webkit-user-select: none;
|
||||
-ms-user-select: none;
|
||||
user-select: none;
|
||||
}
|
||||
.js:not(.sidebar-resizing) .sidebar {
|
||||
html:not(.sidebar-resizing) .sidebar {
|
||||
transition: transform 0.3s; /* Animation: slide away */
|
||||
}
|
||||
.sidebar code {
|
||||
@ -387,16 +465,35 @@ ul#searchresults span.teaser em {
|
||||
position: absolute;
|
||||
cursor: col-resize;
|
||||
width: 0;
|
||||
right: 0;
|
||||
right: calc(var(--sidebar-resize-indicator-width) * -1);
|
||||
top: 0;
|
||||
bottom: 0;
|
||||
display: flex;
|
||||
align-items: center;
|
||||
}
|
||||
|
||||
.sidebar-resize-handle .sidebar-resize-indicator {
|
||||
width: 100%;
|
||||
height: 12px;
|
||||
background-color: var(--icons);
|
||||
margin-inline-start: var(--sidebar-resize-indicator-space);
|
||||
}
|
||||
|
||||
[dir=rtl] .sidebar .sidebar-resize-handle {
|
||||
left: calc(var(--sidebar-resize-indicator-width) * -1);
|
||||
right: unset;
|
||||
}
|
||||
.js .sidebar .sidebar-resize-handle {
|
||||
cursor: col-resize;
|
||||
width: 5px;
|
||||
width: calc(var(--sidebar-resize-indicator-width) - var(--sidebar-resize-indicator-space));
|
||||
}
|
||||
.sidebar-hidden .sidebar {
|
||||
transform: translateX(calc(0px - var(--sidebar-width)));
|
||||
/* sidebar-hidden */
|
||||
#sidebar-toggle-anchor:not(:checked) ~ .sidebar {
|
||||
transform: translateX(calc(0px - var(--sidebar-width) - var(--sidebar-resize-indicator-width)));
|
||||
z-index: -1;
|
||||
}
|
||||
[dir=rtl] #sidebar-toggle-anchor:not(:checked) ~ .sidebar {
|
||||
transform: translateX(calc(var(--sidebar-width) + var(--sidebar-resize-indicator-width)));
|
||||
}
|
||||
.sidebar::-webkit-scrollbar {
|
||||
background: var(--sidebar-bg);
|
||||
@ -405,19 +502,26 @@ ul#searchresults span.teaser em {
|
||||
background: var(--scrollbar);
|
||||
}
|
||||
|
||||
.sidebar-visible .page-wrapper {
|
||||
transform: translateX(var(--sidebar-width));
|
||||
/* sidebar-visible */
|
||||
#sidebar-toggle-anchor:checked ~ .page-wrapper {
|
||||
transform: translateX(calc(var(--sidebar-width) + var(--sidebar-resize-indicator-width)));
|
||||
}
|
||||
[dir=rtl] #sidebar-toggle-anchor:checked ~ .page-wrapper {
|
||||
transform: translateX(calc(0px - var(--sidebar-width) - var(--sidebar-resize-indicator-width)));
|
||||
}
|
||||
@media only screen and (min-width: 620px) {
|
||||
.sidebar-visible .page-wrapper {
|
||||
#sidebar-toggle-anchor:checked ~ .page-wrapper {
|
||||
transform: none;
|
||||
margin-inline-start: calc(var(--sidebar-width) + var(--sidebar-resize-indicator-width));
|
||||
}
|
||||
[dir=rtl] #sidebar-toggle-anchor:checked ~ .page-wrapper {
|
||||
transform: none;
|
||||
margin-left: var(--sidebar-width);
|
||||
}
|
||||
}
|
||||
|
||||
.chapter {
|
||||
list-style: none outside none;
|
||||
padding-left: 0;
|
||||
padding-inline-start: 0;
|
||||
line-height: 2.2em;
|
||||
}
|
||||
|
||||
@ -447,7 +551,7 @@ ul#searchresults span.teaser em {
|
||||
.chapter li > a.toggle {
|
||||
cursor: pointer;
|
||||
display: block;
|
||||
margin-left: auto;
|
||||
margin-inline-start: auto;
|
||||
padding: 0 10px;
|
||||
user-select: none;
|
||||
opacity: 0.68;
|
||||
@ -464,7 +568,7 @@ ul#searchresults span.teaser em {
|
||||
|
||||
.chapter li.chapter-item {
|
||||
line-height: 1.5em;
|
||||
margin-top: 0.6em;
|
||||
margin-block-start: 0.6em;
|
||||
}
|
||||
|
||||
.chapter li.expanded > a.toggle div {
|
||||
@ -487,7 +591,7 @@ ul#searchresults span.teaser em {
|
||||
|
||||
.section {
|
||||
list-style: none outside none;
|
||||
padding-left: 20px;
|
||||
padding-inline-start: 20px;
|
||||
line-height: 1.9em;
|
||||
}
|
||||
|
||||
@ -507,7 +611,10 @@ ul#searchresults span.teaser em {
|
||||
padding: 0;
|
||||
list-style: none;
|
||||
display: none;
|
||||
/* Don't let the children's background extend past the rounded corners. */
|
||||
overflow: hidden;
|
||||
}
|
||||
[dir=rtl] .theme-popup { left: unset; right: 10px; }
|
||||
.theme-popup .default {
|
||||
color: var(--icons);
|
||||
}
|
||||
@ -515,10 +622,10 @@ ul#searchresults span.teaser em {
|
||||
width: 100%;
|
||||
border: 0;
|
||||
margin: 0;
|
||||
padding: 2px 10px;
|
||||
padding: 2px 20px;
|
||||
line-height: 25px;
|
||||
white-space: nowrap;
|
||||
text-align: left;
|
||||
text-align: start;
|
||||
cursor: pointer;
|
||||
color: inherit;
|
||||
background: inherit;
|
||||
@ -527,8 +634,10 @@ ul#searchresults span.teaser em {
|
||||
.theme-popup .theme:hover {
|
||||
background-color: var(--theme-hover);
|
||||
}
|
||||
.theme-popup .theme:hover:first-child,
|
||||
.theme-popup .theme:hover:last-child {
|
||||
border-top-left-radius: inherit;
|
||||
border-top-right-radius: inherit;
|
||||
|
||||
.theme-selected::before {
|
||||
display: inline-block;
|
||||
content: "✓";
|
||||
margin-inline-start: -14px;
|
||||
width: 14px;
|
||||
}
|
||||
@ -1,10 +1,9 @@
|
||||
/* Base styles and content styles */
|
||||
|
||||
@import 'variables.css';
|
||||
|
||||
:root {
|
||||
/* Browser default font-size is 16px, this way 1 rem = 10px */
|
||||
font-size: 62.5%;
|
||||
color-scheme: var(--color-scheme);
|
||||
}
|
||||
|
||||
html {
|
||||
@ -22,8 +21,9 @@ body {
|
||||
}
|
||||
|
||||
code {
|
||||
font-family: "Source Code Pro", Consolas, "Ubuntu Mono", Menlo, "DejaVu Sans Mono", monospace, monospace !important;
|
||||
font-size: 0.875em; /* please adjust the ace font size accordingly in editor.js */
|
||||
font-family: var(--mono-font) !important;
|
||||
font-size: var(--code-font-size);
|
||||
direction: ltr !important;
|
||||
}
|
||||
|
||||
/* make long words/inline code not x overflow */
|
||||
@ -47,13 +47,13 @@ h1 code, h2 code, h3 code, h4 code, h5 code, h6 code {
|
||||
.hide-boring .boring { display: none; }
|
||||
.hidden { display: none !important; }
|
||||
|
||||
h2, h3 { margin-top: 2.5em; }
|
||||
h4, h5 { margin-top: 2em; }
|
||||
h2, h3 { margin-block-start: 2.5em; }
|
||||
h4, h5 { margin-block-start: 2em; }
|
||||
|
||||
.header + .header h3,
|
||||
.header + .header h4,
|
||||
.header + .header h5 {
|
||||
margin-top: 1em;
|
||||
margin-block-start: 1em;
|
||||
}
|
||||
|
||||
h1:target::before,
|
||||
@ -64,7 +64,7 @@ h5:target::before,
|
||||
h6:target::before {
|
||||
display: inline-block;
|
||||
content: "»";
|
||||
margin-left: -30px;
|
||||
margin-inline-start: -30px;
|
||||
width: 30px;
|
||||
}
|
||||
|
||||
@ -73,28 +73,34 @@ h6:target::before {
|
||||
https://bugs.webkit.org/show_bug.cgi?id=218076
|
||||
*/
|
||||
:target {
|
||||
/* Safari does not support logical properties */
|
||||
scroll-margin-top: calc(var(--menu-bar-height) + 0.5em);
|
||||
}
|
||||
|
||||
.page {
|
||||
outline: 0;
|
||||
padding: 0 var(--page-padding);
|
||||
margin-top: calc(0px - var(--menu-bar-height)); /* Compensate for the #menu-bar-hover-placeholder */
|
||||
margin-block-start: calc(0px - var(--menu-bar-height)); /* Compensate for the #menu-bar-hover-placeholder */
|
||||
}
|
||||
.page-wrapper {
|
||||
box-sizing: border-box;
|
||||
background-color: var(--bg);
|
||||
}
|
||||
.no-js .page-wrapper,
|
||||
.js:not(.sidebar-resizing) .page-wrapper {
|
||||
transition: margin-left 0.3s ease, transform 0.3s ease; /* Animation: slide away */
|
||||
}
|
||||
[dir=rtl] .js:not(.sidebar-resizing) .page-wrapper {
|
||||
transition: margin-right 0.3s ease, transform 0.3s ease; /* Animation: slide away */
|
||||
}
|
||||
|
||||
.content {
|
||||
overflow-y: auto;
|
||||
padding: 0 5px 50px 5px;
|
||||
}
|
||||
.content main {
|
||||
margin-left: auto;
|
||||
margin-right: auto;
|
||||
margin-inline-start: auto;
|
||||
margin-inline-end: auto;
|
||||
max-width: var(--content-max-width);
|
||||
}
|
||||
.content p { line-height: 1.45em; }
|
||||
@ -144,14 +150,61 @@ blockquote {
|
||||
padding: 0 20px;
|
||||
color: var(--fg);
|
||||
background-color: var(--quote-bg);
|
||||
border-top: .1em solid var(--quote-border);
|
||||
border-bottom: .1em solid var(--quote-border);
|
||||
border-block-start: .1em solid var(--quote-border);
|
||||
border-block-end: .1em solid var(--quote-border);
|
||||
}
|
||||
|
||||
.warning {
|
||||
margin: 20px;
|
||||
padding: 0 20px;
|
||||
border-inline-start: 2px solid var(--warning-border);
|
||||
}
|
||||
|
||||
:not(.footnote-definition) + .footnote-definition,
|
||||
.footnote-definition + :not(.footnote-definition) {
|
||||
margin-top: 2em;
|
||||
.warning:before {
|
||||
position: absolute;
|
||||
width: 3rem;
|
||||
height: 3rem;
|
||||
margin-inline-start: calc(-1.5rem - 21px);
|
||||
content: "ⓘ";
|
||||
text-align: center;
|
||||
background-color: var(--bg);
|
||||
color: var(--warning-border);
|
||||
font-weight: bold;
|
||||
font-size: 2rem;
|
||||
}
|
||||
|
||||
blockquote .warning:before {
|
||||
background-color: var(--quote-bg);
|
||||
}
|
||||
|
||||
kbd {
|
||||
background-color: var(--table-border-color);
|
||||
border-radius: 4px;
|
||||
border: solid 1px var(--theme-popup-border);
|
||||
box-shadow: inset 0 -1px 0 var(--theme-hover);
|
||||
display: inline-block;
|
||||
font-size: var(--code-font-size);
|
||||
font-family: var(--mono-font);
|
||||
line-height: 10px;
|
||||
padding: 4px 5px;
|
||||
vertical-align: middle;
|
||||
}
|
||||
|
||||
sup {
|
||||
/* Set the line-height for superscript and footnote references so that there
|
||||
isn't an awkward space appearing above lines that contain the footnote.
|
||||
|
||||
See https://github.com/rust-lang/mdBook/pull/2443#discussion_r1813773583
|
||||
for an explanation.
|
||||
*/
|
||||
line-height: 0;
|
||||
}
|
||||
|
||||
:not(.footnote-definition) + .footnote-definition {
|
||||
margin-block-start: 2em;
|
||||
}
|
||||
.footnote-definition:not(:has(+ .footnote-definition)) {
|
||||
margin-block-end: 2em;
|
||||
}
|
||||
.footnote-definition {
|
||||
font-size: 0.9em;
|
||||
@ -7,8 +7,8 @@
|
||||
}
|
||||
|
||||
#page-wrapper.page-wrapper {
|
||||
transform: none;
|
||||
margin-left: 0px;
|
||||
transform: none !important;
|
||||
margin-inline-start: 0px;
|
||||
overflow-y: initial;
|
||||
}
|
||||
|
||||
@ -23,11 +23,7 @@
|
||||
}
|
||||
|
||||
code {
|
||||
background-color: #666666;
|
||||
border-radius: 5px;
|
||||
|
||||
/* Force background to be printed in Chrome */
|
||||
-webkit-print-color-adjust: exact;
|
||||
direction: ltr !important;
|
||||
}
|
||||
|
||||
pre > .buttons {
|
||||
@ -3,9 +3,13 @@
|
||||
|
||||
:root {
|
||||
--sidebar-width: 300px;
|
||||
--sidebar-resize-indicator-width: 8px;
|
||||
--sidebar-resize-indicator-space: 2px;
|
||||
--page-padding: 15px;
|
||||
--content-max-width: 750px;
|
||||
--menu-bar-height: 50px;
|
||||
--mono-font: "Source Code Pro", Consolas, "Ubuntu Mono", Menlo, "DejaVu Sans Mono", monospace, monospace;
|
||||
--code-font-size: 0.875em; /* please adjust the ace font size accordingly in editor.js */
|
||||
}
|
||||
|
||||
/* Themes */
|
||||
@ -36,6 +40,8 @@
|
||||
--quote-bg: hsl(226, 15%, 17%);
|
||||
--quote-border: hsl(226, 15%, 22%);
|
||||
|
||||
--warning-border: #ff8e00;
|
||||
|
||||
--table-border-color: hsl(210, 25%, 13%);
|
||||
--table-header-bg: hsl(210, 25%, 28%);
|
||||
--table-alternate-bg: hsl(210, 25%, 11%);
|
||||
@ -48,6 +54,13 @@
|
||||
--searchresults-border-color: #888;
|
||||
--searchresults-li-bg: #252932;
|
||||
--search-mark-bg: #e3b171;
|
||||
|
||||
--color-scheme: dark;
|
||||
|
||||
/* Same as `--icons` */
|
||||
--copy-button-filter: invert(45%) sepia(6%) saturate(621%) hue-rotate(198deg) brightness(99%) contrast(85%);
|
||||
/* Same as `--sidebar-active` */
|
||||
--copy-button-filter-hover: invert(68%) sepia(55%) saturate(531%) hue-rotate(341deg) brightness(104%) contrast(101%);
|
||||
}
|
||||
|
||||
.coal {
|
||||
@ -76,6 +89,8 @@
|
||||
--quote-bg: hsl(234, 21%, 18%);
|
||||
--quote-border: hsl(234, 21%, 23%);
|
||||
|
||||
--warning-border: #ff8e00;
|
||||
|
||||
--table-border-color: hsl(200, 7%, 13%);
|
||||
--table-header-bg: hsl(200, 7%, 28%);
|
||||
--table-alternate-bg: hsl(200, 7%, 11%);
|
||||
@ -88,9 +103,16 @@
|
||||
--searchresults-border-color: #98a3ad;
|
||||
--searchresults-li-bg: #2b2b2f;
|
||||
--search-mark-bg: #355c7d;
|
||||
|
||||
--color-scheme: dark;
|
||||
|
||||
/* Same as `--icons` */
|
||||
--copy-button-filter: invert(26%) sepia(8%) saturate(575%) hue-rotate(169deg) brightness(87%) contrast(82%);
|
||||
/* Same as `--sidebar-active` */
|
||||
--copy-button-filter-hover: invert(36%) sepia(70%) saturate(503%) hue-rotate(167deg) brightness(98%) contrast(89%);
|
||||
}
|
||||
|
||||
.light {
|
||||
.light, html:not(.js) {
|
||||
--bg: hsl(0, 0%, 100%);
|
||||
--fg: hsl(0, 0%, 0%);
|
||||
|
||||
@ -116,6 +138,8 @@
|
||||
--quote-bg: hsl(197, 37%, 96%);
|
||||
--quote-border: hsl(197, 37%, 91%);
|
||||
|
||||
--warning-border: #ff8e00;
|
||||
|
||||
--table-border-color: hsl(0, 0%, 95%);
|
||||
--table-header-bg: hsl(0, 0%, 80%);
|
||||
--table-alternate-bg: hsl(0, 0%, 97%);
|
||||
@ -128,6 +152,13 @@
|
||||
--searchresults-border-color: #888;
|
||||
--searchresults-li-bg: #e4f2fe;
|
||||
--search-mark-bg: #a2cff5;
|
||||
|
||||
--color-scheme: light;
|
||||
|
||||
/* Same as `--icons` */
|
||||
--copy-button-filter: invert(45.49%);
|
||||
/* Same as `--sidebar-active` */
|
||||
--copy-button-filter-hover: invert(14%) sepia(93%) saturate(4250%) hue-rotate(243deg) brightness(99%) contrast(130%);
|
||||
}
|
||||
|
||||
.navy {
|
||||
@ -156,6 +187,8 @@
|
||||
--quote-bg: hsl(226, 15%, 17%);
|
||||
--quote-border: hsl(226, 15%, 22%);
|
||||
|
||||
--warning-border: #ff8e00;
|
||||
|
||||
--table-border-color: hsl(226, 23%, 16%);
|
||||
--table-header-bg: hsl(226, 23%, 31%);
|
||||
--table-alternate-bg: hsl(226, 23%, 14%);
|
||||
@ -168,6 +201,13 @@
|
||||
--searchresults-border-color: #5c5c68;
|
||||
--searchresults-li-bg: #242430;
|
||||
--search-mark-bg: #a2cff5;
|
||||
|
||||
--color-scheme: dark;
|
||||
|
||||
/* Same as `--icons` */
|
||||
--copy-button-filter: invert(51%) sepia(10%) saturate(393%) hue-rotate(198deg) brightness(86%) contrast(87%);
|
||||
/* Same as `--sidebar-active` */
|
||||
--copy-button-filter-hover: invert(46%) sepia(20%) saturate(1537%) hue-rotate(156deg) brightness(85%) contrast(90%);
|
||||
}
|
||||
|
||||
.rust {
|
||||
@ -196,6 +236,8 @@
|
||||
--quote-bg: hsl(60, 5%, 75%);
|
||||
--quote-border: hsl(60, 5%, 70%);
|
||||
|
||||
--warning-border: #ff8e00;
|
||||
|
||||
--table-border-color: hsl(60, 9%, 82%);
|
||||
--table-header-bg: #b3a497;
|
||||
--table-alternate-bg: hsl(60, 9%, 84%);
|
||||
@ -208,10 +250,15 @@
|
||||
--searchresults-border-color: #888;
|
||||
--searchresults-li-bg: #dec2a2;
|
||||
--search-mark-bg: #e69f67;
|
||||
|
||||
/* Same as `--icons` */
|
||||
--copy-button-filter: invert(51%) sepia(10%) saturate(393%) hue-rotate(198deg) brightness(86%) contrast(87%);
|
||||
/* Same as `--sidebar-active` */
|
||||
--copy-button-filter-hover: invert(77%) sepia(16%) saturate(1798%) hue-rotate(328deg) brightness(98%) contrast(83%);
|
||||
}
|
||||
|
||||
@media (prefers-color-scheme: dark) {
|
||||
.light.no-js {
|
||||
html:not(.js) {
|
||||
--bg: hsl(200, 7%, 8%);
|
||||
--fg: #98a3ad;
|
||||
|
||||
@ -237,6 +284,8 @@
|
||||
--quote-bg: hsl(234, 21%, 18%);
|
||||
--quote-border: hsl(234, 21%, 23%);
|
||||
|
||||
--warning-border: #ff8e00;
|
||||
|
||||
--table-border-color: hsl(200, 7%, 13%);
|
||||
--table-header-bg: hsl(200, 7%, 28%);
|
||||
--table-alternate-bg: hsl(200, 7%, 11%);
|
||||
@ -249,5 +298,12 @@
|
||||
--searchresults-border-color: #98a3ad;
|
||||
--searchresults-li-bg: #2b2b2f;
|
||||
--search-mark-bg: #355c7d;
|
||||
|
||||
--color-scheme: dark;
|
||||
|
||||
/* Same as `--icons` */
|
||||
--copy-button-filter: invert(26%) sepia(8%) saturate(575%) hue-rotate(169deg) brightness(87%) contrast(82%);
|
||||
/* Same as `--sidebar-active` */
|
||||
--copy-button-filter-hover: invert(36%) sepia(70%) saturate(503%) hue-rotate(167deg) brightness(98%) contrast(89%);
|
||||
}
|
||||
}
|
||||
|
Before Width: | Height: | Size: 5.5 KiB After Width: | Height: | Size: 5.5 KiB |
|
Before Width: | Height: | Size: 1.8 KiB After Width: | Height: | Size: 1.8 KiB |
@ -16,6 +16,7 @@
|
||||
.hljs-variable,
|
||||
.hljs-template-variable,
|
||||
.hljs-attribute,
|
||||
.hljs-attr,
|
||||
.hljs-tag,
|
||||
.hljs-name,
|
||||
.hljs-regexp,
|
||||
54
zsh-guide/book/highlight.js
Normal file
54
zsh-guide/book/highlight.js
Normal file
File diff suppressed because one or more lines are too long
@ -1,17 +1,16 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
<title>A User's Guide to the Z-Shell - Zsh User's Guide</title>
|
||||
<title>A User's Guide to the Z-Shell - Zsh Guide</title>
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded affix "><a href="zshguide.html" class="active">A User's Guide to the Z-Shell</a></li><li class="chapter-item expanded "><a href="zshguide01.html"><strong aria-hidden="true">1.</strong> A short introduction</a></li><li class="chapter-item expanded "><a href="zshguide02.html"><strong aria-hidden="true">2.</strong> What to put in your startup files</a></li><li class="chapter-item expanded "><a href="zshguide03.html"><strong aria-hidden="true">3.</strong> Dealing with basic shell syntax</a></li><li class="chapter-item expanded "><a href="zshguide04.html"><strong aria-hidden="true">4.</strong> The Z-Shell Line Editor</a></li><li class="chapter-item expanded "><a href="zshguide05.html"><strong aria-hidden="true">5.</strong> Substitutions</a></li><li class="chapter-item expanded "><a href="zshguide06.html"><strong aria-hidden="true">6.</strong> Completion, old and new</a></li><li class="chapter-item expanded "><a href="zshguide07.html"><strong aria-hidden="true">7.</strong> Modules and other bits and pieces Not written</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -116,7 +120,7 @@
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<h1 class="menu-title">Zsh User's Guide</h1>
|
||||
<h1 class="menu-title">Zsh Guide</h1>
|
||||
|
||||
<div class="right-buttons">
|
||||
<a href="print.html" title="Print this book" aria-label="Print this book">
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -378,7 +382,7 @@ etc.</a></p>
|
||||
<nav class="nav-wrapper" aria-label="Page navigation">
|
||||
<!-- Mobile navigation buttons -->
|
||||
|
||||
<a rel="next" href="zshguide01.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="zshguide01.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -389,31 +393,48 @@ etc.</a></p>
|
||||
|
||||
<nav class="nav-wide-wrapper" aria-label="Page navigation">
|
||||
|
||||
<a rel="next" href="zshguide01.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="zshguide01.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
socket.onmessage = function (event) {
|
||||
if (event.data === "reload") {
|
||||
socket.close();
|
||||
location.reload();
|
||||
}
|
||||
};
|
||||
|
||||
window.onbeforeunload = function() {
|
||||
socket.close();
|
||||
}
|
||||
</script>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
File diff suppressed because it is too large
Load Diff
@ -316,7 +316,7 @@ window.search = window.search || {};
|
||||
|
||||
// Eventhandler for keyevents on `document`
|
||||
function globalKeyHandler(e) {
|
||||
if (e.altKey || e.ctrlKey || e.metaKey || e.shiftKey || e.target.type === 'textarea' || e.target.type === 'text') { return; }
|
||||
if (e.altKey || e.ctrlKey || e.metaKey || e.shiftKey || e.target.type === 'textarea' || e.target.type === 'text' || !hasFocus() && /^(?:input|select|textarea)$/i.test(e.target.nodeName)) { return; }
|
||||
|
||||
if (e.keyCode === ESCAPE_KEYCODE) {
|
||||
e.preventDefault();
|
||||
1
zsh-guide/book/searchindex.js
Normal file
1
zsh-guide/book/searchindex.js
Normal file
File diff suppressed because one or more lines are too long
1
zsh-guide/book/searchindex.json
Normal file
1
zsh-guide/book/searchindex.json
Normal file
File diff suppressed because one or more lines are too long
836
zsh-guide/book/theme/catppuccin.css
Normal file
836
zsh-guide/book/theme/catppuccin.css
Normal file
@ -0,0 +1,836 @@
|
||||
/* https://highlightjs.readthedocs.io/en/latest/css-classes-reference.html */
|
||||
.latte.hljs {
|
||||
color: #4c4f69;
|
||||
background: #eff1f5;
|
||||
}
|
||||
.latte .hljs-keyword {
|
||||
color: #8839ef;
|
||||
}
|
||||
.latte .hljs-built_in {
|
||||
color: #d20f39;
|
||||
}
|
||||
.latte .hljs-type {
|
||||
color: #df8e1d;
|
||||
}
|
||||
.latte .hljs-literal {
|
||||
color: #fe640b;
|
||||
}
|
||||
.latte .hljs-number {
|
||||
color: #fe640b;
|
||||
}
|
||||
.latte .hljs-operator {
|
||||
color: #04a5e5;
|
||||
}
|
||||
.latte .hljs-punctuation {
|
||||
color: #5c5f77;
|
||||
}
|
||||
.latte .hljs-property {
|
||||
color: #179299;
|
||||
}
|
||||
.latte .hljs-regexp {
|
||||
color: #ea76cb;
|
||||
}
|
||||
.latte .hljs-string {
|
||||
color: #40a02b;
|
||||
}
|
||||
.latte .hljs-char.escape_ {
|
||||
color: #40a02b;
|
||||
}
|
||||
.latte .hljs-subst {
|
||||
color: #6c6f85;
|
||||
}
|
||||
.latte .hljs-symbol {
|
||||
color: #dd7878;
|
||||
}
|
||||
.latte .hljs-variable {
|
||||
color: #8839ef;
|
||||
}
|
||||
.latte .hljs-variable.language_ {
|
||||
color: #8839ef;
|
||||
}
|
||||
.latte .hljs-variable.constant_ {
|
||||
color: #fe640b;
|
||||
}
|
||||
.latte .hljs-title {
|
||||
color: #1e66f5;
|
||||
}
|
||||
.latte .hljs-title.class_ {
|
||||
color: #df8e1d;
|
||||
}
|
||||
.latte .hljs-title.function_ {
|
||||
color: #1e66f5;
|
||||
}
|
||||
.latte .hljs-params {
|
||||
color: #4c4f69;
|
||||
}
|
||||
.latte .hljs-comment {
|
||||
color: #7c7f93;
|
||||
}
|
||||
.latte .hljs-doctag {
|
||||
color: #d20f39;
|
||||
}
|
||||
.latte .hljs-meta {
|
||||
color: #fe640b;
|
||||
}
|
||||
.latte .hljs-section {
|
||||
color: #1e66f5;
|
||||
}
|
||||
.latte .hljs-tag {
|
||||
color: #179299;
|
||||
}
|
||||
.latte .hljs-name {
|
||||
color: #8839ef;
|
||||
}
|
||||
.latte .hljs-attr {
|
||||
color: #1e66f5;
|
||||
}
|
||||
.latte .hljs-attribute {
|
||||
color: #40a02b;
|
||||
}
|
||||
.latte .hljs-bullet {
|
||||
color: #179299;
|
||||
}
|
||||
.latte .hljs-code {
|
||||
color: #40a02b;
|
||||
}
|
||||
.latte .hljs-emphasis {
|
||||
color: #d20f39;
|
||||
font-style: italic;
|
||||
}
|
||||
.latte .hljs-strong {
|
||||
color: #d20f39;
|
||||
font-weight: bold;
|
||||
}
|
||||
.latte .hljs-formula {
|
||||
color: #179299;
|
||||
}
|
||||
.latte .hljs-link {
|
||||
color: #209fb5;
|
||||
font-style: italic;
|
||||
}
|
||||
.latte .hljs-quote {
|
||||
color: #40a02b;
|
||||
font-style: italic;
|
||||
}
|
||||
.latte .hljs-selector-tag {
|
||||
color: #df8e1d;
|
||||
}
|
||||
.latte .hljs-selector-id {
|
||||
color: #1e66f5;
|
||||
}
|
||||
.latte .hljs-selector-class {
|
||||
color: #179299;
|
||||
}
|
||||
.latte .hljs-selector-attr {
|
||||
color: #8839ef;
|
||||
}
|
||||
.latte .hljs-selector-pseudo {
|
||||
color: #179299;
|
||||
}
|
||||
.latte .hljs-template-tag {
|
||||
color: #dd7878;
|
||||
}
|
||||
.latte .hljs-template-variable {
|
||||
color: #dd7878;
|
||||
}
|
||||
.latte .hljs-addition {
|
||||
color: #40a02b;
|
||||
background: rgba(64, 160, 43, 0.15);
|
||||
}
|
||||
.latte .hljs-deletion {
|
||||
color: #d20f39;
|
||||
background: rgba(210, 15, 57, 0.15);
|
||||
}
|
||||
.latte :is(h1, h2, h3, h4, h5, h6) a code {
|
||||
color: #4c4f69;
|
||||
}
|
||||
.latte a code {
|
||||
color: #1e66f5;
|
||||
}
|
||||
.latte code {
|
||||
color: #4c4f69;
|
||||
background: #e6e9ef;
|
||||
}
|
||||
.latte blockquote blockquote {
|
||||
border-top: 0.1em solid #acb0be;
|
||||
border-bottom: 0.1em solid #acb0be;
|
||||
}
|
||||
.latte hr {
|
||||
border-color: #acb0be;
|
||||
border-style: solid;
|
||||
}
|
||||
.latte del {
|
||||
color: #7c7f93;
|
||||
}
|
||||
.latte .ace_gutter {
|
||||
color: #8c8fa1;
|
||||
background: #e6e9ef;
|
||||
}
|
||||
.latte .ace_gutter-active-line.ace_gutter-cell {
|
||||
color: #ea76cb;
|
||||
background: #e6e9ef;
|
||||
}
|
||||
.latte .tooltiptext {
|
||||
background: #e6e9ef;
|
||||
color: #4c4f69;
|
||||
}
|
||||
|
||||
.frappe.hljs {
|
||||
color: #c6d0f5;
|
||||
background: #303446;
|
||||
}
|
||||
.frappe .hljs-keyword {
|
||||
color: #ca9ee6;
|
||||
}
|
||||
.frappe .hljs-built_in {
|
||||
color: #e78284;
|
||||
}
|
||||
.frappe .hljs-type {
|
||||
color: #e5c890;
|
||||
}
|
||||
.frappe .hljs-literal {
|
||||
color: #ef9f76;
|
||||
}
|
||||
.frappe .hljs-number {
|
||||
color: #ef9f76;
|
||||
}
|
||||
.frappe .hljs-operator {
|
||||
color: #99d1db;
|
||||
}
|
||||
.frappe .hljs-punctuation {
|
||||
color: #b5bfe2;
|
||||
}
|
||||
.frappe .hljs-property {
|
||||
color: #81c8be;
|
||||
}
|
||||
.frappe .hljs-regexp {
|
||||
color: #f4b8e4;
|
||||
}
|
||||
.frappe .hljs-string {
|
||||
color: #a6d189;
|
||||
}
|
||||
.frappe .hljs-char.escape_ {
|
||||
color: #a6d189;
|
||||
}
|
||||
.frappe .hljs-subst {
|
||||
color: #a5adce;
|
||||
}
|
||||
.frappe .hljs-symbol {
|
||||
color: #eebebe;
|
||||
}
|
||||
.frappe .hljs-variable {
|
||||
color: #ca9ee6;
|
||||
}
|
||||
.frappe .hljs-variable.language_ {
|
||||
color: #ca9ee6;
|
||||
}
|
||||
.frappe .hljs-variable.constant_ {
|
||||
color: #ef9f76;
|
||||
}
|
||||
.frappe .hljs-title {
|
||||
color: #8caaee;
|
||||
}
|
||||
.frappe .hljs-title.class_ {
|
||||
color: #e5c890;
|
||||
}
|
||||
.frappe .hljs-title.function_ {
|
||||
color: #8caaee;
|
||||
}
|
||||
.frappe .hljs-params {
|
||||
color: #c6d0f5;
|
||||
}
|
||||
.frappe .hljs-comment {
|
||||
color: #949cbb;
|
||||
}
|
||||
.frappe .hljs-doctag {
|
||||
color: #e78284;
|
||||
}
|
||||
.frappe .hljs-meta {
|
||||
color: #ef9f76;
|
||||
}
|
||||
.frappe .hljs-section {
|
||||
color: #8caaee;
|
||||
}
|
||||
.frappe .hljs-tag {
|
||||
color: #81c8be;
|
||||
}
|
||||
.frappe .hljs-name {
|
||||
color: #ca9ee6;
|
||||
}
|
||||
.frappe .hljs-attr {
|
||||
color: #8caaee;
|
||||
}
|
||||
.frappe .hljs-attribute {
|
||||
color: #a6d189;
|
||||
}
|
||||
.frappe .hljs-bullet {
|
||||
color: #81c8be;
|
||||
}
|
||||
.frappe .hljs-code {
|
||||
color: #a6d189;
|
||||
}
|
||||
.frappe .hljs-emphasis {
|
||||
color: #e78284;
|
||||
font-style: italic;
|
||||
}
|
||||
.frappe .hljs-strong {
|
||||
color: #e78284;
|
||||
font-weight: bold;
|
||||
}
|
||||
.frappe .hljs-formula {
|
||||
color: #81c8be;
|
||||
}
|
||||
.frappe .hljs-link {
|
||||
color: #85c1dc;
|
||||
font-style: italic;
|
||||
}
|
||||
.frappe .hljs-quote {
|
||||
color: #a6d189;
|
||||
font-style: italic;
|
||||
}
|
||||
.frappe .hljs-selector-tag {
|
||||
color: #e5c890;
|
||||
}
|
||||
.frappe .hljs-selector-id {
|
||||
color: #8caaee;
|
||||
}
|
||||
.frappe .hljs-selector-class {
|
||||
color: #81c8be;
|
||||
}
|
||||
.frappe .hljs-selector-attr {
|
||||
color: #ca9ee6;
|
||||
}
|
||||
.frappe .hljs-selector-pseudo {
|
||||
color: #81c8be;
|
||||
}
|
||||
.frappe .hljs-template-tag {
|
||||
color: #eebebe;
|
||||
}
|
||||
.frappe .hljs-template-variable {
|
||||
color: #eebebe;
|
||||
}
|
||||
.frappe .hljs-addition {
|
||||
color: #a6d189;
|
||||
background: rgba(166, 209, 137, 0.15);
|
||||
}
|
||||
.frappe .hljs-deletion {
|
||||
color: #e78284;
|
||||
background: rgba(231, 130, 132, 0.15);
|
||||
}
|
||||
.frappe :is(h1, h2, h3, h4, h5, h6) a code {
|
||||
color: #c6d0f5;
|
||||
}
|
||||
.frappe a code {
|
||||
color: #8caaee;
|
||||
}
|
||||
.frappe code {
|
||||
color: #c6d0f5;
|
||||
background: #292c3c;
|
||||
}
|
||||
.frappe blockquote blockquote {
|
||||
border-top: 0.1em solid #626880;
|
||||
border-bottom: 0.1em solid #626880;
|
||||
}
|
||||
.frappe hr {
|
||||
border-color: #626880;
|
||||
border-style: solid;
|
||||
}
|
||||
.frappe del {
|
||||
color: #949cbb;
|
||||
}
|
||||
.frappe .ace_gutter {
|
||||
color: #838ba7;
|
||||
background: #292c3c;
|
||||
}
|
||||
.frappe .ace_gutter-active-line.ace_gutter-cell {
|
||||
color: #f4b8e4;
|
||||
background: #292c3c;
|
||||
}
|
||||
.frappe .tooltiptext {
|
||||
background: #292c3c;
|
||||
color: #c6d0f5;
|
||||
}
|
||||
|
||||
.macchiato.hljs {
|
||||
color: #cad3f5;
|
||||
background: #24273a;
|
||||
}
|
||||
.macchiato .hljs-keyword {
|
||||
color: #c6a0f6;
|
||||
}
|
||||
.macchiato .hljs-built_in {
|
||||
color: #ed8796;
|
||||
}
|
||||
.macchiato .hljs-type {
|
||||
color: #eed49f;
|
||||
}
|
||||
.macchiato .hljs-literal {
|
||||
color: #f5a97f;
|
||||
}
|
||||
.macchiato .hljs-number {
|
||||
color: #f5a97f;
|
||||
}
|
||||
.macchiato .hljs-operator {
|
||||
color: #91d7e3;
|
||||
}
|
||||
.macchiato .hljs-punctuation {
|
||||
color: #b8c0e0;
|
||||
}
|
||||
.macchiato .hljs-property {
|
||||
color: #8bd5ca;
|
||||
}
|
||||
.macchiato .hljs-regexp {
|
||||
color: #f5bde6;
|
||||
}
|
||||
.macchiato .hljs-string {
|
||||
color: #a6da95;
|
||||
}
|
||||
.macchiato .hljs-char.escape_ {
|
||||
color: #a6da95;
|
||||
}
|
||||
.macchiato .hljs-subst {
|
||||
color: #a5adcb;
|
||||
}
|
||||
.macchiato .hljs-symbol {
|
||||
color: #f0c6c6;
|
||||
}
|
||||
.macchiato .hljs-variable {
|
||||
color: #c6a0f6;
|
||||
}
|
||||
.macchiato .hljs-variable.language_ {
|
||||
color: #c6a0f6;
|
||||
}
|
||||
.macchiato .hljs-variable.constant_ {
|
||||
color: #f5a97f;
|
||||
}
|
||||
.macchiato .hljs-title {
|
||||
color: #8aadf4;
|
||||
}
|
||||
.macchiato .hljs-title.class_ {
|
||||
color: #eed49f;
|
||||
}
|
||||
.macchiato .hljs-title.function_ {
|
||||
color: #8aadf4;
|
||||
}
|
||||
.macchiato .hljs-params {
|
||||
color: #cad3f5;
|
||||
}
|
||||
.macchiato .hljs-comment {
|
||||
color: #939ab7;
|
||||
}
|
||||
.macchiato .hljs-doctag {
|
||||
color: #ed8796;
|
||||
}
|
||||
.macchiato .hljs-meta {
|
||||
color: #f5a97f;
|
||||
}
|
||||
.macchiato .hljs-section {
|
||||
color: #8aadf4;
|
||||
}
|
||||
.macchiato .hljs-tag {
|
||||
color: #8bd5ca;
|
||||
}
|
||||
.macchiato .hljs-name {
|
||||
color: #c6a0f6;
|
||||
}
|
||||
.macchiato .hljs-attr {
|
||||
color: #8aadf4;
|
||||
}
|
||||
.macchiato .hljs-attribute {
|
||||
color: #a6da95;
|
||||
}
|
||||
.macchiato .hljs-bullet {
|
||||
color: #8bd5ca;
|
||||
}
|
||||
.macchiato .hljs-code {
|
||||
color: #a6da95;
|
||||
}
|
||||
.macchiato .hljs-emphasis {
|
||||
color: #ed8796;
|
||||
font-style: italic;
|
||||
}
|
||||
.macchiato .hljs-strong {
|
||||
color: #ed8796;
|
||||
font-weight: bold;
|
||||
}
|
||||
.macchiato .hljs-formula {
|
||||
color: #8bd5ca;
|
||||
}
|
||||
.macchiato .hljs-link {
|
||||
color: #7dc4e4;
|
||||
font-style: italic;
|
||||
}
|
||||
.macchiato .hljs-quote {
|
||||
color: #a6da95;
|
||||
font-style: italic;
|
||||
}
|
||||
.macchiato .hljs-selector-tag {
|
||||
color: #eed49f;
|
||||
}
|
||||
.macchiato .hljs-selector-id {
|
||||
color: #8aadf4;
|
||||
}
|
||||
.macchiato .hljs-selector-class {
|
||||
color: #8bd5ca;
|
||||
}
|
||||
.macchiato .hljs-selector-attr {
|
||||
color: #c6a0f6;
|
||||
}
|
||||
.macchiato .hljs-selector-pseudo {
|
||||
color: #8bd5ca;
|
||||
}
|
||||
.macchiato .hljs-template-tag {
|
||||
color: #f0c6c6;
|
||||
}
|
||||
.macchiato .hljs-template-variable {
|
||||
color: #f0c6c6;
|
||||
}
|
||||
.macchiato .hljs-addition {
|
||||
color: #a6da95;
|
||||
background: rgba(166, 218, 149, 0.15);
|
||||
}
|
||||
.macchiato .hljs-deletion {
|
||||
color: #ed8796;
|
||||
background: rgba(237, 135, 150, 0.15);
|
||||
}
|
||||
.macchiato :is(h1, h2, h3, h4, h5, h6) a code {
|
||||
color: #cad3f5;
|
||||
}
|
||||
.macchiato a code {
|
||||
color: #8aadf4;
|
||||
}
|
||||
.macchiato code {
|
||||
color: #cad3f5;
|
||||
background: #1e2030;
|
||||
}
|
||||
.macchiato blockquote blockquote {
|
||||
border-top: 0.1em solid #5b6078;
|
||||
border-bottom: 0.1em solid #5b6078;
|
||||
}
|
||||
.macchiato hr {
|
||||
border-color: #5b6078;
|
||||
border-style: solid;
|
||||
}
|
||||
.macchiato del {
|
||||
color: #939ab7;
|
||||
}
|
||||
.macchiato .ace_gutter {
|
||||
color: #8087a2;
|
||||
background: #1e2030;
|
||||
}
|
||||
.macchiato .ace_gutter-active-line.ace_gutter-cell {
|
||||
color: #f5bde6;
|
||||
background: #1e2030;
|
||||
}
|
||||
.macchiato .tooltiptext {
|
||||
background: #1e2030;
|
||||
color: #cad3f5;
|
||||
}
|
||||
|
||||
.mocha.hljs {
|
||||
color: #cdd6f4;
|
||||
background: #1e1e2e;
|
||||
}
|
||||
.mocha .hljs-keyword {
|
||||
color: #cba6f7;
|
||||
}
|
||||
.mocha .hljs-built_in {
|
||||
color: #f38ba8;
|
||||
}
|
||||
.mocha .hljs-type {
|
||||
color: #f9e2af;
|
||||
}
|
||||
.mocha .hljs-literal {
|
||||
color: #fab387;
|
||||
}
|
||||
.mocha .hljs-number {
|
||||
color: #fab387;
|
||||
}
|
||||
.mocha .hljs-operator {
|
||||
color: #89dceb;
|
||||
}
|
||||
.mocha .hljs-punctuation {
|
||||
color: #bac2de;
|
||||
}
|
||||
.mocha .hljs-property {
|
||||
color: #94e2d5;
|
||||
}
|
||||
.mocha .hljs-regexp {
|
||||
color: #f5c2e7;
|
||||
}
|
||||
.mocha .hljs-string {
|
||||
color: #a6e3a1;
|
||||
}
|
||||
.mocha .hljs-char.escape_ {
|
||||
color: #a6e3a1;
|
||||
}
|
||||
.mocha .hljs-subst {
|
||||
color: #a6adc8;
|
||||
}
|
||||
.mocha .hljs-symbol {
|
||||
color: #f2cdcd;
|
||||
}
|
||||
.mocha .hljs-variable {
|
||||
color: #cba6f7;
|
||||
}
|
||||
.mocha .hljs-variable.language_ {
|
||||
color: #cba6f7;
|
||||
}
|
||||
.mocha .hljs-variable.constant_ {
|
||||
color: #fab387;
|
||||
}
|
||||
.mocha .hljs-title {
|
||||
color: #89b4fa;
|
||||
}
|
||||
.mocha .hljs-title.class_ {
|
||||
color: #f9e2af;
|
||||
}
|
||||
.mocha .hljs-title.function_ {
|
||||
color: #89b4fa;
|
||||
}
|
||||
.mocha .hljs-params {
|
||||
color: #cdd6f4;
|
||||
}
|
||||
.mocha .hljs-comment {
|
||||
color: #9399b2;
|
||||
}
|
||||
.mocha .hljs-doctag {
|
||||
color: #f38ba8;
|
||||
}
|
||||
.mocha .hljs-meta {
|
||||
color: #fab387;
|
||||
}
|
||||
.mocha .hljs-section {
|
||||
color: #89b4fa;
|
||||
}
|
||||
.mocha .hljs-tag {
|
||||
color: #94e2d5;
|
||||
}
|
||||
.mocha .hljs-name {
|
||||
color: #cba6f7;
|
||||
}
|
||||
.mocha .hljs-attr {
|
||||
color: #89b4fa;
|
||||
}
|
||||
.mocha .hljs-attribute {
|
||||
color: #a6e3a1;
|
||||
}
|
||||
.mocha .hljs-bullet {
|
||||
color: #94e2d5;
|
||||
}
|
||||
.mocha .hljs-code {
|
||||
color: #a6e3a1;
|
||||
}
|
||||
.mocha .hljs-emphasis {
|
||||
color: #f38ba8;
|
||||
font-style: italic;
|
||||
}
|
||||
.mocha .hljs-strong {
|
||||
color: #f38ba8;
|
||||
font-weight: bold;
|
||||
}
|
||||
.mocha .hljs-formula {
|
||||
color: #94e2d5;
|
||||
}
|
||||
.mocha .hljs-link {
|
||||
color: #74c7ec;
|
||||
font-style: italic;
|
||||
}
|
||||
.mocha .hljs-quote {
|
||||
color: #a6e3a1;
|
||||
font-style: italic;
|
||||
}
|
||||
.mocha .hljs-selector-tag {
|
||||
color: #f9e2af;
|
||||
}
|
||||
.mocha .hljs-selector-id {
|
||||
color: #89b4fa;
|
||||
}
|
||||
.mocha .hljs-selector-class {
|
||||
color: #94e2d5;
|
||||
}
|
||||
.mocha .hljs-selector-attr {
|
||||
color: #cba6f7;
|
||||
}
|
||||
.mocha .hljs-selector-pseudo {
|
||||
color: #94e2d5;
|
||||
}
|
||||
.mocha .hljs-template-tag {
|
||||
color: #f2cdcd;
|
||||
}
|
||||
.mocha .hljs-template-variable {
|
||||
color: #f2cdcd;
|
||||
}
|
||||
.mocha .hljs-addition {
|
||||
color: #a6e3a1;
|
||||
background: rgba(166, 227, 161, 0.15);
|
||||
}
|
||||
.mocha .hljs-deletion {
|
||||
color: #f38ba8;
|
||||
background: rgba(243, 139, 168, 0.15);
|
||||
}
|
||||
.mocha :is(h1, h2, h3, h4, h5, h6) a code {
|
||||
color: #cdd6f4;
|
||||
}
|
||||
.mocha a code {
|
||||
color: #89b4fa;
|
||||
}
|
||||
.mocha code {
|
||||
color: #cdd6f4;
|
||||
background: #181825;
|
||||
}
|
||||
.mocha blockquote blockquote {
|
||||
border-top: 0.1em solid #585b70;
|
||||
border-bottom: 0.1em solid #585b70;
|
||||
}
|
||||
.mocha hr {
|
||||
border-color: #585b70;
|
||||
border-style: solid;
|
||||
}
|
||||
.mocha del {
|
||||
color: #9399b2;
|
||||
}
|
||||
.mocha .ace_gutter {
|
||||
color: #7f849c;
|
||||
background: #181825;
|
||||
}
|
||||
.mocha .ace_gutter-active-line.ace_gutter-cell {
|
||||
color: #f5c2e7;
|
||||
background: #181825;
|
||||
}
|
||||
.mocha .tooltiptext {
|
||||
background: #181825;
|
||||
color: #cdd6f4;
|
||||
}
|
||||
|
||||
.latte {
|
||||
--bg: #eff1f5;
|
||||
--fg: #4c4f69;
|
||||
--sidebar-bg: #e6e9ef;
|
||||
--sidebar-fg: #4c4f69;
|
||||
--sidebar-non-existant: #9ca0b0;
|
||||
--sidebar-active: #1e66f5;
|
||||
--sidebar-spacer: #9ca0b0;
|
||||
--scrollbar: #9ca0b0;
|
||||
--icons: #9ca0b0;
|
||||
--icons-hover: #7c7f93;
|
||||
--links: #1e66f5;
|
||||
--inline-code-color: #4c4f69;
|
||||
--theme-popup-bg: #e6e9ef;
|
||||
--theme-popup-border: #9ca0b0;
|
||||
--theme-hover: #ccd0da;
|
||||
--quote-bg: #e6e9ef;
|
||||
--quote-border: #dce0e8;
|
||||
--table-border-color: #ccd0da;
|
||||
--table-header-bg: #e6e9ef;
|
||||
--table-alternate-bg: #e6e9ef;
|
||||
--searchbar-border-color: #ccd0da;
|
||||
--searchbar-bg: #e6e9ef;
|
||||
--searchbar-fg: #4c4f69;
|
||||
--searchbar-shadow-color: #dce0e8;
|
||||
--searchresults-header-fg: #4c4f69;
|
||||
--searchresults-border-color: #ccd0da;
|
||||
--searchresults-li-bg: #eff1f5;
|
||||
--search-mark-bg: #fe640b;
|
||||
--warning-border: #fe640b;
|
||||
--color-scheme: light;
|
||||
}
|
||||
|
||||
.frappe {
|
||||
--bg: #303446;
|
||||
--fg: #c6d0f5;
|
||||
--sidebar-bg: #292c3c;
|
||||
--sidebar-fg: #c6d0f5;
|
||||
--sidebar-non-existant: #737994;
|
||||
--sidebar-active: #8caaee;
|
||||
--sidebar-spacer: #737994;
|
||||
--scrollbar: #737994;
|
||||
--icons: #737994;
|
||||
--icons-hover: #949cbb;
|
||||
--links: #8caaee;
|
||||
--inline-code-color: #c6d0f5;
|
||||
--theme-popup-bg: #292c3c;
|
||||
--theme-popup-border: #737994;
|
||||
--theme-hover: #414559;
|
||||
--quote-bg: #292c3c;
|
||||
--quote-border: #232634;
|
||||
--table-border-color: #414559;
|
||||
--table-header-bg: #292c3c;
|
||||
--table-alternate-bg: #292c3c;
|
||||
--searchbar-border-color: #414559;
|
||||
--searchbar-bg: #292c3c;
|
||||
--searchbar-fg: #c6d0f5;
|
||||
--searchbar-shadow-color: #232634;
|
||||
--searchresults-header-fg: #c6d0f5;
|
||||
--searchresults-border-color: #414559;
|
||||
--searchresults-li-bg: #303446;
|
||||
--search-mark-bg: #ef9f76;
|
||||
--warning-border: #ef9f76;
|
||||
--color-scheme: dark;
|
||||
}
|
||||
|
||||
.macchiato {
|
||||
--bg: #24273a;
|
||||
--fg: #cad3f5;
|
||||
--sidebar-bg: #1e2030;
|
||||
--sidebar-fg: #cad3f5;
|
||||
--sidebar-non-existant: #6e738d;
|
||||
--sidebar-active: #8aadf4;
|
||||
--sidebar-spacer: #6e738d;
|
||||
--scrollbar: #6e738d;
|
||||
--icons: #6e738d;
|
||||
--icons-hover: #939ab7;
|
||||
--links: #8aadf4;
|
||||
--inline-code-color: #cad3f5;
|
||||
--theme-popup-bg: #1e2030;
|
||||
--theme-popup-border: #6e738d;
|
||||
--theme-hover: #363a4f;
|
||||
--quote-bg: #1e2030;
|
||||
--quote-border: #181926;
|
||||
--table-border-color: #363a4f;
|
||||
--table-header-bg: #1e2030;
|
||||
--table-alternate-bg: #1e2030;
|
||||
--searchbar-border-color: #363a4f;
|
||||
--searchbar-bg: #1e2030;
|
||||
--searchbar-fg: #cad3f5;
|
||||
--searchbar-shadow-color: #181926;
|
||||
--searchresults-header-fg: #cad3f5;
|
||||
--searchresults-border-color: #363a4f;
|
||||
--searchresults-li-bg: #24273a;
|
||||
--search-mark-bg: #f5a97f;
|
||||
--warning-border: #f5a97f;
|
||||
--color-scheme: dark;
|
||||
}
|
||||
|
||||
.mocha {
|
||||
--bg: #1e1e2e;
|
||||
--fg: #cdd6f4;
|
||||
--sidebar-bg: #181825;
|
||||
--sidebar-fg: #cdd6f4;
|
||||
--sidebar-non-existant: #6c7086;
|
||||
--sidebar-active: #89b4fa;
|
||||
--sidebar-spacer: #6c7086;
|
||||
--scrollbar: #6c7086;
|
||||
--icons: #6c7086;
|
||||
--icons-hover: #9399b2;
|
||||
--links: #89b4fa;
|
||||
--inline-code-color: #cdd6f4;
|
||||
--theme-popup-bg: #181825;
|
||||
--theme-popup-border: #6c7086;
|
||||
--theme-hover: #313244;
|
||||
--quote-bg: #181825;
|
||||
--quote-border: #11111b;
|
||||
--table-border-color: #313244;
|
||||
--table-header-bg: #181825;
|
||||
--table-alternate-bg: #181825;
|
||||
--searchbar-border-color: #313244;
|
||||
--searchbar-bg: #181825;
|
||||
--searchbar-fg: #cdd6f4;
|
||||
--searchbar-shadow-color: #11111b;
|
||||
--searchresults-header-fg: #cdd6f4;
|
||||
--searchresults-border-color: #313244;
|
||||
--searchresults-li-bg: #1e1e2e;
|
||||
--search-mark-bg: #fab387;
|
||||
--warning-border: #fab387;
|
||||
--color-scheme: dark;
|
||||
}
|
||||
33
zsh-guide/book/toc.html
Normal file
33
zsh-guide/book/toc.html
Normal file
@ -0,0 +1,33 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="mocha" dir="ltr">
|
||||
<head>
|
||||
<!-- sidebar iframe generated using mdBook
|
||||
|
||||
This is a frame, and not included directly in the page, to control the total size of the
|
||||
book. The TOC contains an entry for each page, so if each page includes a copy of the TOC,
|
||||
the total size of the page becomes O(n**2).
|
||||
|
||||
The frame is only used as a fallback when JS is turned off. When it's on, the sidebar is
|
||||
instead added to the main page by `toc.js` instead. The JavaScript mode is better
|
||||
because, when running in a `file:///` URL, the iframed page would not be Same-Origin as
|
||||
the rest of the page, so the sidebar and the main page theme would fall out of sync.
|
||||
-->
|
||||
<meta charset="UTF-8">
|
||||
<meta name="robots" content="noindex">
|
||||
<!-- Custom HTML head -->
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
<link rel="stylesheet" href="css/variables.css">
|
||||
<link rel="stylesheet" href="css/general.css">
|
||||
<link rel="stylesheet" href="css/chrome.css">
|
||||
<link rel="stylesheet" href="css/print.css" media="print">
|
||||
<!-- Fonts -->
|
||||
<link rel="stylesheet" href="FontAwesome/css/font-awesome.css">
|
||||
<link rel="stylesheet" href="fonts/fonts.css">
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
</head>
|
||||
<body class="sidebar-iframe-inner">
|
||||
<ol class="chapter"><li class="chapter-item expanded affix "><a href="zshguide.html" target="_parent">A User's Guide to the Z-Shell</a></li><li class="chapter-item expanded "><a href="zshguide01.html" target="_parent"><strong aria-hidden="true">1.</strong> A short introduction</a></li><li class="chapter-item expanded "><a href="zshguide02.html" target="_parent"><strong aria-hidden="true">2.</strong> What to put in your startup files</a></li><li class="chapter-item expanded "><a href="zshguide03.html" target="_parent"><strong aria-hidden="true">3.</strong> Dealing with basic shell syntax</a></li><li class="chapter-item expanded "><a href="zshguide04.html" target="_parent"><strong aria-hidden="true">4.</strong> The Z-Shell Line Editor</a></li><li class="chapter-item expanded "><a href="zshguide05.html" target="_parent"><strong aria-hidden="true">5.</strong> Substitutions</a></li><li class="chapter-item expanded "><a href="zshguide06.html" target="_parent"><strong aria-hidden="true">6.</strong> Completion, old and new</a></li><li class="chapter-item expanded "><a href="zshguide07.html" target="_parent"><strong aria-hidden="true">7.</strong> Modules and other bits and pieces Not written</a></li></ol>
|
||||
</body>
|
||||
</html>
|
||||
70
zsh-guide/book/toc.js
Normal file
70
zsh-guide/book/toc.js
Normal file
@ -0,0 +1,70 @@
|
||||
// Populate the sidebar
|
||||
//
|
||||
// This is a script, and not included directly in the page, to control the total size of the book.
|
||||
// The TOC contains an entry for each page, so if each page includes a copy of the TOC,
|
||||
// the total size of the page becomes O(n**2).
|
||||
class MDBookSidebarScrollbox extends HTMLElement {
|
||||
constructor() {
|
||||
super();
|
||||
}
|
||||
connectedCallback() {
|
||||
this.innerHTML = '<ol class="chapter"><li class="chapter-item expanded affix "><a href="zshguide.html">A User's Guide to the Z-Shell</a></li><li class="chapter-item expanded "><a href="zshguide01.html"><strong aria-hidden="true">1.</strong> A short introduction</a></li><li class="chapter-item expanded "><a href="zshguide02.html"><strong aria-hidden="true">2.</strong> What to put in your startup files</a></li><li class="chapter-item expanded "><a href="zshguide03.html"><strong aria-hidden="true">3.</strong> Dealing with basic shell syntax</a></li><li class="chapter-item expanded "><a href="zshguide04.html"><strong aria-hidden="true">4.</strong> The Z-Shell Line Editor</a></li><li class="chapter-item expanded "><a href="zshguide05.html"><strong aria-hidden="true">5.</strong> Substitutions</a></li><li class="chapter-item expanded "><a href="zshguide06.html"><strong aria-hidden="true">6.</strong> Completion, old and new</a></li><li class="chapter-item expanded "><a href="zshguide07.html"><strong aria-hidden="true">7.</strong> Modules and other bits and pieces Not written</a></li></ol>';
|
||||
// Set the current, active page, and reveal it if it's hidden
|
||||
let current_page = document.location.href.toString().split("#")[0];
|
||||
if (current_page.endsWith("/")) {
|
||||
current_page += "index.html";
|
||||
}
|
||||
var links = Array.prototype.slice.call(this.querySelectorAll("a"));
|
||||
var l = links.length;
|
||||
for (var i = 0; i < l; ++i) {
|
||||
var link = links[i];
|
||||
var href = link.getAttribute("href");
|
||||
if (href && !href.startsWith("#") && !/^(?:[a-z+]+:)?\/\//.test(href)) {
|
||||
link.href = path_to_root + href;
|
||||
}
|
||||
// The "index" page is supposed to alias the first chapter in the book.
|
||||
if (link.href === current_page || (i === 0 && path_to_root === "" && current_page.endsWith("/index.html"))) {
|
||||
link.classList.add("active");
|
||||
var parent = link.parentElement;
|
||||
if (parent && parent.classList.contains("chapter-item")) {
|
||||
parent.classList.add("expanded");
|
||||
}
|
||||
while (parent) {
|
||||
if (parent.tagName === "LI" && parent.previousElementSibling) {
|
||||
if (parent.previousElementSibling.classList.contains("chapter-item")) {
|
||||
parent.previousElementSibling.classList.add("expanded");
|
||||
}
|
||||
}
|
||||
parent = parent.parentElement;
|
||||
}
|
||||
}
|
||||
}
|
||||
// Track and set sidebar scroll position
|
||||
this.addEventListener('click', function(e) {
|
||||
if (e.target.tagName === 'A') {
|
||||
sessionStorage.setItem('sidebar-scroll', this.scrollTop);
|
||||
}
|
||||
}, { passive: true });
|
||||
var sidebarScrollTop = sessionStorage.getItem('sidebar-scroll');
|
||||
sessionStorage.removeItem('sidebar-scroll');
|
||||
if (sidebarScrollTop) {
|
||||
// preserve sidebar scroll position when navigating via links within sidebar
|
||||
this.scrollTop = sidebarScrollTop;
|
||||
} else {
|
||||
// scroll sidebar to current active section when navigating via "next/previous chapter" buttons
|
||||
var activeSection = document.querySelector('#sidebar .active');
|
||||
if (activeSection) {
|
||||
activeSection.scrollIntoView({ block: 'center' });
|
||||
}
|
||||
}
|
||||
// Toggle buttons
|
||||
var sidebarAnchorToggles = document.querySelectorAll('#sidebar a.toggle');
|
||||
function toggleSection(ev) {
|
||||
ev.currentTarget.parentElement.classList.toggle('expanded');
|
||||
}
|
||||
Array.from(sidebarAnchorToggles).forEach(function (el) {
|
||||
el.addEventListener('click', toggleSection);
|
||||
});
|
||||
}
|
||||
}
|
||||
window.customElements.define("mdbook-sidebar-scrollbox", MDBookSidebarScrollbox);
|
||||
@ -1,7 +1,7 @@
|
||||
/* Tomorrow Night Theme */
|
||||
/* http://jmblog.github.com/color-themes-for-google-code-highlightjs */
|
||||
/* https://github.com/jmblog/color-themes-for-highlightjs */
|
||||
/* Original theme - https://github.com/chriskempson/tomorrow-theme */
|
||||
/* http://jmblog.github.com/color-themes-for-google-code-highlightjs */
|
||||
/* https://github.com/jmblog/color-themes-for-highlightjs */
|
||||
|
||||
/* Tomorrow Comment */
|
||||
.hljs-comment {
|
||||
@ -11,6 +11,7 @@
|
||||
/* Tomorrow Red */
|
||||
.hljs-variable,
|
||||
.hljs-attribute,
|
||||
.hljs-attr,
|
||||
.hljs-tag,
|
||||
.hljs-regexp,
|
||||
.ruby .hljs-constant,
|
||||
@ -54,6 +55,7 @@
|
||||
|
||||
/* Tomorrow Aqua */
|
||||
.hljs-title,
|
||||
.hljs-section,
|
||||
.css .hljs-hexcolor {
|
||||
color: #8abeb7;
|
||||
}
|
||||
@ -1,17 +1,16 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
<title>A User's Guide to the Z-Shell - Zsh User's Guide</title>
|
||||
<title>A User's Guide to the Z-Shell - Zsh Guide</title>
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded affix "><a href="zshguide.html" class="active">A User's Guide to the Z-Shell</a></li><li class="chapter-item expanded "><a href="zshguide01.html"><strong aria-hidden="true">1.</strong> A short introduction</a></li><li class="chapter-item expanded "><a href="zshguide02.html"><strong aria-hidden="true">2.</strong> What to put in your startup files</a></li><li class="chapter-item expanded "><a href="zshguide03.html"><strong aria-hidden="true">3.</strong> Dealing with basic shell syntax</a></li><li class="chapter-item expanded "><a href="zshguide04.html"><strong aria-hidden="true">4.</strong> The Z-Shell Line Editor</a></li><li class="chapter-item expanded "><a href="zshguide05.html"><strong aria-hidden="true">5.</strong> Substitutions</a></li><li class="chapter-item expanded "><a href="zshguide06.html"><strong aria-hidden="true">6.</strong> Completion, old and new</a></li><li class="chapter-item expanded "><a href="zshguide07.html"><strong aria-hidden="true">7.</strong> Modules and other bits and pieces Not written</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -116,7 +120,7 @@
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<h1 class="menu-title">Zsh User's Guide</h1>
|
||||
<h1 class="menu-title">Zsh Guide</h1>
|
||||
|
||||
<div class="right-buttons">
|
||||
<a href="print.html" title="Print this book" aria-label="Print this book">
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -378,7 +382,7 @@ etc.</a></p>
|
||||
<nav class="nav-wrapper" aria-label="Page navigation">
|
||||
<!-- Mobile navigation buttons -->
|
||||
|
||||
<a rel="next" href="zshguide01.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="zshguide01.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -389,31 +393,48 @@ etc.</a></p>
|
||||
|
||||
<nav class="nav-wide-wrapper" aria-label="Page navigation">
|
||||
|
||||
<a rel="next" href="zshguide01.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="zshguide01.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
socket.onmessage = function (event) {
|
||||
if (event.data === "reload") {
|
||||
socket.close();
|
||||
location.reload();
|
||||
}
|
||||
};
|
||||
|
||||
window.onbeforeunload = function() {
|
||||
socket.close();
|
||||
}
|
||||
</script>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,17 +1,16 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
<title>A short introduction - Zsh User's Guide</title>
|
||||
<title>A short introduction - Zsh Guide</title>
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded affix "><a href="zshguide.html">A User's Guide to the Z-Shell</a></li><li class="chapter-item expanded "><a href="zshguide01.html" class="active"><strong aria-hidden="true">1.</strong> A short introduction</a></li><li class="chapter-item expanded "><a href="zshguide02.html"><strong aria-hidden="true">2.</strong> What to put in your startup files</a></li><li class="chapter-item expanded "><a href="zshguide03.html"><strong aria-hidden="true">3.</strong> Dealing with basic shell syntax</a></li><li class="chapter-item expanded "><a href="zshguide04.html"><strong aria-hidden="true">4.</strong> The Z-Shell Line Editor</a></li><li class="chapter-item expanded "><a href="zshguide05.html"><strong aria-hidden="true">5.</strong> Substitutions</a></li><li class="chapter-item expanded "><a href="zshguide06.html"><strong aria-hidden="true">6.</strong> Completion, old and new</a></li><li class="chapter-item expanded "><a href="zshguide07.html"><strong aria-hidden="true">7.</strong> Modules and other bits and pieces Not written</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -116,7 +120,7 @@
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<h1 class="menu-title">Zsh User's Guide</h1>
|
||||
<h1 class="menu-title">Zsh Guide</h1>
|
||||
|
||||
<div class="right-buttons">
|
||||
<a href="print.html" title="Print this book" aria-label="Print this book">
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -404,7 +408,7 @@ particular PC.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="zshguide02.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="zshguide02.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -418,31 +422,48 @@ particular PC.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="zshguide02.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="zshguide02.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
socket.onmessage = function (event) {
|
||||
if (event.data === "reload") {
|
||||
socket.close();
|
||||
location.reload();
|
||||
}
|
||||
};
|
||||
|
||||
window.onbeforeunload = function() {
|
||||
socket.close();
|
||||
}
|
||||
</script>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,17 +1,16 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
<title>What to put in your startup files - Zsh User's Guide</title>
|
||||
<title>What to put in your startup files - Zsh Guide</title>
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded affix "><a href="zshguide.html">A User's Guide to the Z-Shell</a></li><li class="chapter-item expanded "><a href="zshguide01.html"><strong aria-hidden="true">1.</strong> A short introduction</a></li><li class="chapter-item expanded "><a href="zshguide02.html" class="active"><strong aria-hidden="true">2.</strong> What to put in your startup files</a></li><li class="chapter-item expanded "><a href="zshguide03.html"><strong aria-hidden="true">3.</strong> Dealing with basic shell syntax</a></li><li class="chapter-item expanded "><a href="zshguide04.html"><strong aria-hidden="true">4.</strong> The Z-Shell Line Editor</a></li><li class="chapter-item expanded "><a href="zshguide05.html"><strong aria-hidden="true">5.</strong> Substitutions</a></li><li class="chapter-item expanded "><a href="zshguide06.html"><strong aria-hidden="true">6.</strong> Completion, old and new</a></li><li class="chapter-item expanded "><a href="zshguide07.html"><strong aria-hidden="true">7.</strong> Modules and other bits and pieces Not written</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -116,7 +120,7 @@
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<h1 class="menu-title">Zsh User's Guide</h1>
|
||||
<h1 class="menu-title">Zsh Guide</h1>
|
||||
|
||||
<div class="right-buttons">
|
||||
<a href="print.html" title="Print this book" aria-label="Print this book">
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -494,7 +498,7 @@ for example,</p>
|
||||
could still put quotes there anyway.</p>
|
||||
<p>Users of csh should note that you don't use `<code>set</code>' to set parameters.
|
||||
This is important because there is a <code>set</code> command, but it works
|
||||
differently --- if you try `<code>set var="this wont't work"</code>', you won't
|
||||
differently --- if you try `<code>set var="this wont't work"</code>', you won't
|
||||
get an error but you won't set the parameter, either. Type `<code>print $1</code>'
|
||||
to see what you did set instead.</p>
|
||||
<p>To get back what was stored in a parameter, you use the name somewhere
|
||||
@ -502,10 +506,10 @@ on the command line with a `<code>$</code>' tacked on the front --- this is call
|
||||
an <strong>expansion</strong>, or to be more precise, since there are other types of
|
||||
expansion, a <strong>parameter expansion</strong>. For example, after the first
|
||||
assignment above.</p>
|
||||
<pre><code> print -- '$foo is "'$foo'"'
|
||||
<pre><code> print -- '$foo is "'$foo'"'
|
||||
</code></pre>
|
||||
<p>gives</p>
|
||||
<pre><code> $foo is "This is a parameter."
|
||||
<pre><code> $foo is "This is a parameter."
|
||||
</code></pre>
|
||||
<p>so you can see what I meant about the effect of single quotes. Note the
|
||||
asymmetry --- there is no `<code>$</code>' when assigning the parameter, but there
|
||||
@ -613,7 +617,7 @@ use arrays when they want word splitting, since as I explained you have
|
||||
control over what is split and what is not; that's why <code>SH_WORD_SPLIT</code>
|
||||
is not set by default. Users of other shells just get used to putting
|
||||
things in double quotes,</p>
|
||||
<pre><code> command "$foo"
|
||||
<pre><code> command "$foo"
|
||||
</code></pre>
|
||||
<p>which, unlike single quotes, allow the `<code>$</code>' to remain special, and
|
||||
have the side effect that whatever is in quotes will remain a single
|
||||
@ -660,7 +664,7 @@ if you typed it, while zsh is using what you assigned to <code>foo</code> withou
|
||||
allowing it to be changed any more. To allow the word to be expanded in
|
||||
zsh, too, you can set the option <code>GLOB_SUBST</code>. As with <code>SH_WORD_SPLIT</code>,
|
||||
the way around the ksh behaviour if you don't want the value changed is
|
||||
to use double quotes: <code>"$foo"</code>.</p>
|
||||
to use double quotes: <code>"$foo"</code>.</p>
|
||||
<p>You are less likely to have to worry about <code>SH_FILE_EXPANSION</code>. It
|
||||
determines when the shell expands things like <code>~/.zshrc</code> to the full
|
||||
path, e.g. <code>/home/user2/pws/.zshrc</code>. In the case of zsh, this is usually
|
||||
@ -842,11 +846,11 @@ called, but some others to help it along. Then you need to do this:</p>
|
||||
helper() {
|
||||
# goodness knows what this does
|
||||
}
|
||||
fn "$@"
|
||||
fn "$@"
|
||||
# this actually calls the function the first time,
|
||||
# with any arguments passed (see the subsection
|
||||
# `Function Parameters' in the section `Functions'
|
||||
# of the next chapter for the "$@").
|
||||
# of the next chapter for the "$@").
|
||||
</code></pre>
|
||||
<p>That last non-comment line is unnecessary with <code>KSH_AUTOLOAD</code>. The
|
||||
functions supplied with zsh assume that <code>KSH_AUTOLOAD</code> is not set,
|
||||
@ -1529,8 +1533,8 @@ associative array parameters <code>$fg</code> and <code>$bg</code> which you use
|
||||
the escape sequences for given colours, for example
|
||||
<code>${fg[red]}${bg[yellow]}</code> produces the sequences for red text on a
|
||||
yellow background. So for example,</p>
|
||||
<pre><code> PS1="%{${bg[white]}${fg[red]}%}%(?..(%?%))\
|
||||
%{${fg[yellow]}${bg[black]}%}%# "
|
||||
<pre><code> PS1="%{${bg[white]}${fg[red]}%}%(?..(%?%))\
|
||||
%{${fg[yellow]}${bg[black]}%}%# "
|
||||
</code></pre>
|
||||
<p>produces a red-on-white `<code>(1)</code>' if the previous programme exited with
|
||||
status 1, but nothing if it exited with status 0, followed by a
|
||||
@ -1981,7 +1985,7 @@ for all interactive shells, and for no others.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="zshguide03.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="zshguide03.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -1995,31 +1999,48 @@ for all interactive shells, and for no others.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="zshguide03.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="zshguide03.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
socket.onmessage = function (event) {
|
||||
if (event.data === "reload") {
|
||||
socket.close();
|
||||
location.reload();
|
||||
}
|
||||
};
|
||||
|
||||
window.onbeforeunload = function() {
|
||||
socket.close();
|
||||
}
|
||||
</script>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,17 +1,16 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
<title>Dealing with basic shell syntax - Zsh User's Guide</title>
|
||||
<title>Dealing with basic shell syntax - Zsh Guide</title>
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded affix "><a href="zshguide.html">A User's Guide to the Z-Shell</a></li><li class="chapter-item expanded "><a href="zshguide01.html"><strong aria-hidden="true">1.</strong> A short introduction</a></li><li class="chapter-item expanded "><a href="zshguide02.html"><strong aria-hidden="true">2.</strong> What to put in your startup files</a></li><li class="chapter-item expanded "><a href="zshguide03.html" class="active"><strong aria-hidden="true">3.</strong> Dealing with basic shell syntax</a></li><li class="chapter-item expanded "><a href="zshguide04.html"><strong aria-hidden="true">4.</strong> The Z-Shell Line Editor</a></li><li class="chapter-item expanded "><a href="zshguide05.html"><strong aria-hidden="true">5.</strong> Substitutions</a></li><li class="chapter-item expanded "><a href="zshguide06.html"><strong aria-hidden="true">6.</strong> Completion, old and new</a></li><li class="chapter-item expanded "><a href="zshguide07.html"><strong aria-hidden="true">7.</strong> Modules and other bits and pieces Not written</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -116,7 +120,7 @@
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<h1 class="menu-title">Zsh User's Guide</h1>
|
||||
<h1 class="menu-title">Zsh Guide</h1>
|
||||
|
||||
<div class="right-buttons">
|
||||
<a href="print.html" title="Print this book" aria-label="Print this book">
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -916,11 +920,11 @@ fashion:</p>
|
||||
emulate -R zsh
|
||||
setopt localoptions
|
||||
|
||||
if [[ ARGC -eq 1 && "$1" == [+-]<-> ]] then
|
||||
if [[ ARGC -eq 1 && "$1" == [+-]<-> ]] then
|
||||
setopt pushdignoredups
|
||||
builtin pushd ~$1
|
||||
else
|
||||
builtin pushd "$@"
|
||||
builtin pushd "$@"
|
||||
fi
|
||||
</code></pre>
|
||||
<p>The `<code>&&</code>' is a logical `and', requiring both tests to be true. The
|
||||
@ -1008,7 +1012,7 @@ function of the same name. To call the command itself inside the shell
|
||||
function, you use `<code>command</code>'. The following works, although it's
|
||||
obviously not all that useful as it stands:</p>
|
||||
<pre><code> ls() {
|
||||
command ls "$[@]"
|
||||
command ls "$[@]"
|
||||
}
|
||||
</code></pre>
|
||||
<p>so when you run `<code>ls</code>', it calls the function, which calls the real
|
||||
@ -1083,7 +1087,7 @@ second prints out the definitions of any functions it was asked about
|
||||
very useful option is <code>-m</code>, which takes any arguments as patterns using
|
||||
the usual zsh pattern format, in other words the same one used for
|
||||
matching files. Thus</p>
|
||||
<pre><code> whence -vm "*"
|
||||
<pre><code> whence -vm "*"
|
||||
</code></pre>
|
||||
<p>prints out every command the shell knows about, together with what it
|
||||
thinks of it.</p>
|
||||
@ -1219,7 +1223,7 @@ the <code>typeset</code> statement is equivalent to</p>
|
||||
</code></pre>
|
||||
<p>which can tell a scalar assignment, and hence knows not to split words,
|
||||
or quote the backquotes,</p>
|
||||
<pre><code> % typeset var="`echo two words`"
|
||||
<pre><code> % typeset var="`echo two words`"
|
||||
</code></pre>
|
||||
<p>There are three important types we haven't talked about; both of these
|
||||
can only be created with <code>typeset</code> or one of the similar builtins I'll
|
||||
@ -1364,7 +1368,7 @@ strings). Anyway, I'd recommend that if you know a parameter has to be
|
||||
an integer or floating point value you should declare it as such.</p>
|
||||
<p>There is a builtin called <code>let</code> to handle mathematical expressions, but
|
||||
since</p>
|
||||
<pre><code> let "num = num + 1"
|
||||
<pre><code> let "num = num + 1"
|
||||
</code></pre>
|
||||
<p>is equivalent to</p>
|
||||
<pre><code> (( num = num + 1 ))
|
||||
@ -1971,7 +1975,7 @@ builtin. The first argument is a chunk of shell code to execute, which
|
||||
obviously needs to be quoted when you pass it as an argument, and the
|
||||
remaining arguments are a list of signals to handle, minus the <code>SIG</code>
|
||||
prefix. So:</p>
|
||||
<pre><code> trap "echo I\\'m trapped." INT
|
||||
<pre><code> trap "echo I\\'m trapped." INT
|
||||
</code></pre>
|
||||
<p>tells the shell what to do on <code>SIGINT</code>, i.e. <code>^C</code>. Note the extra layer
|
||||
of quoting: the double quotes surround the code, so that when they are
|
||||
@ -2043,7 +2047,7 @@ function type has some extra wiring to allow you both to trap a signal,
|
||||
and pretend to anyone watching that the shell didn't handle it. An
|
||||
example will show this:</p>
|
||||
<pre><code> TRAPINT() {
|
||||
print "Signal caught, stopping anyway."
|
||||
print "Signal caught, stopping anyway."
|
||||
return $(( 128 + $1 ))
|
||||
}
|
||||
</code></pre>
|
||||
@ -2430,7 +2434,7 @@ sometimes happens when you write a shell script to process the arguments
|
||||
to an external command, or set parameters for it, then call that
|
||||
command. For example:</p>
|
||||
<pre><code> export MOZILLA_HOME=/usr/local/netscape
|
||||
netscape "$@"
|
||||
netscape "$@"
|
||||
</code></pre>
|
||||
<p>Run as a script, this sets an environment variable, then starts
|
||||
<code>netscape</code>. However, as always the shell waits for the command to
|
||||
@ -2438,7 +2442,7 @@ finish. That's rather wasteful here, since there's nothing more for the
|
||||
shell to do; you'd rather it simply magically turned into the <code>netscape</code>
|
||||
command. You can actually do this:</p>
|
||||
<pre><code> export MOZILLA_HOME=/usr/local/netscape
|
||||
exec netscape "$@"
|
||||
exec netscape "$@"
|
||||
</code></pre>
|
||||
<p>`<code>exec</code>' tells the shell that it doesn't need to wait; it can just make
|
||||
the command to run replace the shell. So this only uses a single
|
||||
@ -2587,7 +2591,7 @@ takes a single argument. I showed one: `-z $var' tests whether
|
||||
non-zero length. Perhaps this is as good a time as any to point out that
|
||||
the arguments to these commands can be any single word expression, not
|
||||
just variables or filenames. You are quite at liberty to test</p>
|
||||
<pre><code> if [[ -z "$var is sqrt(`print bibble`)" ]]; then
|
||||
<pre><code> if [[ -z "$var is sqrt(`print bibble`)" ]]; then
|
||||
print Flying pig detected.
|
||||
fi
|
||||
</code></pre>
|
||||
@ -2597,7 +2601,7 @@ usually return a whole set of words, as if they were in double quotes,
|
||||
joining the bits with spaces:</p>
|
||||
<pre><code> array=(two words)
|
||||
if [[ $array = 'two words' ]]; then
|
||||
print "The array \$array is OK. O, joy."
|
||||
print "The array \$array is OK. O, joy."
|
||||
fi
|
||||
</code></pre>
|
||||
<p>Apart from `<code>-z</code>' and `<code>-n</code>', most of the two-argument tests are to do
|
||||
@ -3062,13 +3066,13 @@ spaces unless you ask it too. So:</p>
|
||||
</code></pre>
|
||||
<p>Now here's the difference:</p>
|
||||
<pre><code> % set two words
|
||||
% args "$*"
|
||||
% args "$*"
|
||||
1 two words
|
||||
% args "$@"
|
||||
% args "$@"
|
||||
2 two words
|
||||
</code></pre>
|
||||
<p>In quotes, <code>"$*"</code> behaves as a normal array, joining the words with
|
||||
spaces. However, <code>"$@"</code> doesn't --- it still behaves as if it was
|
||||
<p>In quotes, <code>"$*"</code> behaves as a normal array, joining the words with
|
||||
spaces. However, <code>"$@"</code> doesn't --- it still behaves as if it was
|
||||
unquoted. You can't see from the arguments themselves in this case, but
|
||||
you can from the digit giving the number of arguments the function has.</p>
|
||||
<p>This probably seems pretty silly. Why quote something to have it behave
|
||||
@ -3082,15 +3086,15 @@ spaces again:</p>
|
||||
2 one word
|
||||
% args $@
|
||||
2 one word
|
||||
% args "$*"
|
||||
% args "$*"
|
||||
1 one word
|
||||
% args "$@"
|
||||
% args "$@"
|
||||
1 one word
|
||||
</code></pre>
|
||||
<p>Aha! <em>This</em> time <code>"$@"</code> kept the single word with the space intact. In
|
||||
other words, <code>"$@"</code> was a slightly primitive mechanism for suppressing
|
||||
<p>Aha! <em>This</em> time <code>"$@"</code> kept the single word with the space intact. In
|
||||
other words, <code>"$@"</code> was a slightly primitive mechanism for suppressing
|
||||
splitting of words, while allowing the splitting of arrays into
|
||||
elements. In zsh, you would probably quite often use <code>$*</code>, not <code>"$@"</code>,
|
||||
elements. In zsh, you would probably quite often use <code>$*</code>, not <code>"$@"</code>,
|
||||
safe in the knowledge that nothing was split until you asked it to be;
|
||||
and if you wanted it split, you would use the special form of
|
||||
substitution <code>${=*}</code> which does that:</p>
|
||||
@ -3123,12 +3127,12 @@ same happens with all empty variables, including scalars:</p>
|
||||
</code></pre>
|
||||
<p>But there are times when you don't want that, any more than you want
|
||||
word splitting --- you want <em>all</em> arguments passed just as you gave
|
||||
them. This is another side effect of the <code>"$@"</code> form.</p>
|
||||
<pre><code> % args "$@"
|
||||
them. This is another side effect of the <code>"$@"</code> form.</p>
|
||||
<pre><code> % args "$@"
|
||||
3 hello there
|
||||
</code></pre>
|
||||
<p>Here, the empty element was passed in as well. That's why you often find
|
||||
<code>"$@"</code> being used in zsh when wordsplitting is already turned off.</p>
|
||||
<code>"$@"</code> being used in zsh when wordsplitting is already turned off.</p>
|
||||
<p>Another note: why does the following not work like the example with
|
||||
<code>$*</code>?</p>
|
||||
<pre><code> % args hello '' there
|
||||
@ -3146,7 +3150,7 @@ assigned to <code>$2</code>; later, this was missed out when passing <code>$*</c
|
||||
function. The same difference occurs with scalars:</p>
|
||||
<pre><code> % args $empty
|
||||
0
|
||||
% args "$empty"
|
||||
% args "$empty"
|
||||
1
|
||||
</code></pre>
|
||||
<p>The <code>$empty</code> expanded to an empty string in each case. In the first case
|
||||
@ -3164,18 +3168,18 @@ on line splitting? | empty string
|
||||
--------------------------------------------------
|
||||
$* n | 2 1 0
|
||||
$@ n | 2 1 0
|
||||
"$*" n | 1 1 1
|
||||
"$@" n | 2 1 1
|
||||
"$*" n | 1 1 1
|
||||
"$@" n | 2 1 1
|
||||
|
|
||||
$* y | 2 2 0
|
||||
$@ y | 2 2 0
|
||||
"$*" y | 1 1 1
|
||||
"$@" y | 2 1 1
|
||||
"$*" y | 1 1 1
|
||||
"$@" y | 2 1 1
|
||||
|
|
||||
${=*} n | 2 2 0
|
||||
${=@} n | 2 2 0
|
||||
"${=*}" n | 2 2 1
|
||||
"${=@}" n | 2 2 1
|
||||
"${=*}" n | 2 2 1
|
||||
"${=@}" n | 2 2 1
|
||||
</code></pre>
|
||||
<p>On the left is shown the expression to be passed to the function, and in
|
||||
the three right hand columns the number of arguments the function will
|
||||
@ -3192,38 +3196,38 @@ splitting, for convenience: that's particularly simple, since it always
|
||||
forces words to be split, even inside quotation marks.</p>
|
||||
<p>I would recommend that anyone not wedded to the Bourne shell behaviour
|
||||
use the top set as standard: in particular, `<code>$*</code>' for normal array
|
||||
behaviour with removal of empty items, `<code>"$@"</code>' for normal array
|
||||
behaviour with empty items left as empty items, and `<code>"$*"</code>' for
|
||||
behaviour with removal of empty items, `<code>"$@"</code>' for normal array
|
||||
behaviour with empty items left as empty items, and `<code>"$*"</code>' for
|
||||
turning arrays into single strings. If you need word-splitting, you
|
||||
should use `<code>${=*}</code>' or `<code>"${=@}"</code>' for splitting with/without removal
|
||||
should use `<code>${=*}</code>' or `<code>"${=@}"</code>' for splitting with/without removal
|
||||
of empty items (obviously there's no counterpart to the quoted-array
|
||||
behaviour here). Then keep <code>SH_WORD_SPLIT</code> turned off. If you are wedded
|
||||
to the Bourne shell behaviour, you're on your own.</p>
|
||||
<p><strong>It's a bug</strong></p>
|
||||
<p>There's a bug in handling of the the form <code>${1+"$@"}</code>. This looks rather
|
||||
<p>There's a bug in handling of the the form <code>${1+"$@"}</code>. This looks rather
|
||||
an arcane and unlikely combination, but actually it is commonly used to
|
||||
get around a bug in some versions of the Bourne shell (which is not in
|
||||
zsh): that <code>"$@"</code> generates a single empty argument if there are no
|
||||
zsh): that <code>"$@"</code> generates a single empty argument if there are no
|
||||
arguments. The form shown tests whether there is a first argument, and
|
||||
if so substitutes <code>"$@"</code>, else it doesn't substitute anything, avoiding
|
||||
if so substitutes <code>"$@"</code>, else it doesn't substitute anything, avoiding
|
||||
the bug.</p>
|
||||
<p>Unfortunately, in zsh, when <code>shwordsplit</code> is set --- which is the time
|
||||
you usually run across attempts like this to standardise the way
|
||||
different shells work --- this will actually cause too much
|
||||
word-splitting. The way the shell is written at the moment, the embedded
|
||||
<code>"$@"</code> will force extra splitting on spaces inside the arguments. So if
|
||||
<code>"$@"</code> will force extra splitting on spaces inside the arguments. So if
|
||||
the first argument is `<code>one word</code>', and <code>shwordsplit</code> is set,
|
||||
<code>${1+"$@"}</code> produces <em>two</em> words `<code>one</code>' and `<code>word</code>'.</p>
|
||||
<code>${1+"$@"}</code> produces <em>two</em> words `<code>one</code>' and `<code>word</code>'.</p>
|
||||
<p>Oliver Kiddle spotted a way of getting round this which has been adapted
|
||||
for use in the GNU autoconf package: in your initialisation code, have</p>
|
||||
<pre><code> [ x$ZSH_VERSION != x ] && alias -g '${1+"$@"}'='"$@"'
|
||||
<pre><code> [ x$ZSH_VERSION != x ] && alias -g '${1+"$@"}'='"$@"'
|
||||
</code></pre>
|
||||
<p>This uses a global alias to turn <code>${1+"$@"}</code> wherever it occurs as a
|
||||
single word into <code>"$@"</code> which doesn't have the problem. Aliasing occurs
|
||||
<p>This uses a global alias to turn <code>${1+"$@"}</code> wherever it occurs as a
|
||||
single word into <code>"$@"</code> which doesn't have the problem. Aliasing occurs
|
||||
so early in processing that the fact that most of the characters have a
|
||||
special meaning to the shell is irrelevant; the shell behaves as if it
|
||||
read in <code>"$@"</code>. The only catch is that for this to work the script or
|
||||
function must use <em>exactly</em> the character string <code>${1+"$@"}</code>, with no
|
||||
read in <code>"$@"</code>. The only catch is that for this to work the script or
|
||||
function must use <em>exactly</em> the character string <code>${1+"$@"}</code>, with no
|
||||
leading or trailing word characters (whitespace, obviously, or
|
||||
characters which terminate parsing such as `<code>;</code>' are all right). Some
|
||||
day, we may fix the underlying bug, but it's not very easy with the way
|
||||
@ -3243,8 +3247,8 @@ full array. Otherwise, my advice would be to stick with the Bourne shell
|
||||
variants, however cryptic they may look at first sight, for the usual
|
||||
reason that zsh isn't really like the C shell and if you pretend it is,
|
||||
you will come a cropper sooner or later.</p>
|
||||
<p>It looks like you're missing <code>"$@"</code>, but actually you can do that with
|
||||
<code>"${argv[@]}"</code>. This, like negative indices and slices, works with all
|
||||
<p>It looks like you're missing <code>"$@"</code>, but actually you can do that with
|
||||
<code>"${argv[@]}"</code>. This, like negative indices and slices, works with all
|
||||
arrays.</p>
|
||||
<p>There's one slight oddity with <code>$ARGC</code> and <code>$argv</code>, which isn't really a
|
||||
deliberate feature of the shell at all, but just in case you run into
|
||||
@ -3263,7 +3267,7 @@ the same behaviour applies to all commands, not just functions. What I
|
||||
mean is, in</p>
|
||||
<pre><code> fn() {
|
||||
cat $*
|
||||
cat "$*"
|
||||
cat "$*"
|
||||
}
|
||||
</code></pre>
|
||||
<p>the `<code>cat</code>' command will see the differences in behaviour between the
|
||||
@ -3503,9 +3507,9 @@ bar.</p>
|
||||
<pre><code> chpwd() {
|
||||
[[ -t 1 ]] || return
|
||||
case $TERM in
|
||||
(sun-cmd) print -Pn "\e]l%~\e\\"
|
||||
(sun-cmd) print -Pn "\e]l%~\e\\"
|
||||
;;
|
||||
(*xterm*|rxvt|(dt|k|E)term) print -Pn "\e]2;%~\a"
|
||||
(*xterm*|rxvt|(dt|k|E)term) print -Pn "\e]2;%~\a"
|
||||
;;
|
||||
esac
|
||||
}
|
||||
@ -3621,7 +3625,7 @@ understands, not just sets of words. That's because the text retrieved
|
||||
from the alias is put back into the input, and reread more or less as if
|
||||
you'd typed it. That means you can get away with strange combinations
|
||||
like</p>
|
||||
<pre><code> alias tripe="echo foo | sed 's/foo/bar/' |"
|
||||
<pre><code> alias tripe="echo foo | sed 's/foo/bar/' |"
|
||||
tripe cat
|
||||
</code></pre>
|
||||
<p>which is interpreted exactly the same way as</p>
|
||||
@ -3640,7 +3644,7 @@ interpreted literally to stop the expansion. The point is that because
|
||||
aliases are expanded early on in processing of the command line, looking
|
||||
up an alias is done on a string without quotes removed. So if you have
|
||||
an alias `<code>drivel</code>', none of the strings `<code>\drivel</code>', `<code>'d'rivel</code>',
|
||||
or `<code>drivel""</code>' will be expanded as the alias: they all would have the
|
||||
or `<code>drivel""</code>' will be expanded as the alias: they all would have the
|
||||
same effect as proper commands, after the quotes are removed, but as
|
||||
aliases they appear different. The manual entry also notes that you can
|
||||
actually make aliases for any of these special forms, e.g. `<code>alias '\drivel'=...</code>' (note the quotes, since you need the backslash to be
|
||||
@ -3752,10 +3756,10 @@ that the `<code>!</code>'s can be quoted by putting them in single quotes:</p>
|
||||
<pre><code> echo 'Hello!!'
|
||||
</code></pre>
|
||||
<p>doesn't insert the previous line at that point, but</p>
|
||||
<pre><code> echo "Hello!!"
|
||||
<pre><code> echo "Hello!!"
|
||||
</code></pre>
|
||||
<p>does. You can always quote active `<code>!</code>'s with a backslash, so</p>
|
||||
<pre><code> echo "Hello\!\!"
|
||||
<pre><code> echo "Hello\!\!"
|
||||
</code></pre>
|
||||
<p>works, with or without the double quotes. Amusingly, since single quotes
|
||||
aren't special in double quotes, if you set the <code>HIST_VERIFY</code> option,
|
||||
@ -3765,14 +3769,14 @@ possibilities above in order, then keep hitting return, you will find
|
||||
ever increasing command lines:</p>
|
||||
<pre><code> % echo 'Hello!!'
|
||||
Hello!!
|
||||
% echo "Hello!!"
|
||||
% echo "Helloecho 'Hello!!'"
|
||||
% echo "Helloecho 'Helloecho 'Hello!!''"
|
||||
% echo "Helloecho 'Helloecho 'Helloecho 'Hello!!'''"
|
||||
% echo "Hello!!"
|
||||
% echo "Helloecho 'Hello!!'"
|
||||
% echo "Helloecho 'Helloecho 'Hello!!''"
|
||||
% echo "Helloecho 'Helloecho 'Helloecho 'Hello!!'''"
|
||||
</code></pre>
|
||||
<p>and if you understand why, you have a good grasp of how quotes work.</p>
|
||||
<p>There's another way of quoting exclamation marks in a line: put a
|
||||
`<code>!"</code>' in it. It can appear anywhere (as long as it's not in single
|
||||
`<code>!"</code>' in it. It can appear anywhere (as long as it's not in single
|
||||
quotes) and will be removed from the line, but it has the effect of
|
||||
disabling any subsequent exclamation marks till the end of the line.
|
||||
This is the only time quote marks which are significant to the shell
|
||||
@ -3941,7 +3945,7 @@ the null character. I'll use the <code>args</code> function again:</p>
|
||||
<pre><code> % args() { print $# $*; }
|
||||
% args $(echo two words)
|
||||
2 two words
|
||||
% args "$(echo one word)"
|
||||
% args "$(echo one word)"
|
||||
1 one word
|
||||
</code></pre>
|
||||
<p>The first form will split on newlines, not just spaces, so an equivalent
|
||||
@ -4024,7 +4028,7 @@ but it was, and the shell executed typeset with the arguments
|
||||
pokery with tildes described below. Other shells do this differently,
|
||||
and zsh (from 4.0.2 and 4.1.1) provides a compatibility option,
|
||||
<code>KSH_TYPESET</code>. In earlier versions you need to use quotes:</p>
|
||||
<pre><code> % typeset foo="`echo words words`"
|
||||
<pre><code> % typeset foo="`echo words words`"
|
||||
% print $foo
|
||||
words words
|
||||
</code></pre>
|
||||
@ -5157,7 +5161,7 @@ bug. Use <code>{ cmd1 && cmd2 } &</code> as a workaround.</li>
|
||||
</li>
|
||||
<li>
|
||||
<p>* The results of parameter substitutions are treated as plain
|
||||
text: <code>foo="*"; print $foo</code> prints all files in ksh but <code>*</code> in
|
||||
text: <code>foo="*"; print $foo</code> prints all files in ksh but <code>*</code> in
|
||||
zsh (unset <code>GLOB_SUBST</code>).</p>
|
||||
</li>
|
||||
<li>
|
||||
@ -5248,7 +5252,7 @@ default.</li>
|
||||
<ul>
|
||||
<li>Some built-ins (<code>r</code>, <code>autoload</code>, <code>history</code>, <code>integer</code> ...) were
|
||||
aliases in ksh.</li>
|
||||
<li>There is no built-in command newgrp: use e.g. <code>alias newgrp="exec newgrp"</code></li>
|
||||
<li>There is no built-in command newgrp: use e.g. <code>alias newgrp="exec newgrp"</code></li>
|
||||
<li><code>jobs</code> has no <code>-n</code> flag.</li>
|
||||
<li><code>read</code> has no <code>-s</code> flag.</li>
|
||||
</ul>
|
||||
@ -5357,7 +5361,7 @@ example:</p>
|
||||
# Put the right path in here ---
|
||||
# or just rely on finding zsh in
|
||||
# $path, since `exec' handles that.
|
||||
exec /usr/local/bin/zsh $0 "$@"
|
||||
exec /usr/local/bin/zsh $0 "$@"
|
||||
fi
|
||||
|
||||
print $ZSH_VERSION
|
||||
@ -5373,7 +5377,7 @@ was originally executed. Running this as `<code>testexec foo bar</code>' gives m
|
||||
<p>I hope you won't have to resort to that. By the way, really,
|
||||
excruciatingly old versions of zsh didn't have <code>$ZSH_VERSION</code>. Rather
|
||||
than fix the script, I suggest you upgrade the shell. Also, on some old
|
||||
Bourne shells you might need to replace <code>"$@"</code> with <code>${1+"$@"}</code>, which
|
||||
Bourne shells you might need to replace <code>"$@"</code> with <code>${1+"$@"}</code>, which
|
||||
is more careful about only putting in arguments if there were any (this
|
||||
is the sort of thing we'll see in <a href="zshguide05.html#subst">chapter 5</a>).
|
||||
Usually this isn't necessary.</p>
|
||||
@ -5409,7 +5413,7 @@ life's not that simple.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="zshguide04.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="zshguide04.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -5423,31 +5427,48 @@ life's not that simple.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="zshguide04.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="zshguide04.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
socket.onmessage = function (event) {
|
||||
if (event.data === "reload") {
|
||||
socket.close();
|
||||
location.reload();
|
||||
}
|
||||
};
|
||||
|
||||
window.onbeforeunload = function() {
|
||||
socket.close();
|
||||
}
|
||||
</script>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,17 +1,16 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
<title>The Z-Shell Line Editor - Zsh User's Guide</title>
|
||||
<title>The Z-Shell Line Editor - Zsh Guide</title>
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded affix "><a href="zshguide.html">A User's Guide to the Z-Shell</a></li><li class="chapter-item expanded "><a href="zshguide01.html"><strong aria-hidden="true">1.</strong> A short introduction</a></li><li class="chapter-item expanded "><a href="zshguide02.html"><strong aria-hidden="true">2.</strong> What to put in your startup files</a></li><li class="chapter-item expanded "><a href="zshguide03.html"><strong aria-hidden="true">3.</strong> Dealing with basic shell syntax</a></li><li class="chapter-item expanded "><a href="zshguide04.html" class="active"><strong aria-hidden="true">4.</strong> The Z-Shell Line Editor</a></li><li class="chapter-item expanded "><a href="zshguide05.html"><strong aria-hidden="true">5.</strong> Substitutions</a></li><li class="chapter-item expanded "><a href="zshguide06.html"><strong aria-hidden="true">6.</strong> Completion, old and new</a></li><li class="chapter-item expanded "><a href="zshguide07.html"><strong aria-hidden="true">7.</strong> Modules and other bits and pieces Not written</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -116,7 +120,7 @@
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<h1 class="menu-title">Zsh User's Guide</h1>
|
||||
<h1 class="menu-title">Zsh Guide</h1>
|
||||
|
||||
<div class="right-buttons">
|
||||
<a href="print.html" title="Print this book" aria-label="Print this book">
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -390,10 +394,10 @@ the end, and the convention where the `<code>[</code>' is replaced by an `<code>
|
||||
supported was the first of those two. The second, and any other
|
||||
convention, were not supported at all and you had to bind the keys
|
||||
yourself. This was done by something like:</p>
|
||||
<pre><code> bindkey "\eOA" up-line-or-history
|
||||
bindkey "\eOB" down-line-or-history
|
||||
bindkey "\eOC" forward-char
|
||||
bindkey "\eOD" backward-char
|
||||
<pre><code> bindkey "\eOA" up-line-or-history
|
||||
bindkey "\eOB" down-line-or-history
|
||||
bindkey "\eOC" forward-char
|
||||
bindkey "\eOD" backward-char
|
||||
</code></pre>
|
||||
<p>The shell tries harder now, and provided your system has the correct
|
||||
information about your terminal (zsh uses an old system called
|
||||
@ -475,7 +479,7 @@ easiest way is probably to use the syntax `<code>\x??</code>', where the `<code>
|
||||
are the two hex digits for the key. In the case of delete, it is
|
||||
`<code>\x7f</code>'. You can confirm this by:</p>
|
||||
<pre><code> % bindkey '\x7f'
|
||||
"^?" backward-delete-char
|
||||
"^?" backward-delete-char
|
||||
</code></pre>
|
||||
<p><span id="l82"></span></p>
|
||||
<h3 id="423-more-deletion"><a class="header" href="#423-more-deletion">4.2.3: More deletion</a></h3>
|
||||
@ -665,7 +669,7 @@ ones, for you to bind to keys in order to have that behaviour.</p>
|
||||
you can jump over real shell words (i.e. individual command arguments)
|
||||
by using some more substitution trickery, or you can consider only
|
||||
space-delimited words (though that's not so far from what you get with
|
||||
<code>$WORDCHARS</code> by adding `<code>"`'\@</code>').</p>
|
||||
<code>$WORDCHARS</code> by adding `<code>"`'\@</code>').</p>
|
||||
<p><span id="l88"></span></p>
|
||||
<h3 id="435-regions-and-marks"><a class="header" href="#435-regions-and-marks">4.3.5: Regions and marks</a></h3>
|
||||
<p>Another useful concept from Emacs is that of regions and marks. In
|
||||
@ -1026,7 +1030,7 @@ if you're lucky). This is far beyond the scope of this guide --- which I
|
||||
say, as you probably realise by now, to cover up for not knowing much
|
||||
about it. Here's another example from Oliver Kiddle, though; it uses
|
||||
control with the left-cursor key to send an escape sequence: insert</p>
|
||||
<pre><code> Ctrl<Key>Left: string(0x1b) string("[159q") \n\
|
||||
<pre><code> Ctrl<Key>Left: string(0x1b) string("[159q") \n\
|
||||
</code></pre>
|
||||
<p>into the middle of the example above --- this shows how multiple
|
||||
definitions are handled. Modern xterms already send special escape
|
||||
@ -1052,7 +1056,7 @@ user-defined widget, which is described in a later section. So bindings
|
||||
of this sort are going a little out of fashion. However, they do provide
|
||||
quick shortcuts. Two from Oliver Kiddle:</p>
|
||||
<pre><code> bindkey -s '^[[072q' '^V^I' # Ctrl-Tab
|
||||
bindkey -s "\C-x\C-z" "\eqsuspend\n"
|
||||
bindkey -s "\C-x\C-z" "\eqsuspend\n"
|
||||
</code></pre>
|
||||
<p>You can also quite easily do some of the things you can do with global
|
||||
aliases.</p>
|
||||
@ -1084,7 +1088,7 @@ changes, so can be used if your experimentation has completely ruined
|
||||
every other keymap. It only has bindings for <code>self-insert</code> (most keys)
|
||||
and <code>accept-line</code> (<code>^j</code> and <code>^m</code>), but that's enough to enter commands.</p>
|
||||
<p>The names are most useful in two places. First, you can use `<code>bindkey -M</code> <em>keymap</em>' to define keys in a particular map:</p>
|
||||
<pre><code> bindkey -M vicmd "\e[OA" up-line-or-history
|
||||
<pre><code> bindkey -M vicmd "\e[OA" up-line-or-history
|
||||
</code></pre>
|
||||
<p>binds the usual up-cursor key in <code>vicmd</code> mode, whatever keymap is
|
||||
currently set. Actually, any version of the shell which understands the
|
||||
@ -1468,7 +1472,7 @@ to the shell, but to accept the line anyway: you write your own widget
|
||||
finishes, and then use `<code>zle -N accept-line</code>. Here's a trivial but not
|
||||
entirely stupid example:</p>
|
||||
<pre><code> accept-line() {
|
||||
print -n "\e]2;Executing $BUFFER\a"
|
||||
print -n "\e]2;Executing $BUFFER\a"
|
||||
zle .accept-line
|
||||
}
|
||||
zle -N accept-line
|
||||
@ -1753,8 +1757,8 @@ and execute this widget.</p>
|
||||
word2=$match[2]
|
||||
|
||||
if [[ -n $word1 && -n $word2 ]]; then
|
||||
LBUFFER="$pat1$word2$ws1"
|
||||
RBUFFER="$ws2$word1$pat2"
|
||||
LBUFFER="$pat1$word2$ws1"
|
||||
RBUFFER="$ws2$word1$pat2"
|
||||
else
|
||||
zle beep
|
||||
fi
|
||||
@ -1792,11 +1796,11 @@ one heavy going. you probably don't want to look too closely at this.</p>
|
||||
(shell) local bufwords
|
||||
# This splits the line into words as the shell understands them.
|
||||
bufwords=(${(z)LBUFFER})
|
||||
wordpat1="${(q)bufwords[-1]}"
|
||||
wordpat1="${(q)bufwords[-1]}"
|
||||
# Take substring of RBUFFER to skip over first character,
|
||||
# which is the one under the cursor.
|
||||
bufwords=(${(z)RBUFFER[2,-1]})
|
||||
wordpat2="${(q)bufwords[1]}"
|
||||
wordpat2="${(q)bufwords[1]}"
|
||||
blankpat='[[:blank:]]#'
|
||||
;;
|
||||
(space) blankpat='[[:blank:]]#'
|
||||
@ -1814,9 +1818,9 @@ one heavy going. you probably don't want to look too closely at this.</p>
|
||||
# of alphanumerics and the characters in $wc.
|
||||
# Quote $wc where necessary, because we don't want those
|
||||
# characters to be considered as pattern characters later on.
|
||||
blankpat="[^${(q)wc}a-zA-Z0-9]#"
|
||||
blankpat="[^${(q)wc}a-zA-Z0-9]#"
|
||||
# and a word character is anything else.
|
||||
wordpat1="[${(q)wc}a-zA-Z0-9]##"
|
||||
wordpat1="[${(q)wc}a-zA-Z0-9]##"
|
||||
wordpat2=$wordpat1
|
||||
;;
|
||||
esac
|
||||
@ -1835,8 +1839,8 @@ one heavy going. you probably don't want to look too closely at this.</p>
|
||||
word2=$match[2]
|
||||
|
||||
if [[ -n $word1 && -n $word2 ]]; then
|
||||
LBUFFER="$pat1$word2$ws1"
|
||||
RBUFFER="$ws2$word1$pat2"
|
||||
LBUFFER="$pat1$word2$ws1"
|
||||
RBUFFER="$ws2$word1$pat2"
|
||||
else
|
||||
zle beep
|
||||
fi
|
||||
@ -1896,15 +1900,15 @@ decimal.</p>
|
||||
local msg modes key mode=dec code char
|
||||
# Prompt for and read a base.
|
||||
integer base=10
|
||||
zle -R "ASCII code (o -> oct, x -> hex) [$mode]: "
|
||||
zle -R "ASCII code (o -> oct, x -> hex) [$mode]: "
|
||||
read -k key
|
||||
case $key in
|
||||
(o) base=8 mode=oct
|
||||
zle -R "ASCII code [$mode]: "
|
||||
zle -R "ASCII code [$mode]: "
|
||||
read -k key
|
||||
;;
|
||||
(x) base=16 mode=hex
|
||||
zle -R "ASCII code [$mode]: "
|
||||
zle -R "ASCII code [$mode]: "
|
||||
read -k key
|
||||
;;
|
||||
esac
|
||||
@ -1924,7 +1928,7 @@ decimal.</p>
|
||||
# is an abnormal termination.
|
||||
return 1
|
||||
else
|
||||
code="${code}${key}"
|
||||
code="${code}${key}"
|
||||
fi
|
||||
char=
|
||||
if [[ -n $code ]]; then
|
||||
@ -1941,7 +1945,7 @@ decimal.</p>
|
||||
|
||||
# Prompt for any more digits, showing
|
||||
# the character as it would be inserted.
|
||||
zle -R "ASCII code [$mode]: $code${char:+ = $char}"
|
||||
zle -R "ASCII code [$mode]: $code${char:+ = $char}"
|
||||
read -k key || return 1
|
||||
done
|
||||
# If aborted with no code, return
|
||||
@ -1989,7 +1993,7 @@ character sets for now.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="zshguide05.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="zshguide05.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -2003,31 +2007,48 @@ character sets for now.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="zshguide05.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="zshguide05.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
socket.onmessage = function (event) {
|
||||
if (event.data === "reload") {
|
||||
socket.close();
|
||||
location.reload();
|
||||
}
|
||||
};
|
||||
|
||||
window.onbeforeunload = function() {
|
||||
socket.close();
|
||||
}
|
||||
</script>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,17 +1,16 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
<title>Substitutions - Zsh User's Guide</title>
|
||||
<title>Substitutions - Zsh Guide</title>
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded affix "><a href="zshguide.html">A User's Guide to the Z-Shell</a></li><li class="chapter-item expanded "><a href="zshguide01.html"><strong aria-hidden="true">1.</strong> A short introduction</a></li><li class="chapter-item expanded "><a href="zshguide02.html"><strong aria-hidden="true">2.</strong> What to put in your startup files</a></li><li class="chapter-item expanded "><a href="zshguide03.html"><strong aria-hidden="true">3.</strong> Dealing with basic shell syntax</a></li><li class="chapter-item expanded "><a href="zshguide04.html"><strong aria-hidden="true">4.</strong> The Z-Shell Line Editor</a></li><li class="chapter-item expanded "><a href="zshguide05.html" class="active"><strong aria-hidden="true">5.</strong> Substitutions</a></li><li class="chapter-item expanded "><a href="zshguide06.html"><strong aria-hidden="true">6.</strong> Completion, old and new</a></li><li class="chapter-item expanded "><a href="zshguide07.html"><strong aria-hidden="true">7.</strong> Modules and other bits and pieces Not written</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -116,7 +120,7 @@
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<h1 class="menu-title">Zsh User's Guide</h1>
|
||||
<h1 class="menu-title">Zsh Guide</h1>
|
||||
|
||||
<div class="right-buttons">
|
||||
<a href="print.html" title="Print this book" aria-label="Print this book">
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -276,8 +280,8 @@ being assigned to an array. Here's an example:</p>
|
||||
print 'a quoted string' and\ another\ argument
|
||||
% read -r line <file
|
||||
% for word in ${(z)line}; do
|
||||
for> print -r "quoted: $word"
|
||||
for> print -r "unquoted: ${(Q)word}"
|
||||
for> print -r "quoted: $word"
|
||||
for> print -r "unquoted: ${(Q)word}"
|
||||
for> done
|
||||
quoted: print
|
||||
unquoted: print
|
||||
@ -434,7 +438,7 @@ using `<code>print -l</code>', which prints one argument per line:</p>
|
||||
bar
|
||||
one
|
||||
two
|
||||
% print -l "$(echo foo bar) $array"
|
||||
% print -l "$(echo foo bar) $array"
|
||||
foo bar one two
|
||||
</code></pre>
|
||||
<p>The reason this is `almost' invariable is that parameter substitution
|
||||
@ -447,14 +451,14 @@ not removed. I covered this at some length in <a href="zshguide03.html#syntax">c
|
||||
3</a>.</p>
|
||||
<p>This is extended for other parameters in the following way:</p>
|
||||
<pre><code> % array=(one two three)
|
||||
% print -l "${array[@]}"
|
||||
% print -l "${array[@]}"
|
||||
one
|
||||
two
|
||||
three
|
||||
</code></pre>
|
||||
<p>and more generally for all forms of substitution using another flag,
|
||||
<code>(@)</code>:</p>
|
||||
<pre><code> % print -l "${(@)array}"
|
||||
<pre><code> % print -l "${(@)array}"
|
||||
one
|
||||
two
|
||||
three
|
||||
@ -470,26 +474,26 @@ slice of an array in zsh:</p>
|
||||
<p>where negative numbers count from the end of the array. The numbers in
|
||||
square brackets are referred to as subscripts. This can get the <code>(@)</code>
|
||||
treatment, too:</p>
|
||||
<pre><code> % print -l "${(@)array[2,-1]}"
|
||||
<pre><code> % print -l "${(@)array[2,-1]}"
|
||||
two
|
||||
three
|
||||
</code></pre>
|
||||
<p>Although it's probably not obvious, you can use the other notation in
|
||||
this case:</p>
|
||||
<pre><code> % print -l "${array[@][2,-1]}"
|
||||
<pre><code> % print -l "${array[@][2,-1]}"
|
||||
two
|
||||
three
|
||||
</code></pre>
|
||||
<p>The shell will actually handle arbitrary numbers of subscripts in
|
||||
parameter substitutions, not just one; each applies to the result of the
|
||||
previous one:</p>
|
||||
<pre><code> % print -l "${array[@][2,-1][1]}"
|
||||
<pre><code> % print -l "${array[@][2,-1][1]}"
|
||||
two
|
||||
</code></pre>
|
||||
<p>What you have to watch out for is that that last subscript selected a
|
||||
single word. You can continue to apply subscripts, but they will apply
|
||||
only on the <em>characters</em> in that word, not on array elements:</p>
|
||||
<pre><code> % print -l "${array[@][2,1][1][2,-1]}"
|
||||
<pre><code> % print -l "${array[@][2,1][1][2,-1]}"
|
||||
wo
|
||||
</code></pre>
|
||||
<p>We've now strayed severely off topic: the subscripts will of course work
|
||||
@ -513,7 +517,7 @@ the command line:</p>
|
||||
Words on line two
|
||||
% args $(<file)
|
||||
8
|
||||
% args "$(<file)"
|
||||
% args "$(<file)"
|
||||
1
|
||||
</code></pre>
|
||||
<p>The unquoted substitution split the file into individual words; the
|
||||
@ -523,7 +527,7 @@ rules.</p>
|
||||
splitting on spaces within the line. This is where parameter expansion
|
||||
can come in. There is a flag <code>(f)</code> which says `split the result of the
|
||||
expansion, one word per line'. Here's how to use it in this case:</p>
|
||||
<pre><code> % args "${(f)$(<file)}"
|
||||
<pre><code> % args "${(f)$(<file)}"
|
||||
2
|
||||
</code></pre>
|
||||
<p>Where you would usually put the name of a parameter, you put the command
|
||||
@ -557,21 +561,21 @@ code within the backquotes will be treated as the end of the quotes.</p>
|
||||
<p>The second reason, which is closely related, is that it can be quite
|
||||
difficult to decide how many levels of quotes are required inside a
|
||||
backquoted expression. Consider:</p>
|
||||
<pre><code> % print "`echo \"hello\"`"
|
||||
<pre><code> % print "`echo \"hello\"`"
|
||||
hello
|
||||
% print "$(echo \"hello\")"
|
||||
"hello"
|
||||
% print "$(echo \"hello\")"
|
||||
"hello"
|
||||
</code></pre>
|
||||
<p>It's hard to explain quite what the difference here is without waving my
|
||||
hands, which prevents me from typing, but the essential point is really
|
||||
the same one about nesting: you can't do it with backquotes, because the
|
||||
start and end symbols are the same, but you can do it with parentheses.
|
||||
So in the second case there is no doubt that the embedded command line,
|
||||
`<code>echo \"hello\"</code>', is to be treated exactly as if that had appeared
|
||||
`<code>echo \"hello\"</code>', is to be treated exactly as if that had appeared
|
||||
outside the command substitution; whereas in the first place, the quotes
|
||||
within quotes had to be, um, quoted.</p>
|
||||
<p>As a consequence, in</p>
|
||||
<pre><code> % print "$(echo "hello")"
|
||||
<pre><code> % print "$(echo "hello")"
|
||||
hello
|
||||
</code></pre>
|
||||
<p>you need to be careful: at first glance, the pairs of double quotes
|
||||
@ -579,7 +583,7 @@ surround `<code>$</code>(<code>echo </code>' and `)', but they don't, they are n
|
||||
virtue of the substitution. You see the same thing with parameter
|
||||
substitution:</p>
|
||||
<pre><code> % unset foo
|
||||
% print "${foo:-"a string"}"
|
||||
% print "${foo:-"a string"}"
|
||||
a string
|
||||
</code></pre>
|
||||
<p>A third, less good, reason for using the form with parentheses is that
|
||||
@ -712,10 +716,10 @@ at that point if you prefer.</p>
|
||||
|
||||
for arg in $*; do
|
||||
case $arg in
|
||||
(*.bz2) args[$i]="=(bunzip2 -c ${(q)arg})"
|
||||
(*.bz2) args[$i]="=(bunzip2 -c ${(q)arg})"
|
||||
;;
|
||||
# this assumes your zcat is the one installed with gzip:
|
||||
(*.(gz|Z)) args[$i]="=(zcat ${(q)arg})"
|
||||
(*.(gz|Z)) args[$i]="=(zcat ${(q)arg})"
|
||||
;;
|
||||
(*) args=${(q)arg}
|
||||
;;
|
||||
@ -850,7 +854,7 @@ passed to a command again:</p>
|
||||
1
|
||||
% args ${array[(r)X*]}
|
||||
0
|
||||
% args "${array[(r)X*]}"
|
||||
% args "${array[(r)X*]}"
|
||||
1
|
||||
</code></pre>
|
||||
<p>where in the last case the empty string was quoted, and passed down as a
|
||||
@ -871,9 +875,9 @@ match at the beginning gives you zero, so:</p>
|
||||
<pre><code> array=(three egregious words)
|
||||
for pat in '*e*e*' '*a*a*'; do
|
||||
if [[ ${array[(i)$pat]} -le ${#array} ]]; then
|
||||
print "Pattern $pat matched in array: ${array[(r)$pat]}."
|
||||
print "Pattern $pat matched in array: ${array[(r)$pat]}."
|
||||
else
|
||||
print "Pattern $pat failed to match in array"
|
||||
print "Pattern $pat failed to match in array"
|
||||
fi
|
||||
done
|
||||
</code></pre>
|
||||
@ -962,7 +966,7 @@ associative arrays:</p>
|
||||
<p>which is quite a lot clearer. As always, this will fail if you engage in
|
||||
un-zsh activities with <code>SH_WORD_SPLIT</code>, but judicious use of <code>@</code>,
|
||||
whether as a flag or a subscript, and double quotes, will always work:</p>
|
||||
<pre><code> % print -l "${(@kv)assoc}"
|
||||
<pre><code> % print -l "${(@kv)assoc}"
|
||||
*
|
||||
asterisk
|
||||
]
|
||||
@ -1076,7 +1080,7 @@ in perl and zsh.</p>
|
||||
$hash{key} ${hash[key]}
|
||||
keys %hash ${(k)hash}
|
||||
values %hash ${(v)hash}
|
||||
%hash2 = %hash; typeset -A hash2; hash2=("${(@kv)hash}")
|
||||
%hash2 = %hash; typeset -A hash2; hash2=("${(@kv)hash}")
|
||||
unset %hash; unset hash
|
||||
if (exists $hash{key}) { if (( ${+hash[key]} )); then
|
||||
... ...
|
||||
@ -1132,7 +1136,7 @@ scalars, which it will split if necessary) by using <code>(w)</code>:</p>
|
||||
84
|
||||
% print ${(c)#path}
|
||||
84
|
||||
% foo="three scalar words"
|
||||
% foo="three scalar words"
|
||||
% print ${(w)#foo}
|
||||
3
|
||||
</code></pre>
|
||||
@ -1141,7 +1145,7 @@ includes the space used for separating (equal to the number of colons
|
||||
separating the elements in <code>$PATH</code>). There's a relative of <code>(w)</code> called
|
||||
<code>(W)</code>, which treats multiple word separators as having zero-length words
|
||||
in between:</p>
|
||||
<pre><code> % foo="three well-spaced word"
|
||||
<pre><code> % foo="three well-spaced word"
|
||||
% print ${(w)#foo}
|
||||
3
|
||||
% print ${(W)#foo}
|
||||
@ -1196,7 +1200,7 @@ been processed.</p>
|
||||
enough: the <em>value</em> is substituted if the parameter <em>doesn't</em> have zero
|
||||
length. In this case, <em>value</em> will often be another parameter
|
||||
substitution:</p>
|
||||
<pre><code> print ${value:+"the value of value is $value"}
|
||||
<pre><code> print ${value:+"the value of value is $value"}
|
||||
</code></pre>
|
||||
<p>prints the string only if <code>$#value</code> is greater than zero. Note that what
|
||||
can appear after the `<code>+</code>' is pretty much any single word the shell can
|
||||
@ -1204,11 +1208,11 @@ parse; all the usual single-word substitutions (so globbing is excluded)
|
||||
will be applied to it, and quotes will work just the same as usual. This
|
||||
applies to the values after `<code>:-</code>' and `<code>:=</code>', too. One other commonly
|
||||
seen trick might be worth mentioning:</p>
|
||||
<pre><code> print ${1+"$@"}
|
||||
<pre><code> print ${1+"$@"}
|
||||
</code></pre>
|
||||
<p>substitutes all the positional parameters as they were passed if the
|
||||
first one was set (here you don't want the colon). This was necessary in
|
||||
some old shells because <code>"$@"</code> on its own gave you a single empty
|
||||
some old shells because <code>"$@"</code> on its own gave you a single empty
|
||||
argument instead of no arguments when no arguments were passed. This
|
||||
workaround isn't necessary in zsh, nor in most modern Bourne-derived
|
||||
shells. There's a bug in zsh's handling, however; see the section on
|
||||
@ -1497,7 +1501,7 @@ set and try to join a string:</p>
|
||||
but the spaces still caused word-spliting even though you asked for the
|
||||
array to be joined with colons. To avoid this, either don't use
|
||||
<code>SH_WORD_SPLIT</code> (my personal preference), or use quotes:</p>
|
||||
<pre><code> % print -l "${(j.:.)foo}"
|
||||
<pre><code> % print -l "${(j.:.)foo}"
|
||||
another array:of:words with spaces
|
||||
</code></pre>
|
||||
<p>The elements of an array would normally be joined by spaces in this
|
||||
@ -1510,7 +1514,7 @@ tab, newline and NUL.</p>
|
||||
the string to split on, but also ensures the split will take place even
|
||||
if the expression is quoted:</p>
|
||||
<pre><code> % array=('element one' 'element two' 'element three')
|
||||
% print -l "${=array}"
|
||||
% print -l "${=array}"
|
||||
element
|
||||
one
|
||||
element
|
||||
@ -1525,7 +1529,7 @@ array.</p>
|
||||
<p>I will talk shortly about nested parameter substitution; you should also
|
||||
note that splitting and joining will if necessary take place at all
|
||||
levels of a nested substitution, not just the outermost one:</p>
|
||||
<pre><code> % foo="three blind words"
|
||||
<pre><code> % foo="three blind words"
|
||||
% print ${#${(z)foo}}
|
||||
3
|
||||
</code></pre>
|
||||
@ -1642,7 +1646,7 @@ violation of the rules.</p>
|
||||
<p>Sometimes you don't need anything more than the flags. The most useful
|
||||
case is making the `fill' flags generate repeated words, with the
|
||||
effect of perl's `<code>x</code>' operator (for those not familiar with perl, the
|
||||
expression `<code>"string" x 3</code>' produces the string `stringstringstring'.
|
||||
expression `<code>"string" x 3</code>' produces the string `stringstringstring'.
|
||||
Here, you need to remember that the fill width you specify is the total
|
||||
width, not the number of repetitions, so you need to multiply it by the
|
||||
length of the string:</p>
|
||||
@ -1682,7 +1686,7 @@ probably be the neatest way of doing the same thing:</p>
|
||||
<pre><code> # Perl code.
|
||||
@p = qw(/dir1/file1.ext1 /dir2/file2.ext2);
|
||||
@q = map { m%^(?:.*/)(.*?)(?:\.[^.]*|)$%; } @p;
|
||||
print "@q\n";'
|
||||
print "@q\n";'
|
||||
</code></pre>
|
||||
<p>or numerous possible variants. In a shell, there's no way of putting
|
||||
functions like that into the command line without complicating the basic
|
||||
@ -1826,7 +1830,7 @@ remember the longest element:</p>
|
||||
$newl = length $_;
|
||||
$elt = $_, $l = $newl if $l > $newl;
|
||||
}
|
||||
print $elt, "\n";
|
||||
print $elt, "\n";
|
||||
</code></pre>
|
||||
<p>You can do just the same thing in zsh easily enough in this case;</p>
|
||||
<pre><code> local val elt
|
||||
@ -2082,7 +2086,7 @@ confused:</p>
|
||||
<p>because `<code>$s</code>' evaluates to an empty string before the arithmetic
|
||||
evaluation proper, which spoils the syntax. There's one common case
|
||||
where you need to do that, and that's with positional parameters:</p>
|
||||
<pre><code> % fn() { print "Twice $1 is $(( 2 * $1 ))"; }
|
||||
<pre><code> % fn() { print "Twice $1 is $(( 2 * $1 ))"; }
|
||||
% fn 3
|
||||
Twice 3 is 6
|
||||
% fn
|
||||
@ -2090,7 +2094,7 @@ where you need to do that, and that's with positional parameters:</p>
|
||||
</code></pre>
|
||||
<p>Obviously turning the `<code>$1</code>' into `<code>1</code>' means something completely
|
||||
different. You can guard against this with default values:</p>
|
||||
<pre><code> % fn() { print "Twice ${1:=0} is $(( 2 * $1 ))"; }
|
||||
<pre><code> % fn() { print "Twice ${1:=0} is $(( 2 * $1 ))"; }
|
||||
% fn
|
||||
Twice 0 is 0
|
||||
</code></pre>
|
||||
@ -2309,7 +2313,7 @@ builtins, and then only in the values of an assignment. However, in
|
||||
combination with <code>MAGIC_EQUAL_SUBST</code>, you will get the same behaviour
|
||||
with any command argument that looks like an assignment --- actually,
|
||||
anything following an `<code>=</code>' which wasn't at the start of the word, so
|
||||
`<code>"hello mother, => I'm home "$(echo right now)</code>' qualifies.</p>
|
||||
`<code>"hello mother, => I'm home "$(echo right now)</code>' qualifies.</p>
|
||||
<p>It seems that bash behaves as if both <code>KSH_TYPESET</code> <em>and</em>
|
||||
<code>MAGIC_EQUAL_SUBST</code> are always in effect.</p>
|
||||
<p><span id="l135"></span></p>
|
||||
@ -2451,9 +2455,9 @@ rest of this section if it doesn't make sense now:</p>
|
||||
setopt localoptions extendedglob
|
||||
if [[ $1 = ([-+]|)([0-9]##.[0-9]#|[0-9]#.[0-9]##)\
|
||||
([eE]([-+]|)[0-9]##|) ]]; then
|
||||
print -r -- "$1 is a floating point number"
|
||||
print -r -- "$1 is a floating point number"
|
||||
else
|
||||
print -r -- "$1 is not a floating point number"
|
||||
print -r -- "$1 is not a floating point number"
|
||||
fi
|
||||
}
|
||||
</code></pre>
|
||||
@ -2498,9 +2502,9 @@ shell doesn't take it as a pipe, but in some contexts where this won't
|
||||
happen, such as a case statement label, you can omit any parentheses
|
||||
that would completely surround the pattern. So in</p>
|
||||
<pre><code> case $foo in
|
||||
(bar|rod|pipe) print "foo represents a piece of metal"
|
||||
(bar|rod|pipe) print "foo represents a piece of metal"
|
||||
;;
|
||||
(*) print "Are you trying to be different?"
|
||||
(*) print "Are you trying to be different?"
|
||||
;;
|
||||
esac
|
||||
</code></pre>
|
||||
@ -3265,7 +3269,7 @@ function to correct misspelled filenames.</p>
|
||||
fi
|
||||
|
||||
for (( approx = 1; approx <= max_approx; approx++ )); do
|
||||
trylist=( (#a$approx)"$file"(N) )
|
||||
trylist=( (#a$approx)"$file"(N) )
|
||||
(( $#trylist )) && break
|
||||
done
|
||||
(( $#trylist )) || return 1
|
||||
@ -3475,7 +3479,7 @@ generic way of passing down options to the programmes executed, using
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="zshguide06.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="zshguide06.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -3489,31 +3493,48 @@ generic way of passing down options to the programmes executed, using
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="zshguide06.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="zshguide06.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
socket.onmessage = function (event) {
|
||||
if (event.data === "reload") {
|
||||
socket.close();
|
||||
location.reload();
|
||||
}
|
||||
};
|
||||
|
||||
window.onbeforeunload = function() {
|
||||
socket.close();
|
||||
}
|
||||
</script>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,17 +1,16 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
<title>Completion, old and new - Zsh User's Guide</title>
|
||||
<title>Completion, old and new - Zsh Guide</title>
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded affix "><a href="zshguide.html">A User's Guide to the Z-Shell</a></li><li class="chapter-item expanded "><a href="zshguide01.html"><strong aria-hidden="true">1.</strong> A short introduction</a></li><li class="chapter-item expanded "><a href="zshguide02.html"><strong aria-hidden="true">2.</strong> What to put in your startup files</a></li><li class="chapter-item expanded "><a href="zshguide03.html"><strong aria-hidden="true">3.</strong> Dealing with basic shell syntax</a></li><li class="chapter-item expanded "><a href="zshguide04.html"><strong aria-hidden="true">4.</strong> The Z-Shell Line Editor</a></li><li class="chapter-item expanded "><a href="zshguide05.html"><strong aria-hidden="true">5.</strong> Substitutions</a></li><li class="chapter-item expanded "><a href="zshguide06.html" class="active"><strong aria-hidden="true">6.</strong> Completion, old and new</a></li><li class="chapter-item expanded "><a href="zshguide07.html"><strong aria-hidden="true">7.</strong> Modules and other bits and pieces Not written</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -116,7 +120,7 @@
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<h1 class="menu-title">Zsh User's Guide</h1>
|
||||
<h1 class="menu-title">Zsh Guide</h1>
|
||||
|
||||
<div class="right-buttons">
|
||||
<a href="print.html" title="Print this book" aria-label="Print this book">
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -616,9 +620,9 @@ extra completions for all your aliases. However, it's possible you may
|
||||
want to define something different for the alias than for the command it
|
||||
expands to. In that case, you will need to set <code>COMPLETE_ALIASES</code>, and
|
||||
to make arrangements for completing after every alias which does not
|
||||
already match the name of a command. Hence `<code>alias zcat="myzcat -dc"</code>'
|
||||
already match the name of a command. Hence `<code>alias zcat="myzcat -dc"</code>'
|
||||
will work with the option set, even if you haven't told the system about
|
||||
`<code>myzcat</code>', while `<code>alias myzcat="gzip -dc"</code>' will not work unless you
|
||||
`<code>myzcat</code>', while `<code>alias myzcat="gzip -dc"</code>' will not work unless you
|
||||
do define a completion for myzcat: here `<code>compdef _gzip myzcat</code>' would
|
||||
probably be good enough. Without the option set, it would be the other
|
||||
way around: the first alias would not work without the extra <code>compdef</code>,
|
||||
@ -969,7 +973,7 @@ for <code>cd</code> will only show subdirectories of where you are, not those of
|
||||
rod/ stick/
|
||||
</code></pre>
|
||||
<p>There's more you can do with the <code>tag-order</code> style: if you put the tags
|
||||
into the same word by quoting, for example <code>"local-directories path-directories"</code>, then they would be tried at the same time, which in
|
||||
into the same word by quoting, for example <code>"local-directories path-directories"</code>, then they would be tried at the same time, which in
|
||||
this case gives you the effect of the default. In fact, since it's too
|
||||
much work to know what tags are going to be available for every single
|
||||
possible completion, the default when there is no appropriate
|
||||
@ -1056,7 +1060,7 @@ simply alters the order in which the tags which <em>are</em> valid are
|
||||
examined. Come back and read this paragraph again when you can't work
|
||||
out why <code>tag-order</code> isn't doing what you want.</p>
|
||||
<p>Note that the rule for testing patterns means that you can always
|
||||
specify a catch-all worst case by `<code>zstyle "*" style ...</code>', which will
|
||||
specify a catch-all worst case by `<code>zstyle "*" style ...</code>', which will
|
||||
always be tried last --- not just in completion, in fact, since other
|
||||
parts of the shell use the styles mechanism, and without the
|
||||
`<code>:completion:</code>' at the start of the context this style definition will
|
||||
@ -1818,21 +1822,21 @@ the value to the default.</p>
|
||||
instructions. The parameter <code>$ZLS_COLORS</code> is the lowest-level part of
|
||||
the system used by <code>zsh/complist</code>. There is a simple builtin default,
|
||||
while having the style set to the empty string is equivalent to:</p>
|
||||
<pre><code> ZLS_COLORS="no=00:fi=00:di=01;34:ln=01;36:\
|
||||
<pre><code> ZLS_COLORS="no=00:fi=00:di=01;34:ln=01;36:\
|
||||
pi=40;33:so=01;35:bd=40;33;01:cd=40;33;01:\
|
||||
ex=01;32:lc=\e[:rm=m:tc=00:sp=00:ma=07:hi=00:du=00
|
||||
</code></pre>
|
||||
<p>It has essentially the same format as <code>$LS_COLORS</code>, and indeed you can
|
||||
get a more useful set of values by using the <code>dircolors</code> command which
|
||||
comes with <code>ls</code>:</p>
|
||||
<pre><code> ZLS_COLORS="no=00:fi=00:di=01;34:ln=01;36:\
|
||||
<pre><code> ZLS_COLORS="no=00:fi=00:di=01;34:ln=01;36:\
|
||||
pi=40;33:so=01;35:do=01;35:bd=40;33;01:cd=40;33;01:\
|
||||
or=40;31;01:ex=01;32:*.tar=01;31:*.tgz=01;31:\
|
||||
*.arj=01;31:*.taz=01;31:*.lzh=01;31:*.zip=01;31:\
|
||||
*.z=01;31:*.Z=01;31:*.gz=01;31:*.deb=01;31:\
|
||||
*.jpg=01;35:*.gif=01;35:*.bmp=01;35:*.ppm=01;35:\
|
||||
*.tga=01;35:*.xbm=01;35:*.xpm=01;35:*.tif=01;35:\
|
||||
*.mpg=01;37:*.avi=01;37:*.gl=01;37:*.dl=01;37:"
|
||||
*.mpg=01;37:*.avi=01;37:*.gl=01;37:*.dl=01;37:"
|
||||
</code></pre>
|
||||
<p>You should see the manual for the <code>zsh/complist</code> module for details, but
|
||||
note in particular the addition of the type `<code>ma</code>', which specifies how
|
||||
@ -1843,7 +1847,7 @@ prompt, which you can display with `<code>print -P %Sfoo</code>'.</p>
|
||||
always uses that to set <code>$ZLS_COLORS</code>; otherwise it doesn't know whether
|
||||
the value it has found has come from the user or is a previous value
|
||||
taken from some style. That takes this format:</p>
|
||||
<pre><code> zstyle ':completion:*' list-colors "no=00" "fi=00" ...
|
||||
<pre><code> zstyle ':completion:*' list-colors "no=00" "fi=00" ...
|
||||
</code></pre>
|
||||
<p>You can use an already defined <code>$LS_COLORS</code>:</p>
|
||||
<pre><code> zstyle ':completion:*' list-colors ${(s.:.)LS_COLORS}
|
||||
@ -2546,8 +2550,8 @@ for all those possible bindings, you need to issue the right statements
|
||||
in your <code>.zshrc</code>, since only the bindings with `<code>~</code>' are set up by
|
||||
default to avoid clashes. This will do it:</p>
|
||||
<pre><code> for key in '!' '$' '@' '/'; do
|
||||
bindkey "\e$key" _bash_complete-word
|
||||
bindkey "^X$key" _bash_list-choices
|
||||
bindkey "\e$key" _bash_complete-word
|
||||
bindkey "^X$key" _bash_list-choices
|
||||
done
|
||||
</code></pre>
|
||||
<p>Unlike most widgets, which are tied to functions of the same name to
|
||||
@ -3017,7 +3021,7 @@ the main file. The file <code>_perforce</code> therefore has the structure:</p>
|
||||
}
|
||||
|
||||
# Code to make sure _perforce is run when we load it
|
||||
_perforce "$@"
|
||||
_perforce "$@"
|
||||
</code></pre>
|
||||
<p>That last line is probably the least obvious. It's because of the fact
|
||||
that zsh (unlike other shells) usually treats the file of an autoloaded
|
||||
@ -3060,7 +3064,7 @@ first word after the <code>p4</code> command itself. A simple way of doing that
|
||||
# Remember the subcommand name
|
||||
local cmd=${words[2]}
|
||||
# Set the context for the subcommand.
|
||||
curcontext="${curcontext%:*:*}:p4-$cmd"
|
||||
curcontext="${curcontext%:*:*}:p4-$cmd"
|
||||
# Narrow the range of words we are looking at to exclude `p4'
|
||||
(( CURRENT-- ))
|
||||
shift words
|
||||
@ -3072,7 +3076,7 @@ first word after the <code>p4</code> command itself. A simple way of doing that
|
||||
_call_program help-commands p4 help commands | while read -A hline; do
|
||||
(( ${#hline} < 2 )) && continue
|
||||
[[ $hline[1] = (#i)perforce ]] && continue
|
||||
cmdlist=($cmdlist "${hline[1]}:${hline[2,-1]}")
|
||||
cmdlist=($cmdlist "${hline[1]}:${hline[2,-1]}")
|
||||
done
|
||||
_describe -t p4-commands 'Perforce command' cmdlist
|
||||
fi
|
||||
@ -3170,7 +3174,7 @@ version.</p>
|
||||
'-d-[select diff option]:diff option:'\
|
||||
'((b\:ignore\ blanks c\:context n\:RCS s\:summary'\
|
||||
'u\:unified w\:ignore\ all\ whitespace))' \
|
||||
"*::file:_perforce_files"
|
||||
"*::file:_perforce_files"
|
||||
}
|
||||
</code></pre>
|
||||
<p>I've split the argument beginning <code>-d</code> into three lines to fit, but it's
|
||||
@ -3295,8 +3299,8 @@ characters there's no easy way of quoting them. You didn't need to know
|
||||
this.)</p>
|
||||
<p>I'm going to say we can complete both like this:</p>
|
||||
<pre><code> _alternative \
|
||||
"files:file:_path_files" \
|
||||
"subdirs:subdirectory search:_perforce_subdir_search"
|
||||
"files:file:_path_files" \
|
||||
"subdirs:subdirectory search:_perforce_subdir_search"
|
||||
</code></pre>
|
||||
<p>The function <code>_alternative</code> is a little bit like <code>_arguments</code>, but
|
||||
thankfully much simpler. It's name gives away its purpose; every
|
||||
@ -3324,7 +3328,7 @@ invented a suitable tag `<code>subdirs</code>', a description, `<code>subdirecto
|
||||
completion. This is quite simple:</p>
|
||||
<pre><code> _perforce_subdir_search() {
|
||||
compset -P '*/'
|
||||
compadd "$@" '...'
|
||||
compadd "$@" '...'
|
||||
}
|
||||
</code></pre>
|
||||
<p>The first line tells the completion system to ignore anything up to the
|
||||
@ -3336,11 +3340,11 @@ default in zsh and other UNIX pattern matchers.</p>
|
||||
<p>The second line actually adds the `<code>...</code>' as a completion; <code>compadd</code> is
|
||||
the key builtin for the whole completion system. I've actually passed
|
||||
some on the arguments which we got to `<code>_perforce_subdir_search</code>' via
|
||||
`<code>"$@"</code>'. In fact, looking back it seems as if there weren't any!
|
||||
`<code>"$@"</code>'. In fact, looking back it seems as if there weren't any!
|
||||
However, <code>_alternative</code> actually passed some behind my back --- and it's
|
||||
a good thing, too, since it's exactly those arguments that give the tag
|
||||
`<code>subdirs</code>' and the description `<code>subdirectory search</code>'. So that extra
|
||||
`<code>"$@"</code>' is actually quite important. The buck stops here; there's
|
||||
`<code>"$@"</code>' is actually quite important. The buck stops here; there's
|
||||
nothing below <code>compadd</code>. A function of this simplest only works well
|
||||
when the handling of tags and contexts has already been done; but we
|
||||
just saw that <code>_alternative</code> did that, so as long as we always call
|
||||
@ -3365,13 +3369,13 @@ structure of <code>p4_files</code> so far looks like:</p>
|
||||
)
|
||||
# add other alternatives, such as the `...' thing
|
||||
altfiles=($altfiles
|
||||
"subdirs:subdirectory search:_perforce_subdir_search"
|
||||
"subdirs:subdirectory search:_perforce_subdir_search"
|
||||
)
|
||||
_alternative $altfiles
|
||||
else
|
||||
_alternative \
|
||||
"files:file:_path_files" \
|
||||
"subdirs:subdirectory search:_perforce_subdir_search"
|
||||
"files:file:_path_files" \
|
||||
"subdirs:subdirectory search:_perforce_subdir_search"
|
||||
fi
|
||||
</code></pre>
|
||||
<p>where we are still to write the functions for the first two alternatives
|
||||
@ -3414,11 +3418,11 @@ only operate on directories. Here's <code>_perforce_depot_files</code>;
|
||||
local -a files
|
||||
|
||||
compset -P '*/'
|
||||
files=(${${${(f)"$(\
|
||||
files=(${${${(f)"$(\
|
||||
_call_program files p4 files \
|
||||
\"\$pfx\*\$\{\(Q\)SUFFIX\}\" 2>/dev/null)"}%\#*}##*/})
|
||||
\"\$pfx\*\$\{\(Q\)SUFFIX\}\" 2>/dev/null)"}%\#*}##*/})
|
||||
[[ $#files -eq 1 && $files[1] = '' ]] && files=()
|
||||
compadd "$@" -a files
|
||||
compadd "$@" -a files
|
||||
}
|
||||
</code></pre>
|
||||
<p>A little messy (and still not quite the full horror). I've split the key
|
||||
@ -3435,18 +3439,18 @@ example, if the name on the line so far had a space, <code>$PREFIX</code> (which
|
||||
comes from what is on the command line without any quotes being
|
||||
stripped) would have the space quoted somehow, e.g. `<code>name\ with\ space</code>'. We arrange for <code>$pfx</code> to contain `<code>name with space</code>', which is
|
||||
how Perforce knows the file, using the <code>(Q)</code> parameter flag. We then
|
||||
pass the argument <code>"$pfx*${(Q)SUFFIX}"</code> to `<code>p4 files</code>'; this generates
|
||||
pass the argument <code>"$pfx*${(Q)SUFFIX}"</code> to `<code>p4 files</code>'; this generates
|
||||
matching files internally. The extra layer of backslash-quoting is for
|
||||
the benefit of <code>_call_program</code>, which re-evaluates its arguments; this
|
||||
ensures the argument is expanded at the point it gets passed to <code>p4 files</code>. All this goes to show just how difficult getting the quoting
|
||||
right can be.</p>
|
||||
<p>Once we've got the list of bare filenames, we check to see if the list
|
||||
is just one element with no length. That's an artefact of the the
|
||||
<code>"$(cmd)"</code> syntax; if the output is empty, because its quoted you still
|
||||
<code>"$(cmd)"</code> syntax; if the output is empty, because its quoted you still
|
||||
get one zero-length string output, which we don't want.</p>
|
||||
<p>Finally, we pass the result to <code>compadd</code> as before. Again, tags and the
|
||||
description have already been handled and we just need to make sure the
|
||||
appropriate options get passed in with <code>"$@"</code>. This time we use the
|
||||
appropriate options get passed in with <code>"$@"</code>. This time we use the
|
||||
`<code>-a</code>' option which tells <code>compadd</code> that any arguments are array name,
|
||||
not a list of completions. This is more efficient; compadd only needs to
|
||||
expand the array internally instead of the shell passing a potentially
|
||||
@ -3483,7 +3487,7 @@ completion (such as the `<code>/</code>' after a directory --- this is
|
||||
historically where this feature came from).</p>
|
||||
<p>The method is to add an extra argument everywhere we complete a file
|
||||
name. For example, change the <code>compadd</code> in <code>_perforce_depot_files</code> to:</p>
|
||||
<pre><code> compadd "$@" -R _perforce_file_suffix -a files
|
||||
<pre><code> compadd "$@" -R _perforce_file_suffix -a files
|
||||
</code></pre>
|
||||
<p>where the option argument specifies a function:</p>
|
||||
<pre><code> _perforce_file_suffix() {
|
||||
@ -3492,10 +3496,10 @@ name. For example, change the <code>compadd</code> in <code>_perforce_depot_file
|
||||
if [[ $LBUFFER[-1] = ' ' ]]; then
|
||||
if [[ $KEYS = '#' ]]; then
|
||||
# Suffix removal with an added backslash
|
||||
LBUFFER="$LBUFFER[1,-2]\\"
|
||||
LBUFFER="$LBUFFER[1,-2]\\"
|
||||
elif [[ $KEYS = (*[^[:print:]]*|[[:blank:]\;\&\|@]) ]]; then
|
||||
# Normal suffix removal
|
||||
LBUFFER="$LBUFFER[1,-2]"
|
||||
LBUFFER="$LBUFFER[1,-2]"
|
||||
fi
|
||||
fi
|
||||
}
|
||||
@ -3572,7 +3576,7 @@ numbers with the all-important descriptions.</p>
|
||||
_call_program filelog p4 filelog \$pfx 2>/dev/null |
|
||||
while read rline; do
|
||||
if [[ $rline = (#b)'... #'(<->)*\'(*)\' ]]; then
|
||||
rl=($l "${match[1]}:${match[2]}")
|
||||
rl=($l "${match[1]}:${match[2]}")
|
||||
fi
|
||||
done
|
||||
fi
|
||||
@ -3634,7 +3638,7 @@ function are called <code>_gunzip</code>:</p>
|
||||
local expl
|
||||
|
||||
_description files expl 'compressed file'
|
||||
_files "$expl[@]" -g '*.[gG][zZ]'
|
||||
_files "$expl[@]" -g '*.[gG][zZ]'
|
||||
</code></pre>
|
||||
<p>You can probably see straight away that if you want to design your own
|
||||
completion function for a command which takes, say, files ending in
|
||||
@ -3796,7 +3800,7 @@ parameters made available by the <code>zsh/parameter</code> module.</p>
|
||||
simply adds all possible files as completions, taking account of the
|
||||
word on the command line to establish directories and so on.</p>
|
||||
<p>For more specific use, you can give it various options: `<code>-/</code>' means
|
||||
complete directories, and, as you saw, `<code>-g "<pattern>"</code>' gives a
|
||||
complete directories, and, as you saw, `<code>-g "<pattern>"</code>' gives a
|
||||
filename generation pattern to produce matching files.</p>
|
||||
<p>A couple of other options, which can be combined with the ones above,
|
||||
are worthy of mention. If you use `<code>-W <dir></code>', then completion takes
|
||||
@ -3816,7 +3820,7 @@ current directory, then in a standard directory, say,
|
||||
<p>--- note there is no `<code>$</code>' before the variable <code>$oomph_dirs</code> here,
|
||||
since it should only be expanded deep inside <code>_files</code>.</p>
|
||||
<p>The system that implements <code>$fignore</code> and the <code>ignored-patterns</code> style
|
||||
can be intercepted, if you need to, with the option `<code>-F "<pat>"</code>';
|
||||
can be intercepted, if you need to, with the option `<code>-F "<pat>"</code>';
|
||||
`<code><pat></code>' is an array of patterns to ignore, in the usual completion
|
||||
format, in other words the name of a real shell array, or a list of
|
||||
values inside parentheses. If you make sure all the tags stuff is
|
||||
@ -3963,10 +3967,10 @@ understanding of zsh's parameter and command expansion mechanisms and a
|
||||
strong stomach will be useful here.</p>
|
||||
<p>For example, here is the expansion used by the <code>_limits</code> function to
|
||||
retrieve the names of resource limits from the <code>limit</code> command itself:</p>
|
||||
<pre><code> print ${${(f)"$(limit)"}%% *}
|
||||
<pre><code> print ${${(f)"$(limit)"}%% *}
|
||||
</code></pre>
|
||||
<p>which you can test does the right thing. Here's a translation:
|
||||
<code>"$(limit)"</code> calls the command in a quoted context, which means you get
|
||||
<code>"$(limit)"</code> calls the command in a quoted context, which means you get
|
||||
the output as if it were a single file (just type `<code>limit</code>' to see what
|
||||
that is). <code>${(f)...}</code> splits this into an array (it is now outside
|
||||
quotes, so splitting will generate an array) with one element per line.
|
||||
@ -4030,7 +4034,7 @@ more.</p>
|
||||
<p>Actually, this is already done by the the <code>_files</code> and <code>_path_files</code>
|
||||
functions for filename completion. Also, you can get some help using the
|
||||
<code>compset</code> builtin command. In this case, the incantation is</p>
|
||||
<pre><code> if compset -P "*/"; then
|
||||
<pre><code> if compset -P "*/"; then
|
||||
# do whatever you need to with the leading
|
||||
# string up to / stripped off
|
||||
else
|
||||
@ -4050,15 +4054,15 @@ are probably the most frequent.</p>
|
||||
<p>If you want to make the test made by <code>compset</code>, but without the side
|
||||
effect of changing the prefixes and suffixes, there are tests like this:</p>
|
||||
<pre><code> if [[ -prefix */ ]]; then
|
||||
# same as with `compset -P "*/"', except prefixes were left alone.
|
||||
# same as with `compset -P "*/"', except prefixes were left alone.
|
||||
fi
|
||||
</code></pre>
|
||||
<p>These have the advantage of looking like all the standard tests
|
||||
understood by the shell.</p>
|
||||
<p>There are three other parameters special to completion. The <code>$QIPREFIX</code>
|
||||
and <code>$QISUFFIX</code> are a special prefix and suffix used when you are
|
||||
dividing up a quoted word --- for example, in `<code>zsh -c "echo hi"</code>', the
|
||||
word <code>"echo hi"</code> is going to be used as a command line in its own right,
|
||||
dividing up a quoted word --- for example, in `<code>zsh -c "echo hi"</code>', the
|
||||
word <code>"echo hi"</code> is going to be used as a command line in its own right,
|
||||
so if you want to do completion there, you need to have it split up. You
|
||||
can use `<code>compset -q</code>' to split a word in this fashion.</p>
|
||||
<p>There is also an associative array <code>$compstate</code>, which allows you to
|
||||
@ -4131,7 +4135,7 @@ original test failed, then we simply complete what's there as a user.</p>
|
||||
to extract the <code>$NUMERIC</code>th (default first) most recently modified file.</p>
|
||||
<pre><code> local file
|
||||
file=($~PREFIX*$~SUFFIX(om[${NUMERIC:-1}]N))
|
||||
(( $#file )) && compadd -U -i "$IPREFIX" -I "$ISUFFIX" -f -Q - $file
|
||||
(( $#file )) && compadd -U -i "$IPREFIX" -I "$ISUFFIX" -f -Q - $file
|
||||
</code></pre>
|
||||
<p>Instead of doing it with mirrors, this uses globbing qualifiers to
|
||||
extract the required file; <code>om</code> specifies ordering by modification time,
|
||||
@ -4151,7 +4155,7 @@ suppose you were in a context where you were completing after
|
||||
to `<code>file=</code>' was not to count and not to be shown as part of the
|
||||
completion. You would want to keep that when the word was put back on
|
||||
the command line. However, `<code>-U</code>' would delete that too. Hence the
|
||||
`<code>-i "$IPREFIX"</code>' to make sure it's retained. The same argument goes
|
||||
`<code>-i "$IPREFIX"</code>' to make sure it's retained. The same argument goes
|
||||
for the ignored suffix. However, there's currently no way of getting
|
||||
<code>_most_recent_file</code> to work on only a part of a string, so this
|
||||
explanation really only applies when you call it from another completion
|
||||
@ -4183,7 +4187,7 @@ completion functions which will pass the arguments on to <code>compadd</code>. F
|
||||
example,</p>
|
||||
<pre><code> local expl
|
||||
_description files expl 'my special files'
|
||||
_files "$expl[@]"
|
||||
_files "$expl[@]"
|
||||
</code></pre>
|
||||
<p>This sets the files tag; <code>_description</code> sets <code>$expl</code> to pass on the
|
||||
description, and maybe other things such as a group name for the tag, in
|
||||
@ -4210,7 +4214,7 @@ the generated tags, checking the labels. The call above would now look
|
||||
like this:</p>
|
||||
<pre><code> _wanted files expl 'my special files' _files
|
||||
</code></pre>
|
||||
<p>Note that you now don't pass the <code>"$expl[@]"</code>, which hasn't even been
|
||||
<p>Note that you now don't pass the <code>"$expl[@]"</code>, which hasn't even been
|
||||
set yet; <code>_wanted</code> will generate the string using the parameter name you
|
||||
say (here `<code>expl</code>', as usual), and assume that the function generating
|
||||
the completions can use the result passed down to it. This is true of
|
||||
@ -4239,11 +4243,11 @@ the loop we are using. The end result looks like this:</p>
|
||||
<pre><code> local expl ret=1
|
||||
_tags foo bar rod
|
||||
while _tags; do
|
||||
_requested foo expl "This is the description for tag foo" \
|
||||
_requested foo expl "This is the description for tag foo" \
|
||||
compadd all foos completions && ret=0
|
||||
_requested bar expl "This is the description for tag bar" \
|
||||
_requested bar expl "This is the description for tag bar" \
|
||||
compadd all bars completions && ret=0
|
||||
_requested rod expl "This is the description for tag rod" \
|
||||
_requested rod expl "This is the description for tag rod" \
|
||||
compadd all rods completions && ret=0
|
||||
(( ret )) || return 0 # leave if matches were generated
|
||||
done
|
||||
@ -4257,7 +4261,7 @@ valid tag is its argument and acts accordingly, and can be used only for
|
||||
simple, `one-shot' completions.</p>
|
||||
<p>With <code>_requested</code>, unlike <code>_wanted</code>, you can separate out the arguments
|
||||
to the completion generator itself --- here <code>compadd</code> --- into a
|
||||
different statement, remembering the <code>"$expl[@]"</code> argument in that case.
|
||||
different statement, remembering the <code>"$expl[@]"</code> argument in that case.
|
||||
You can miss out the second and third arguments for <code>_requested</code> in this
|
||||
way. This time the loop which generates labels for tags is not
|
||||
performed, and you have to arrange it yourself, with the usual trade off
|
||||
@ -4295,11 +4299,11 @@ it complete inside the function <code>_mh</code>.</p>
|
||||
<pre><code> _tags sequences
|
||||
while _tags; do
|
||||
while _next_label sequences expl sequence; do
|
||||
compadd "$expl[@]" $(mark $foldnam 2>/dev/null |
|
||||
compadd "$expl[@]" $(mark $foldnam 2>/dev/null |
|
||||
awk -F: '{ print $1 }') && ret=0
|
||||
compadd "$expl[@]" reply next cur prev \
|
||||
compadd "$expl[@]" reply next cur prev \
|
||||
first last all unseen && ret=0
|
||||
_files "$expl[@]" -W folddir -g '<->' && ret=0
|
||||
_files "$expl[@]" -W folddir -g '<->' && ret=0
|
||||
done
|
||||
(( ret )) || return 0
|
||||
done
|
||||
@ -4398,7 +4402,7 @@ will need to know about the parameter <code>$curcontext</code>, which is what
|
||||
stores the middle part of the context, sans `<code>:completion:</code>' and sans
|
||||
tag. When you need to look something up, you pass this context to
|
||||
<code>zstyle</code> with `<code>:completion:</code>' stuck in front:</p>
|
||||
<pre><code> zstyle -b ":completion:${curcontext}:tag" style-name parameter
|
||||
<pre><code> zstyle -b ":completion:${curcontext}:tag" style-name parameter
|
||||
</code></pre>
|
||||
<p>If the tag is irrelevant, you can leave it empty, but you still need the
|
||||
final colon since there should always be six in total. In some cases
|
||||
@ -4427,7 +4431,7 @@ parameter has already been declared as one.</p>
|
||||
status zero if and only if the <code>pattern</code> matches one of the values
|
||||
stored in the style for the given context.</p>
|
||||
<p>Typical usages are thus:</p>
|
||||
<pre><code> if zstyle -t ":completion:${curcontext}:" foo; then
|
||||
<pre><code> if zstyle -t ":completion:${curcontext}:" foo; then
|
||||
# do things in a fooish way
|
||||
else
|
||||
# do things in an unfooish way
|
||||
@ -4435,7 +4439,7 @@ stored in the style for the given context.</p>
|
||||
</code></pre>
|
||||
<p>or to use the value:</p>
|
||||
<pre><code> local val
|
||||
if zstyle -s ":completion:${curcontext}:" foo val; then
|
||||
if zstyle -s ":completion:${curcontext}:" foo val; then
|
||||
# use $val to establish how fooish to be
|
||||
else
|
||||
# be defaultly fooish
|
||||
@ -4491,7 +4495,7 @@ These are the possible completions, passed straight down to
|
||||
<li>
|
||||
<p>The same, but with double parentheses; the list in this case
|
||||
consists of the completion, a backslashed colon, and a description.
|
||||
So an extended version of the previous action is `<code>((red\:The\ colour\ red blue:The\ colour\ blue))</code>' and so on. You can escape
|
||||
So an extended version of the previous action is `<code>((red\:The\ colour\ red blue\:The\ colour\ blue))</code>' and so on. You can escape
|
||||
other colons inside the specifications in this way, too.</p>
|
||||
</li>
|
||||
<li>
|
||||
@ -4762,9 +4766,9 @@ descriptions for a whole lot of options at once. It allows you to do
|
||||
that with several different sets of completions that may require
|
||||
different options to <code>compadd</code>. The general form looks something like
|
||||
this:</p>
|
||||
<pre><code> _describe "description of set 1" descs1 compls1 \
|
||||
<pre><code> _describe "description of set 1" descs1 compls1 \
|
||||
<compadd-opts-1> -- \
|
||||
"description of set 2" ...
|
||||
"description of set 2" ...
|
||||
</code></pre>
|
||||
<p>where you can have any number of sets separated by the `<code>-``-</code>'. The
|
||||
<code>descs1</code> and <code>compls1</code> are arrays of the same length, giving a list of
|
||||
@ -4822,7 +4826,7 @@ list of matches is a lot of files with path components. Here's another
|
||||
reasonable usage:</p>
|
||||
<pre><code> local groups expl
|
||||
groups=($(awk -F: '{ print $1 }' ~/.newsrc))
|
||||
_wanted groups expl 'newsgroup' _multi_parts "$expl[@]" . groups
|
||||
_wanted groups expl 'newsgroup' _multi_parts "$expl[@]" . groups
|
||||
</code></pre>
|
||||
<p>The generated array contains names of Usenet newsgroups, i.e. names with
|
||||
components separated by a `<code>.</code>', and <code>_multi_parts</code> allows you to
|
||||
@ -4914,7 +4918,7 @@ using just the tab key and ordinary characters.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="zshguide07.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="zshguide07.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -4928,31 +4932,48 @@ using just the tab key and ordinary characters.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="zshguide07.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="zshguide07.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
socket.onmessage = function (event) {
|
||||
if (event.data === "reload") {
|
||||
socket.close();
|
||||
location.reload();
|
||||
}
|
||||
};
|
||||
|
||||
window.onbeforeunload = function() {
|
||||
socket.close();
|
||||
}
|
||||
</script>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,17 +1,16 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
<title>Modules and other bits and pieces Not written - Zsh User's Guide</title>
|
||||
<title>Modules and other bits and pieces Not written - Zsh Guide</title>
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded affix "><a href="zshguide.html">A User's Guide to the Z-Shell</a></li><li class="chapter-item expanded "><a href="zshguide01.html"><strong aria-hidden="true">1.</strong> A short introduction</a></li><li class="chapter-item expanded "><a href="zshguide02.html"><strong aria-hidden="true">2.</strong> What to put in your startup files</a></li><li class="chapter-item expanded "><a href="zshguide03.html"><strong aria-hidden="true">3.</strong> Dealing with basic shell syntax</a></li><li class="chapter-item expanded "><a href="zshguide04.html"><strong aria-hidden="true">4.</strong> The Z-Shell Line Editor</a></li><li class="chapter-item expanded "><a href="zshguide05.html"><strong aria-hidden="true">5.</strong> Substitutions</a></li><li class="chapter-item expanded "><a href="zshguide06.html"><strong aria-hidden="true">6.</strong> Completion, old and new</a></li><li class="chapter-item expanded "><a href="zshguide07.html" class="active"><strong aria-hidden="true">7.</strong> Modules and other bits and pieces Not written</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -116,7 +120,7 @@
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<h1 class="menu-title">Zsh User's Guide</h1>
|
||||
<h1 class="menu-title">Zsh Guide</h1>
|
||||
|
||||
<div class="right-buttons">
|
||||
<a href="print.html" title="Print this book" aria-label="Print this book">
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -211,24 +215,41 @@
|
||||
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
socket.onmessage = function (event) {
|
||||
if (event.data === "reload") {
|
||||
socket.close();
|
||||
location.reload();
|
||||
}
|
||||
};
|
||||
|
||||
window.onbeforeunload = function() {
|
||||
socket.close();
|
||||
}
|
||||
</script>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
836
zsh-guide/theme/catppuccin.css
Normal file
836
zsh-guide/theme/catppuccin.css
Normal file
@ -0,0 +1,836 @@
|
||||
/* https://highlightjs.readthedocs.io/en/latest/css-classes-reference.html */
|
||||
.latte.hljs {
|
||||
color: #4c4f69;
|
||||
background: #eff1f5;
|
||||
}
|
||||
.latte .hljs-keyword {
|
||||
color: #8839ef;
|
||||
}
|
||||
.latte .hljs-built_in {
|
||||
color: #d20f39;
|
||||
}
|
||||
.latte .hljs-type {
|
||||
color: #df8e1d;
|
||||
}
|
||||
.latte .hljs-literal {
|
||||
color: #fe640b;
|
||||
}
|
||||
.latte .hljs-number {
|
||||
color: #fe640b;
|
||||
}
|
||||
.latte .hljs-operator {
|
||||
color: #04a5e5;
|
||||
}
|
||||
.latte .hljs-punctuation {
|
||||
color: #5c5f77;
|
||||
}
|
||||
.latte .hljs-property {
|
||||
color: #179299;
|
||||
}
|
||||
.latte .hljs-regexp {
|
||||
color: #ea76cb;
|
||||
}
|
||||
.latte .hljs-string {
|
||||
color: #40a02b;
|
||||
}
|
||||
.latte .hljs-char.escape_ {
|
||||
color: #40a02b;
|
||||
}
|
||||
.latte .hljs-subst {
|
||||
color: #6c6f85;
|
||||
}
|
||||
.latte .hljs-symbol {
|
||||
color: #dd7878;
|
||||
}
|
||||
.latte .hljs-variable {
|
||||
color: #8839ef;
|
||||
}
|
||||
.latte .hljs-variable.language_ {
|
||||
color: #8839ef;
|
||||
}
|
||||
.latte .hljs-variable.constant_ {
|
||||
color: #fe640b;
|
||||
}
|
||||
.latte .hljs-title {
|
||||
color: #1e66f5;
|
||||
}
|
||||
.latte .hljs-title.class_ {
|
||||
color: #df8e1d;
|
||||
}
|
||||
.latte .hljs-title.function_ {
|
||||
color: #1e66f5;
|
||||
}
|
||||
.latte .hljs-params {
|
||||
color: #4c4f69;
|
||||
}
|
||||
.latte .hljs-comment {
|
||||
color: #7c7f93;
|
||||
}
|
||||
.latte .hljs-doctag {
|
||||
color: #d20f39;
|
||||
}
|
||||
.latte .hljs-meta {
|
||||
color: #fe640b;
|
||||
}
|
||||
.latte .hljs-section {
|
||||
color: #1e66f5;
|
||||
}
|
||||
.latte .hljs-tag {
|
||||
color: #179299;
|
||||
}
|
||||
.latte .hljs-name {
|
||||
color: #8839ef;
|
||||
}
|
||||
.latte .hljs-attr {
|
||||
color: #1e66f5;
|
||||
}
|
||||
.latte .hljs-attribute {
|
||||
color: #40a02b;
|
||||
}
|
||||
.latte .hljs-bullet {
|
||||
color: #179299;
|
||||
}
|
||||
.latte .hljs-code {
|
||||
color: #40a02b;
|
||||
}
|
||||
.latte .hljs-emphasis {
|
||||
color: #d20f39;
|
||||
font-style: italic;
|
||||
}
|
||||
.latte .hljs-strong {
|
||||
color: #d20f39;
|
||||
font-weight: bold;
|
||||
}
|
||||
.latte .hljs-formula {
|
||||
color: #179299;
|
||||
}
|
||||
.latte .hljs-link {
|
||||
color: #209fb5;
|
||||
font-style: italic;
|
||||
}
|
||||
.latte .hljs-quote {
|
||||
color: #40a02b;
|
||||
font-style: italic;
|
||||
}
|
||||
.latte .hljs-selector-tag {
|
||||
color: #df8e1d;
|
||||
}
|
||||
.latte .hljs-selector-id {
|
||||
color: #1e66f5;
|
||||
}
|
||||
.latte .hljs-selector-class {
|
||||
color: #179299;
|
||||
}
|
||||
.latte .hljs-selector-attr {
|
||||
color: #8839ef;
|
||||
}
|
||||
.latte .hljs-selector-pseudo {
|
||||
color: #179299;
|
||||
}
|
||||
.latte .hljs-template-tag {
|
||||
color: #dd7878;
|
||||
}
|
||||
.latte .hljs-template-variable {
|
||||
color: #dd7878;
|
||||
}
|
||||
.latte .hljs-addition {
|
||||
color: #40a02b;
|
||||
background: rgba(64, 160, 43, 0.15);
|
||||
}
|
||||
.latte .hljs-deletion {
|
||||
color: #d20f39;
|
||||
background: rgba(210, 15, 57, 0.15);
|
||||
}
|
||||
.latte :is(h1, h2, h3, h4, h5, h6) a code {
|
||||
color: #4c4f69;
|
||||
}
|
||||
.latte a code {
|
||||
color: #1e66f5;
|
||||
}
|
||||
.latte code {
|
||||
color: #4c4f69;
|
||||
background: #e6e9ef;
|
||||
}
|
||||
.latte blockquote blockquote {
|
||||
border-top: 0.1em solid #acb0be;
|
||||
border-bottom: 0.1em solid #acb0be;
|
||||
}
|
||||
.latte hr {
|
||||
border-color: #acb0be;
|
||||
border-style: solid;
|
||||
}
|
||||
.latte del {
|
||||
color: #7c7f93;
|
||||
}
|
||||
.latte .ace_gutter {
|
||||
color: #8c8fa1;
|
||||
background: #e6e9ef;
|
||||
}
|
||||
.latte .ace_gutter-active-line.ace_gutter-cell {
|
||||
color: #ea76cb;
|
||||
background: #e6e9ef;
|
||||
}
|
||||
.latte .tooltiptext {
|
||||
background: #e6e9ef;
|
||||
color: #4c4f69;
|
||||
}
|
||||
|
||||
.frappe.hljs {
|
||||
color: #c6d0f5;
|
||||
background: #303446;
|
||||
}
|
||||
.frappe .hljs-keyword {
|
||||
color: #ca9ee6;
|
||||
}
|
||||
.frappe .hljs-built_in {
|
||||
color: #e78284;
|
||||
}
|
||||
.frappe .hljs-type {
|
||||
color: #e5c890;
|
||||
}
|
||||
.frappe .hljs-literal {
|
||||
color: #ef9f76;
|
||||
}
|
||||
.frappe .hljs-number {
|
||||
color: #ef9f76;
|
||||
}
|
||||
.frappe .hljs-operator {
|
||||
color: #99d1db;
|
||||
}
|
||||
.frappe .hljs-punctuation {
|
||||
color: #b5bfe2;
|
||||
}
|
||||
.frappe .hljs-property {
|
||||
color: #81c8be;
|
||||
}
|
||||
.frappe .hljs-regexp {
|
||||
color: #f4b8e4;
|
||||
}
|
||||
.frappe .hljs-string {
|
||||
color: #a6d189;
|
||||
}
|
||||
.frappe .hljs-char.escape_ {
|
||||
color: #a6d189;
|
||||
}
|
||||
.frappe .hljs-subst {
|
||||
color: #a5adce;
|
||||
}
|
||||
.frappe .hljs-symbol {
|
||||
color: #eebebe;
|
||||
}
|
||||
.frappe .hljs-variable {
|
||||
color: #ca9ee6;
|
||||
}
|
||||
.frappe .hljs-variable.language_ {
|
||||
color: #ca9ee6;
|
||||
}
|
||||
.frappe .hljs-variable.constant_ {
|
||||
color: #ef9f76;
|
||||
}
|
||||
.frappe .hljs-title {
|
||||
color: #8caaee;
|
||||
}
|
||||
.frappe .hljs-title.class_ {
|
||||
color: #e5c890;
|
||||
}
|
||||
.frappe .hljs-title.function_ {
|
||||
color: #8caaee;
|
||||
}
|
||||
.frappe .hljs-params {
|
||||
color: #c6d0f5;
|
||||
}
|
||||
.frappe .hljs-comment {
|
||||
color: #949cbb;
|
||||
}
|
||||
.frappe .hljs-doctag {
|
||||
color: #e78284;
|
||||
}
|
||||
.frappe .hljs-meta {
|
||||
color: #ef9f76;
|
||||
}
|
||||
.frappe .hljs-section {
|
||||
color: #8caaee;
|
||||
}
|
||||
.frappe .hljs-tag {
|
||||
color: #81c8be;
|
||||
}
|
||||
.frappe .hljs-name {
|
||||
color: #ca9ee6;
|
||||
}
|
||||
.frappe .hljs-attr {
|
||||
color: #8caaee;
|
||||
}
|
||||
.frappe .hljs-attribute {
|
||||
color: #a6d189;
|
||||
}
|
||||
.frappe .hljs-bullet {
|
||||
color: #81c8be;
|
||||
}
|
||||
.frappe .hljs-code {
|
||||
color: #a6d189;
|
||||
}
|
||||
.frappe .hljs-emphasis {
|
||||
color: #e78284;
|
||||
font-style: italic;
|
||||
}
|
||||
.frappe .hljs-strong {
|
||||
color: #e78284;
|
||||
font-weight: bold;
|
||||
}
|
||||
.frappe .hljs-formula {
|
||||
color: #81c8be;
|
||||
}
|
||||
.frappe .hljs-link {
|
||||
color: #85c1dc;
|
||||
font-style: italic;
|
||||
}
|
||||
.frappe .hljs-quote {
|
||||
color: #a6d189;
|
||||
font-style: italic;
|
||||
}
|
||||
.frappe .hljs-selector-tag {
|
||||
color: #e5c890;
|
||||
}
|
||||
.frappe .hljs-selector-id {
|
||||
color: #8caaee;
|
||||
}
|
||||
.frappe .hljs-selector-class {
|
||||
color: #81c8be;
|
||||
}
|
||||
.frappe .hljs-selector-attr {
|
||||
color: #ca9ee6;
|
||||
}
|
||||
.frappe .hljs-selector-pseudo {
|
||||
color: #81c8be;
|
||||
}
|
||||
.frappe .hljs-template-tag {
|
||||
color: #eebebe;
|
||||
}
|
||||
.frappe .hljs-template-variable {
|
||||
color: #eebebe;
|
||||
}
|
||||
.frappe .hljs-addition {
|
||||
color: #a6d189;
|
||||
background: rgba(166, 209, 137, 0.15);
|
||||
}
|
||||
.frappe .hljs-deletion {
|
||||
color: #e78284;
|
||||
background: rgba(231, 130, 132, 0.15);
|
||||
}
|
||||
.frappe :is(h1, h2, h3, h4, h5, h6) a code {
|
||||
color: #c6d0f5;
|
||||
}
|
||||
.frappe a code {
|
||||
color: #8caaee;
|
||||
}
|
||||
.frappe code {
|
||||
color: #c6d0f5;
|
||||
background: #292c3c;
|
||||
}
|
||||
.frappe blockquote blockquote {
|
||||
border-top: 0.1em solid #626880;
|
||||
border-bottom: 0.1em solid #626880;
|
||||
}
|
||||
.frappe hr {
|
||||
border-color: #626880;
|
||||
border-style: solid;
|
||||
}
|
||||
.frappe del {
|
||||
color: #949cbb;
|
||||
}
|
||||
.frappe .ace_gutter {
|
||||
color: #838ba7;
|
||||
background: #292c3c;
|
||||
}
|
||||
.frappe .ace_gutter-active-line.ace_gutter-cell {
|
||||
color: #f4b8e4;
|
||||
background: #292c3c;
|
||||
}
|
||||
.frappe .tooltiptext {
|
||||
background: #292c3c;
|
||||
color: #c6d0f5;
|
||||
}
|
||||
|
||||
.macchiato.hljs {
|
||||
color: #cad3f5;
|
||||
background: #24273a;
|
||||
}
|
||||
.macchiato .hljs-keyword {
|
||||
color: #c6a0f6;
|
||||
}
|
||||
.macchiato .hljs-built_in {
|
||||
color: #ed8796;
|
||||
}
|
||||
.macchiato .hljs-type {
|
||||
color: #eed49f;
|
||||
}
|
||||
.macchiato .hljs-literal {
|
||||
color: #f5a97f;
|
||||
}
|
||||
.macchiato .hljs-number {
|
||||
color: #f5a97f;
|
||||
}
|
||||
.macchiato .hljs-operator {
|
||||
color: #91d7e3;
|
||||
}
|
||||
.macchiato .hljs-punctuation {
|
||||
color: #b8c0e0;
|
||||
}
|
||||
.macchiato .hljs-property {
|
||||
color: #8bd5ca;
|
||||
}
|
||||
.macchiato .hljs-regexp {
|
||||
color: #f5bde6;
|
||||
}
|
||||
.macchiato .hljs-string {
|
||||
color: #a6da95;
|
||||
}
|
||||
.macchiato .hljs-char.escape_ {
|
||||
color: #a6da95;
|
||||
}
|
||||
.macchiato .hljs-subst {
|
||||
color: #a5adcb;
|
||||
}
|
||||
.macchiato .hljs-symbol {
|
||||
color: #f0c6c6;
|
||||
}
|
||||
.macchiato .hljs-variable {
|
||||
color: #c6a0f6;
|
||||
}
|
||||
.macchiato .hljs-variable.language_ {
|
||||
color: #c6a0f6;
|
||||
}
|
||||
.macchiato .hljs-variable.constant_ {
|
||||
color: #f5a97f;
|
||||
}
|
||||
.macchiato .hljs-title {
|
||||
color: #8aadf4;
|
||||
}
|
||||
.macchiato .hljs-title.class_ {
|
||||
color: #eed49f;
|
||||
}
|
||||
.macchiato .hljs-title.function_ {
|
||||
color: #8aadf4;
|
||||
}
|
||||
.macchiato .hljs-params {
|
||||
color: #cad3f5;
|
||||
}
|
||||
.macchiato .hljs-comment {
|
||||
color: #939ab7;
|
||||
}
|
||||
.macchiato .hljs-doctag {
|
||||
color: #ed8796;
|
||||
}
|
||||
.macchiato .hljs-meta {
|
||||
color: #f5a97f;
|
||||
}
|
||||
.macchiato .hljs-section {
|
||||
color: #8aadf4;
|
||||
}
|
||||
.macchiato .hljs-tag {
|
||||
color: #8bd5ca;
|
||||
}
|
||||
.macchiato .hljs-name {
|
||||
color: #c6a0f6;
|
||||
}
|
||||
.macchiato .hljs-attr {
|
||||
color: #8aadf4;
|
||||
}
|
||||
.macchiato .hljs-attribute {
|
||||
color: #a6da95;
|
||||
}
|
||||
.macchiato .hljs-bullet {
|
||||
color: #8bd5ca;
|
||||
}
|
||||
.macchiato .hljs-code {
|
||||
color: #a6da95;
|
||||
}
|
||||
.macchiato .hljs-emphasis {
|
||||
color: #ed8796;
|
||||
font-style: italic;
|
||||
}
|
||||
.macchiato .hljs-strong {
|
||||
color: #ed8796;
|
||||
font-weight: bold;
|
||||
}
|
||||
.macchiato .hljs-formula {
|
||||
color: #8bd5ca;
|
||||
}
|
||||
.macchiato .hljs-link {
|
||||
color: #7dc4e4;
|
||||
font-style: italic;
|
||||
}
|
||||
.macchiato .hljs-quote {
|
||||
color: #a6da95;
|
||||
font-style: italic;
|
||||
}
|
||||
.macchiato .hljs-selector-tag {
|
||||
color: #eed49f;
|
||||
}
|
||||
.macchiato .hljs-selector-id {
|
||||
color: #8aadf4;
|
||||
}
|
||||
.macchiato .hljs-selector-class {
|
||||
color: #8bd5ca;
|
||||
}
|
||||
.macchiato .hljs-selector-attr {
|
||||
color: #c6a0f6;
|
||||
}
|
||||
.macchiato .hljs-selector-pseudo {
|
||||
color: #8bd5ca;
|
||||
}
|
||||
.macchiato .hljs-template-tag {
|
||||
color: #f0c6c6;
|
||||
}
|
||||
.macchiato .hljs-template-variable {
|
||||
color: #f0c6c6;
|
||||
}
|
||||
.macchiato .hljs-addition {
|
||||
color: #a6da95;
|
||||
background: rgba(166, 218, 149, 0.15);
|
||||
}
|
||||
.macchiato .hljs-deletion {
|
||||
color: #ed8796;
|
||||
background: rgba(237, 135, 150, 0.15);
|
||||
}
|
||||
.macchiato :is(h1, h2, h3, h4, h5, h6) a code {
|
||||
color: #cad3f5;
|
||||
}
|
||||
.macchiato a code {
|
||||
color: #8aadf4;
|
||||
}
|
||||
.macchiato code {
|
||||
color: #cad3f5;
|
||||
background: #1e2030;
|
||||
}
|
||||
.macchiato blockquote blockquote {
|
||||
border-top: 0.1em solid #5b6078;
|
||||
border-bottom: 0.1em solid #5b6078;
|
||||
}
|
||||
.macchiato hr {
|
||||
border-color: #5b6078;
|
||||
border-style: solid;
|
||||
}
|
||||
.macchiato del {
|
||||
color: #939ab7;
|
||||
}
|
||||
.macchiato .ace_gutter {
|
||||
color: #8087a2;
|
||||
background: #1e2030;
|
||||
}
|
||||
.macchiato .ace_gutter-active-line.ace_gutter-cell {
|
||||
color: #f5bde6;
|
||||
background: #1e2030;
|
||||
}
|
||||
.macchiato .tooltiptext {
|
||||
background: #1e2030;
|
||||
color: #cad3f5;
|
||||
}
|
||||
|
||||
.mocha.hljs {
|
||||
color: #cdd6f4;
|
||||
background: #1e1e2e;
|
||||
}
|
||||
.mocha .hljs-keyword {
|
||||
color: #cba6f7;
|
||||
}
|
||||
.mocha .hljs-built_in {
|
||||
color: #f38ba8;
|
||||
}
|
||||
.mocha .hljs-type {
|
||||
color: #f9e2af;
|
||||
}
|
||||
.mocha .hljs-literal {
|
||||
color: #fab387;
|
||||
}
|
||||
.mocha .hljs-number {
|
||||
color: #fab387;
|
||||
}
|
||||
.mocha .hljs-operator {
|
||||
color: #89dceb;
|
||||
}
|
||||
.mocha .hljs-punctuation {
|
||||
color: #bac2de;
|
||||
}
|
||||
.mocha .hljs-property {
|
||||
color: #94e2d5;
|
||||
}
|
||||
.mocha .hljs-regexp {
|
||||
color: #f5c2e7;
|
||||
}
|
||||
.mocha .hljs-string {
|
||||
color: #a6e3a1;
|
||||
}
|
||||
.mocha .hljs-char.escape_ {
|
||||
color: #a6e3a1;
|
||||
}
|
||||
.mocha .hljs-subst {
|
||||
color: #a6adc8;
|
||||
}
|
||||
.mocha .hljs-symbol {
|
||||
color: #f2cdcd;
|
||||
}
|
||||
.mocha .hljs-variable {
|
||||
color: #cba6f7;
|
||||
}
|
||||
.mocha .hljs-variable.language_ {
|
||||
color: #cba6f7;
|
||||
}
|
||||
.mocha .hljs-variable.constant_ {
|
||||
color: #fab387;
|
||||
}
|
||||
.mocha .hljs-title {
|
||||
color: #89b4fa;
|
||||
}
|
||||
.mocha .hljs-title.class_ {
|
||||
color: #f9e2af;
|
||||
}
|
||||
.mocha .hljs-title.function_ {
|
||||
color: #89b4fa;
|
||||
}
|
||||
.mocha .hljs-params {
|
||||
color: #cdd6f4;
|
||||
}
|
||||
.mocha .hljs-comment {
|
||||
color: #9399b2;
|
||||
}
|
||||
.mocha .hljs-doctag {
|
||||
color: #f38ba8;
|
||||
}
|
||||
.mocha .hljs-meta {
|
||||
color: #fab387;
|
||||
}
|
||||
.mocha .hljs-section {
|
||||
color: #89b4fa;
|
||||
}
|
||||
.mocha .hljs-tag {
|
||||
color: #94e2d5;
|
||||
}
|
||||
.mocha .hljs-name {
|
||||
color: #cba6f7;
|
||||
}
|
||||
.mocha .hljs-attr {
|
||||
color: #89b4fa;
|
||||
}
|
||||
.mocha .hljs-attribute {
|
||||
color: #a6e3a1;
|
||||
}
|
||||
.mocha .hljs-bullet {
|
||||
color: #94e2d5;
|
||||
}
|
||||
.mocha .hljs-code {
|
||||
color: #a6e3a1;
|
||||
}
|
||||
.mocha .hljs-emphasis {
|
||||
color: #f38ba8;
|
||||
font-style: italic;
|
||||
}
|
||||
.mocha .hljs-strong {
|
||||
color: #f38ba8;
|
||||
font-weight: bold;
|
||||
}
|
||||
.mocha .hljs-formula {
|
||||
color: #94e2d5;
|
||||
}
|
||||
.mocha .hljs-link {
|
||||
color: #74c7ec;
|
||||
font-style: italic;
|
||||
}
|
||||
.mocha .hljs-quote {
|
||||
color: #a6e3a1;
|
||||
font-style: italic;
|
||||
}
|
||||
.mocha .hljs-selector-tag {
|
||||
color: #f9e2af;
|
||||
}
|
||||
.mocha .hljs-selector-id {
|
||||
color: #89b4fa;
|
||||
}
|
||||
.mocha .hljs-selector-class {
|
||||
color: #94e2d5;
|
||||
}
|
||||
.mocha .hljs-selector-attr {
|
||||
color: #cba6f7;
|
||||
}
|
||||
.mocha .hljs-selector-pseudo {
|
||||
color: #94e2d5;
|
||||
}
|
||||
.mocha .hljs-template-tag {
|
||||
color: #f2cdcd;
|
||||
}
|
||||
.mocha .hljs-template-variable {
|
||||
color: #f2cdcd;
|
||||
}
|
||||
.mocha .hljs-addition {
|
||||
color: #a6e3a1;
|
||||
background: rgba(166, 227, 161, 0.15);
|
||||
}
|
||||
.mocha .hljs-deletion {
|
||||
color: #f38ba8;
|
||||
background: rgba(243, 139, 168, 0.15);
|
||||
}
|
||||
.mocha :is(h1, h2, h3, h4, h5, h6) a code {
|
||||
color: #cdd6f4;
|
||||
}
|
||||
.mocha a code {
|
||||
color: #89b4fa;
|
||||
}
|
||||
.mocha code {
|
||||
color: #cdd6f4;
|
||||
background: #181825;
|
||||
}
|
||||
.mocha blockquote blockquote {
|
||||
border-top: 0.1em solid #585b70;
|
||||
border-bottom: 0.1em solid #585b70;
|
||||
}
|
||||
.mocha hr {
|
||||
border-color: #585b70;
|
||||
border-style: solid;
|
||||
}
|
||||
.mocha del {
|
||||
color: #9399b2;
|
||||
}
|
||||
.mocha .ace_gutter {
|
||||
color: #7f849c;
|
||||
background: #181825;
|
||||
}
|
||||
.mocha .ace_gutter-active-line.ace_gutter-cell {
|
||||
color: #f5c2e7;
|
||||
background: #181825;
|
||||
}
|
||||
.mocha .tooltiptext {
|
||||
background: #181825;
|
||||
color: #cdd6f4;
|
||||
}
|
||||
|
||||
.latte {
|
||||
--bg: #eff1f5;
|
||||
--fg: #4c4f69;
|
||||
--sidebar-bg: #e6e9ef;
|
||||
--sidebar-fg: #4c4f69;
|
||||
--sidebar-non-existant: #9ca0b0;
|
||||
--sidebar-active: #1e66f5;
|
||||
--sidebar-spacer: #9ca0b0;
|
||||
--scrollbar: #9ca0b0;
|
||||
--icons: #9ca0b0;
|
||||
--icons-hover: #7c7f93;
|
||||
--links: #1e66f5;
|
||||
--inline-code-color: #4c4f69;
|
||||
--theme-popup-bg: #e6e9ef;
|
||||
--theme-popup-border: #9ca0b0;
|
||||
--theme-hover: #ccd0da;
|
||||
--quote-bg: #e6e9ef;
|
||||
--quote-border: #dce0e8;
|
||||
--table-border-color: #ccd0da;
|
||||
--table-header-bg: #e6e9ef;
|
||||
--table-alternate-bg: #e6e9ef;
|
||||
--searchbar-border-color: #ccd0da;
|
||||
--searchbar-bg: #e6e9ef;
|
||||
--searchbar-fg: #4c4f69;
|
||||
--searchbar-shadow-color: #dce0e8;
|
||||
--searchresults-header-fg: #4c4f69;
|
||||
--searchresults-border-color: #ccd0da;
|
||||
--searchresults-li-bg: #eff1f5;
|
||||
--search-mark-bg: #fe640b;
|
||||
--warning-border: #fe640b;
|
||||
--color-scheme: light;
|
||||
}
|
||||
|
||||
.frappe {
|
||||
--bg: #303446;
|
||||
--fg: #c6d0f5;
|
||||
--sidebar-bg: #292c3c;
|
||||
--sidebar-fg: #c6d0f5;
|
||||
--sidebar-non-existant: #737994;
|
||||
--sidebar-active: #8caaee;
|
||||
--sidebar-spacer: #737994;
|
||||
--scrollbar: #737994;
|
||||
--icons: #737994;
|
||||
--icons-hover: #949cbb;
|
||||
--links: #8caaee;
|
||||
--inline-code-color: #c6d0f5;
|
||||
--theme-popup-bg: #292c3c;
|
||||
--theme-popup-border: #737994;
|
||||
--theme-hover: #414559;
|
||||
--quote-bg: #292c3c;
|
||||
--quote-border: #232634;
|
||||
--table-border-color: #414559;
|
||||
--table-header-bg: #292c3c;
|
||||
--table-alternate-bg: #292c3c;
|
||||
--searchbar-border-color: #414559;
|
||||
--searchbar-bg: #292c3c;
|
||||
--searchbar-fg: #c6d0f5;
|
||||
--searchbar-shadow-color: #232634;
|
||||
--searchresults-header-fg: #c6d0f5;
|
||||
--searchresults-border-color: #414559;
|
||||
--searchresults-li-bg: #303446;
|
||||
--search-mark-bg: #ef9f76;
|
||||
--warning-border: #ef9f76;
|
||||
--color-scheme: dark;
|
||||
}
|
||||
|
||||
.macchiato {
|
||||
--bg: #24273a;
|
||||
--fg: #cad3f5;
|
||||
--sidebar-bg: #1e2030;
|
||||
--sidebar-fg: #cad3f5;
|
||||
--sidebar-non-existant: #6e738d;
|
||||
--sidebar-active: #8aadf4;
|
||||
--sidebar-spacer: #6e738d;
|
||||
--scrollbar: #6e738d;
|
||||
--icons: #6e738d;
|
||||
--icons-hover: #939ab7;
|
||||
--links: #8aadf4;
|
||||
--inline-code-color: #cad3f5;
|
||||
--theme-popup-bg: #1e2030;
|
||||
--theme-popup-border: #6e738d;
|
||||
--theme-hover: #363a4f;
|
||||
--quote-bg: #1e2030;
|
||||
--quote-border: #181926;
|
||||
--table-border-color: #363a4f;
|
||||
--table-header-bg: #1e2030;
|
||||
--table-alternate-bg: #1e2030;
|
||||
--searchbar-border-color: #363a4f;
|
||||
--searchbar-bg: #1e2030;
|
||||
--searchbar-fg: #cad3f5;
|
||||
--searchbar-shadow-color: #181926;
|
||||
--searchresults-header-fg: #cad3f5;
|
||||
--searchresults-border-color: #363a4f;
|
||||
--searchresults-li-bg: #24273a;
|
||||
--search-mark-bg: #f5a97f;
|
||||
--warning-border: #f5a97f;
|
||||
--color-scheme: dark;
|
||||
}
|
||||
|
||||
.mocha {
|
||||
--bg: #1e1e2e;
|
||||
--fg: #cdd6f4;
|
||||
--sidebar-bg: #181825;
|
||||
--sidebar-fg: #cdd6f4;
|
||||
--sidebar-non-existant: #6c7086;
|
||||
--sidebar-active: #89b4fa;
|
||||
--sidebar-spacer: #6c7086;
|
||||
--scrollbar: #6c7086;
|
||||
--icons: #6c7086;
|
||||
--icons-hover: #9399b2;
|
||||
--links: #89b4fa;
|
||||
--inline-code-color: #cdd6f4;
|
||||
--theme-popup-bg: #181825;
|
||||
--theme-popup-border: #6c7086;
|
||||
--theme-hover: #313244;
|
||||
--quote-bg: #181825;
|
||||
--quote-border: #11111b;
|
||||
--table-border-color: #313244;
|
||||
--table-header-bg: #181825;
|
||||
--table-alternate-bg: #181825;
|
||||
--searchbar-border-color: #313244;
|
||||
--searchbar-bg: #181825;
|
||||
--searchbar-fg: #cdd6f4;
|
||||
--searchbar-shadow-color: #11111b;
|
||||
--searchresults-header-fg: #cdd6f4;
|
||||
--searchresults-border-color: #313244;
|
||||
--searchresults-li-bg: #1e1e2e;
|
||||
--search-mark-bg: #fab387;
|
||||
--warning-border: #fab387;
|
||||
--color-scheme: dark;
|
||||
}
|
||||
@ -1,11 +1,11 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="{{ language }}" class="sidebar-visible no-js {{ default_theme }}">
|
||||
<html lang="{{ language }}" class="{{ default_theme }} sidebar-visible" dir="{{ text_direction }}">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
<title>{{ title }}</title>
|
||||
{{#if is_print }}
|
||||
<meta name="robots" content="noindex" />
|
||||
<meta name="robots" content="noindex">
|
||||
{{/if}}
|
||||
{{#if base_url}}
|
||||
<base href="{{ base_url }}">
|
||||
@ -15,10 +15,9 @@
|
||||
<!-- Custom HTML head -->
|
||||
{{> head}}
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
<meta name="description" content="{{ description }}">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
{{#if favicon_svg}}
|
||||
<link rel="icon" href="{{ path_to_root }}favicon.svg">
|
||||
@ -51,18 +50,21 @@
|
||||
|
||||
{{#if mathjax_support}}
|
||||
<!-- MathJax -->
|
||||
<script async type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
|
||||
<script async src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
|
||||
{{/if}}
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var path_to_root = "{{ path_to_root }}";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "{{ preferred_dark_theme }}" : "{{ default_theme }}";
|
||||
</script>
|
||||
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="{{ path_to_root }}toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -78,34 +80,42 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('{{ default_theme }}')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
{{#toc}}{{/toc}}
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="{{ path_to_root }}toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
@ -113,24 +123,19 @@
|
||||
<div class="page">
|
||||
{{> header}}
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">{{ theme_option "Light" }}</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">{{ theme_option "Rust" }}</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">{{ theme_option "Coal" }}</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">{{ theme_option "Navy" }}</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">{{ theme_option "Ayu" }}</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">{{ theme_option "Latte" }}</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">{{ theme_option "Frappé" }}</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">{{ theme_option "Macchiato" }}</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">{{ theme_option "Mocha" }}</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
{{#if search_enabled}}
|
||||
<button id="search-toggle" class="icon-button" type="button" title="Search. (Shortkey: s)" aria-label="Toggle Searchbar" aria-expanded="false" aria-keyshortcuts="S" aria-controls="searchbar">
|
||||
@ -175,7 +180,7 @@
|
||||
{{/if}}
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -197,7 +202,7 @@
|
||||
{{/previous}}
|
||||
|
||||
{{#next}}
|
||||
<a rel="next" href="{{ path_to_root }}{{link}}" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="{{ path_to_root }}{{link}}" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
{{/next}}
|
||||
@ -215,7 +220,7 @@
|
||||
{{/previous}}
|
||||
|
||||
{{#next}}
|
||||
<a rel="next" href="{{ path_to_root }}{{link}}" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="{{ path_to_root }}{{link}}" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
{{/next}}
|
||||
@ -225,7 +230,7 @@
|
||||
|
||||
{{#if live_reload_endpoint}}
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "{{{live_reload_endpoint}}}";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
@ -244,7 +249,7 @@
|
||||
|
||||
{{#if google_analytics}}
|
||||
<!-- Google Analytics Tag -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var localAddrs = ["localhost", "127.0.0.1", ""];
|
||||
|
||||
// make sure we don't activate google analytics if the developer is
|
||||
@ -262,43 +267,43 @@
|
||||
{{/if}}
|
||||
|
||||
{{#if playground_line_numbers}}
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_line_numbers = true;
|
||||
</script>
|
||||
{{/if}}
|
||||
|
||||
{{#if playground_copyable}}
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
{{/if}}
|
||||
|
||||
{{#if playground_js}}
|
||||
<script src="{{ path_to_root }}ace.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="{{ path_to_root }}editor.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="{{ path_to_root }}mode-rust.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="{{ path_to_root }}theme-dawn.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="{{ path_to_root }}theme-tomorrow_night.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="{{ path_to_root }}ace.js"></script>
|
||||
<script src="{{ path_to_root }}editor.js"></script>
|
||||
<script src="{{ path_to_root }}mode-rust.js"></script>
|
||||
<script src="{{ path_to_root }}theme-dawn.js"></script>
|
||||
<script src="{{ path_to_root }}theme-tomorrow_night.js"></script>
|
||||
{{/if}}
|
||||
|
||||
{{#if search_js}}
|
||||
<script src="{{ path_to_root }}elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="{{ path_to_root }}mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="{{ path_to_root }}searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="{{ path_to_root }}elasticlunr.min.js"></script>
|
||||
<script src="{{ path_to_root }}mark.min.js"></script>
|
||||
<script src="{{ path_to_root }}searcher.js"></script>
|
||||
{{/if}}
|
||||
|
||||
<script src="{{ path_to_root }}clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="{{ path_to_root }}highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="{{ path_to_root }}book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="{{ path_to_root }}clipboard.min.js"></script>
|
||||
<script src="{{ path_to_root }}highlight.js"></script>
|
||||
<script src="{{ path_to_root }}book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
{{#each additional_js}}
|
||||
<script type="text/javascript" src="{{ ../path_to_root }}{{this}}"></script>
|
||||
<script src="{{ ../path_to_root }}{{this}}"></script>
|
||||
{{/each}}
|
||||
|
||||
{{#if is_print}}
|
||||
{{#if mathjax_support}}
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.addEventListener('load', function() {
|
||||
MathJax.Hub.Register.StartupHook('End', function() {
|
||||
window.setTimeout(window.print, 100);
|
||||
@ -306,7 +311,7 @@
|
||||
});
|
||||
</script>
|
||||
{{else}}
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.addEventListener('load', function() {
|
||||
window.setTimeout(window.print, 100);
|
||||
});
|
||||
@ -314,5 +319,6 @@
|
||||
{{/if}}
|
||||
{{/if}}
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
11
zsh-manual/book.toml
Normal file
11
zsh-manual/book.toml
Normal file
@ -0,0 +1,11 @@
|
||||
[book]
|
||||
authors = ["Jeffrey Serio"]
|
||||
language = "en"
|
||||
multilingual = false
|
||||
src = "src"
|
||||
title = "Zsh Manual"
|
||||
|
||||
[output.html]
|
||||
additional-css = ["./theme/catppuccin.css"]
|
||||
default-theme = "mocha"
|
||||
preferred-dark-theme = "mocha"
|
||||
@ -1,5 +1,5 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
@ -8,11 +8,10 @@
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -32,18 +31,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -59,56 +60,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="The-Z-Shell-Manual.html"><strong aria-hidden="true">1.</strong> The Z Shell Manual</a></li><li class="chapter-item expanded "><a href="Introduction.html"><strong aria-hidden="true">2.</strong> Introduction</a></li><li class="chapter-item expanded "><a href="Roadmap.html"><strong aria-hidden="true">3.</strong> Roadmap</a></li><li class="chapter-item expanded "><a href="Invocation.html"><strong aria-hidden="true">4.</strong> Invocation</a></li><li class="chapter-item expanded "><a href="Files.html"><strong aria-hidden="true">5.</strong> Files</a></li><li class="chapter-item expanded "><a href="Shell-Grammar.html"><strong aria-hidden="true">6.</strong> Shell Grammar</a></li><li class="chapter-item expanded "><a href="Redirection.html"><strong aria-hidden="true">7.</strong> Redirection</a></li><li class="chapter-item expanded "><a href="Command-Execution.html"><strong aria-hidden="true">8.</strong> Command Execution</a></li><li class="chapter-item expanded "><a href="Functions.html"><strong aria-hidden="true">9.</strong> Functions</a></li><li class="chapter-item expanded "><a href="Jobs-&-Signals.html"><strong aria-hidden="true">10.</strong> Jobs & Signals</a></li><li class="chapter-item expanded "><a href="Arithmetic-Evaluation.html"><strong aria-hidden="true">11.</strong> Arithmetic Evaluation</a></li><li class="chapter-item expanded "><a href="Conditional-Expressions.html"><strong aria-hidden="true">12.</strong> Conditional Expressions</a></li><li class="chapter-item expanded "><a href="Prompt-Expansion.html"><strong aria-hidden="true">13.</strong> Prompt Expansion</a></li><li class="chapter-item expanded "><a href="Expansion.html"><strong aria-hidden="true">14.</strong> Expansion</a></li><li class="chapter-item expanded "><a href="Parameters.html"><strong aria-hidden="true">15.</strong> Parameters</a></li><li class="chapter-item expanded "><a href="Options.html"><strong aria-hidden="true">16.</strong> Options</a></li><li class="chapter-item expanded "><a href="Shell-Builtin-Commands.html"><strong aria-hidden="true">17.</strong> Shell Builtin Commands</a></li><li class="chapter-item expanded "><a href="Zsh-Line-Editor.html"><strong aria-hidden="true">18.</strong> Zsh Line Editor</a></li><li class="chapter-item expanded "><a href="Completion-Widgets.html"><strong aria-hidden="true">19.</strong> Completion Widgets</a></li><li class="chapter-item expanded "><a href="Completion-System.html"><strong aria-hidden="true">20.</strong> Completion System</a></li><li class="chapter-item expanded "><a href="Completion-Using-compctl.html"><strong aria-hidden="true">21.</strong> Completion Using compctl</a></li><li class="chapter-item expanded "><a href="Zsh-Modules.html"><strong aria-hidden="true">22.</strong> Zsh Modules</a></li><li class="chapter-item expanded "><a href="Calendar-Function-System.html"><strong aria-hidden="true">23.</strong> Calendar Function System</a></li><li class="chapter-item expanded "><a href="TCP-Function-System.html"><strong aria-hidden="true">24.</strong> TCP Function System</a></li><li class="chapter-item expanded "><a href="Zftp-Function-System.html"><strong aria-hidden="true">25.</strong> Zftp Function System</a></li><li class="chapter-item expanded "><a href="User-Contributions.html"><strong aria-hidden="true">26.</strong> User Contributions</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -139,7 +143,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -170,7 +174,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
@ -188,21 +192,22 @@
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,5 +1,5 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
@ -7,11 +7,10 @@
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="The-Z-Shell-Manual.html"><strong aria-hidden="true">1.</strong> The Z Shell Manual</a></li><li class="chapter-item expanded "><a href="Introduction.html"><strong aria-hidden="true">2.</strong> Introduction</a></li><li class="chapter-item expanded "><a href="Roadmap.html"><strong aria-hidden="true">3.</strong> Roadmap</a></li><li class="chapter-item expanded "><a href="Invocation.html"><strong aria-hidden="true">4.</strong> Invocation</a></li><li class="chapter-item expanded "><a href="Files.html"><strong aria-hidden="true">5.</strong> Files</a></li><li class="chapter-item expanded "><a href="Shell-Grammar.html"><strong aria-hidden="true">6.</strong> Shell Grammar</a></li><li class="chapter-item expanded "><a href="Redirection.html"><strong aria-hidden="true">7.</strong> Redirection</a></li><li class="chapter-item expanded "><a href="Command-Execution.html"><strong aria-hidden="true">8.</strong> Command Execution</a></li><li class="chapter-item expanded "><a href="Functions.html"><strong aria-hidden="true">9.</strong> Functions</a></li><li class="chapter-item expanded "><a href="Jobs-&-Signals.html"><strong aria-hidden="true">10.</strong> Jobs & Signals</a></li><li class="chapter-item expanded "><a href="Arithmetic-Evaluation.html" class="active"><strong aria-hidden="true">11.</strong> Arithmetic Evaluation</a></li><li class="chapter-item expanded "><a href="Conditional-Expressions.html"><strong aria-hidden="true">12.</strong> Conditional Expressions</a></li><li class="chapter-item expanded "><a href="Prompt-Expansion.html"><strong aria-hidden="true">13.</strong> Prompt Expansion</a></li><li class="chapter-item expanded "><a href="Expansion.html"><strong aria-hidden="true">14.</strong> Expansion</a></li><li class="chapter-item expanded "><a href="Parameters.html"><strong aria-hidden="true">15.</strong> Parameters</a></li><li class="chapter-item expanded "><a href="Options.html"><strong aria-hidden="true">16.</strong> Options</a></li><li class="chapter-item expanded "><a href="Shell-Builtin-Commands.html"><strong aria-hidden="true">17.</strong> Shell Builtin Commands</a></li><li class="chapter-item expanded "><a href="Zsh-Line-Editor.html"><strong aria-hidden="true">18.</strong> Zsh Line Editor</a></li><li class="chapter-item expanded "><a href="Completion-Widgets.html"><strong aria-hidden="true">19.</strong> Completion Widgets</a></li><li class="chapter-item expanded "><a href="Completion-System.html"><strong aria-hidden="true">20.</strong> Completion System</a></li><li class="chapter-item expanded "><a href="Completion-Using-compctl.html"><strong aria-hidden="true">21.</strong> Completion Using compctl</a></li><li class="chapter-item expanded "><a href="Zsh-Modules.html"><strong aria-hidden="true">22.</strong> Zsh Modules</a></li><li class="chapter-item expanded "><a href="Calendar-Function-System.html"><strong aria-hidden="true">23.</strong> Calendar Function System</a></li><li class="chapter-item expanded "><a href="TCP-Function-System.html"><strong aria-hidden="true">24.</strong> TCP Function System</a></li><li class="chapter-item expanded "><a href="Zftp-Function-System.html"><strong aria-hidden="true">25.</strong> Zftp Function System</a></li><li class="chapter-item expanded "><a href="User-Contributions.html"><strong aria-hidden="true">26.</strong> User Contributions</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -175,7 +179,7 @@ as spaces, require quoting, an alternative form is provided: for any
|
||||
command which begins with a ‘((’, all the characters until a matching
|
||||
‘))’ are treated as a double-quoted expression and arithmetic expansion
|
||||
performed as for an argument of let. More precisely, ‘((<code>...</code>))’ is
|
||||
equivalent to ‘let "<code>...</code>"’. The return status is 0 if the arithmetic
|
||||
equivalent to ‘let "<code>...</code>"’. The return status is 0 if the arithmetic
|
||||
value of the expression is non-zero, 1 if it is zero, and 2 if an error
|
||||
occurred.</p>
|
||||
<p>For example, the following statement</p>
|
||||
@ -185,7 +189,7 @@ occurred.</p>
|
||||
</div>
|
||||
<p>is equivalent to</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">let "val = 2 + 1"
|
||||
<pre><code class="language-zsh">let "val = 2 + 1"
|
||||
</code></pre>
|
||||
</div>
|
||||
<p>both assigning the value 3 to the shell variable val and returning a
|
||||
@ -429,7 +433,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Conditional-Expressions.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Conditional-Expressions.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -443,7 +447,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Conditional-Expressions.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Conditional-Expressions.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
@ -451,7 +455,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
@ -469,21 +473,22 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,5 +1,5 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
@ -7,11 +7,10 @@
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="The-Z-Shell-Manual.html"><strong aria-hidden="true">1.</strong> The Z Shell Manual</a></li><li class="chapter-item expanded "><a href="Introduction.html"><strong aria-hidden="true">2.</strong> Introduction</a></li><li class="chapter-item expanded "><a href="Roadmap.html"><strong aria-hidden="true">3.</strong> Roadmap</a></li><li class="chapter-item expanded "><a href="Invocation.html"><strong aria-hidden="true">4.</strong> Invocation</a></li><li class="chapter-item expanded "><a href="Files.html"><strong aria-hidden="true">5.</strong> Files</a></li><li class="chapter-item expanded "><a href="Shell-Grammar.html"><strong aria-hidden="true">6.</strong> Shell Grammar</a></li><li class="chapter-item expanded "><a href="Redirection.html"><strong aria-hidden="true">7.</strong> Redirection</a></li><li class="chapter-item expanded "><a href="Command-Execution.html"><strong aria-hidden="true">8.</strong> Command Execution</a></li><li class="chapter-item expanded "><a href="Functions.html"><strong aria-hidden="true">9.</strong> Functions</a></li><li class="chapter-item expanded "><a href="Jobs-&-Signals.html"><strong aria-hidden="true">10.</strong> Jobs & Signals</a></li><li class="chapter-item expanded "><a href="Arithmetic-Evaluation.html"><strong aria-hidden="true">11.</strong> Arithmetic Evaluation</a></li><li class="chapter-item expanded "><a href="Conditional-Expressions.html"><strong aria-hidden="true">12.</strong> Conditional Expressions</a></li><li class="chapter-item expanded "><a href="Prompt-Expansion.html"><strong aria-hidden="true">13.</strong> Prompt Expansion</a></li><li class="chapter-item expanded "><a href="Expansion.html"><strong aria-hidden="true">14.</strong> Expansion</a></li><li class="chapter-item expanded "><a href="Parameters.html"><strong aria-hidden="true">15.</strong> Parameters</a></li><li class="chapter-item expanded "><a href="Options.html"><strong aria-hidden="true">16.</strong> Options</a></li><li class="chapter-item expanded "><a href="Shell-Builtin-Commands.html"><strong aria-hidden="true">17.</strong> Shell Builtin Commands</a></li><li class="chapter-item expanded "><a href="Zsh-Line-Editor.html"><strong aria-hidden="true">18.</strong> Zsh Line Editor</a></li><li class="chapter-item expanded "><a href="Completion-Widgets.html"><strong aria-hidden="true">19.</strong> Completion Widgets</a></li><li class="chapter-item expanded "><a href="Completion-System.html"><strong aria-hidden="true">20.</strong> Completion System</a></li><li class="chapter-item expanded "><a href="Completion-Using-compctl.html"><strong aria-hidden="true">21.</strong> Completion Using compctl</a></li><li class="chapter-item expanded "><a href="Zsh-Modules.html"><strong aria-hidden="true">22.</strong> Zsh Modules</a></li><li class="chapter-item expanded "><a href="Calendar-Function-System.html" class="active"><strong aria-hidden="true">23.</strong> Calendar Function System</a></li><li class="chapter-item expanded "><a href="TCP-Function-System.html"><strong aria-hidden="true">24.</strong> TCP Function System</a></li><li class="chapter-item expanded "><a href="Zftp-Function-System.html"><strong aria-hidden="true">25.</strong> Zftp Function System</a></li><li class="chapter-item expanded "><a href="User-Contributions.html"><strong aria-hidden="true">26.</strong> User Contributions</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -236,7 +240,7 @@ string that may include both a date and a time specification.) Note that
|
||||
there is no localization support; month and day names must be in English
|
||||
and separator characters are fixed. Matching is case insensitive, and
|
||||
only the first three letters of the names are significant, although as a
|
||||
special case a form beginning "month" does not match "Monday".
|
||||
special case a form beginning "month" does not match "Monday".
|
||||
Furthermore, time zones are not handled; all times are assumed to be
|
||||
local.</p>
|
||||
<p>It is recommended that, rather than exploring the intricacies of the
|
||||
@ -320,7 +324,7 @@ contents are irrelevant, so janissary, febrile, martial, apricot, maybe,
|
||||
junta, etc. are happily handled.</p>
|
||||
<p>Where the year is shown as optional, the current year is assumed. There
|
||||
are only two such cases, the form Jun 20 or 14 September (the only two
|
||||
commonly occurring forms, apart from a "the" in some forms of English,
|
||||
commonly occurring forms, apart from a "the" in some forms of English,
|
||||
which isn’t currently supported). Such dates will of course become
|
||||
ambiguous in the future, so should ideally be avoided.</p>
|
||||
<p>Times may follow dates with a colon, e.g. 1965/07/12:09:45; this is in
|
||||
@ -488,7 +492,7 @@ Brief: display at most the first <code>lines</code> lines of the calendar entry.
|
||||
Explicitly specify a calendar file instead of the value of the
|
||||
calendar-file style or the default ~/calendar.</p>
|
||||
<p>-d<br />
|
||||
Move any events that have passed from the calendar file to the "done"
|
||||
Move any events that have passed from the calendar file to the "done"
|
||||
file, as given by the done-file style or the default which is the
|
||||
calendar file with .done appended. This option is implied by the -s
|
||||
option.</p>
|
||||
@ -524,8 +528,8 @@ of an event are rescheduled or cancelled. This is done with the
|
||||
OCCURRENCE keyword, followed by whitespace and the date and time of the
|
||||
occurrence in the regular sequence, followed by whitespace and either
|
||||
the date and time of the rescheduled event or the exact string
|
||||
CANCELLED. In this case the date and time must be in exactly the "date
|
||||
with local time" format used by the text/calendar MIME type (RFC 2445),
|
||||
CANCELLED. In this case the date and time must be in exactly the "date
|
||||
with local time" format used by the text/calendar MIME type (RFC 2445),
|
||||
<code><YYYY><MM><DD></code>T<code><hh><mm><ss></code> (note the presence of the literal
|
||||
character T). The first word (the regular recurrence) may be something
|
||||
other than a proper date/time to indicate that the event is additional
|
||||
@ -562,7 +566,7 @@ headline date/time).</p>
|
||||
calendar file has changed, for example), and also to have it running in
|
||||
multiples instances of the shell since the calendar file is locked when
|
||||
in use.</p>
|
||||
<p>By default, expired events are moved to the "done" file; see the -d
|
||||
<p>By default, expired events are moved to the "done" file; see the -d
|
||||
option. Use -D to prevent this.</p>
|
||||
<p>-S <code>showprog</code><br />
|
||||
Explicitly specify a programme to be used for showing events instead of
|
||||
@ -806,7 +810,7 @@ format as output by the date command (also known as ‘ctime format’): ‘%a
|
||||
<p>done-file</p>
|
||||
<p>The location of the file to which events which have passed are appended.
|
||||
The default is the calendar file location with the suffix .done. The
|
||||
style may be set to an empty string in which case a "done" file will not
|
||||
style may be set to an empty string in which case a "done" file will not
|
||||
be maintained.</p>
|
||||
<p><span id="index-reformat_002ddate"></span></p>
|
||||
<p>reformat-date</p>
|
||||
@ -944,7 +948,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="TCP-Function-System.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="TCP-Function-System.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -958,7 +962,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="TCP-Function-System.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="TCP-Function-System.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
@ -966,7 +970,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
@ -984,21 +988,22 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,5 +1,5 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
@ -7,11 +7,10 @@
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="The-Z-Shell-Manual.html"><strong aria-hidden="true">1.</strong> The Z Shell Manual</a></li><li class="chapter-item expanded "><a href="Introduction.html"><strong aria-hidden="true">2.</strong> Introduction</a></li><li class="chapter-item expanded "><a href="Roadmap.html"><strong aria-hidden="true">3.</strong> Roadmap</a></li><li class="chapter-item expanded "><a href="Invocation.html"><strong aria-hidden="true">4.</strong> Invocation</a></li><li class="chapter-item expanded "><a href="Files.html"><strong aria-hidden="true">5.</strong> Files</a></li><li class="chapter-item expanded "><a href="Shell-Grammar.html"><strong aria-hidden="true">6.</strong> Shell Grammar</a></li><li class="chapter-item expanded "><a href="Redirection.html"><strong aria-hidden="true">7.</strong> Redirection</a></li><li class="chapter-item expanded "><a href="Command-Execution.html" class="active"><strong aria-hidden="true">8.</strong> Command Execution</a></li><li class="chapter-item expanded "><a href="Functions.html"><strong aria-hidden="true">9.</strong> Functions</a></li><li class="chapter-item expanded "><a href="Jobs-&-Signals.html"><strong aria-hidden="true">10.</strong> Jobs & Signals</a></li><li class="chapter-item expanded "><a href="Arithmetic-Evaluation.html"><strong aria-hidden="true">11.</strong> Arithmetic Evaluation</a></li><li class="chapter-item expanded "><a href="Conditional-Expressions.html"><strong aria-hidden="true">12.</strong> Conditional Expressions</a></li><li class="chapter-item expanded "><a href="Prompt-Expansion.html"><strong aria-hidden="true">13.</strong> Prompt Expansion</a></li><li class="chapter-item expanded "><a href="Expansion.html"><strong aria-hidden="true">14.</strong> Expansion</a></li><li class="chapter-item expanded "><a href="Parameters.html"><strong aria-hidden="true">15.</strong> Parameters</a></li><li class="chapter-item expanded "><a href="Options.html"><strong aria-hidden="true">16.</strong> Options</a></li><li class="chapter-item expanded "><a href="Shell-Builtin-Commands.html"><strong aria-hidden="true">17.</strong> Shell Builtin Commands</a></li><li class="chapter-item expanded "><a href="Zsh-Line-Editor.html"><strong aria-hidden="true">18.</strong> Zsh Line Editor</a></li><li class="chapter-item expanded "><a href="Completion-Widgets.html"><strong aria-hidden="true">19.</strong> Completion Widgets</a></li><li class="chapter-item expanded "><a href="Completion-System.html"><strong aria-hidden="true">20.</strong> Completion System</a></li><li class="chapter-item expanded "><a href="Completion-Using-compctl.html"><strong aria-hidden="true">21.</strong> Completion Using compctl</a></li><li class="chapter-item expanded "><a href="Zsh-Modules.html"><strong aria-hidden="true">22.</strong> Zsh Modules</a></li><li class="chapter-item expanded "><a href="Calendar-Function-System.html"><strong aria-hidden="true">23.</strong> Calendar Function System</a></li><li class="chapter-item expanded "><a href="TCP-Function-System.html"><strong aria-hidden="true">24.</strong> TCP Function System</a></li><li class="chapter-item expanded "><a href="Zftp-Function-System.html"><strong aria-hidden="true">25.</strong> Zftp Function System</a></li><li class="chapter-item expanded "><a href="User-Contributions.html"><strong aria-hidden="true">26.</strong> User Contributions</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -201,7 +205,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Functions.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Functions.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -215,7 +219,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Functions.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Functions.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
@ -223,7 +227,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
@ -241,21 +245,22 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,5 +1,5 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
@ -7,11 +7,10 @@
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="The-Z-Shell-Manual.html"><strong aria-hidden="true">1.</strong> The Z Shell Manual</a></li><li class="chapter-item expanded "><a href="Introduction.html"><strong aria-hidden="true">2.</strong> Introduction</a></li><li class="chapter-item expanded "><a href="Roadmap.html"><strong aria-hidden="true">3.</strong> Roadmap</a></li><li class="chapter-item expanded "><a href="Invocation.html"><strong aria-hidden="true">4.</strong> Invocation</a></li><li class="chapter-item expanded "><a href="Files.html"><strong aria-hidden="true">5.</strong> Files</a></li><li class="chapter-item expanded "><a href="Shell-Grammar.html"><strong aria-hidden="true">6.</strong> Shell Grammar</a></li><li class="chapter-item expanded "><a href="Redirection.html"><strong aria-hidden="true">7.</strong> Redirection</a></li><li class="chapter-item expanded "><a href="Command-Execution.html"><strong aria-hidden="true">8.</strong> Command Execution</a></li><li class="chapter-item expanded "><a href="Functions.html"><strong aria-hidden="true">9.</strong> Functions</a></li><li class="chapter-item expanded "><a href="Jobs-&-Signals.html"><strong aria-hidden="true">10.</strong> Jobs & Signals</a></li><li class="chapter-item expanded "><a href="Arithmetic-Evaluation.html"><strong aria-hidden="true">11.</strong> Arithmetic Evaluation</a></li><li class="chapter-item expanded "><a href="Conditional-Expressions.html"><strong aria-hidden="true">12.</strong> Conditional Expressions</a></li><li class="chapter-item expanded "><a href="Prompt-Expansion.html"><strong aria-hidden="true">13.</strong> Prompt Expansion</a></li><li class="chapter-item expanded "><a href="Expansion.html"><strong aria-hidden="true">14.</strong> Expansion</a></li><li class="chapter-item expanded "><a href="Parameters.html"><strong aria-hidden="true">15.</strong> Parameters</a></li><li class="chapter-item expanded "><a href="Options.html"><strong aria-hidden="true">16.</strong> Options</a></li><li class="chapter-item expanded "><a href="Shell-Builtin-Commands.html"><strong aria-hidden="true">17.</strong> Shell Builtin Commands</a></li><li class="chapter-item expanded "><a href="Zsh-Line-Editor.html"><strong aria-hidden="true">18.</strong> Zsh Line Editor</a></li><li class="chapter-item expanded "><a href="Completion-Widgets.html"><strong aria-hidden="true">19.</strong> Completion Widgets</a></li><li class="chapter-item expanded "><a href="Completion-System.html" class="active"><strong aria-hidden="true">20.</strong> Completion System</a></li><li class="chapter-item expanded "><a href="Completion-Using-compctl.html"><strong aria-hidden="true">21.</strong> Completion Using compctl</a></li><li class="chapter-item expanded "><a href="Zsh-Modules.html"><strong aria-hidden="true">22.</strong> Zsh Modules</a></li><li class="chapter-item expanded "><a href="Calendar-Function-System.html"><strong aria-hidden="true">23.</strong> Calendar Function System</a></li><li class="chapter-item expanded "><a href="TCP-Function-System.html"><strong aria-hidden="true">24.</strong> TCP Function System</a></li><li class="chapter-item expanded "><a href="Zftp-Function-System.html"><strong aria-hidden="true">25.</strong> Zftp Function System</a></li><li class="chapter-item expanded "><a href="User-Contributions.html"><strong aria-hidden="true">26.</strong> User Contributions</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -411,8 +415,8 @@ does not begin with ‘_’ this will be added. The <code>widget-name</code> sho
|
||||
not clash with the name of any existing widget: names based on the name
|
||||
of the function are most useful. For example,</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">#compdef -K _foo_complete complete-word "^X^C" \
|
||||
_foo_list list-choices "^X^D"
|
||||
<pre><code class="language-zsh">#compdef -K _foo_complete complete-word "^X^C" \
|
||||
_foo_list list-choices "^X^D"
|
||||
</code></pre>
|
||||
</div>
|
||||
<p>(all on one line) defines a widget _foo_complete for completion, bound
|
||||
@ -506,7 +510,7 @@ and‘-value-,-default-,-default-’, in that order, until it finds a
|
||||
function to handle the context.</p>
|
||||
<p>As an example:</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">compdef '_files -g "*.log"' '-redirect-,2>,-default-'
|
||||
<pre><code class="language-zsh">compdef '_files -g "*.log"' '-redirect-,2>,-default-'
|
||||
</code></pre>
|
||||
</div>
|
||||
<p>completes files matching ‘*.log’ after ‘2> <TAB>’ for any command with
|
||||
@ -553,7 +557,7 @@ completions. This provides a way of avoiding having to define a new
|
||||
completion function. For example, to complete files ending in ‘.h’ as
|
||||
arguments to the command foo:</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">compdef '_files -g "*.h"' foo
|
||||
<pre><code class="language-zsh">compdef '_files -g "*.h"' foo
|
||||
</code></pre>
|
||||
</div>
|
||||
<p>The option -n prevents any completions already defined for the command
|
||||
@ -616,10 +620,10 @@ and the significance of the cursor position. This takes account of a
|
||||
number of things including the command word (such as ‘grep’ or ‘zsh’)
|
||||
and options to which the current word may be an argument (such as the
|
||||
‘-o’ option to zsh which takes a shell option as an argument).</p>
|
||||
<p>The context starts out very generic ("we are beginning a completion")
|
||||
and becomes more specific as more is learned ("the current word is in a
|
||||
position that is usually a command name" or "the current word might be a
|
||||
variable name" and so on). Therefore the context will vary during the
|
||||
<p>The context starts out very generic ("we are beginning a completion")
|
||||
and becomes more specific as more is learned ("the current word is in a
|
||||
position that is usually a command name" or "the current word might be a
|
||||
variable name" and so on). Therefore the context will vary during the
|
||||
same call to the completion system.</p>
|
||||
<p>This context information is condensed into a string consisting of
|
||||
multiple fields separated by colons, referred to simply as ‘the context’
|
||||
@ -1278,7 +1282,7 @@ array of ‘<code>VAR</code>=<code>value</code>’ assignments to be exported in
|
||||
environment before the completion for the target command is invoked.</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">zstyle ':completion:*:sudo::' environ \
|
||||
PATH="/sbin:/usr/sbin:$PATH" HOME="/root"
|
||||
PATH="/sbin:/usr/sbin:$PATH" HOME="/root"
|
||||
</code></pre>
|
||||
</div>
|
||||
<p><span id="index-expand_002c-completion-style"></span></p>
|
||||
@ -2675,8 +2679,8 @@ using the -e option to zstyle so that some completers are only used when
|
||||
completion is attempted a second time on the same string, e.g.:</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">zstyle -e ':completion:*' completer '
|
||||
if [[ $_last_try != "$HISTNO$BUFFER$CURSOR" ]]; then
|
||||
_last_try="$HISTNO$BUFFER$CURSOR"
|
||||
if [[ $_last_try != "$HISTNO$BUFFER$CURSOR" ]]; then
|
||||
_last_try="$HISTNO$BUFFER$CURSOR"
|
||||
reply=(_complete _match _prefix)
|
||||
else
|
||||
reply=(_ignored _correct _approximate)
|
||||
@ -2966,8 +2970,8 @@ of these bindings clash with standard zsh bindings, only ‘\e~’ and
|
||||
added to .zshrc after compinit has been run:</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">for key in '!' '$' '@' '/' '~'; do
|
||||
bindkey "\e$key" _bash_complete-word
|
||||
bindkey "^X$key" _bash_list-choices
|
||||
bindkey "\e$key" _bash_complete-word
|
||||
bindkey "^X$key" _bash_list-choices
|
||||
done
|
||||
</code></pre>
|
||||
</div>
|
||||
@ -3267,7 +3271,7 @@ Do not complete options after the first non-option argument on the line.
|
||||
arguments. For example, to make _arguments stop completing options
|
||||
after the first normal argument, but ignoring all strings starting with
|
||||
a hyphen even if they are not described by one of the <code>optspec</code>s, the
|
||||
form is ‘-A "-*"’.</p>
|
||||
form is ‘-A "-*"’.</p>
|
||||
<p>-O <code>name</code><br />
|
||||
Pass the elements of the array <code>name</code> as arguments to functions called
|
||||
to execute <code>action</code>s. This is discussed in detail below.</p>
|
||||
@ -3548,7 +3552,7 @@ array) should be made local to the calling function to avoid passing
|
||||
back the modified value and should be initialised to the current value
|
||||
at the start of the function:</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">local curcontext="$curcontext"
|
||||
<pre><code class="language-zsh">local curcontext="$curcontext"
|
||||
</code></pre>
|
||||
</div>
|
||||
<p>This is useful where it is not possible for multiple states to be valid
|
||||
@ -3671,7 +3675,7 @@ can be given as the name of an array parameter or as a literal list in
|
||||
parentheses. For example,</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">_arguments -- -i \
|
||||
"(--(en|dis)able-FEATURE*)"
|
||||
"(--(en|dis)able-FEATURE*)"
|
||||
</code></pre>
|
||||
</div>
|
||||
<p>will cause completion to ignore the options ‘--enable-FEATURE’ and
|
||||
@ -3684,7 +3688,7 @@ so that it forms a single argument word in the _arguments call.</p>
|
||||
‘--enable-foo’, but the script also accepts the negated form
|
||||
‘--disable-foo’. To allow completion of the second form:</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">_arguments -- -s "((#s)--enable- --disable-)"
|
||||
<pre><code class="language-zsh">_arguments -- -s "((#s)--enable- --disable-)"
|
||||
</code></pre>
|
||||
</div>
|
||||
<p><em>Miscellaneous notes</em></p>
|
||||
@ -3732,7 +3736,7 @@ cache file as the only argument.</p>
|
||||
<pre><code class="language-zsh">_example_caching_policy () {
|
||||
# rebuild if cache is more than a week old
|
||||
local -a oldp
|
||||
oldp=( "$1"(Nm+7) )
|
||||
oldp=( "$1"(Nm+7) )
|
||||
(( $#oldp ))
|
||||
}
|
||||
</code></pre>
|
||||
@ -3785,7 +3789,7 @@ should contain the possible values for the combinations in the
|
||||
appropriate order (users, hosts, ports in the example above). The values
|
||||
for the different fields are separated by colons. This can be altered
|
||||
with the option -s to _combination which specifies a pattern. Typically
|
||||
this is a character class, as for example ‘-s "[:@]"’ in the case of
|
||||
this is a character class, as for example ‘-s "[:@]"’ in the case of
|
||||
the users-hosts style. Each ‘<code>field</code>=<code>pattern</code>’ specification restricts
|
||||
the completions which apply to elements of the style with appropriately
|
||||
matching fields.</p>
|
||||
@ -3919,7 +3923,7 @@ the option ‘-V’, ‘-1V’, or ‘-2V’.</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">local expl
|
||||
_description files expl file
|
||||
compadd "$expl[@]" - "$files[@]"
|
||||
compadd "$expl[@]" - "$files[@]"
|
||||
</code></pre>
|
||||
</div>
|
||||
<p>Note the use of the parameter expl, the hyphen, and the list of matches.
|
||||
@ -4007,7 +4011,7 @@ _arguments.</p>
|
||||
<p>As an example, consider a command taking the options -n and -none, where
|
||||
-n must be followed by a numeric value in the same word. By using:</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">_arguments '-n-: :_guard "[0-9]#" "numeric value"' '-none'
|
||||
<pre><code class="language-zsh">_arguments '-n-: :_guard "[0-9]#" "numeric value"' '-none'
|
||||
</code></pre>
|
||||
</div>
|
||||
<p>_arguments can be made to both display the message ‘numeric value’ and
|
||||
@ -4084,7 +4088,7 @@ style.</p>
|
||||
if _requested foo; then
|
||||
...
|
||||
while _next_label foo expl '...'; do
|
||||
compadd "$expl[@]" ... && ret=0
|
||||
compadd "$expl[@]" ... && ret=0
|
||||
done
|
||||
...
|
||||
fi
|
||||
@ -4379,8 +4383,8 @@ the generated array at that point.</p>
|
||||
_regex_words mydb-commands 'mydb commands' \
|
||||
'add:add an entry to mydb:$mydb_add_cmds' \
|
||||
'show:show entries in mydb'
|
||||
_regex_arguments _mydb "$reply[@]"
|
||||
_mydb "$@"
|
||||
_regex_arguments _mydb "$reply[@]"
|
||||
_mydb "$@"
|
||||
</code></pre>
|
||||
</div>
|
||||
<p>This shows a completion function for a command mydb which takes two
|
||||
@ -4699,7 +4703,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Completion-Using-compctl.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Completion-Using-compctl.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -4713,7 +4717,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Completion-Using-compctl.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Completion-Using-compctl.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
@ -4721,7 +4725,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
@ -4739,21 +4743,22 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,5 +1,5 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
@ -7,11 +7,10 @@
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="The-Z-Shell-Manual.html"><strong aria-hidden="true">1.</strong> The Z Shell Manual</a></li><li class="chapter-item expanded "><a href="Introduction.html"><strong aria-hidden="true">2.</strong> Introduction</a></li><li class="chapter-item expanded "><a href="Roadmap.html"><strong aria-hidden="true">3.</strong> Roadmap</a></li><li class="chapter-item expanded "><a href="Invocation.html"><strong aria-hidden="true">4.</strong> Invocation</a></li><li class="chapter-item expanded "><a href="Files.html"><strong aria-hidden="true">5.</strong> Files</a></li><li class="chapter-item expanded "><a href="Shell-Grammar.html"><strong aria-hidden="true">6.</strong> Shell Grammar</a></li><li class="chapter-item expanded "><a href="Redirection.html"><strong aria-hidden="true">7.</strong> Redirection</a></li><li class="chapter-item expanded "><a href="Command-Execution.html"><strong aria-hidden="true">8.</strong> Command Execution</a></li><li class="chapter-item expanded "><a href="Functions.html"><strong aria-hidden="true">9.</strong> Functions</a></li><li class="chapter-item expanded "><a href="Jobs-&-Signals.html"><strong aria-hidden="true">10.</strong> Jobs & Signals</a></li><li class="chapter-item expanded "><a href="Arithmetic-Evaluation.html"><strong aria-hidden="true">11.</strong> Arithmetic Evaluation</a></li><li class="chapter-item expanded "><a href="Conditional-Expressions.html"><strong aria-hidden="true">12.</strong> Conditional Expressions</a></li><li class="chapter-item expanded "><a href="Prompt-Expansion.html"><strong aria-hidden="true">13.</strong> Prompt Expansion</a></li><li class="chapter-item expanded "><a href="Expansion.html"><strong aria-hidden="true">14.</strong> Expansion</a></li><li class="chapter-item expanded "><a href="Parameters.html"><strong aria-hidden="true">15.</strong> Parameters</a></li><li class="chapter-item expanded "><a href="Options.html"><strong aria-hidden="true">16.</strong> Options</a></li><li class="chapter-item expanded "><a href="Shell-Builtin-Commands.html"><strong aria-hidden="true">17.</strong> Shell Builtin Commands</a></li><li class="chapter-item expanded "><a href="Zsh-Line-Editor.html"><strong aria-hidden="true">18.</strong> Zsh Line Editor</a></li><li class="chapter-item expanded "><a href="Completion-Widgets.html"><strong aria-hidden="true">19.</strong> Completion Widgets</a></li><li class="chapter-item expanded "><a href="Completion-System.html"><strong aria-hidden="true">20.</strong> Completion System</a></li><li class="chapter-item expanded "><a href="Completion-Using-compctl.html" class="active"><strong aria-hidden="true">21.</strong> Completion Using compctl</a></li><li class="chapter-item expanded "><a href="Zsh-Modules.html"><strong aria-hidden="true">22.</strong> Zsh Modules</a></li><li class="chapter-item expanded "><a href="Calendar-Function-System.html"><strong aria-hidden="true">23.</strong> Calendar Function System</a></li><li class="chapter-item expanded "><a href="TCP-Function-System.html"><strong aria-hidden="true">24.</strong> TCP Function System</a></li><li class="chapter-item expanded "><a href="Zftp-Function-System.html"><strong aria-hidden="true">25.</strong> Zftp Function System</a></li><li class="chapter-item expanded "><a href="User-Contributions.html"><strong aria-hidden="true">26.</strong> User Contributions</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -372,8 +376,8 @@ may be a set of space- or comma-separated values in parentheses, in
|
||||
which any delimiter may be escaped with a backslash; in this case the
|
||||
argument should be quoted. For example,</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">compctl -k "(cputime filesize datasize stacksize
|
||||
coredumpsize resident descriptors)" limit
|
||||
<pre><code class="language-zsh">compctl -k "(cputime filesize datasize stacksize
|
||||
coredumpsize resident descriptors)" limit
|
||||
</code></pre>
|
||||
</div>
|
||||
<p>-g <code>globstring</code><br />
|
||||
@ -439,7 +443,7 @@ The <code>prefix</code> is inserted just before the completed string; any initia
|
||||
part already typed will be completed and the whole <code>prefix</code> ignored for
|
||||
completion purposes. For example,</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">compctl -j -P "%" kill
|
||||
<pre><code class="language-zsh">compctl -j -P "%" kill
|
||||
</code></pre>
|
||||
</div>
|
||||
<p>inserts a ‘%’ after the kill command and then completes job names.</p>
|
||||
@ -718,7 +722,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Zsh-Modules.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Zsh-Modules.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -732,7 +736,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Zsh-Modules.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Zsh-Modules.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
@ -740,7 +744,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
@ -758,21 +762,22 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,5 +1,5 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
@ -7,11 +7,10 @@
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="The-Z-Shell-Manual.html"><strong aria-hidden="true">1.</strong> The Z Shell Manual</a></li><li class="chapter-item expanded "><a href="Introduction.html"><strong aria-hidden="true">2.</strong> Introduction</a></li><li class="chapter-item expanded "><a href="Roadmap.html"><strong aria-hidden="true">3.</strong> Roadmap</a></li><li class="chapter-item expanded "><a href="Invocation.html"><strong aria-hidden="true">4.</strong> Invocation</a></li><li class="chapter-item expanded "><a href="Files.html"><strong aria-hidden="true">5.</strong> Files</a></li><li class="chapter-item expanded "><a href="Shell-Grammar.html"><strong aria-hidden="true">6.</strong> Shell Grammar</a></li><li class="chapter-item expanded "><a href="Redirection.html"><strong aria-hidden="true">7.</strong> Redirection</a></li><li class="chapter-item expanded "><a href="Command-Execution.html"><strong aria-hidden="true">8.</strong> Command Execution</a></li><li class="chapter-item expanded "><a href="Functions.html"><strong aria-hidden="true">9.</strong> Functions</a></li><li class="chapter-item expanded "><a href="Jobs-&-Signals.html"><strong aria-hidden="true">10.</strong> Jobs & Signals</a></li><li class="chapter-item expanded "><a href="Arithmetic-Evaluation.html"><strong aria-hidden="true">11.</strong> Arithmetic Evaluation</a></li><li class="chapter-item expanded "><a href="Conditional-Expressions.html"><strong aria-hidden="true">12.</strong> Conditional Expressions</a></li><li class="chapter-item expanded "><a href="Prompt-Expansion.html"><strong aria-hidden="true">13.</strong> Prompt Expansion</a></li><li class="chapter-item expanded "><a href="Expansion.html"><strong aria-hidden="true">14.</strong> Expansion</a></li><li class="chapter-item expanded "><a href="Parameters.html"><strong aria-hidden="true">15.</strong> Parameters</a></li><li class="chapter-item expanded "><a href="Options.html"><strong aria-hidden="true">16.</strong> Options</a></li><li class="chapter-item expanded "><a href="Shell-Builtin-Commands.html"><strong aria-hidden="true">17.</strong> Shell Builtin Commands</a></li><li class="chapter-item expanded "><a href="Zsh-Line-Editor.html"><strong aria-hidden="true">18.</strong> Zsh Line Editor</a></li><li class="chapter-item expanded "><a href="Completion-Widgets.html" class="active"><strong aria-hidden="true">19.</strong> Completion Widgets</a></li><li class="chapter-item expanded "><a href="Completion-System.html"><strong aria-hidden="true">20.</strong> Completion System</a></li><li class="chapter-item expanded "><a href="Completion-Using-compctl.html"><strong aria-hidden="true">21.</strong> Completion Using compctl</a></li><li class="chapter-item expanded "><a href="Zsh-Modules.html"><strong aria-hidden="true">22.</strong> Zsh Modules</a></li><li class="chapter-item expanded "><a href="Calendar-Function-System.html"><strong aria-hidden="true">23.</strong> Calendar Function System</a></li><li class="chapter-item expanded "><a href="TCP-Function-System.html"><strong aria-hidden="true">24.</strong> TCP Function System</a></li><li class="chapter-item expanded "><a href="Zftp-Function-System.html"><strong aria-hidden="true">25.</strong> Zftp Function System</a></li><li class="chapter-item expanded "><a href="User-Contributions.html"><strong aria-hidden="true">26.</strong> User Contributions</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -256,10 +260,10 @@ altered to give a common prefix for all matches.</p>
|
||||
<p><span id="index-QIPREFIX"></span></p>
|
||||
<p>QIPREFIX</p>
|
||||
<p>This parameter is read-only and contains the quoted string up to the
|
||||
word being completed. E.g. when completing ‘"foo’, this parameter
|
||||
word being completed. E.g. when completing ‘"foo’, this parameter
|
||||
contains the double quote. If the -q option of compset is used (see
|
||||
below), and the original string was ‘"foo bar’ with the cursor on the
|
||||
‘bar’, this parameter contains ‘"foo ’.</p>
|
||||
below), and the original string was ‘"foo bar’ with the cursor on the
|
||||
‘bar’, this parameter contains ‘"foo ’.</p>
|
||||
<p><span id="index-QISUFFIX"></span></p>
|
||||
<p>QISUFFIX</p>
|
||||
<p>Like QIPREFIX, but containing the suffix.</p>
|
||||
@ -661,12 +665,12 @@ or the slash automatically added after completing directories will be
|
||||
automatically removed if the next character typed inserts one of the
|
||||
characters given in the <code>remove-chars</code>. This string is parsed as a
|
||||
characters class and understands the backslash sequences used by the
|
||||
print command. For example, ‘-r "a-z\t"’ removes the suffix if the next
|
||||
character typed inserts a lower case character or a TAB, and ‘-r "^0-9"’
|
||||
print command. For example, ‘-r "a-z\t"’ removes the suffix if the next
|
||||
character typed inserts a lower case character or a TAB, and ‘-r "^0-9"’
|
||||
removes the suffix if the next character typed inserts anything but a
|
||||
digit. One extra backslash sequence is understood in this string: ‘\-’
|
||||
stands for all characters that insert nothing. Thus ‘-S "=" -q’ is the
|
||||
same as ‘-S "=" -r "= \t\n\-"’.</p>
|
||||
stands for all characters that insert nothing. Thus ‘-S "=" -q’ is the
|
||||
same as ‘-S "=" -r "= \t\n\-"’.</p>
|
||||
<p>This option may also be used without the -S option; then any
|
||||
automatically added space will be removed when one of the characters in
|
||||
the list is typed.</p>
|
||||
@ -698,7 +702,7 @@ the tests will not otherwise be performed.</p>
|
||||
Specifies an array containing patterns. <code>completions</code> that match one of
|
||||
these patterns are ignored, that is, not considered to be matches.</p>
|
||||
<p>The <code>array</code> may be the name of an array parameter or a list of literal
|
||||
patterns enclosed in parentheses and quoted, as in ‘-F "(*?.o *?.h)"’.
|
||||
patterns enclosed in parentheses and quoted, as in ‘-F "(*?.o *?.h)"’.
|
||||
If the name of an array is given, the elements of the array are taken as
|
||||
the patterns.</p>
|
||||
<p>-Q<br />
|
||||
@ -726,7 +730,7 @@ that match will be stored in the array parameter whose name is given as
|
||||
As the -O option, except that instead of those of the <code>completions</code>
|
||||
which match being stored in <code>array</code>, the strings generated internally by
|
||||
the completion code are stored. For example, with a match specification
|
||||
of ‘-M "L:|no="’, a current word of ‘nof’ and <code>completions</code> of ‘foo’,
|
||||
of ‘-M "L:|no="’, a current word of ‘nof’ and <code>completions</code> of ‘foo’,
|
||||
this option stores the string ‘nofoo’ in the array, whereas the -O
|
||||
option stores the ‘foo’ originally given.</p>
|
||||
<p>-D <code>array</code><br />
|
||||
@ -1094,7 +1098,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Completion-System.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Completion-System.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -1108,7 +1112,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Completion-System.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Completion-System.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
@ -1116,7 +1120,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
@ -1134,21 +1138,22 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,5 +1,5 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
@ -7,11 +7,10 @@
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="The-Z-Shell-Manual.html"><strong aria-hidden="true">1.</strong> The Z Shell Manual</a></li><li class="chapter-item expanded "><a href="Introduction.html"><strong aria-hidden="true">2.</strong> Introduction</a></li><li class="chapter-item expanded "><a href="Roadmap.html"><strong aria-hidden="true">3.</strong> Roadmap</a></li><li class="chapter-item expanded "><a href="Invocation.html"><strong aria-hidden="true">4.</strong> Invocation</a></li><li class="chapter-item expanded "><a href="Files.html"><strong aria-hidden="true">5.</strong> Files</a></li><li class="chapter-item expanded "><a href="Shell-Grammar.html"><strong aria-hidden="true">6.</strong> Shell Grammar</a></li><li class="chapter-item expanded "><a href="Redirection.html"><strong aria-hidden="true">7.</strong> Redirection</a></li><li class="chapter-item expanded "><a href="Command-Execution.html"><strong aria-hidden="true">8.</strong> Command Execution</a></li><li class="chapter-item expanded "><a href="Functions.html"><strong aria-hidden="true">9.</strong> Functions</a></li><li class="chapter-item expanded "><a href="Jobs-&-Signals.html"><strong aria-hidden="true">10.</strong> Jobs & Signals</a></li><li class="chapter-item expanded "><a href="Arithmetic-Evaluation.html"><strong aria-hidden="true">11.</strong> Arithmetic Evaluation</a></li><li class="chapter-item expanded "><a href="Conditional-Expressions.html" class="active"><strong aria-hidden="true">12.</strong> Conditional Expressions</a></li><li class="chapter-item expanded "><a href="Prompt-Expansion.html"><strong aria-hidden="true">13.</strong> Prompt Expansion</a></li><li class="chapter-item expanded "><a href="Expansion.html"><strong aria-hidden="true">14.</strong> Expansion</a></li><li class="chapter-item expanded "><a href="Parameters.html"><strong aria-hidden="true">15.</strong> Parameters</a></li><li class="chapter-item expanded "><a href="Options.html"><strong aria-hidden="true">16.</strong> Options</a></li><li class="chapter-item expanded "><a href="Shell-Builtin-Commands.html"><strong aria-hidden="true">17.</strong> Shell Builtin Commands</a></li><li class="chapter-item expanded "><a href="Zsh-Line-Editor.html"><strong aria-hidden="true">18.</strong> Zsh Line Editor</a></li><li class="chapter-item expanded "><a href="Completion-Widgets.html"><strong aria-hidden="true">19.</strong> Completion Widgets</a></li><li class="chapter-item expanded "><a href="Completion-System.html"><strong aria-hidden="true">20.</strong> Completion System</a></li><li class="chapter-item expanded "><a href="Completion-Using-compctl.html"><strong aria-hidden="true">21.</strong> Completion Using compctl</a></li><li class="chapter-item expanded "><a href="Zsh-Modules.html"><strong aria-hidden="true">22.</strong> Zsh Modules</a></li><li class="chapter-item expanded "><a href="Calendar-Function-System.html"><strong aria-hidden="true">23.</strong> Calendar Function System</a></li><li class="chapter-item expanded "><a href="TCP-Function-System.html"><strong aria-hidden="true">24.</strong> TCP Function System</a></li><li class="chapter-item expanded "><a href="Zftp-Function-System.html"><strong aria-hidden="true">25.</strong> Zftp Function System</a></li><li class="chapter-item expanded "><a href="User-Contributions.html"><strong aria-hidden="true">26.</strong> User Contributions</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -354,7 +358,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Prompt-Expansion.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Prompt-Expansion.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -368,7 +372,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Prompt-Expansion.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Prompt-Expansion.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
@ -376,7 +380,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
@ -394,21 +398,22 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,5 +1,5 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
@ -7,11 +7,10 @@
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="The-Z-Shell-Manual.html"><strong aria-hidden="true">1.</strong> The Z Shell Manual</a></li><li class="chapter-item expanded "><a href="Introduction.html"><strong aria-hidden="true">2.</strong> Introduction</a></li><li class="chapter-item expanded "><a href="Roadmap.html"><strong aria-hidden="true">3.</strong> Roadmap</a></li><li class="chapter-item expanded "><a href="Invocation.html"><strong aria-hidden="true">4.</strong> Invocation</a></li><li class="chapter-item expanded "><a href="Files.html"><strong aria-hidden="true">5.</strong> Files</a></li><li class="chapter-item expanded "><a href="Shell-Grammar.html"><strong aria-hidden="true">6.</strong> Shell Grammar</a></li><li class="chapter-item expanded "><a href="Redirection.html"><strong aria-hidden="true">7.</strong> Redirection</a></li><li class="chapter-item expanded "><a href="Command-Execution.html"><strong aria-hidden="true">8.</strong> Command Execution</a></li><li class="chapter-item expanded "><a href="Functions.html"><strong aria-hidden="true">9.</strong> Functions</a></li><li class="chapter-item expanded "><a href="Jobs-&-Signals.html"><strong aria-hidden="true">10.</strong> Jobs & Signals</a></li><li class="chapter-item expanded "><a href="Arithmetic-Evaluation.html"><strong aria-hidden="true">11.</strong> Arithmetic Evaluation</a></li><li class="chapter-item expanded "><a href="Conditional-Expressions.html"><strong aria-hidden="true">12.</strong> Conditional Expressions</a></li><li class="chapter-item expanded "><a href="Prompt-Expansion.html"><strong aria-hidden="true">13.</strong> Prompt Expansion</a></li><li class="chapter-item expanded "><a href="Expansion.html" class="active"><strong aria-hidden="true">14.</strong> Expansion</a></li><li class="chapter-item expanded "><a href="Parameters.html"><strong aria-hidden="true">15.</strong> Parameters</a></li><li class="chapter-item expanded "><a href="Options.html"><strong aria-hidden="true">16.</strong> Options</a></li><li class="chapter-item expanded "><a href="Shell-Builtin-Commands.html"><strong aria-hidden="true">17.</strong> Shell Builtin Commands</a></li><li class="chapter-item expanded "><a href="Zsh-Line-Editor.html"><strong aria-hidden="true">18.</strong> Zsh Line Editor</a></li><li class="chapter-item expanded "><a href="Completion-Widgets.html"><strong aria-hidden="true">19.</strong> Completion Widgets</a></li><li class="chapter-item expanded "><a href="Completion-System.html"><strong aria-hidden="true">20.</strong> Completion System</a></li><li class="chapter-item expanded "><a href="Completion-Using-compctl.html"><strong aria-hidden="true">21.</strong> Completion Using compctl</a></li><li class="chapter-item expanded "><a href="Zsh-Modules.html"><strong aria-hidden="true">22.</strong> Zsh Modules</a></li><li class="chapter-item expanded "><a href="Calendar-Function-System.html"><strong aria-hidden="true">23.</strong> Calendar Function System</a></li><li class="chapter-item expanded "><a href="TCP-Function-System.html"><strong aria-hidden="true">24.</strong> TCP Function System</a></li><li class="chapter-item expanded "><a href="Zftp-Function-System.html"><strong aria-hidden="true">25.</strong> Zftp Function System</a></li><li class="chapter-item expanded "><a href="User-Contributions.html"><strong aria-hidden="true">26.</strong> User Contributions</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -219,7 +223,7 @@ These five are performed in left-to-right fashion. On each argument, any
|
||||
of the five steps that are needed are performed one after the other.
|
||||
Hence, for example, all the parts of parameter expansion are completed
|
||||
before command substitution is started. After these expansions, all
|
||||
unquoted occurrences of the characters ‘\’,‘’’ and ‘"’ are removed.</p>
|
||||
unquoted occurrences of the characters ‘\’,‘’’ and ‘"’ are removed.</p>
|
||||
<p><em>Filename Expansion</em><br />
|
||||
If the SH_FILE_EXPANSION option is set, the order of expansion is
|
||||
modified for compatibility with sh and ksh. In that case <em>filename
|
||||
@ -288,10 +292,10 @@ replacing the string <code>foo</code> with <code>bar</code>. More precisely, the
|
||||
‘^<code>foo</code>^<code>bar</code>^’ is synonymous with ‘!!:s^<code>foo</code>^<code>bar</code>^’, hence other
|
||||
modifiers (see <a href="#Modifiers">Modifiers</a>) may follow the final ‘^’. In
|
||||
particular, ‘^<code>foo</code>^<code>bar</code>^:G’ performs a global substitution.</p>
|
||||
<p>If the shell encounters the character sequence ‘!"’ in the input, the
|
||||
<p>If the shell encounters the character sequence ‘!"’ in the input, the
|
||||
history mechanism is temporarily disabled until the current list (see
|
||||
<a href="Shell-Grammar.html#Shell-Grammar">Shell Grammar</a>) is fully parsed. The
|
||||
‘!"’ is removed from the input, and any subsequent ‘!’ characters have
|
||||
‘!"’ is removed from the input, and any subsequent ‘!’ characters have
|
||||
no special significance.</p>
|
||||
<p><span id="index-fc_002c-use-of"></span></p>
|
||||
<p>A less convenient but more comprehensible form of command history
|
||||
@ -675,18 +679,18 @@ important difference from other shells. However, as in other shells,
|
||||
null words are elided from unquoted parameters’ expansions.</p>
|
||||
<p>With default options, after the assignments:</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">array=("first word" "" "third word")
|
||||
scalar="only word"
|
||||
<pre><code class="language-zsh">array=("first word" "" "third word")
|
||||
scalar="only word"
|
||||
</code></pre>
|
||||
</div>
|
||||
<p>then $array substitutes two words, ‘first word’ and ‘third word’, and
|
||||
$scalar substitutes a single word ‘only word’. Note that second element
|
||||
of array was elided. Scalar parameters can be elided too if their value
|
||||
is null (empty). To avoid elision, use quoting as follows: "$scalar" for
|
||||
scalars and "${array[@]}" or "${(@)array}" for arrays. (The last two
|
||||
is null (empty). To avoid elision, use quoting as follows: "$scalar" for
|
||||
scalars and "${array[@]}" or "${(@)array}" for arrays. (The last two
|
||||
forms are equivalent.)</p>
|
||||
<p>Parameter expansions can involve <em>flags</em>, as in ‘${(@kv)aliases}’, and
|
||||
other operators, such as ‘${PREFIX:-"/usr/local"}’. Parameter expansions
|
||||
other operators, such as ‘${PREFIX:-"/usr/local"}’. Parameter expansions
|
||||
can also be nested. These topics will be introduced below. The full
|
||||
rules are complicated and are noted at the end.</p>
|
||||
<p>In the expansions discussed below that require a pattern, the form of
|
||||
@ -800,7 +804,7 @@ empty, the other array is output with no extra elements inserted.</p>
|
||||
elements, which can be unexpected. The second print provides a
|
||||
workaround which should continue to work if this is changed.</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">a=(a b); b=(1 2); print -l "${a:^b}"; print -l "${${a:^b}}"
|
||||
<pre><code class="language-zsh">a=(a b); b=(1 2); print -l "${a:^b}"; print -l "${${a:^b}}"
|
||||
</code></pre>
|
||||
</div>
|
||||
<p>${<code>name</code>:<code>offset</code>}<br />
|
||||
@ -886,7 +890,7 @@ the I and S parameter expansion flags below; however, the flags M, R, B,
|
||||
E and N are not useful.</p>
|
||||
<p>For example,</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">foo="twinkle twinkle little star" sub="t*e" rep="spy"
|
||||
<pre><code class="language-zsh">foo="twinkle twinkle little star" sub="t*e" rep="spy"
|
||||
print ${foo//${~sub}/$rep}
|
||||
print ${(S)foo//${~sub}/$rep}
|
||||
</code></pre>
|
||||
@ -968,10 +972,10 @@ expansion may also be followed by a subscript expression as described in
|
||||
<a href="Parameters.html#Array-Parameters">Array Parameters</a>.</p>
|
||||
<p>Note that double quotes may appear around nested expressions, in which
|
||||
case only the part inside is treated as quoted; for example,
|
||||
${(f)"$(foo)"} quotes the result of $(foo), but the flag ‘(f)’ (see
|
||||
${(f)"$(foo)"} quotes the result of $(foo), but the flag ‘(f)’ (see
|
||||
below) is applied using the rules for unquoted expansions. Note further
|
||||
that quotes are themselves nested in this context; for example, in
|
||||
"${(@f)"$(foo)"}", there are two sets of quotes, one surrounding the
|
||||
"${(@f)"$(foo)"}", there are two sets of quotes, one surrounding the
|
||||
whole expression, the other (redundant) surrounding the $(foo) as
|
||||
before.</p>
|
||||
<hr />
|
||||
@ -1000,8 +1004,8 @@ depending on the setting of the PROMPT_PERCENT, PROMPT_SUBST and
|
||||
PROMPT_BANG options.</p>
|
||||
<p>@<br />
|
||||
In double quotes, array elements are put into separate words. E.g.,
|
||||
‘"${(@)foo}"’ is equivalent to ‘"${foo[@]}"’ and ‘"${(@)foo[1,2]}"’
|
||||
is the same as ‘"$foo[1]" "$foo[2]"’. This is distinct from <em>field
|
||||
‘"${(@)foo}"’ is equivalent to ‘"${foo[@]}"’ and ‘"${(@)foo[1,2]}"’
|
||||
is the same as ‘"$foo[1]" "$foo[2]"’. This is distinct from <em>field
|
||||
splitting</em> by the f, s or z flags, which still applies within each array
|
||||
element.</p>
|
||||
<p>A<br />
|
||||
@ -1243,7 +1247,7 @@ follow ~ within the same set of parentheses. Compare with ~ outside
|
||||
parentheses, which forces the entire substituted string to be treated as
|
||||
a pattern. Hence, for example,</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">[[ "?" = ${(~j.|.)array} ]]
|
||||
<pre><code class="language-zsh">[[ "?" = ${(~j.|.)array} ]]
|
||||
</code></pre>
|
||||
</div>
|
||||
<p>treats ‘|’ as a pattern and succeeds if and only if $array contains the
|
||||
@ -1305,13 +1309,13 @@ separate element.</p>
|
||||
are retained inside double quotes is disabled for arrays generated by
|
||||
splitting; hence the following:</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">line="one::three"
|
||||
print -l "${(s.:.)line}"
|
||||
<pre><code class="language-zsh">line="one::three"
|
||||
print -l "${(s.:.)line}"
|
||||
</code></pre>
|
||||
</div>
|
||||
<p>produces two lines of output for one and three and elides the empty
|
||||
field. To override this behaviour, supply the ‘(@)’ flag as well, i.e.
|
||||
"${(@s.:.)line}".</p>
|
||||
"${(@s.:.)line}".</p>
|
||||
<p>Z:<code>opts</code>:<br />
|
||||
As z but takes a combination of option letters between a following pair
|
||||
of delimiter characters. With no options the effect is identical to z.
|
||||
@ -1342,7 +1346,7 @@ With # or ##, search for the match that starts closest to the start of
|
||||
the string (a ‘substring match’). Of all matches at a particular
|
||||
position, # selects the shortest and ## the longest:</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">% str="aXbXc"
|
||||
<pre><code class="language-zsh">% str="aXbXc"
|
||||
% echo ${(S)str#X*}
|
||||
abXc
|
||||
% echo ${(S)str##X*}
|
||||
@ -1353,7 +1357,7 @@ a
|
||||
<p>With % or %%, search for the match that starts closest to the end of the
|
||||
string:</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">% str="aXbXc"
|
||||
<pre><code class="language-zsh">% str="aXbXc"
|
||||
% echo ${(S)str%X*}
|
||||
aXbc
|
||||
% echo ${(S)str%%X*}
|
||||
@ -1367,7 +1371,7 @@ end of the string, as one might expect.)</p>
|
||||
matching, i.e. that the shortest instead of the longest match should be
|
||||
replaced:</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">% str="abab"
|
||||
<pre><code class="language-zsh">% str="abab"
|
||||
% echo ${str/*b/_}
|
||||
_
|
||||
% echo ${(S)str/*b/_}
|
||||
@ -1493,8 +1497,8 @@ Any remaining subscripts (i.e. of a nested substitution) are evaluated
|
||||
at this point, based on whether the value is an array or a scalar. As
|
||||
with 3., multiple subscripts can appear. Note that ${foo[2,4][2]} is
|
||||
thus equivalent to ${${foo[2,4]}[2]} and also to
|
||||
"${${(@)foo[2,4]}[2]}" (the nested substitution returns an array in
|
||||
both cases), but not to "${${foo[2,4]}[2]}" (the nested substitution
|
||||
"${${(@)foo[2,4]}[2]}" (the nested substitution returns an array in
|
||||
both cases), but not to "${${foo[2,4]}[2]}" (the nested substitution
|
||||
returns a scalar because of the quotes).</p>
|
||||
<p>7. <em>Modifiers</em><br />
|
||||
Any modifiers, as specified by a trailing ‘#’, ‘%’, ‘/’ (possibly
|
||||
@ -1583,24 +1587,24 @@ flags (rule 2.) applied to the new value.</p>
|
||||
<h3 id="1433-examples"><a class="header" href="#1433-examples">14.3.3 Examples</a></h3>
|
||||
<p><span id="index-parameter-expansion_002c-examples"></span></p>
|
||||
<p>The flag f is useful to split a double-quoted substitution line by line.
|
||||
For example, ${(f)"$(<<code>file</code>)"} substitutes the contents of <code>file</code>
|
||||
For example, ${(f)"$(<<code>file</code>)"} substitutes the contents of <code>file</code>
|
||||
divided so that each line is an element of the resulting array. Compare
|
||||
this with the effect of $(<<code>file</code>) alone, which divides the file up by
|
||||
words, or the same inside double quotes, which makes the entire content
|
||||
of the file a single string.</p>
|
||||
<p>The following illustrates the rules for nested parameter expansions.
|
||||
Suppose that $foo contains the array (bar baz):</p>
|
||||
<p>"${(@)${foo}[1]}"<br />
|
||||
This produces the result b. First, the inner substitution "${foo}",
|
||||
which has no array (@) flag, produces a single word result "bar baz".
|
||||
The outer substitution "${(@)...[1]}" detects that this is a scalar,
|
||||
<p>"${(@)${foo}[1]}"<br />
|
||||
This produces the result b. First, the inner substitution "${foo}",
|
||||
which has no array (@) flag, produces a single word result "bar baz".
|
||||
The outer substitution "${(@)...[1]}" detects that this is a scalar,
|
||||
so that (despite the ‘(@)’ flag) the subscript picks the first
|
||||
character.</p>
|
||||
<p>"${${(@)foo}[1]}"<br />
|
||||
<p>"${${(@)foo}[1]}"<br />
|
||||
This produces the result ‘bar’. In this case, the inner substitution
|
||||
"${(@)foo}" produces the array ‘(bar baz)’. The outer substitution
|
||||
"${...[1]}" detects that this is an array and picks the first word.
|
||||
This is similar to the simple case "${foo[1]}".</p>
|
||||
"${(@)foo}" produces the array ‘(bar baz)’. The outer substitution
|
||||
"${...[1]}" detects that this is an array and picks the first word.
|
||||
This is similar to the simple case "${foo[1]}".</p>
|
||||
<p>As an example of the rules for word splitting and joining, suppose $foo
|
||||
contains the array ‘(ax1 bx1)’. Then</p>
|
||||
<p>${(s/x/)foo}<br />
|
||||
@ -1610,7 +1614,7 @@ produces ‘a’, ‘1’, ‘b’ and ‘1’.</p>
|
||||
<p>${(s/x/)foo%%1*}<br />
|
||||
produces ‘a’ and ‘ b’ (note the extra space). As substitution occurs
|
||||
before either joining or splitting, the operation first generates the
|
||||
modified array (ax bx), which is joined to give "ax bx", and then split
|
||||
modified array (ax bx), which is joined to give "ax bx", and then split
|
||||
to give ‘a’, ‘ b’ and ‘’. The final empty string will then be elided, as
|
||||
it is not in double quotes.</p>
|
||||
<hr />
|
||||
@ -2078,7 +2082,7 @@ flags are not considered parenthesised groups; only the first nine
|
||||
active parentheses can be referenced.</p>
|
||||
<p>For example,</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">foo="a_string_with_a_message"
|
||||
<pre><code class="language-zsh">foo="a_string_with_a_message"
|
||||
if [[ $foo = (a|an)_(#b)(*) ]]; then
|
||||
print ${foo[$mbegin[1],$mend[1]]}
|
||||
fi
|
||||
@ -2169,7 +2173,7 @@ provides a single simple and memorable method.</p>
|
||||
<p>Note that assertions of the form ‘(^(#s))’ also work, i.e. match
|
||||
anywhere except at the start of the string, although this actually means
|
||||
‘anything except a zero-length portion at the start of the string’; you
|
||||
need to use ‘(""~(#s))’ to match a zero-length portion of the string
|
||||
need to use ‘(""~(#s))’ to match a zero-length portion of the string
|
||||
not at the start.</p>
|
||||
<p>q<br />
|
||||
A ‘q’ and everything up to the closing parenthesis of the globbing flags
|
||||
@ -2483,9 +2487,9 @@ bytes in length.</p>
|
||||
kilobytes, megabytes, or blocks (of 512 bytes) instead. (On some systems
|
||||
additional specifiers are available for gigabytes, ‘g’ or ‘G’, and
|
||||
terabytes, ‘t’ or ‘T’.) If a size specifier is used a file is regarded
|
||||
as "exactly" the size if the file size rounded up to the next unit is
|
||||
as "exactly" the size if the file size rounded up to the next unit is
|
||||
equal to the test size. Hence ‘*(Lm1)’ matches files from 1 byte up to
|
||||
1 Megabyte inclusive. Note also that the set of files "less than" the
|
||||
1 Megabyte inclusive. Note also that the set of files "less than" the
|
||||
test size only includes files that would not match the equality test;
|
||||
hence ‘*(Lm-1)’ only matches files of zero size.</p>
|
||||
<p>^<br />
|
||||
@ -2651,7 +2655,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Parameters.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Parameters.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -2665,7 +2669,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Parameters.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Parameters.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
@ -2673,7 +2677,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
@ -2691,21 +2695,22 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,5 +1,5 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
@ -7,11 +7,10 @@
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="The-Z-Shell-Manual.html"><strong aria-hidden="true">1.</strong> The Z Shell Manual</a></li><li class="chapter-item expanded "><a href="Introduction.html"><strong aria-hidden="true">2.</strong> Introduction</a></li><li class="chapter-item expanded "><a href="Roadmap.html"><strong aria-hidden="true">3.</strong> Roadmap</a></li><li class="chapter-item expanded "><a href="Invocation.html"><strong aria-hidden="true">4.</strong> Invocation</a></li><li class="chapter-item expanded "><a href="Files.html" class="active"><strong aria-hidden="true">5.</strong> Files</a></li><li class="chapter-item expanded "><a href="Shell-Grammar.html"><strong aria-hidden="true">6.</strong> Shell Grammar</a></li><li class="chapter-item expanded "><a href="Redirection.html"><strong aria-hidden="true">7.</strong> Redirection</a></li><li class="chapter-item expanded "><a href="Command-Execution.html"><strong aria-hidden="true">8.</strong> Command Execution</a></li><li class="chapter-item expanded "><a href="Functions.html"><strong aria-hidden="true">9.</strong> Functions</a></li><li class="chapter-item expanded "><a href="Jobs-&-Signals.html"><strong aria-hidden="true">10.</strong> Jobs & Signals</a></li><li class="chapter-item expanded "><a href="Arithmetic-Evaluation.html"><strong aria-hidden="true">11.</strong> Arithmetic Evaluation</a></li><li class="chapter-item expanded "><a href="Conditional-Expressions.html"><strong aria-hidden="true">12.</strong> Conditional Expressions</a></li><li class="chapter-item expanded "><a href="Prompt-Expansion.html"><strong aria-hidden="true">13.</strong> Prompt Expansion</a></li><li class="chapter-item expanded "><a href="Expansion.html"><strong aria-hidden="true">14.</strong> Expansion</a></li><li class="chapter-item expanded "><a href="Parameters.html"><strong aria-hidden="true">15.</strong> Parameters</a></li><li class="chapter-item expanded "><a href="Options.html"><strong aria-hidden="true">16.</strong> Options</a></li><li class="chapter-item expanded "><a href="Shell-Builtin-Commands.html"><strong aria-hidden="true">17.</strong> Shell Builtin Commands</a></li><li class="chapter-item expanded "><a href="Zsh-Line-Editor.html"><strong aria-hidden="true">18.</strong> Zsh Line Editor</a></li><li class="chapter-item expanded "><a href="Completion-Widgets.html"><strong aria-hidden="true">19.</strong> Completion Widgets</a></li><li class="chapter-item expanded "><a href="Completion-System.html"><strong aria-hidden="true">20.</strong> Completion System</a></li><li class="chapter-item expanded "><a href="Completion-Using-compctl.html"><strong aria-hidden="true">21.</strong> Completion Using compctl</a></li><li class="chapter-item expanded "><a href="Zsh-Modules.html"><strong aria-hidden="true">22.</strong> Zsh Modules</a></li><li class="chapter-item expanded "><a href="Calendar-Function-System.html"><strong aria-hidden="true">23.</strong> Calendar Function System</a></li><li class="chapter-item expanded "><a href="TCP-Function-System.html"><strong aria-hidden="true">24.</strong> TCP Function System</a></li><li class="chapter-item expanded "><a href="Zftp-Function-System.html"><strong aria-hidden="true">25.</strong> Zftp Function System</a></li><li class="chapter-item expanded "><a href="User-Contributions.html"><strong aria-hidden="true">26.</strong> User Contributions</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -240,7 +244,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Shell-Grammar.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Shell-Grammar.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -254,7 +258,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Shell-Grammar.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Shell-Grammar.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
@ -262,7 +266,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
@ -280,21 +284,22 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
|
Before Width: | Height: | Size: 434 KiB After Width: | Height: | Size: 434 KiB |
@ -1,5 +1,5 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
@ -7,11 +7,10 @@
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="The-Z-Shell-Manual.html"><strong aria-hidden="true">1.</strong> The Z Shell Manual</a></li><li class="chapter-item expanded "><a href="Introduction.html"><strong aria-hidden="true">2.</strong> Introduction</a></li><li class="chapter-item expanded "><a href="Roadmap.html"><strong aria-hidden="true">3.</strong> Roadmap</a></li><li class="chapter-item expanded "><a href="Invocation.html"><strong aria-hidden="true">4.</strong> Invocation</a></li><li class="chapter-item expanded "><a href="Files.html"><strong aria-hidden="true">5.</strong> Files</a></li><li class="chapter-item expanded "><a href="Shell-Grammar.html"><strong aria-hidden="true">6.</strong> Shell Grammar</a></li><li class="chapter-item expanded "><a href="Redirection.html"><strong aria-hidden="true">7.</strong> Redirection</a></li><li class="chapter-item expanded "><a href="Command-Execution.html"><strong aria-hidden="true">8.</strong> Command Execution</a></li><li class="chapter-item expanded "><a href="Functions.html" class="active"><strong aria-hidden="true">9.</strong> Functions</a></li><li class="chapter-item expanded "><a href="Jobs-&-Signals.html"><strong aria-hidden="true">10.</strong> Jobs & Signals</a></li><li class="chapter-item expanded "><a href="Arithmetic-Evaluation.html"><strong aria-hidden="true">11.</strong> Arithmetic Evaluation</a></li><li class="chapter-item expanded "><a href="Conditional-Expressions.html"><strong aria-hidden="true">12.</strong> Conditional Expressions</a></li><li class="chapter-item expanded "><a href="Prompt-Expansion.html"><strong aria-hidden="true">13.</strong> Prompt Expansion</a></li><li class="chapter-item expanded "><a href="Expansion.html"><strong aria-hidden="true">14.</strong> Expansion</a></li><li class="chapter-item expanded "><a href="Parameters.html"><strong aria-hidden="true">15.</strong> Parameters</a></li><li class="chapter-item expanded "><a href="Options.html"><strong aria-hidden="true">16.</strong> Options</a></li><li class="chapter-item expanded "><a href="Shell-Builtin-Commands.html"><strong aria-hidden="true">17.</strong> Shell Builtin Commands</a></li><li class="chapter-item expanded "><a href="Zsh-Line-Editor.html"><strong aria-hidden="true">18.</strong> Zsh Line Editor</a></li><li class="chapter-item expanded "><a href="Completion-Widgets.html"><strong aria-hidden="true">19.</strong> Completion Widgets</a></li><li class="chapter-item expanded "><a href="Completion-System.html"><strong aria-hidden="true">20.</strong> Completion System</a></li><li class="chapter-item expanded "><a href="Completion-Using-compctl.html"><strong aria-hidden="true">21.</strong> Completion Using compctl</a></li><li class="chapter-item expanded "><a href="Zsh-Modules.html"><strong aria-hidden="true">22.</strong> Zsh Modules</a></li><li class="chapter-item expanded "><a href="Calendar-Function-System.html"><strong aria-hidden="true">23.</strong> Calendar Function System</a></li><li class="chapter-item expanded "><a href="TCP-Function-System.html"><strong aria-hidden="true">24.</strong> TCP Function System</a></li><li class="chapter-item expanded "><a href="Zftp-Function-System.html"><strong aria-hidden="true">25.</strong> Zftp Function System</a></li><li class="chapter-item expanded "><a href="User-Contributions.html"><strong aria-hidden="true">26.</strong> User Contributions</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -288,7 +292,7 @@ myfunc args...
|
||||
<p>In fact, the functions command outputs ‘builtin autoload -X’ as the body
|
||||
of an autoloaded function. This is done so that</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">eval "$(functions)"
|
||||
<pre><code class="language-zsh">eval "$(functions)"
|
||||
</code></pre>
|
||||
</div>
|
||||
<p>produces a reasonable result. A true autoloaded function can be
|
||||
@ -330,9 +334,9 @@ own local variable scope.</p>
|
||||
<pre><code class="language-zsh">variable=outside
|
||||
function {
|
||||
local variable=inside
|
||||
print "I am $variable with arguments $*"
|
||||
print "I am $variable with arguments $*"
|
||||
} this and that
|
||||
print "I am $variable"
|
||||
print "I am $variable"
|
||||
</code></pre>
|
||||
</div>
|
||||
<p>outputs the following:</p>
|
||||
@ -463,7 +467,7 @@ plus the signal number. Hence the following causes the handler for
|
||||
SIGINT to print a message, then mimic the usual effect of the signal.</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">TRAPINT() {
|
||||
print "Caught SIGINT, aborting."
|
||||
print "Caught SIGINT, aborting."
|
||||
return $(( 128 + $1 ))
|
||||
}
|
||||
</code></pre>
|
||||
@ -536,7 +540,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Jobs-&-Signals.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Jobs-&-Signals.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -550,7 +554,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Jobs-&-Signals.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Jobs-&-Signals.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
@ -558,7 +562,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
@ -576,21 +580,22 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,5 +1,5 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
@ -7,11 +7,10 @@
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="The-Z-Shell-Manual.html"><strong aria-hidden="true">1.</strong> The Z Shell Manual</a></li><li class="chapter-item expanded "><a href="Introduction.html" class="active"><strong aria-hidden="true">2.</strong> Introduction</a></li><li class="chapter-item expanded "><a href="Roadmap.html"><strong aria-hidden="true">3.</strong> Roadmap</a></li><li class="chapter-item expanded "><a href="Invocation.html"><strong aria-hidden="true">4.</strong> Invocation</a></li><li class="chapter-item expanded "><a href="Files.html"><strong aria-hidden="true">5.</strong> Files</a></li><li class="chapter-item expanded "><a href="Shell-Grammar.html"><strong aria-hidden="true">6.</strong> Shell Grammar</a></li><li class="chapter-item expanded "><a href="Redirection.html"><strong aria-hidden="true">7.</strong> Redirection</a></li><li class="chapter-item expanded "><a href="Command-Execution.html"><strong aria-hidden="true">8.</strong> Command Execution</a></li><li class="chapter-item expanded "><a href="Functions.html"><strong aria-hidden="true">9.</strong> Functions</a></li><li class="chapter-item expanded "><a href="Jobs-&-Signals.html"><strong aria-hidden="true">10.</strong> Jobs & Signals</a></li><li class="chapter-item expanded "><a href="Arithmetic-Evaluation.html"><strong aria-hidden="true">11.</strong> Arithmetic Evaluation</a></li><li class="chapter-item expanded "><a href="Conditional-Expressions.html"><strong aria-hidden="true">12.</strong> Conditional Expressions</a></li><li class="chapter-item expanded "><a href="Prompt-Expansion.html"><strong aria-hidden="true">13.</strong> Prompt Expansion</a></li><li class="chapter-item expanded "><a href="Expansion.html"><strong aria-hidden="true">14.</strong> Expansion</a></li><li class="chapter-item expanded "><a href="Parameters.html"><strong aria-hidden="true">15.</strong> Parameters</a></li><li class="chapter-item expanded "><a href="Options.html"><strong aria-hidden="true">16.</strong> Options</a></li><li class="chapter-item expanded "><a href="Shell-Builtin-Commands.html"><strong aria-hidden="true">17.</strong> Shell Builtin Commands</a></li><li class="chapter-item expanded "><a href="Zsh-Line-Editor.html"><strong aria-hidden="true">18.</strong> Zsh Line Editor</a></li><li class="chapter-item expanded "><a href="Completion-Widgets.html"><strong aria-hidden="true">19.</strong> Completion Widgets</a></li><li class="chapter-item expanded "><a href="Completion-System.html"><strong aria-hidden="true">20.</strong> Completion System</a></li><li class="chapter-item expanded "><a href="Completion-Using-compctl.html"><strong aria-hidden="true">21.</strong> Completion Using compctl</a></li><li class="chapter-item expanded "><a href="Zsh-Modules.html"><strong aria-hidden="true">22.</strong> Zsh Modules</a></li><li class="chapter-item expanded "><a href="Calendar-Function-System.html"><strong aria-hidden="true">23.</strong> Calendar Function System</a></li><li class="chapter-item expanded "><a href="TCP-Function-System.html"><strong aria-hidden="true">24.</strong> TCP Function System</a></li><li class="chapter-item expanded "><a href="Zftp-Function-System.html"><strong aria-hidden="true">25.</strong> Zftp Function System</a></li><li class="chapter-item expanded "><a href="User-Contributions.html"><strong aria-hidden="true">26.</strong> User Contributions</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -277,7 +281,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Roadmap.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Roadmap.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -291,7 +295,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Roadmap.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Roadmap.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
@ -299,7 +303,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
@ -317,21 +321,22 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,5 +1,5 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
@ -7,11 +7,10 @@
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="The-Z-Shell-Manual.html"><strong aria-hidden="true">1.</strong> The Z Shell Manual</a></li><li class="chapter-item expanded "><a href="Introduction.html"><strong aria-hidden="true">2.</strong> Introduction</a></li><li class="chapter-item expanded "><a href="Roadmap.html"><strong aria-hidden="true">3.</strong> Roadmap</a></li><li class="chapter-item expanded "><a href="Invocation.html" class="active"><strong aria-hidden="true">4.</strong> Invocation</a></li><li class="chapter-item expanded "><a href="Files.html"><strong aria-hidden="true">5.</strong> Files</a></li><li class="chapter-item expanded "><a href="Shell-Grammar.html"><strong aria-hidden="true">6.</strong> Shell Grammar</a></li><li class="chapter-item expanded "><a href="Redirection.html"><strong aria-hidden="true">7.</strong> Redirection</a></li><li class="chapter-item expanded "><a href="Command-Execution.html"><strong aria-hidden="true">8.</strong> Command Execution</a></li><li class="chapter-item expanded "><a href="Functions.html"><strong aria-hidden="true">9.</strong> Functions</a></li><li class="chapter-item expanded "><a href="Jobs-&-Signals.html"><strong aria-hidden="true">10.</strong> Jobs & Signals</a></li><li class="chapter-item expanded "><a href="Arithmetic-Evaluation.html"><strong aria-hidden="true">11.</strong> Arithmetic Evaluation</a></li><li class="chapter-item expanded "><a href="Conditional-Expressions.html"><strong aria-hidden="true">12.</strong> Conditional Expressions</a></li><li class="chapter-item expanded "><a href="Prompt-Expansion.html"><strong aria-hidden="true">13.</strong> Prompt Expansion</a></li><li class="chapter-item expanded "><a href="Expansion.html"><strong aria-hidden="true">14.</strong> Expansion</a></li><li class="chapter-item expanded "><a href="Parameters.html"><strong aria-hidden="true">15.</strong> Parameters</a></li><li class="chapter-item expanded "><a href="Options.html"><strong aria-hidden="true">16.</strong> Options</a></li><li class="chapter-item expanded "><a href="Shell-Builtin-Commands.html"><strong aria-hidden="true">17.</strong> Shell Builtin Commands</a></li><li class="chapter-item expanded "><a href="Zsh-Line-Editor.html"><strong aria-hidden="true">18.</strong> Zsh Line Editor</a></li><li class="chapter-item expanded "><a href="Completion-Widgets.html"><strong aria-hidden="true">19.</strong> Completion Widgets</a></li><li class="chapter-item expanded "><a href="Completion-System.html"><strong aria-hidden="true">20.</strong> Completion System</a></li><li class="chapter-item expanded "><a href="Completion-Using-compctl.html"><strong aria-hidden="true">21.</strong> Completion Using compctl</a></li><li class="chapter-item expanded "><a href="Zsh-Modules.html"><strong aria-hidden="true">22.</strong> Zsh Modules</a></li><li class="chapter-item expanded "><a href="Calendar-Function-System.html"><strong aria-hidden="true">23.</strong> Calendar Function System</a></li><li class="chapter-item expanded "><a href="TCP-Function-System.html"><strong aria-hidden="true">24.</strong> TCP Function System</a></li><li class="chapter-item expanded "><a href="Zftp-Function-System.html"><strong aria-hidden="true">25.</strong> Zftp Function System</a></li><li class="chapter-item expanded "><a href="User-Contributions.html"><strong aria-hidden="true">26.</strong> User Contributions</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -371,7 +375,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Files.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Files.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -385,7 +389,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Files.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Files.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
@ -393,7 +397,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
@ -411,21 +415,22 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,5 +1,5 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
@ -7,11 +7,10 @@
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="The-Z-Shell-Manual.html"><strong aria-hidden="true">1.</strong> The Z Shell Manual</a></li><li class="chapter-item expanded "><a href="Introduction.html"><strong aria-hidden="true">2.</strong> Introduction</a></li><li class="chapter-item expanded "><a href="Roadmap.html"><strong aria-hidden="true">3.</strong> Roadmap</a></li><li class="chapter-item expanded "><a href="Invocation.html"><strong aria-hidden="true">4.</strong> Invocation</a></li><li class="chapter-item expanded "><a href="Files.html"><strong aria-hidden="true">5.</strong> Files</a></li><li class="chapter-item expanded "><a href="Shell-Grammar.html"><strong aria-hidden="true">6.</strong> Shell Grammar</a></li><li class="chapter-item expanded "><a href="Redirection.html"><strong aria-hidden="true">7.</strong> Redirection</a></li><li class="chapter-item expanded "><a href="Command-Execution.html"><strong aria-hidden="true">8.</strong> Command Execution</a></li><li class="chapter-item expanded "><a href="Functions.html"><strong aria-hidden="true">9.</strong> Functions</a></li><li class="chapter-item expanded "><a href="Jobs-&-Signals.html" class="active"><strong aria-hidden="true">10.</strong> Jobs & Signals</a></li><li class="chapter-item expanded "><a href="Arithmetic-Evaluation.html"><strong aria-hidden="true">11.</strong> Arithmetic Evaluation</a></li><li class="chapter-item expanded "><a href="Conditional-Expressions.html"><strong aria-hidden="true">12.</strong> Conditional Expressions</a></li><li class="chapter-item expanded "><a href="Prompt-Expansion.html"><strong aria-hidden="true">13.</strong> Prompt Expansion</a></li><li class="chapter-item expanded "><a href="Expansion.html"><strong aria-hidden="true">14.</strong> Expansion</a></li><li class="chapter-item expanded "><a href="Parameters.html"><strong aria-hidden="true">15.</strong> Parameters</a></li><li class="chapter-item expanded "><a href="Options.html"><strong aria-hidden="true">16.</strong> Options</a></li><li class="chapter-item expanded "><a href="Shell-Builtin-Commands.html"><strong aria-hidden="true">17.</strong> Shell Builtin Commands</a></li><li class="chapter-item expanded "><a href="Zsh-Line-Editor.html"><strong aria-hidden="true">18.</strong> Zsh Line Editor</a></li><li class="chapter-item expanded "><a href="Completion-Widgets.html"><strong aria-hidden="true">19.</strong> Completion Widgets</a></li><li class="chapter-item expanded "><a href="Completion-System.html"><strong aria-hidden="true">20.</strong> Completion System</a></li><li class="chapter-item expanded "><a href="Completion-Using-compctl.html"><strong aria-hidden="true">21.</strong> Completion Using compctl</a></li><li class="chapter-item expanded "><a href="Zsh-Modules.html"><strong aria-hidden="true">22.</strong> Zsh Modules</a></li><li class="chapter-item expanded "><a href="Calendar-Function-System.html"><strong aria-hidden="true">23.</strong> Calendar Function System</a></li><li class="chapter-item expanded "><a href="TCP-Function-System.html"><strong aria-hidden="true">24.</strong> TCP Function System</a></li><li class="chapter-item expanded "><a href="Zftp-Function-System.html"><strong aria-hidden="true">25.</strong> Zftp Function System</a></li><li class="chapter-item expanded "><a href="User-Contributions.html"><strong aria-hidden="true">26.</strong> User Contributions</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -290,7 +294,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Arithmetic-Evaluation.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Arithmetic-Evaluation.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -304,7 +308,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Arithmetic-Evaluation.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Arithmetic-Evaluation.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
@ -312,7 +316,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
@ -330,21 +334,22 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,5 +1,5 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
@ -7,11 +7,10 @@
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="The-Z-Shell-Manual.html"><strong aria-hidden="true">1.</strong> The Z Shell Manual</a></li><li class="chapter-item expanded "><a href="Introduction.html"><strong aria-hidden="true">2.</strong> Introduction</a></li><li class="chapter-item expanded "><a href="Roadmap.html"><strong aria-hidden="true">3.</strong> Roadmap</a></li><li class="chapter-item expanded "><a href="Invocation.html"><strong aria-hidden="true">4.</strong> Invocation</a></li><li class="chapter-item expanded "><a href="Files.html"><strong aria-hidden="true">5.</strong> Files</a></li><li class="chapter-item expanded "><a href="Shell-Grammar.html"><strong aria-hidden="true">6.</strong> Shell Grammar</a></li><li class="chapter-item expanded "><a href="Redirection.html"><strong aria-hidden="true">7.</strong> Redirection</a></li><li class="chapter-item expanded "><a href="Command-Execution.html"><strong aria-hidden="true">8.</strong> Command Execution</a></li><li class="chapter-item expanded "><a href="Functions.html"><strong aria-hidden="true">9.</strong> Functions</a></li><li class="chapter-item expanded "><a href="Jobs-&-Signals.html"><strong aria-hidden="true">10.</strong> Jobs & Signals</a></li><li class="chapter-item expanded "><a href="Arithmetic-Evaluation.html"><strong aria-hidden="true">11.</strong> Arithmetic Evaluation</a></li><li class="chapter-item expanded "><a href="Conditional-Expressions.html"><strong aria-hidden="true">12.</strong> Conditional Expressions</a></li><li class="chapter-item expanded "><a href="Prompt-Expansion.html"><strong aria-hidden="true">13.</strong> Prompt Expansion</a></li><li class="chapter-item expanded "><a href="Expansion.html"><strong aria-hidden="true">14.</strong> Expansion</a></li><li class="chapter-item expanded "><a href="Parameters.html"><strong aria-hidden="true">15.</strong> Parameters</a></li><li class="chapter-item expanded "><a href="Options.html" class="active"><strong aria-hidden="true">16.</strong> Options</a></li><li class="chapter-item expanded "><a href="Shell-Builtin-Commands.html"><strong aria-hidden="true">17.</strong> Shell Builtin Commands</a></li><li class="chapter-item expanded "><a href="Zsh-Line-Editor.html"><strong aria-hidden="true">18.</strong> Zsh Line Editor</a></li><li class="chapter-item expanded "><a href="Completion-Widgets.html"><strong aria-hidden="true">19.</strong> Completion Widgets</a></li><li class="chapter-item expanded "><a href="Completion-System.html"><strong aria-hidden="true">20.</strong> Completion System</a></li><li class="chapter-item expanded "><a href="Completion-Using-compctl.html"><strong aria-hidden="true">21.</strong> Completion Using compctl</a></li><li class="chapter-item expanded "><a href="Zsh-Modules.html"><strong aria-hidden="true">22.</strong> Zsh Modules</a></li><li class="chapter-item expanded "><a href="Calendar-Function-System.html"><strong aria-hidden="true">23.</strong> Calendar Function System</a></li><li class="chapter-item expanded "><a href="TCP-Function-System.html"><strong aria-hidden="true">24.</strong> TCP Function System</a></li><li class="chapter-item expanded "><a href="Zftp-Function-System.html"><strong aria-hidden="true">25.</strong> Zftp Function System</a></li><li class="chapter-item expanded "><a href="User-Contributions.html"><strong aria-hidden="true">26.</strong> User Contributions</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -866,11 +870,11 @@ restrict the effect of this option to a single function scope, use
|
||||
inside the function nested as that overrides the value within toplevel</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">toplevel() {
|
||||
local foo="in fn"
|
||||
local foo="in fn"
|
||||
nested
|
||||
}
|
||||
nested() {
|
||||
foo="in nested"
|
||||
foo="in nested"
|
||||
}
|
||||
setopt warn_nested_var
|
||||
toplevel
|
||||
@ -1876,7 +1880,7 @@ id="index-quoting-style_002c-csh"></span></p>
|
||||
<p>Changes the rules for single- and double-quoted text to match that of
|
||||
csh. These require that embedded newlines be preceded by a backslash;
|
||||
unescaped newlines will cause an error message. In double-quoted
|
||||
strings, it is made impossible to escape ‘$’, ‘‘’ or ‘"’ (and ‘\’
|
||||
strings, it is made impossible to escape ‘$’, ‘‘’ or ‘"’ (and ‘\’
|
||||
itself no longer needs escaping). Command substitutions are only
|
||||
expanded once, and cannot be nested.</p>
|
||||
<p><span id="index-CSH_005fNULLCMD"></span> <span
|
||||
@ -2545,7 +2549,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Shell-Builtin-Commands.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Shell-Builtin-Commands.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -2559,7 +2563,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Shell-Builtin-Commands.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Shell-Builtin-Commands.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
@ -2567,7 +2571,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
@ -2585,21 +2589,22 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,5 +1,5 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
@ -7,11 +7,10 @@
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="The-Z-Shell-Manual.html"><strong aria-hidden="true">1.</strong> The Z Shell Manual</a></li><li class="chapter-item expanded "><a href="Introduction.html"><strong aria-hidden="true">2.</strong> Introduction</a></li><li class="chapter-item expanded "><a href="Roadmap.html"><strong aria-hidden="true">3.</strong> Roadmap</a></li><li class="chapter-item expanded "><a href="Invocation.html"><strong aria-hidden="true">4.</strong> Invocation</a></li><li class="chapter-item expanded "><a href="Files.html"><strong aria-hidden="true">5.</strong> Files</a></li><li class="chapter-item expanded "><a href="Shell-Grammar.html"><strong aria-hidden="true">6.</strong> Shell Grammar</a></li><li class="chapter-item expanded "><a href="Redirection.html"><strong aria-hidden="true">7.</strong> Redirection</a></li><li class="chapter-item expanded "><a href="Command-Execution.html"><strong aria-hidden="true">8.</strong> Command Execution</a></li><li class="chapter-item expanded "><a href="Functions.html"><strong aria-hidden="true">9.</strong> Functions</a></li><li class="chapter-item expanded "><a href="Jobs-&-Signals.html"><strong aria-hidden="true">10.</strong> Jobs & Signals</a></li><li class="chapter-item expanded "><a href="Arithmetic-Evaluation.html"><strong aria-hidden="true">11.</strong> Arithmetic Evaluation</a></li><li class="chapter-item expanded "><a href="Conditional-Expressions.html"><strong aria-hidden="true">12.</strong> Conditional Expressions</a></li><li class="chapter-item expanded "><a href="Prompt-Expansion.html"><strong aria-hidden="true">13.</strong> Prompt Expansion</a></li><li class="chapter-item expanded "><a href="Expansion.html"><strong aria-hidden="true">14.</strong> Expansion</a></li><li class="chapter-item expanded "><a href="Parameters.html" class="active"><strong aria-hidden="true">15.</strong> Parameters</a></li><li class="chapter-item expanded "><a href="Options.html"><strong aria-hidden="true">16.</strong> Options</a></li><li class="chapter-item expanded "><a href="Shell-Builtin-Commands.html"><strong aria-hidden="true">17.</strong> Shell Builtin Commands</a></li><li class="chapter-item expanded "><a href="Zsh-Line-Editor.html"><strong aria-hidden="true">18.</strong> Zsh Line Editor</a></li><li class="chapter-item expanded "><a href="Completion-Widgets.html"><strong aria-hidden="true">19.</strong> Completion Widgets</a></li><li class="chapter-item expanded "><a href="Completion-System.html"><strong aria-hidden="true">20.</strong> Completion System</a></li><li class="chapter-item expanded "><a href="Completion-Using-compctl.html"><strong aria-hidden="true">21.</strong> Completion Using compctl</a></li><li class="chapter-item expanded "><a href="Zsh-Modules.html"><strong aria-hidden="true">22.</strong> Zsh Modules</a></li><li class="chapter-item expanded "><a href="Calendar-Function-System.html"><strong aria-hidden="true">23.</strong> Calendar Function System</a></li><li class="chapter-item expanded "><a href="TCP-Function-System.html"><strong aria-hidden="true">24.</strong> TCP Function System</a></li><li class="chapter-item expanded "><a href="Zftp-Function-System.html"><strong aria-hidden="true">25.</strong> Zftp Function System</a></li><li class="chapter-item expanded "><a href="User-Contributions.html"><strong aria-hidden="true">26.</strong> User Contributions</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -386,8 +390,8 @@ certain special characters must be protected from interpretation. See
|
||||
<em>Subscript Parsing</em> below for details.</p>
|
||||
<p>A subscript of the form ‘[*]’ or ‘[@]’ evaluates to all elements of
|
||||
an array; there is no difference between the two except when they appear
|
||||
within double quotes. ‘"$foo[*]"’ evaluates to ‘"$foo[1] $foo[2]
|
||||
..."’, whereas ‘"$foo[@]"’ evaluates to ‘"$foo[1]" "$foo[2]" ...’.
|
||||
within double quotes. ‘"$foo[*]"’ evaluates to ‘"$foo[1] $foo[2]
|
||||
..."’, whereas ‘"$foo[@]"’ evaluates to ‘"$foo[1]" "$foo[2]" ...’.
|
||||
For associative arrays, ‘[*]’ or ‘[@]’ evaluate to all the values,
|
||||
in no particular order. Note that this does not substitute the keys; see
|
||||
the documentation for the ‘k’ flag under <a href="Expansion.html#Parameter-Expansion">Parameter
|
||||
@ -411,7 +415,7 @@ in that case the substring extends from the start of the match of the
|
||||
first subscript to the end of the match of the second subscript. For
|
||||
example,</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">string="abcdefghijklm"
|
||||
<pre><code class="language-zsh">string="abcdefghijklm"
|
||||
print ${string[(r)d?,(r)h?]}
|
||||
</code></pre>
|
||||
</div>
|
||||
@ -442,7 +446,7 @@ the other elements to accommodate the new values. (This is not supported
|
||||
for associative arrays.)</p>
|
||||
<p>This syntax also works as an argument to the typeset command:</p>
|
||||
<blockquote>
|
||||
<p>typeset "<code>name</code>[<code>exp</code>]"=<code>value</code></p>
|
||||
<p>typeset "<code>name</code>[<code>exp</code>]"=<code>value</code></p>
|
||||
</blockquote>
|
||||
<p>The <code>value</code> may <em>not</em> be a parenthesized list in this case; only
|
||||
single-element assignments may be made with typeset. Note that quotes
|
||||
@ -452,7 +456,7 @@ modifier could be used instead.</p>
|
||||
<p>To delete an element of an ordinary array, assign ‘()’ to that element.
|
||||
To delete an element of an associative array, use the unset command:</p>
|
||||
<blockquote>
|
||||
<p>unset "<code>name</code>[<code>exp</code>]"</p>
|
||||
<p>unset "<code>name</code>[<code>exp</code>]"</p>
|
||||
</blockquote>
|
||||
<hr />
|
||||
<p><span id="Subscript-Flags"></span></p>
|
||||
@ -587,7 +591,7 @@ arithmetic expression in an ordinary subscript.</p>
|
||||
<p>To avoid subscript parsing limitations in assignments to associative
|
||||
array elements, use the append syntax:</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">aa+=('key with "*strange*" characters' 'value string')
|
||||
<pre><code class="language-zsh">aa+=('key with "*strange*" characters' 'value string')
|
||||
</code></pre>
|
||||
</div>
|
||||
<p>The basic rule to remember when writing a subscript expression is that
|
||||
@ -613,23 +617,23 @@ backslash, and backslashes that protect parentheses or braces are
|
||||
removed during parsing. This is because parameter expansions may be
|
||||
surrounded by balanced braces, and subscript flags are introduced by
|
||||
balanced parentheses.</p>
|
||||
<p>The second difference is that a double-quote (‘"’) may appear as part of
|
||||
<p>The second difference is that a double-quote (‘"’) may appear as part of
|
||||
a subscript expression without being preceded by a backslash, and
|
||||
therefore that the two characters ‘\"’ remain as two characters in the
|
||||
subscript (in true double-quoting, ‘\"’ becomes ‘"’). However, because
|
||||
therefore that the two characters ‘\"’ remain as two characters in the
|
||||
subscript (in true double-quoting, ‘\"’ becomes ‘"’). However, because
|
||||
of the standard shell quoting rules, any double-quotes that appear must
|
||||
occur in balanced pairs unless preceded by a backslash. This makes it
|
||||
more difficult to write a subscript expression that contains an odd
|
||||
number of double-quote characters, but the reason for this difference is
|
||||
so that when a subscript expression appears inside true double-quotes,
|
||||
one can still write ‘\"’ (rather than ‘\\\"’) for ‘"’.</p>
|
||||
one can still write ‘\"’ (rather than ‘\\\"’) for ‘"’.</p>
|
||||
<p>To use an odd number of double quotes as a key in an assignment, use the
|
||||
typeset builtin and an enclosing pair of double quotes; to refer to the
|
||||
value of that key, again use double quotes:</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">typeset -A aa
|
||||
typeset "aa[one\"two\"three\"quotes]"=QQQ
|
||||
print "$aa[one\"two\"three\"quotes]"
|
||||
typeset "aa[one\"two\"three\"quotes]"=QQQ
|
||||
print "$aa[one\"two\"three\"quotes]"
|
||||
</code></pre>
|
||||
</div>
|
||||
<p>It is important to note that the quoting rules do not change when a
|
||||
@ -1410,7 +1414,7 @@ speaking, main memory usage) in kilobytes is greater than this value
|
||||
have timing statistics reported. The format used to output statistics is
|
||||
the value of the TIMEFMT parameter, which is the same as for the
|
||||
REPORTTIME variable and the time builtin; note that by default this does
|
||||
not output memory usage. Appending " max RSS %M" to the value of TIMEFMT
|
||||
not output memory usage. Appending " max RSS %M" to the value of TIMEFMT
|
||||
causes it to output the value that triggered the report. If REPORTTIME
|
||||
is also in use, at most a single report is printed for both triggers.
|
||||
This feature requires the getrusage() system call, commonly supported by
|
||||
@ -1687,7 +1691,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Options.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Options.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -1701,7 +1705,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Options.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Options.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
@ -1709,7 +1713,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
@ -1727,21 +1731,22 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,5 +1,5 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
@ -7,11 +7,10 @@
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="The-Z-Shell-Manual.html"><strong aria-hidden="true">1.</strong> The Z Shell Manual</a></li><li class="chapter-item expanded "><a href="Introduction.html"><strong aria-hidden="true">2.</strong> Introduction</a></li><li class="chapter-item expanded "><a href="Roadmap.html"><strong aria-hidden="true">3.</strong> Roadmap</a></li><li class="chapter-item expanded "><a href="Invocation.html"><strong aria-hidden="true">4.</strong> Invocation</a></li><li class="chapter-item expanded "><a href="Files.html"><strong aria-hidden="true">5.</strong> Files</a></li><li class="chapter-item expanded "><a href="Shell-Grammar.html"><strong aria-hidden="true">6.</strong> Shell Grammar</a></li><li class="chapter-item expanded "><a href="Redirection.html"><strong aria-hidden="true">7.</strong> Redirection</a></li><li class="chapter-item expanded "><a href="Command-Execution.html"><strong aria-hidden="true">8.</strong> Command Execution</a></li><li class="chapter-item expanded "><a href="Functions.html"><strong aria-hidden="true">9.</strong> Functions</a></li><li class="chapter-item expanded "><a href="Jobs-&-Signals.html"><strong aria-hidden="true">10.</strong> Jobs & Signals</a></li><li class="chapter-item expanded "><a href="Arithmetic-Evaluation.html"><strong aria-hidden="true">11.</strong> Arithmetic Evaluation</a></li><li class="chapter-item expanded "><a href="Conditional-Expressions.html"><strong aria-hidden="true">12.</strong> Conditional Expressions</a></li><li class="chapter-item expanded "><a href="Prompt-Expansion.html" class="active"><strong aria-hidden="true">13.</strong> Prompt Expansion</a></li><li class="chapter-item expanded "><a href="Expansion.html"><strong aria-hidden="true">14.</strong> Expansion</a></li><li class="chapter-item expanded "><a href="Parameters.html"><strong aria-hidden="true">15.</strong> Parameters</a></li><li class="chapter-item expanded "><a href="Options.html"><strong aria-hidden="true">16.</strong> Options</a></li><li class="chapter-item expanded "><a href="Shell-Builtin-Commands.html"><strong aria-hidden="true">17.</strong> Shell Builtin Commands</a></li><li class="chapter-item expanded "><a href="Zsh-Line-Editor.html"><strong aria-hidden="true">18.</strong> Zsh Line Editor</a></li><li class="chapter-item expanded "><a href="Completion-Widgets.html"><strong aria-hidden="true">19.</strong> Completion Widgets</a></li><li class="chapter-item expanded "><a href="Completion-System.html"><strong aria-hidden="true">20.</strong> Completion System</a></li><li class="chapter-item expanded "><a href="Completion-Using-compctl.html"><strong aria-hidden="true">21.</strong> Completion Using compctl</a></li><li class="chapter-item expanded "><a href="Zsh-Modules.html"><strong aria-hidden="true">22.</strong> Zsh Modules</a></li><li class="chapter-item expanded "><a href="Calendar-Function-System.html"><strong aria-hidden="true">23.</strong> Calendar Function System</a></li><li class="chapter-item expanded "><a href="TCP-Function-System.html"><strong aria-hidden="true">24.</strong> TCP Function System</a></li><li class="chapter-item expanded "><a href="Zftp-Function-System.html"><strong aria-hidden="true">25.</strong> Zftp Function System</a></li><li class="chapter-item expanded "><a href="User-Contributions.html"><strong aria-hidden="true">26.</strong> User Contributions</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -468,7 +472,7 @@ to ‘..e/pike’. In this string, the terminating character (‘<’, ‘>
|
||||
when using print -P, however, that this must be doubled as the string is
|
||||
also subject to standard print processing, in addition to any
|
||||
backslashes removed by a double quoted string: the worst case is
|
||||
therefore ‘print -P "%<\\\\<<..."’.</p>
|
||||
therefore ‘print -P "%<\\\\<<..."’.</p>
|
||||
<p>If the <code>string</code> is longer than the specified truncation length, it will
|
||||
appear in full, completely replacing the truncated string.</p>
|
||||
<p>The part of the prompt string to be truncated runs to the end of the
|
||||
@ -503,7 +507,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Expansion.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Expansion.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -517,7 +521,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Expansion.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Expansion.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
@ -525,7 +529,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
@ -543,21 +547,22 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,5 +1,5 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
@ -7,11 +7,10 @@
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="The-Z-Shell-Manual.html"><strong aria-hidden="true">1.</strong> The Z Shell Manual</a></li><li class="chapter-item expanded "><a href="Introduction.html"><strong aria-hidden="true">2.</strong> Introduction</a></li><li class="chapter-item expanded "><a href="Roadmap.html"><strong aria-hidden="true">3.</strong> Roadmap</a></li><li class="chapter-item expanded "><a href="Invocation.html"><strong aria-hidden="true">4.</strong> Invocation</a></li><li class="chapter-item expanded "><a href="Files.html"><strong aria-hidden="true">5.</strong> Files</a></li><li class="chapter-item expanded "><a href="Shell-Grammar.html"><strong aria-hidden="true">6.</strong> Shell Grammar</a></li><li class="chapter-item expanded "><a href="Redirection.html" class="active"><strong aria-hidden="true">7.</strong> Redirection</a></li><li class="chapter-item expanded "><a href="Command-Execution.html"><strong aria-hidden="true">8.</strong> Command Execution</a></li><li class="chapter-item expanded "><a href="Functions.html"><strong aria-hidden="true">9.</strong> Functions</a></li><li class="chapter-item expanded "><a href="Jobs-&-Signals.html"><strong aria-hidden="true">10.</strong> Jobs & Signals</a></li><li class="chapter-item expanded "><a href="Arithmetic-Evaluation.html"><strong aria-hidden="true">11.</strong> Arithmetic Evaluation</a></li><li class="chapter-item expanded "><a href="Conditional-Expressions.html"><strong aria-hidden="true">12.</strong> Conditional Expressions</a></li><li class="chapter-item expanded "><a href="Prompt-Expansion.html"><strong aria-hidden="true">13.</strong> Prompt Expansion</a></li><li class="chapter-item expanded "><a href="Expansion.html"><strong aria-hidden="true">14.</strong> Expansion</a></li><li class="chapter-item expanded "><a href="Parameters.html"><strong aria-hidden="true">15.</strong> Parameters</a></li><li class="chapter-item expanded "><a href="Options.html"><strong aria-hidden="true">16.</strong> Options</a></li><li class="chapter-item expanded "><a href="Shell-Builtin-Commands.html"><strong aria-hidden="true">17.</strong> Shell Builtin Commands</a></li><li class="chapter-item expanded "><a href="Zsh-Line-Editor.html"><strong aria-hidden="true">18.</strong> Zsh Line Editor</a></li><li class="chapter-item expanded "><a href="Completion-Widgets.html"><strong aria-hidden="true">19.</strong> Completion Widgets</a></li><li class="chapter-item expanded "><a href="Completion-System.html"><strong aria-hidden="true">20.</strong> Completion System</a></li><li class="chapter-item expanded "><a href="Completion-Using-compctl.html"><strong aria-hidden="true">21.</strong> Completion Using compctl</a></li><li class="chapter-item expanded "><a href="Zsh-Modules.html"><strong aria-hidden="true">22.</strong> Zsh Modules</a></li><li class="chapter-item expanded "><a href="Calendar-Function-System.html"><strong aria-hidden="true">23.</strong> Calendar Function System</a></li><li class="chapter-item expanded "><a href="TCP-Function-System.html"><strong aria-hidden="true">24.</strong> TCP Function System</a></li><li class="chapter-item expanded "><a href="Zftp-Function-System.html"><strong aria-hidden="true">25.</strong> Zftp Function System</a></li><li class="chapter-item expanded "><a href="User-Contributions.html"><strong aria-hidden="true">26.</strong> User Contributions</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -479,7 +483,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Command-Execution.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Command-Execution.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -493,7 +497,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Command-Execution.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Command-Execution.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
@ -501,7 +505,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
@ -519,21 +523,22 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,5 +1,5 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
@ -7,11 +7,10 @@
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="The-Z-Shell-Manual.html"><strong aria-hidden="true">1.</strong> The Z Shell Manual</a></li><li class="chapter-item expanded "><a href="Introduction.html"><strong aria-hidden="true">2.</strong> Introduction</a></li><li class="chapter-item expanded "><a href="Roadmap.html" class="active"><strong aria-hidden="true">3.</strong> Roadmap</a></li><li class="chapter-item expanded "><a href="Invocation.html"><strong aria-hidden="true">4.</strong> Invocation</a></li><li class="chapter-item expanded "><a href="Files.html"><strong aria-hidden="true">5.</strong> Files</a></li><li class="chapter-item expanded "><a href="Shell-Grammar.html"><strong aria-hidden="true">6.</strong> Shell Grammar</a></li><li class="chapter-item expanded "><a href="Redirection.html"><strong aria-hidden="true">7.</strong> Redirection</a></li><li class="chapter-item expanded "><a href="Command-Execution.html"><strong aria-hidden="true">8.</strong> Command Execution</a></li><li class="chapter-item expanded "><a href="Functions.html"><strong aria-hidden="true">9.</strong> Functions</a></li><li class="chapter-item expanded "><a href="Jobs-&-Signals.html"><strong aria-hidden="true">10.</strong> Jobs & Signals</a></li><li class="chapter-item expanded "><a href="Arithmetic-Evaluation.html"><strong aria-hidden="true">11.</strong> Arithmetic Evaluation</a></li><li class="chapter-item expanded "><a href="Conditional-Expressions.html"><strong aria-hidden="true">12.</strong> Conditional Expressions</a></li><li class="chapter-item expanded "><a href="Prompt-Expansion.html"><strong aria-hidden="true">13.</strong> Prompt Expansion</a></li><li class="chapter-item expanded "><a href="Expansion.html"><strong aria-hidden="true">14.</strong> Expansion</a></li><li class="chapter-item expanded "><a href="Parameters.html"><strong aria-hidden="true">15.</strong> Parameters</a></li><li class="chapter-item expanded "><a href="Options.html"><strong aria-hidden="true">16.</strong> Options</a></li><li class="chapter-item expanded "><a href="Shell-Builtin-Commands.html"><strong aria-hidden="true">17.</strong> Shell Builtin Commands</a></li><li class="chapter-item expanded "><a href="Zsh-Line-Editor.html"><strong aria-hidden="true">18.</strong> Zsh Line Editor</a></li><li class="chapter-item expanded "><a href="Completion-Widgets.html"><strong aria-hidden="true">19.</strong> Completion Widgets</a></li><li class="chapter-item expanded "><a href="Completion-System.html"><strong aria-hidden="true">20.</strong> Completion System</a></li><li class="chapter-item expanded "><a href="Completion-Using-compctl.html"><strong aria-hidden="true">21.</strong> Completion Using compctl</a></li><li class="chapter-item expanded "><a href="Zsh-Modules.html"><strong aria-hidden="true">22.</strong> Zsh Modules</a></li><li class="chapter-item expanded "><a href="Calendar-Function-System.html"><strong aria-hidden="true">23.</strong> Calendar Function System</a></li><li class="chapter-item expanded "><a href="TCP-Function-System.html"><strong aria-hidden="true">24.</strong> TCP Function System</a></li><li class="chapter-item expanded "><a href="Zftp-Function-System.html"><strong aria-hidden="true">25.</strong> Zftp Function System</a></li><li class="chapter-item expanded "><a href="User-Contributions.html"><strong aria-hidden="true">26.</strong> User Contributions</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -344,7 +348,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Invocation.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Invocation.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -358,7 +362,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Invocation.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Invocation.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
@ -366,7 +370,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
@ -384,21 +388,22 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,5 +1,5 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
@ -7,11 +7,10 @@
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="The-Z-Shell-Manual.html"><strong aria-hidden="true">1.</strong> The Z Shell Manual</a></li><li class="chapter-item expanded "><a href="Introduction.html"><strong aria-hidden="true">2.</strong> Introduction</a></li><li class="chapter-item expanded "><a href="Roadmap.html"><strong aria-hidden="true">3.</strong> Roadmap</a></li><li class="chapter-item expanded "><a href="Invocation.html"><strong aria-hidden="true">4.</strong> Invocation</a></li><li class="chapter-item expanded "><a href="Files.html"><strong aria-hidden="true">5.</strong> Files</a></li><li class="chapter-item expanded "><a href="Shell-Grammar.html"><strong aria-hidden="true">6.</strong> Shell Grammar</a></li><li class="chapter-item expanded "><a href="Redirection.html"><strong aria-hidden="true">7.</strong> Redirection</a></li><li class="chapter-item expanded "><a href="Command-Execution.html"><strong aria-hidden="true">8.</strong> Command Execution</a></li><li class="chapter-item expanded "><a href="Functions.html"><strong aria-hidden="true">9.</strong> Functions</a></li><li class="chapter-item expanded "><a href="Jobs-&-Signals.html"><strong aria-hidden="true">10.</strong> Jobs & Signals</a></li><li class="chapter-item expanded "><a href="Arithmetic-Evaluation.html"><strong aria-hidden="true">11.</strong> Arithmetic Evaluation</a></li><li class="chapter-item expanded "><a href="Conditional-Expressions.html"><strong aria-hidden="true">12.</strong> Conditional Expressions</a></li><li class="chapter-item expanded "><a href="Prompt-Expansion.html"><strong aria-hidden="true">13.</strong> Prompt Expansion</a></li><li class="chapter-item expanded "><a href="Expansion.html"><strong aria-hidden="true">14.</strong> Expansion</a></li><li class="chapter-item expanded "><a href="Parameters.html"><strong aria-hidden="true">15.</strong> Parameters</a></li><li class="chapter-item expanded "><a href="Options.html"><strong aria-hidden="true">16.</strong> Options</a></li><li class="chapter-item expanded "><a href="Shell-Builtin-Commands.html" class="active"><strong aria-hidden="true">17.</strong> Shell Builtin Commands</a></li><li class="chapter-item expanded "><a href="Zsh-Line-Editor.html"><strong aria-hidden="true">18.</strong> Zsh Line Editor</a></li><li class="chapter-item expanded "><a href="Completion-Widgets.html"><strong aria-hidden="true">19.</strong> Completion Widgets</a></li><li class="chapter-item expanded "><a href="Completion-System.html"><strong aria-hidden="true">20.</strong> Completion System</a></li><li class="chapter-item expanded "><a href="Completion-Using-compctl.html"><strong aria-hidden="true">21.</strong> Completion Using compctl</a></li><li class="chapter-item expanded "><a href="Zsh-Modules.html"><strong aria-hidden="true">22.</strong> Zsh Modules</a></li><li class="chapter-item expanded "><a href="Calendar-Function-System.html"><strong aria-hidden="true">23.</strong> Calendar Function System</a></li><li class="chapter-item expanded "><a href="TCP-Function-System.html"><strong aria-hidden="true">24.</strong> TCP Function System</a></li><li class="chapter-item expanded "><a href="Zftp-Function-System.html"><strong aria-hidden="true">25.</strong> Zftp Function System</a></li><li class="chapter-item expanded "><a href="User-Contributions.html"><strong aria-hidden="true">26.</strong> User Contributions</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -682,7 +686,7 @@ act on shell functions. The -r option causes enable to act on reserved
|
||||
words. Without arguments printed. With the -m flag the arguments are
|
||||
taken as patterns disabled with the disable builtin command.</p>
|
||||
<p>enable -p reenables patterns disabled with disable -p. Note that it does
|
||||
not override globbing options; for example, ‘enable -p "~"’ does not
|
||||
not override globbing options; for example, ‘enable -p "~"’ does not
|
||||
cause the pattern character ~ to be active unless the EXTENDED_GLOB
|
||||
option is also set. To enable all possible patterns (so that they may be
|
||||
individually disabled with disable -p), use ‘setopt EXTENDED_GLOB
|
||||
@ -818,7 +822,7 @@ The current list is saved to its $HISTFILE before it is destroyed
|
||||
(assuming that $HISTFILE and $SAVEHIST are set appropriately, of
|
||||
course). The values of $HISTFILE, $HISTSIZE, and $SAVEHIST are restored
|
||||
to the values they had when ‘fc -p’ was called. Note that this
|
||||
restoration can conflict with making these variables "local", so your
|
||||
restoration can conflict with making these variables "local", so your
|
||||
best bet is to avoid local declarations for these variables in functions
|
||||
that use ‘fc -p’. The one other guaranteed-safe combination is declaring
|
||||
these variables to be local at the top of your function and using the
|
||||
@ -1050,9 +1054,9 @@ processes is provided.</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">sleep 10 & # Job in background
|
||||
( # Shell forks
|
||||
jobs # Shows information about "sleep 10 &"
|
||||
jobs # Shows information about "sleep 10 &"
|
||||
sleep 5 & # Process in background (no job control)
|
||||
jobs # Shows information about "sleep 5 &"
|
||||
jobs # Shows information about "sleep 5 &"
|
||||
)
|
||||
</code></pre>
|
||||
</div>
|
||||
@ -1232,7 +1236,7 @@ case-independently.</p>
|
||||
Print the arguments separated by newlines instead of spaces. Note: if
|
||||
the list of arguments is empty, print -l will still output one empty
|
||||
line. To print a possibly-empty list of arguments one per line, use
|
||||
print -C1, as in ‘print -rC1 – "$list[@]"’.</p>
|
||||
print -C1, as in ‘print -rC1 – "$list[@]"’.</p>
|
||||
<p>-m<br />
|
||||
Take the first argument as a pattern (should be quoted), and remove it
|
||||
from the argument list together with subsequent arguments that do not
|
||||
@ -1241,7 +1245,7 @@ match this pattern.</p>
|
||||
Do not add a newline to the output.</p>
|
||||
<p>-N<br />
|
||||
Print the arguments separated and terminated by nulls. Again, print
|
||||
-rNC1 – "$list[@]" is a canonical way to print an arbitrary list as
|
||||
-rNC1 – "$list[@]" is a canonical way to print an arbitrary list as
|
||||
null-delimited records.</p>
|
||||
<p>-o<br />
|
||||
Print the arguments sorted in ascending order.</p>
|
||||
@ -1477,7 +1481,7 @@ id="index-functions_002c-returning-from"></span></p>
|
||||
with the return status specified by an arithmetic expression <code>n</code>. For
|
||||
example, the following prints ‘42’:</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">() { integer foo=40; return "foo + 2" }
|
||||
<pre><code class="language-zsh">() { integer foo=40; return "foo + 2" }
|
||||
echo $?
|
||||
</code></pre>
|
||||
</div>
|
||||
@ -1490,7 +1494,7 @@ to whatever it was previously processing; with a non-zero status, the
|
||||
shell will behave as interrupted except that the return status of the
|
||||
trap is retained. Note that the numeric value of the signal which caused
|
||||
the trap is passed as the first argument, so the statement ‘return
|
||||
"128+$1"’ will return the same status as if the signal had not been
|
||||
"128+$1"’ will return the same status as if the signal had not been
|
||||
trapped.</p>
|
||||
<p>sched</p>
|
||||
<p>See <a href="Zsh-Modules.html#The-zsh_002fsched-Module">The zsh/sched Module</a>.</p>
|
||||
@ -1757,7 +1761,7 @@ typeset svar=$(echo one word) avar=(several words)
|
||||
<p>The above creates a scalar parameter svar and an array parameter avar as
|
||||
if the assignments had been</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">svar="one word"
|
||||
<pre><code class="language-zsh">svar="one word"
|
||||
avar=(several words)
|
||||
</code></pre>
|
||||
</div>
|
||||
@ -1808,10 +1812,10 @@ in a command substitution, separate the declaration of the parameter
|
||||
from its initialization:</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh"># WRONG
|
||||
typeset var1=$(exit 1) || echo "Trouble with var1"
|
||||
typeset var1=$(exit 1) || echo "Trouble with var1"
|
||||
|
||||
# RIGHT
|
||||
typeset var1 && var1=$(exit 1) || echo "Trouble with var1"
|
||||
typeset var1 && var1=$(exit 1) || echo "Trouble with var1"
|
||||
</code></pre>
|
||||
</div>
|
||||
<p>To initialize a parameter <code>param</code> to a command output and mark it
|
||||
@ -1835,7 +1839,7 @@ example, ‘typeset -U +’ is equivalent to ‘typeset +U’ and displays the
|
||||
names of all arrays having the uniqueness attribute, whereas ‘typeset -f
|
||||
-U +’ displays the names of all autoloadable functions. If + is the only
|
||||
option, then type information (array, readonly, etc.) is also printed
|
||||
for each parameter, in the same manner as ‘typeset +m "*"’.</p>
|
||||
for each parameter, in the same manner as ‘typeset +m "*"’.</p>
|
||||
<p>-g<br />
|
||||
The -g (global) means that any resulting parameter will not be
|
||||
restricted to local scope. Note that this does not necessarily mean that
|
||||
@ -2593,7 +2597,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Zsh-Line-Editor.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Zsh-Line-Editor.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -2607,7 +2611,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Zsh-Line-Editor.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Zsh-Line-Editor.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
@ -2615,7 +2619,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
@ -2633,21 +2637,22 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,5 +1,5 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
@ -7,11 +7,10 @@
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="The-Z-Shell-Manual.html"><strong aria-hidden="true">1.</strong> The Z Shell Manual</a></li><li class="chapter-item expanded "><a href="Introduction.html"><strong aria-hidden="true">2.</strong> Introduction</a></li><li class="chapter-item expanded "><a href="Roadmap.html"><strong aria-hidden="true">3.</strong> Roadmap</a></li><li class="chapter-item expanded "><a href="Invocation.html"><strong aria-hidden="true">4.</strong> Invocation</a></li><li class="chapter-item expanded "><a href="Files.html"><strong aria-hidden="true">5.</strong> Files</a></li><li class="chapter-item expanded "><a href="Shell-Grammar.html" class="active"><strong aria-hidden="true">6.</strong> Shell Grammar</a></li><li class="chapter-item expanded "><a href="Redirection.html"><strong aria-hidden="true">7.</strong> Redirection</a></li><li class="chapter-item expanded "><a href="Command-Execution.html"><strong aria-hidden="true">8.</strong> Command Execution</a></li><li class="chapter-item expanded "><a href="Functions.html"><strong aria-hidden="true">9.</strong> Functions</a></li><li class="chapter-item expanded "><a href="Jobs-&-Signals.html"><strong aria-hidden="true">10.</strong> Jobs & Signals</a></li><li class="chapter-item expanded "><a href="Arithmetic-Evaluation.html"><strong aria-hidden="true">11.</strong> Arithmetic Evaluation</a></li><li class="chapter-item expanded "><a href="Conditional-Expressions.html"><strong aria-hidden="true">12.</strong> Conditional Expressions</a></li><li class="chapter-item expanded "><a href="Prompt-Expansion.html"><strong aria-hidden="true">13.</strong> Prompt Expansion</a></li><li class="chapter-item expanded "><a href="Expansion.html"><strong aria-hidden="true">14.</strong> Expansion</a></li><li class="chapter-item expanded "><a href="Parameters.html"><strong aria-hidden="true">15.</strong> Parameters</a></li><li class="chapter-item expanded "><a href="Options.html"><strong aria-hidden="true">16.</strong> Options</a></li><li class="chapter-item expanded "><a href="Shell-Builtin-Commands.html"><strong aria-hidden="true">17.</strong> Shell Builtin Commands</a></li><li class="chapter-item expanded "><a href="Zsh-Line-Editor.html"><strong aria-hidden="true">18.</strong> Zsh Line Editor</a></li><li class="chapter-item expanded "><a href="Completion-Widgets.html"><strong aria-hidden="true">19.</strong> Completion Widgets</a></li><li class="chapter-item expanded "><a href="Completion-System.html"><strong aria-hidden="true">20.</strong> Completion System</a></li><li class="chapter-item expanded "><a href="Completion-Using-compctl.html"><strong aria-hidden="true">21.</strong> Completion Using compctl</a></li><li class="chapter-item expanded "><a href="Zsh-Modules.html"><strong aria-hidden="true">22.</strong> Zsh Modules</a></li><li class="chapter-item expanded "><a href="Calendar-Function-System.html"><strong aria-hidden="true">23.</strong> Calendar Function System</a></li><li class="chapter-item expanded "><a href="TCP-Function-System.html"><strong aria-hidden="true">24.</strong> TCP Function System</a></li><li class="chapter-item expanded "><a href="Zftp-Function-System.html"><strong aria-hidden="true">25.</strong> Zftp Function System</a></li><li class="chapter-item expanded "><a href="User-Contributions.html"><strong aria-hidden="true">26.</strong> User Contributions</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -727,8 +731,8 @@ single quotes are turned into a single quote. For example,</p>
|
||||
</div>
|
||||
<p>outputs nothing apart from a newline if RC_QUOTES is not set, but one
|
||||
single quote if it is set.</p>
|
||||
<p>Inside double quotes (""), parameter and command substitution occur, and
|
||||
‘\’ quotes the characters ‘\’, ‘‘’, ‘"’, ‘$’, and the first character
|
||||
<p>Inside double quotes (""), parameter and command substitution occur, and
|
||||
‘\’ quotes the characters ‘\’, ‘‘’, ‘"’, ‘$’, and the first character
|
||||
of $histchars (default ‘!’).</p>
|
||||
<hr />
|
||||
<p>This document was generated on <em>May 14, 2022</em> using <a href="http://www.nongnu.org/texi2html/"><em>texi2html
|
||||
@ -743,7 +747,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Redirection.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Redirection.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -757,7 +761,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Redirection.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Redirection.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
@ -765,7 +769,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
@ -783,21 +787,22 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,5 +1,5 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
@ -7,11 +7,10 @@
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="The-Z-Shell-Manual.html"><strong aria-hidden="true">1.</strong> The Z Shell Manual</a></li><li class="chapter-item expanded "><a href="Introduction.html"><strong aria-hidden="true">2.</strong> Introduction</a></li><li class="chapter-item expanded "><a href="Roadmap.html"><strong aria-hidden="true">3.</strong> Roadmap</a></li><li class="chapter-item expanded "><a href="Invocation.html"><strong aria-hidden="true">4.</strong> Invocation</a></li><li class="chapter-item expanded "><a href="Files.html"><strong aria-hidden="true">5.</strong> Files</a></li><li class="chapter-item expanded "><a href="Shell-Grammar.html"><strong aria-hidden="true">6.</strong> Shell Grammar</a></li><li class="chapter-item expanded "><a href="Redirection.html"><strong aria-hidden="true">7.</strong> Redirection</a></li><li class="chapter-item expanded "><a href="Command-Execution.html"><strong aria-hidden="true">8.</strong> Command Execution</a></li><li class="chapter-item expanded "><a href="Functions.html"><strong aria-hidden="true">9.</strong> Functions</a></li><li class="chapter-item expanded "><a href="Jobs-&-Signals.html"><strong aria-hidden="true">10.</strong> Jobs & Signals</a></li><li class="chapter-item expanded "><a href="Arithmetic-Evaluation.html"><strong aria-hidden="true">11.</strong> Arithmetic Evaluation</a></li><li class="chapter-item expanded "><a href="Conditional-Expressions.html"><strong aria-hidden="true">12.</strong> Conditional Expressions</a></li><li class="chapter-item expanded "><a href="Prompt-Expansion.html"><strong aria-hidden="true">13.</strong> Prompt Expansion</a></li><li class="chapter-item expanded "><a href="Expansion.html"><strong aria-hidden="true">14.</strong> Expansion</a></li><li class="chapter-item expanded "><a href="Parameters.html"><strong aria-hidden="true">15.</strong> Parameters</a></li><li class="chapter-item expanded "><a href="Options.html"><strong aria-hidden="true">16.</strong> Options</a></li><li class="chapter-item expanded "><a href="Shell-Builtin-Commands.html"><strong aria-hidden="true">17.</strong> Shell Builtin Commands</a></li><li class="chapter-item expanded "><a href="Zsh-Line-Editor.html"><strong aria-hidden="true">18.</strong> Zsh Line Editor</a></li><li class="chapter-item expanded "><a href="Completion-Widgets.html"><strong aria-hidden="true">19.</strong> Completion Widgets</a></li><li class="chapter-item expanded "><a href="Completion-System.html"><strong aria-hidden="true">20.</strong> Completion System</a></li><li class="chapter-item expanded "><a href="Completion-Using-compctl.html"><strong aria-hidden="true">21.</strong> Completion Using compctl</a></li><li class="chapter-item expanded "><a href="Zsh-Modules.html"><strong aria-hidden="true">22.</strong> Zsh Modules</a></li><li class="chapter-item expanded "><a href="Calendar-Function-System.html"><strong aria-hidden="true">23.</strong> Calendar Function System</a></li><li class="chapter-item expanded "><a href="TCP-Function-System.html" class="active"><strong aria-hidden="true">24.</strong> TCP Function System</a></li><li class="chapter-item expanded "><a href="Zftp-Function-System.html"><strong aria-hidden="true">25.</strong> Zftp Function System</a></li><li class="chapter-item expanded "><a href="User-Contributions.html"><strong aria-hidden="true">26.</strong> User Contributions</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -824,7 +828,7 @@ that the port is not immediately available for reuse.</p>
|
||||
<p>The following chunk of code puts a list of sessions into an xterm
|
||||
header, with the current session followed by a star.</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">print -n "\033]2;TCP:" ${(k)tcp_by_name:/$TCP_SESS/$TCP_SESS\*} "\a"
|
||||
<pre><code class="language-zsh">print -n "\033]2;TCP:" ${(k)tcp_by_name:/$TCP_SESS/$TCP_SESS\*} "\a"
|
||||
</code></pre>
|
||||
</div>
|
||||
<hr />
|
||||
@ -849,7 +853,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Zftp-Function-System.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Zftp-Function-System.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -863,7 +867,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
<a rel="next" href="Zftp-Function-System.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Zftp-Function-System.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
@ -871,7 +875,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
@ -889,21 +893,22 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,5 +1,5 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
@ -7,11 +7,10 @@
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="The-Z-Shell-Manual.html" class="active"><strong aria-hidden="true">1.</strong> The Z Shell Manual</a></li><li class="chapter-item expanded "><a href="Introduction.html"><strong aria-hidden="true">2.</strong> Introduction</a></li><li class="chapter-item expanded "><a href="Roadmap.html"><strong aria-hidden="true">3.</strong> Roadmap</a></li><li class="chapter-item expanded "><a href="Invocation.html"><strong aria-hidden="true">4.</strong> Invocation</a></li><li class="chapter-item expanded "><a href="Files.html"><strong aria-hidden="true">5.</strong> Files</a></li><li class="chapter-item expanded "><a href="Shell-Grammar.html"><strong aria-hidden="true">6.</strong> Shell Grammar</a></li><li class="chapter-item expanded "><a href="Redirection.html"><strong aria-hidden="true">7.</strong> Redirection</a></li><li class="chapter-item expanded "><a href="Command-Execution.html"><strong aria-hidden="true">8.</strong> Command Execution</a></li><li class="chapter-item expanded "><a href="Functions.html"><strong aria-hidden="true">9.</strong> Functions</a></li><li class="chapter-item expanded "><a href="Jobs-&-Signals.html"><strong aria-hidden="true">10.</strong> Jobs & Signals</a></li><li class="chapter-item expanded "><a href="Arithmetic-Evaluation.html"><strong aria-hidden="true">11.</strong> Arithmetic Evaluation</a></li><li class="chapter-item expanded "><a href="Conditional-Expressions.html"><strong aria-hidden="true">12.</strong> Conditional Expressions</a></li><li class="chapter-item expanded "><a href="Prompt-Expansion.html"><strong aria-hidden="true">13.</strong> Prompt Expansion</a></li><li class="chapter-item expanded "><a href="Expansion.html"><strong aria-hidden="true">14.</strong> Expansion</a></li><li class="chapter-item expanded "><a href="Parameters.html"><strong aria-hidden="true">15.</strong> Parameters</a></li><li class="chapter-item expanded "><a href="Options.html"><strong aria-hidden="true">16.</strong> Options</a></li><li class="chapter-item expanded "><a href="Shell-Builtin-Commands.html"><strong aria-hidden="true">17.</strong> Shell Builtin Commands</a></li><li class="chapter-item expanded "><a href="Zsh-Line-Editor.html"><strong aria-hidden="true">18.</strong> Zsh Line Editor</a></li><li class="chapter-item expanded "><a href="Completion-Widgets.html"><strong aria-hidden="true">19.</strong> Completion Widgets</a></li><li class="chapter-item expanded "><a href="Completion-System.html"><strong aria-hidden="true">20.</strong> Completion System</a></li><li class="chapter-item expanded "><a href="Completion-Using-compctl.html"><strong aria-hidden="true">21.</strong> Completion Using compctl</a></li><li class="chapter-item expanded "><a href="Zsh-Modules.html"><strong aria-hidden="true">22.</strong> Zsh Modules</a></li><li class="chapter-item expanded "><a href="Calendar-Function-System.html"><strong aria-hidden="true">23.</strong> Calendar Function System</a></li><li class="chapter-item expanded "><a href="TCP-Function-System.html"><strong aria-hidden="true">24.</strong> TCP Function System</a></li><li class="chapter-item expanded "><a href="Zftp-Function-System.html"><strong aria-hidden="true">25.</strong> Zftp Function System</a></li><li class="chapter-item expanded "><a href="User-Contributions.html"><strong aria-hidden="true">26.</strong> User Contributions</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -198,7 +202,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
<nav class="nav-wrapper" aria-label="Page navigation">
|
||||
<!-- Mobile navigation buttons -->
|
||||
|
||||
<a rel="next" href="Introduction.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Introduction.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@ -209,7 +213,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
|
||||
<nav class="nav-wide-wrapper" aria-label="Page navigation">
|
||||
|
||||
<a rel="next" href="Introduction.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next prefetch" href="Introduction.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
</nav>
|
||||
@ -217,7 +221,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
@ -235,21 +239,22 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,5 +1,5 @@
|
||||
<!DOCTYPE HTML>
|
||||
<html lang="en" class="sidebar-visible no-js light">
|
||||
<html lang="en" class="mocha sidebar-visible" dir="ltr">
|
||||
<head>
|
||||
<!-- Book generated using mdBook -->
|
||||
<meta charset="UTF-8">
|
||||
@ -7,11 +7,10 @@
|
||||
|
||||
|
||||
<!-- Custom HTML head -->
|
||||
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<meta name="theme-color" content="#ffffff" />
|
||||
<meta name="theme-color" content="#ffffff">
|
||||
|
||||
<link rel="icon" href="favicon.svg">
|
||||
<link rel="shortcut icon" href="favicon.png">
|
||||
@ -31,18 +30,20 @@
|
||||
|
||||
<!-- Custom theme stylesheets -->
|
||||
<link rel="stylesheet" href="./theme/catppuccin.css">
|
||||
<link rel="stylesheet" href="./theme/catppuccin-highlight.css">
|
||||
|
||||
|
||||
<!-- Provide site root to javascript -->
|
||||
<script>
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "mocha" : "mocha";
|
||||
</script>
|
||||
<!-- Start loading toc.js asap -->
|
||||
<script src="toc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<!-- Provide site root to javascript -->
|
||||
<script type="text/javascript">
|
||||
var path_to_root = "";
|
||||
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
|
||||
</script>
|
||||
|
||||
<div id="body-container">
|
||||
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
try {
|
||||
var theme = localStorage.getItem('mdbook-theme');
|
||||
var sidebar = localStorage.getItem('mdbook-sidebar');
|
||||
@ -58,56 +59,59 @@
|
||||
</script>
|
||||
|
||||
<!-- Set the theme before any content is loaded, prevents flash -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
var theme;
|
||||
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
||||
if (theme === null || theme === undefined) { theme = default_theme; }
|
||||
var html = document.querySelector('html');
|
||||
html.classList.remove('no-js')
|
||||
html.classList.remove('light')
|
||||
const html = document.documentElement;
|
||||
html.classList.remove('mocha')
|
||||
html.classList.add(theme);
|
||||
html.classList.add('js');
|
||||
html.classList.add("js");
|
||||
</script>
|
||||
|
||||
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
||||
|
||||
<!-- Hide / unhide sidebar before it is displayed -->
|
||||
<script type="text/javascript">
|
||||
var html = document.querySelector('html');
|
||||
var sidebar = 'hidden';
|
||||
<script>
|
||||
var sidebar = null;
|
||||
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
||||
if (document.body.clientWidth >= 1080) {
|
||||
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
||||
sidebar = sidebar || 'visible';
|
||||
} else {
|
||||
sidebar = 'hidden';
|
||||
}
|
||||
sidebar_toggle.checked = sidebar === 'visible';
|
||||
html.classList.remove('sidebar-visible');
|
||||
html.classList.add("sidebar-" + sidebar);
|
||||
</script>
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="The-Z-Shell-Manual.html"><strong aria-hidden="true">1.</strong> The Z Shell Manual</a></li><li class="chapter-item expanded "><a href="Introduction.html"><strong aria-hidden="true">2.</strong> Introduction</a></li><li class="chapter-item expanded "><a href="Roadmap.html"><strong aria-hidden="true">3.</strong> Roadmap</a></li><li class="chapter-item expanded "><a href="Invocation.html"><strong aria-hidden="true">4.</strong> Invocation</a></li><li class="chapter-item expanded "><a href="Files.html"><strong aria-hidden="true">5.</strong> Files</a></li><li class="chapter-item expanded "><a href="Shell-Grammar.html"><strong aria-hidden="true">6.</strong> Shell Grammar</a></li><li class="chapter-item expanded "><a href="Redirection.html"><strong aria-hidden="true">7.</strong> Redirection</a></li><li class="chapter-item expanded "><a href="Command-Execution.html"><strong aria-hidden="true">8.</strong> Command Execution</a></li><li class="chapter-item expanded "><a href="Functions.html"><strong aria-hidden="true">9.</strong> Functions</a></li><li class="chapter-item expanded "><a href="Jobs-&-Signals.html"><strong aria-hidden="true">10.</strong> Jobs & Signals</a></li><li class="chapter-item expanded "><a href="Arithmetic-Evaluation.html"><strong aria-hidden="true">11.</strong> Arithmetic Evaluation</a></li><li class="chapter-item expanded "><a href="Conditional-Expressions.html"><strong aria-hidden="true">12.</strong> Conditional Expressions</a></li><li class="chapter-item expanded "><a href="Prompt-Expansion.html"><strong aria-hidden="true">13.</strong> Prompt Expansion</a></li><li class="chapter-item expanded "><a href="Expansion.html"><strong aria-hidden="true">14.</strong> Expansion</a></li><li class="chapter-item expanded "><a href="Parameters.html"><strong aria-hidden="true">15.</strong> Parameters</a></li><li class="chapter-item expanded "><a href="Options.html"><strong aria-hidden="true">16.</strong> Options</a></li><li class="chapter-item expanded "><a href="Shell-Builtin-Commands.html"><strong aria-hidden="true">17.</strong> Shell Builtin Commands</a></li><li class="chapter-item expanded "><a href="Zsh-Line-Editor.html"><strong aria-hidden="true">18.</strong> Zsh Line Editor</a></li><li class="chapter-item expanded "><a href="Completion-Widgets.html"><strong aria-hidden="true">19.</strong> Completion Widgets</a></li><li class="chapter-item expanded "><a href="Completion-System.html"><strong aria-hidden="true">20.</strong> Completion System</a></li><li class="chapter-item expanded "><a href="Completion-Using-compctl.html"><strong aria-hidden="true">21.</strong> Completion Using compctl</a></li><li class="chapter-item expanded "><a href="Zsh-Modules.html"><strong aria-hidden="true">22.</strong> Zsh Modules</a></li><li class="chapter-item expanded "><a href="Calendar-Function-System.html"><strong aria-hidden="true">23.</strong> Calendar Function System</a></li><li class="chapter-item expanded "><a href="TCP-Function-System.html"><strong aria-hidden="true">24.</strong> TCP Function System</a></li><li class="chapter-item expanded "><a href="Zftp-Function-System.html"><strong aria-hidden="true">25.</strong> Zftp Function System</a></li><li class="chapter-item expanded "><a href="User-Contributions.html" class="active"><strong aria-hidden="true">26.</strong> User Contributions</a></li></ol>
|
||||
<!-- populated by js -->
|
||||
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
|
||||
<noscript>
|
||||
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
|
||||
</noscript>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
||||
<div class="sidebar-resize-indicator"></div>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
<div id="page-wrapper" class="page-wrapper">
|
||||
|
||||
<div class="page">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky bordered">
|
||||
<div id="menu-bar-hover-placeholder"></div>
|
||||
<div id="menu-bar" class="menu-bar sticky">
|
||||
<div class="left-buttons">
|
||||
<button id="sidebar-toggle" class="icon-button" type="button" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
||||
<i class="fa fa-bars"></i>
|
||||
</button>
|
||||
</label>
|
||||
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
||||
<i class="fa fa-paint-brush"></i>
|
||||
</button>
|
||||
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
||||
<li role="none"><button role="menuitem" class="theme" id="light">Light (default)</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="latte">Latte</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappé</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="frappe">Frappe</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="macchiato">Macchiato</button></li>
|
||||
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
|
||||
</ul>
|
||||
@ -138,7 +142,7 @@
|
||||
</div>
|
||||
|
||||
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
||||
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
||||
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
||||
@ -394,8 +398,8 @@ composed from the TERM, VENDOR and OSTYPE parameters, joined by hyphens.</p>
|
||||
commands, like this:</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">source ${ZDOTDIR:-$HOME}/.zkbd/$TERM-$VENDOR-$OSTYPE
|
||||
[[ -n ${key[Left]} ]] && bindkey "${key[Left]}" backward-char
|
||||
[[ -n ${key[Right]} ]] && bindkey "${key[Right]}" forward-char
|
||||
[[ -n ${key[Left]} ]] && bindkey "${key[Left]}" backward-char
|
||||
[[ -n ${key[Right]} ]] && bindkey "${key[Right]}" forward-char
|
||||
# etc.
|
||||
</code></pre>
|
||||
</div>
|
||||
@ -522,7 +526,7 @@ special widget names are also accepted as the <code>hook</code> argument.</p>
|
||||
is added to the array of widgets to be invoked in the given hook
|
||||
context. Widgets are invoked in the order they were added, with</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">zle widgetname -Nw -f "nolast" -- "$@"
|
||||
<pre><code class="language-zsh">zle widgetname -Nw -f "nolast" -- "$@"
|
||||
</code></pre>
|
||||
</div>
|
||||
<p><span id="index-WIDGET_002c-in-hooks"></span></p>
|
||||
@ -661,7 +665,7 @@ should be fine in practice.</p>
|
||||
<p>recent-dirs-default<br />
|
||||
If true, and the command is expecting a recent directory index, and
|
||||
either there is more than one argument or the argument is not an
|
||||
integer, then fall through to "cd". This allows the lazy to use only one
|
||||
integer, then fall through to "cd". This allows the lazy to use only one
|
||||
command for directory changing. Completion recognises this, too; see
|
||||
recent-dirs-insert for how to control completion when this option is in
|
||||
use.</p>
|
||||
@ -804,7 +808,7 @@ new code. It supports all three of the standard interfaces for directory
|
||||
naming: converting from a name to a directory, converting in the reverse
|
||||
direction to find a short name, and completion of names.</p>
|
||||
<p>The main feature of this function is a path-like syntax, combining
|
||||
abbreviations at multiple levels separated by ":". As an example,
|
||||
abbreviations at multiple levels separated by ":". As an example,
|
||||
~[g:p:s] might specify:</p>
|
||||
<p>g<br />
|
||||
The top level directory for your git area. This first component has to
|
||||
@ -941,7 +945,7 @@ local -A third=(
|
||||
|
||||
# autoload not needed if you did this at initialisation...
|
||||
autoload -Uz zsh_directory_name_generic
|
||||
zsh_directory_name_generic "$@
|
||||
zsh_directory_name_generic "$@
|
||||
</code></pre>
|
||||
</div>
|
||||
<p>It is also possible to use global associative arrays, suitably named,
|
||||
@ -957,7 +961,7 @@ add-zsh-hook -U zsh_directory_name zdn_mywrapper
|
||||
</div>
|
||||
<p>and the function zdn_mywrapper would contain only the following:</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">zsh_directory_name_generic "$@"
|
||||
<pre><code class="language-zsh">zsh_directory_name_generic "$@"
|
||||
</code></pre>
|
||||
</div>
|
||||
<hr />
|
||||
@ -1130,7 +1134,7 @@ not only by a branch name but also by a revision number. This style lets
|
||||
you modify how that string should look.</p>
|
||||
<p><span id="index-nvcsformats"></span></p>
|
||||
<p>nvcsformats</p>
|
||||
<p>These "formats" are set when we didn’t detect a version control system
|
||||
<p>These "formats" are set when we didn’t detect a version control system
|
||||
for the current directory or vcs_info was disabled. This is useful if
|
||||
you want vcs_info to completely take over the generation of your prompt.
|
||||
You would do something like PS1=’${vcs_info_msg_0_}’ to accomplish
|
||||
@ -1167,7 +1171,7 @@ vcs_info will be disabled. This style is checked in the
|
||||
<p>Say, ~/.zsh is a directory under version control, in which you do not
|
||||
want vcs_info to be active, do:</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">zstyle ':vcs_info:*' disable-patterns "${(b)HOME}/.zsh(|/*)"
|
||||
<pre><code class="language-zsh">zstyle ':vcs_info:*' disable-patterns "${(b)HOME}/.zsh(|/*)"
|
||||
</code></pre>
|
||||
</div>
|
||||
<p><span id="index-use_002dquilt"></span></p>
|
||||
@ -1309,15 +1313,15 @@ list of unapplied patches (for example with Mercurial Queue patches).</p>
|
||||
<p>Used by the quilt, hg, and git backends.</p>
|
||||
<p>The default values for these styles in all contexts are:</p>
|
||||
<p>formats<br />
|
||||
" (%s)-[%b]%u%c-"</p>
|
||||
" (%s)-[%b]%u%c-"</p>
|
||||
<p>actionformats<br />
|
||||
" (%s)-[%b|%a]%u%c-"</p>
|
||||
" (%s)-[%b|%a]%u%c-"</p>
|
||||
<p>branchformat<br />
|
||||
"%b:%r" (for bzr, svn, svk and hg)</p>
|
||||
"%b:%r" (for bzr, svn, svk and hg)</p>
|
||||
<p>nvcsformats<br />
|
||||
""</p>
|
||||
""</p>
|
||||
<p>hgrevformat<br />
|
||||
"%r:%h"</p>
|
||||
"%r:%h"</p>
|
||||
<p>max-exports<br />
|
||||
2</p>
|
||||
<p>enable<br />
|
||||
@ -1331,9 +1335,9 @@ false</p>
|
||||
<p>check-for-staged-changes<br />
|
||||
false</p>
|
||||
<p>stagedstr<br />
|
||||
(string: "S")</p>
|
||||
(string: "S")</p>
|
||||
<p>unstagedstr<br />
|
||||
(string: "U")</p>
|
||||
(string: "U")</p>
|
||||
<p>command<br />
|
||||
(empty string)</p>
|
||||
<p>use-server<br />
|
||||
@ -1392,7 +1396,7 @@ A subdirectory within a repository. If $PWD is
|
||||
/foo/bar/repoXY/beer/tasty, %S is beer/tasty.</p>
|
||||
<!-- -->
|
||||
<p>%m<br />
|
||||
A "misc" replacement. It is at the discretion of the backend to decide
|
||||
A "misc" replacement. It is at the discretion of the backend to decide
|
||||
what this replacement expands to.</p>
|
||||
<p>The hg and git backends use this expando to display patch information.
|
||||
hg sources patch information from the mq extensions; git from
|
||||
@ -1515,7 +1519,7 @@ That means that the version control system identifier (which otherwise
|
||||
would be something like ‘svn’ or ‘cvs’) will be set to ‘-quilt-’. This
|
||||
has implications on the used style context where this identifier is the
|
||||
second element. vcs_info will have filled in a proper value for the
|
||||
"repository’s" root directory and the string containing the information
|
||||
"repository’s" root directory and the string containing the information
|
||||
about quilt’s state will be available as the ‘misc’ replacement (and %Q
|
||||
for compatibility with ‘addon’ mode).</p>
|
||||
<p>What is left to discuss is how ‘standalone’ mode is detected. The
|
||||
@ -1740,7 +1744,7 @@ Called after the quilt support is done. The following information is
|
||||
passed as arguments to the hook: 1. the quilt-support mode (‘addon’ or
|
||||
‘standalone’); 2. the directory that contains the patch series; 3. the
|
||||
directory that holds quilt’s status information (the ‘.pc’ directory) or
|
||||
the string "-nopc-" if that directory wasn’t found.</p>
|
||||
the string "-nopc-" if that directory wasn’t found.</p>
|
||||
<p>The ‘hook_com’ parameter is not used.</p>
|
||||
<p>set-branch-format<br />
|
||||
Called before ‘branchformat’ is set. The only argument to the hook is
|
||||
@ -1762,7 +1766,7 @@ be used unchanged as the ‘%i’ replacement in the variables set by
|
||||
vcs_info.</p>
|
||||
<p>pre-addon-quilt<br />
|
||||
This hook is used when vcs_info’s quilt functionality is active in
|
||||
"addon" mode (quilt used on top of a real version control system). It is
|
||||
"addon" mode (quilt used on top of a real version control system). It is
|
||||
activated right before any quilt specific action is taken.</p>
|
||||
<p>Setting the ‘ret’ variable in this hook to a non-zero value avoids any
|
||||
quilt specific actions from being run at all.</p>
|
||||
@ -1931,14 +1935,14 @@ a customised bookmark string for the hg backend.</p>
|
||||
# commas. This mixes things up a little.
|
||||
# Imagine, there's one type of bookmarks that is
|
||||
# special to you. Say, because it's *your* work.
|
||||
# Those bookmarks look always like this: "sh/*"
|
||||
# Those bookmarks look always like this: "sh/*"
|
||||
# (because your initials are sh, for example).
|
||||
# This makes the bookmarks string use only those
|
||||
# bookmarks. If there's more than one, it
|
||||
# concatenates them using commas.
|
||||
# The bookmarks returned by `hg' are available in
|
||||
# the function's positional parameters.
|
||||
local s="${(Mj:,:)@:#sh/*}"
|
||||
local s="${(Mj:,:)@:#sh/*}"
|
||||
# Now, the communication with the code that calls
|
||||
# the hook functions is done via the hook_com[]
|
||||
# hash. The key at which the `gen-hg-bookmark-string'
|
||||
@ -2045,8 +2049,8 @@ may contain any necessary commands to customize your theme, including
|
||||
defining additional functions. To make some complex tasks easier, your
|
||||
setup function may also do any of the following:</p>
|
||||
<p>Assign prompt_opts<br />
|
||||
The array prompt_opts may be assigned any of "bang", "cr", "percent",
|
||||
"sp", and/or "subst" as values. The corresponding setopts (promptbang,
|
||||
The array prompt_opts may be assigned any of "bang", "cr", "percent",
|
||||
"sp", and/or "subst" as values. The corresponding setopts (promptbang,
|
||||
etc.) are turned on, all other prompt-related options are turned off.
|
||||
The prompt_opts array preserves setopts even beyond the scope of
|
||||
localoptions, should your function need that.</p>
|
||||
@ -2260,7 +2264,7 @@ Neither of the styles word-chars nor word-class is used in this case.</p>
|
||||
context.</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">zstyle ':zle:*' word-context \
|
||||
"*/*" filename "[[:space:]]" whitespace
|
||||
"*/*" filename "[[:space:]]" whitespace
|
||||
zstyle ':zle:transpose-words:whitespace' word-style shell
|
||||
zstyle ':zle:transpose-words:filename' word-style normal
|
||||
zstyle ':zle:transpose-words:filename' word-chars ''
|
||||
@ -2617,7 +2621,7 @@ Cedilla.</p>
|
||||
Underline, however there are currently no underlined characters.</p>
|
||||
<p>/<br />
|
||||
Stroke through the base character.</p>
|
||||
<p>"<br />
|
||||
<p>"<br />
|
||||
Double acute (only supported on a few letters).</p>
|
||||
<p>;<br />
|
||||
Ogonek. (A little forward facing hook at the bottom right of the
|
||||
@ -2685,8 +2689,8 @@ Yen</p>
|
||||
<p>Eu<br />
|
||||
Euro (N.B. not in RFC 1345)</p>
|
||||
<p>Punctuation characters<br />
|
||||
References to "right" quotes indicate the shape (like a 9 rather than 6)
|
||||
rather than their grammatical use. (For example, a "right" low double
|
||||
References to "right" quotes indicate the shape (like a 9 rather than 6)
|
||||
rather than their grammatical use. (For example, a "right" low double
|
||||
quote is used to open quotations in German.)</p>
|
||||
<p>!I<br />
|
||||
Inverted exclamation mark</p>
|
||||
@ -2733,17 +2737,17 @@ Left single quote</p>
|
||||
<p>’9<br />
|
||||
Right single quote</p>
|
||||
<p>.9<br />
|
||||
"Right" low quote</p>
|
||||
"Right" low quote</p>
|
||||
<p>9’<br />
|
||||
Reversed "right" quote</p>
|
||||
<p>"6<br />
|
||||
Reversed "right" quote</p>
|
||||
<p>"6<br />
|
||||
Left double quote</p>
|
||||
<p>"9<br />
|
||||
<p>"9<br />
|
||||
Right double quote</p>
|
||||
<p>:9<br />
|
||||
"Right" low double quote</p>
|
||||
<p>9"<br />
|
||||
Reversed "right" double quote</p>
|
||||
"Right" low double quote</p>
|
||||
<p>9"<br />
|
||||
Reversed "right" double quote</p>
|
||||
<p>/-<br />
|
||||
Dagger</p>
|
||||
<p>/=<br />
|
||||
@ -3037,7 +3041,7 @@ quotes, a backslash is inserted before the input character.</p>
|
||||
<p>Styles to control quoting behavior:</p>
|
||||
<p>url-metas<br />
|
||||
This style is looked up in the context ‘:url-quote-magic:<code>scheme</code>’
|
||||
(where <code>scheme</code> is that of the current URL, e.g. "ftp"). The value is a
|
||||
(where <code>scheme</code> is that of the current URL, e.g. "ftp"). The value is a
|
||||
string listing the characters to be treated as globbing metacharacters
|
||||
when appearing in a URL using that scheme. The default is to quote all
|
||||
zsh extended globbing characters, excluding ’<’ and ’>’ but including
|
||||
@ -3064,14 +3068,14 @@ This style is always looked up in the context ‘:urlglobber’, even though
|
||||
it is used by both url-quote-magic and urlglobber. The values form a
|
||||
list of URI schema that should be treated as referring to local files by
|
||||
their real local path names, as opposed to files which are specified
|
||||
relative to a web-server-defined document root. The defaults are "ftp"
|
||||
and "file".</p>
|
||||
relative to a web-server-defined document root. The defaults are "ftp"
|
||||
and "file".</p>
|
||||
<p>url-other-schema<br />
|
||||
Like url-local-schema, but lists all other URI schema upon which
|
||||
urlglobber and url-quote-magic should act. If the URI on the command
|
||||
line does not have a scheme appearing either in this list or in
|
||||
url-local-schema, it is not magically quoted. The default values are
|
||||
"http", "https", and "ftp". When a scheme appears both here and in
|
||||
"http", "https", and "ftp". When a scheme appears both here and in
|
||||
url-local-schema, it is quoted differently depending on whether the
|
||||
command name appears in url-globbers.</p>
|
||||
<p>Loading url-quote-magic also defines a helper function ‘urlglobber’ and
|
||||
@ -3103,7 +3107,7 @@ This function is useful together with the zcalc function described in
|
||||
<a href="#Mathematical-Functions">Mathematical Functions</a>. It should be bound to
|
||||
a key representing a binary operator such as ‘+’, ‘-’, ‘*’ or ‘/’. When
|
||||
running in zcalc, if the key occurs at the start of the line or
|
||||
immediately following an open parenthesis, the text "ans " is inserted
|
||||
immediately following an open parenthesis, the text "ans " is inserted
|
||||
before the representation of the key itself. This allows easy use of the
|
||||
answer from the previous calculation in the current line. The text to be
|
||||
inserted before the symbol typed can be modified by setting the variable
|
||||
@ -3263,7 +3267,7 @@ above). The default behavior of smart-insert-last-word is equivalent to:</p>
|
||||
<pre><code class="language-zsh">zstyle :insert-last-word match '*([[:digit:]]?|[[:alpha:]/\\])*'
|
||||
</code></pre>
|
||||
</div>
|
||||
<p>The above example causes redirections like "2>" to be included.</p>
|
||||
<p>The above example causes redirections like "2>" to be included.</p>
|
||||
<p><span id="index-prompt_002c-widget-style"></span></p>
|
||||
<p>prompt</p>
|
||||
<p>The incremental-complete-word widget shows the value of this style in
|
||||
@ -3356,14 +3360,14 @@ This is important as only this construct provides the required support
|
||||
for exceptions. A typical example is as follows.</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">{
|
||||
# "try" block
|
||||
# ... nested code here calls "throw MyExcept"
|
||||
# "try" block
|
||||
# ... nested code here calls "throw MyExcept"
|
||||
} always {
|
||||
# "always" block
|
||||
# "always" block
|
||||
if catch MyExcept; then
|
||||
print "Caught exception MyExcept"
|
||||
print "Caught exception MyExcept"
|
||||
elif catch ''; then
|
||||
print "Caught a shell error. Propagating..."
|
||||
print "Caught a shell error. Propagating..."
|
||||
throw ''
|
||||
fi
|
||||
# Other exceptions are not handled but may be caught further
|
||||
@ -3380,10 +3384,10 @@ preferable.</p>
|
||||
if catch *; then
|
||||
case $CAUGHT in
|
||||
(MyExcept)
|
||||
print "Caught my own exception"
|
||||
print "Caught my own exception"
|
||||
;;
|
||||
(*)
|
||||
print "Caught some other exception"
|
||||
print "Caught some other exception"
|
||||
;;
|
||||
esac
|
||||
fi
|
||||
@ -3695,7 +3699,7 @@ replaced by the URL. If the style is not set, the default for all new
|
||||
instances is equivalent to %b %u and the defaults for using running
|
||||
browsers are equivalent to the values kfmclient openURL %u for
|
||||
Konqueror, firefox -new-tab %u for Firefox, opera -newpage %u for Opera,
|
||||
and %b -remote "openUrl(%u)" for all others.</p>
|
||||
and %b -remote "openUrl(%u)" for all others.</p>
|
||||
<hr />
|
||||
<p><span id="Mathematical-Functions"></span> <span
|
||||
id="Mathematical-Functions-1"></span></p>
|
||||
@ -4004,7 +4008,7 @@ not available in all versions of zsh.</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">is-at-least 3.1.6-15 && setopt NO_GLOBAL_RCS
|
||||
is-at-least 3.1.0 && setopt HIST_REDUCE_BLANKS
|
||||
is-at-least 2.6-17 || print "You can't use is-at-least here."
|
||||
is-at-least 2.6-17 || print "You can't use is-at-least here."
|
||||
</code></pre>
|
||||
</div>
|
||||
<p><span id="index-nslookup"></span></p>
|
||||
@ -4049,12 +4053,12 @@ function, alias, or command named run-help-<code>cmd</code> is sought. If found,
|
||||
the assistant is executed with the rest of the current command line
|
||||
(everything after the command name <code>cmd</code>) as its arguments. When neither
|
||||
file nor assistant is found, the external command ‘man <code>cmd</code>’ is run.</p>
|
||||
<p>An example assistant for the "ssh" command:</p>
|
||||
<p>An example assistant for the "ssh" command:</p>
|
||||
<div class="example">
|
||||
<pre><code class="language-zsh">run-help-ssh() {
|
||||
emulate -LR zsh
|
||||
local -a args
|
||||
# Delete the "-l username" option
|
||||
# Delete the "-l username" option
|
||||
zparseopts -D -E -a args l:
|
||||
# Delete other options, leaving: host command
|
||||
args=(${@:#-*})
|
||||
@ -4381,7 +4385,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
</div>
|
||||
|
||||
<!-- Livereload script (if served using the cli tool) -->
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
|
||||
const socket = new WebSocket(wsAddress);
|
||||
@ -4399,21 +4403,22 @@ Zsh version 5.9, released on May 14, 2022.</p>
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
<script>
|
||||
window.playground_copyable = true;
|
||||
</script>
|
||||
|
||||
|
||||
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="searcher.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="elasticlunr.min.js"></script>
|
||||
<script src="mark.min.js"></script>
|
||||
<script src="searcher.js"></script>
|
||||
|
||||
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="highlight.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="book.js" type="text/javascript" charset="utf-8"></script>
|
||||
<script src="clipboard.min.js"></script>
|
||||
<script src="highlight.js"></script>
|
||||
<script src="book.js"></script>
|
||||
|
||||
<!-- Custom JS scripts -->
|
||||
|
||||
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
x
Reference in New Issue
Block a user