hyperreal/zsh-manual-mdbook
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add updated Catppuccin theme

Browse Source
This commit is contained in:
Jeffrey Serio 2025-03-07 04:44:45 -06:00
parent 0996546048
commit e27ba9e2ac
185 changed files with 7483 additions and 4941 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
make_mdbook.pl
View File

@ -103,12 +103,12 @@ close(FH);
# Copy md files to zsh manual mdbook src # Copy md files to zsh manual mdbook src
# First ensure it is empty # First ensure it is empty
my $cwd = getcwd(); my $cwd = getcwd();
system("rm -rf $cwd/zsh_manual/src") == 0 or die "$?"; system("rm -rf $cwd/zsh-manual/src") == 0 or die "$?";
mkdir("$cwd/zsh_manual/src") or die "$?"; mkdir("$cwd/zsh-manual/src") or die "$?";
system("cp $mdbook_src_dir/* $cwd/zsh_manual/src/") == 0 or die "$?"; system("cp $mdbook_src_dir/* $cwd/zsh-manual/src/") == 0 or die "$?";
# Replace ``` example with ```zsh for syntax highlighting # Replace ``` example with ```zsh for syntax highlighting
@files = <$cwd/zsh_manual/src/*.md>; @files = <$cwd/zsh-manual/src/*.md>;
foreach my $file (@files) { foreach my $file (@files) {
system("sed -i 's/``` example/```zsh/g' '$file'") == 0 or die "$?"; system("sed -i 's/``` example/```zsh/g' '$file'") == 0 or die "$?";
} }

11
zsh-guide/book.toml Normal file
View 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"

0
zsh_guide/book/.nojekyll → zsh-guide/book/.nojekyll
View File

107
zsh_guide/book/404.html → zsh-guide/book/404.html
View File

@ -1,18 +1,17 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
<title>Page not found - Zsh User&#x27;s Guide</title> <title>Page not found - Zsh Guide</title>
<base href="/"> <base href="/">
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -32,18 +31,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -59,56 +60,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -117,7 +121,7 @@
</button> </button>
</div> </div>
<h1 class="menu-title">Zsh User&#x27;s Guide</h1> <h1 class="menu-title">Zsh Guide</h1>
<div class="right-buttons"> <div class="right-buttons">
<a href="print.html" title="Print this book" aria-label="Print this book"> <a href="print.html" title="Print this book" aria-label="Print this book">
@ -139,7 +143,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
@ -169,24 +173,41 @@
</div> </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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

0
zsh_guide/book/FontAwesome/css/font-awesome.css → zsh-guide/book/FontAwesome/css/font-awesome.css vendored
View File

0
zsh_guide/book/FontAwesome/fonts/FontAwesome.ttf → zsh-guide/book/FontAwesome/fonts/FontAwesome.ttf
View File

0
zsh_guide/book/FontAwesome/fonts/fontawesome-webfont.eot → zsh-guide/book/FontAwesome/fonts/fontawesome-webfont.eot
View File

0
zsh_guide/book/FontAwesome/fonts/fontawesome-webfont.svg → zsh-guide/book/FontAwesome/fonts/fontawesome-webfont.svg
View File

Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 434 KiB

After

Width:  |  Height:  |  Size: 434 KiB

0
zsh_guide/book/FontAwesome/fonts/fontawesome-webfont.ttf → zsh-guide/book/FontAwesome/fonts/fontawesome-webfont.ttf
View File

0
zsh_guide/book/FontAwesome/fonts/fontawesome-webfont.woff → zsh-guide/book/FontAwesome/fonts/fontawesome-webfont.woff
View File

0
zsh_guide/book/FontAwesome/fonts/fontawesome-webfont.woff2 → zsh-guide/book/FontAwesome/fonts/fontawesome-webfont.woff2
View File

0
zsh_guide/book/ayu-highlight.css → zsh-guide/book/ayu-highlight.css
View File

118
zsh_guide/book/book.js → zsh-guide/book/book.js
View File

@ -4,14 +4,16 @@
window.onunload = function () { }; window.onunload = function () { };
// Global variable, shared between modules // Global variable, shared between modules
function playground_text(playground) { function playground_text(playground, hidden = true) {
let code_block = playground.querySelector("code"); let code_block = playground.querySelector("code");
if (window.ace && code_block.classList.contains("editable")) { if (window.ace && code_block.classList.contains("editable")) {
let editor = window.ace.edit(code_block); let editor = window.ace.edit(code_block);
return editor.getValue(); return editor.getValue();
} else { } else if (hidden) {
return code_block.textContent; 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 // 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) { function update_play_button(pre_block, playground_crates) {
var play_button = pre_block.querySelector(".play-button"); var play_button = pre_block.querySelector(".play-button");
@ -166,7 +168,6 @@ function playground_text(playground) {
.filter(function (node) {return node.classList.contains("editable"); }) .filter(function (node) {return node.classList.contains("editable"); })
.forEach(function (block) { block.classList.remove('language-rust'); }); .forEach(function (block) { block.classList.remove('language-rust'); });
Array
code_nodes code_nodes
.filter(function (node) {return !node.classList.contains("editable"); }) .filter(function (node) {return !node.classList.contains("editable"); })
.forEach(function (block) { hljs.highlightBlock(block); }); .forEach(function (block) { hljs.highlightBlock(block); });
@ -178,7 +179,7 @@ function playground_text(playground) {
// even if highlighting doesn't apply // even if highlighting doesn't apply
code_nodes.forEach(function (block) { block.classList.add('hljs'); }); 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')); var lines = Array.from(block.querySelectorAll('.boring'));
// If no lines were hidden, return // If no lines were hidden, return
@ -224,7 +225,7 @@ function playground_text(playground) {
} }
var clipButton = document.createElement('button'); var clipButton = document.createElement('button');
clipButton.className = 'fa fa-copy clip-button'; clipButton.className = 'clip-button';
clipButton.title = 'Copy to clipboard'; clipButton.title = 'Copy to clipboard';
clipButton.setAttribute('aria-label', clipButton.title); clipButton.setAttribute('aria-label', clipButton.title);
clipButton.innerHTML = '<i class=\"tooltiptext\"></i>'; clipButton.innerHTML = '<i class=\"tooltiptext\"></i>';
@ -257,7 +258,7 @@ function playground_text(playground) {
if (window.playground_copyable) { if (window.playground_copyable) {
var copyCodeClipboardButton = document.createElement('button'); var copyCodeClipboardButton = document.createElement('button');
copyCodeClipboardButton.className = 'fa fa-copy clip-button'; copyCodeClipboardButton.className = 'clip-button';
copyCodeClipboardButton.innerHTML = '<i class="tooltiptext"></i>'; copyCodeClipboardButton.innerHTML = '<i class="tooltiptext"></i>';
copyCodeClipboardButton.title = 'Copy to clipboard'; copyCodeClipboardButton.title = 'Copy to clipboard';
copyCodeClipboardButton.setAttribute('aria-label', copyCodeClipboardButton.title); copyCodeClipboardButton.setAttribute('aria-label', copyCodeClipboardButton.title);
@ -288,6 +289,10 @@ function playground_text(playground) {
var themeToggleButton = document.getElementById('theme-toggle'); var themeToggleButton = document.getElementById('theme-toggle');
var themePopup = document.getElementById('theme-list'); var themePopup = document.getElementById('theme-list');
var themeColorMetaTag = document.querySelector('meta[name="theme-color"]'); var themeColorMetaTag = document.querySelector('meta[name="theme-color"]');
var themeIds = [];
themePopup.querySelectorAll('button.theme').forEach(function (el) {
themeIds.push(el.id);
});
var stylesheets = { var stylesheets = {
ayuHighlight: document.querySelector("[href$='ayu-highlight.css']"), ayuHighlight: document.querySelector("[href$='ayu-highlight.css']"),
tomorrowNight: document.querySelector("[href$='tomorrow-night.css']"), tomorrowNight: document.querySelector("[href$='tomorrow-night.css']"),
@ -300,6 +305,13 @@ function playground_text(playground) {
themePopup.querySelector("button#" + get_theme()).focus(); 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() { function hideThemes() {
themePopup.style.display = 'none'; themePopup.style.display = 'none';
themeToggleButton.setAttribute('aria-expanded', false); themeToggleButton.setAttribute('aria-expanded', false);
@ -309,7 +321,7 @@ function playground_text(playground) {
function get_theme() { function get_theme() {
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch (e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch (e) { }
if (theme === null || theme === undefined) { if (theme === null || theme === undefined || !themeIds.includes(theme)) {
return default_theme; return default_theme;
} else { } else {
return theme; return theme;
@ -338,7 +350,7 @@ function playground_text(playground) {
} }
setTimeout(function () { setTimeout(function () {
themeColorMetaTag.content = getComputedStyle(document.body).backgroundColor; themeColorMetaTag.content = getComputedStyle(document.documentElement).backgroundColor;
}, 1); }, 1);
if (window.ace && window.editors) { if (window.ace && window.editors) {
@ -355,6 +367,7 @@ function playground_text(playground) {
html.classList.remove(previousTheme); html.classList.remove(previousTheme);
html.classList.add(theme); html.classList.add(theme);
updateThemeSelected();
} }
// Set theme // Set theme
@ -432,16 +445,17 @@ function playground_text(playground) {
})(); })();
(function sidebar() { (function sidebar() {
var html = document.querySelector("html"); var body = document.querySelector("body");
var sidebar = document.getElementById("sidebar"); var sidebar = document.getElementById("sidebar");
var sidebarLinks = document.querySelectorAll('#sidebar a'); var sidebarLinks = document.querySelectorAll('#sidebar a');
var sidebarToggleButton = document.getElementById("sidebar-toggle"); var sidebarToggleButton = document.getElementById("sidebar-toggle");
var sidebarToggleAnchor = document.getElementById("sidebar-toggle-anchor");
var sidebarResizeHandle = document.getElementById("sidebar-resize-handle"); var sidebarResizeHandle = document.getElementById("sidebar-resize-handle");
var firstContact = null; var firstContact = null;
function showSidebar() { function showSidebar() {
html.classList.remove('sidebar-hidden') body.classList.remove('sidebar-hidden')
html.classList.add('sidebar-visible'); body.classList.add('sidebar-visible');
Array.from(sidebarLinks).forEach(function (link) { Array.from(sidebarLinks).forEach(function (link) {
link.setAttribute('tabIndex', 0); link.setAttribute('tabIndex', 0);
}); });
@ -450,20 +464,9 @@ function playground_text(playground) {
try { localStorage.setItem('mdbook-sidebar', 'visible'); } catch (e) { } 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() { function hideSidebar() {
html.classList.remove('sidebar-visible') body.classList.remove('sidebar-visible')
html.classList.add('sidebar-hidden'); body.classList.add('sidebar-hidden');
Array.from(sidebarLinks).forEach(function (link) { Array.from(sidebarLinks).forEach(function (link) {
link.setAttribute('tabIndex', -1); link.setAttribute('tabIndex', -1);
}); });
@ -473,22 +476,16 @@ function playground_text(playground) {
} }
// Toggle sidebar // Toggle sidebar
sidebarToggleButton.addEventListener('click', function sidebarToggle() { sidebarToggleAnchor.addEventListener('change', function sidebarToggle() {
if (html.classList.contains("sidebar-hidden")) { if (sidebarToggleAnchor.checked) {
var current_width = parseInt( var current_width = parseInt(
document.documentElement.style.getPropertyValue('--sidebar-width'), 10); document.documentElement.style.getPropertyValue('--sidebar-width'), 10);
if (current_width < 150) { if (current_width < 150) {
document.documentElement.style.setProperty('--sidebar-width', '150px'); document.documentElement.style.setProperty('--sidebar-width', '150px');
} }
showSidebar(); showSidebar();
} else if (html.classList.contains("sidebar-visible")) {
hideSidebar();
} else { } else {
if (getComputedStyle(sidebar)['transform'] === 'none') { hideSidebar();
hideSidebar();
} else {
showSidebar();
}
} }
}); });
@ -497,14 +494,14 @@ function playground_text(playground) {
function initResize(e) { function initResize(e) {
window.addEventListener('mousemove', resize, false); window.addEventListener('mousemove', resize, false);
window.addEventListener('mouseup', stopResize, false); window.addEventListener('mouseup', stopResize, false);
html.classList.add('sidebar-resizing'); body.classList.add('sidebar-resizing');
} }
function resize(e) { function resize(e) {
var pos = (e.clientX - sidebar.offsetLeft); var pos = (e.clientX - sidebar.offsetLeft);
if (pos < 20) { if (pos < 20) {
hideSidebar(); hideSidebar();
} else { } else {
if (html.classList.contains("sidebar-hidden")) { if (body.classList.contains("sidebar-hidden")) {
showSidebar(); showSidebar();
} }
pos = Math.min(pos, window.innerWidth - 100); pos = Math.min(pos, window.innerWidth - 100);
@ -513,7 +510,7 @@ function playground_text(playground) {
} }
//on mouseup remove windows functions mousemove & mouseup //on mouseup remove windows functions mousemove & mouseup
function stopResize(e) { function stopResize(e) {
html.classList.remove('sidebar-resizing'); body.classList.remove('sidebar-resizing');
window.removeEventListener('mousemove', resize, false); window.removeEventListener('mousemove', resize, false);
window.removeEventListener('mouseup', stopResize, false); window.removeEventListener('mouseup', stopResize, false);
} }
@ -542,33 +539,41 @@ function playground_text(playground) {
firstContact = null; firstContact = null;
} }
}, { passive: true }); }, { 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() { (function chapterNavigation() {
document.addEventListener('keydown', function (e) { document.addEventListener('keydown', function (e) {
if (e.altKey || e.ctrlKey || e.metaKey || e.shiftKey) { return; } if (e.altKey || e.ctrlKey || e.metaKey || e.shiftKey) { return; }
if (window.search && window.search.hasFocus()) { 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) { switch (e.key) {
case 'ArrowRight': case 'ArrowRight':
e.preventDefault(); e.preventDefault();
var nextButton = document.querySelector('.nav-chapters.next'); if (html.dir == 'rtl') {
if (nextButton) { prev();
window.location.href = nextButton.href; } else {
next();
} }
break; break;
case 'ArrowLeft': case 'ArrowLeft':
e.preventDefault(); e.preventDefault();
var previousButton = document.querySelector('.nav-chapters.previous'); if (html.dir == 'rtl') {
if (previousButton) { next();
window.location.href = previousButton.href; } else {
prev();
} }
break; break;
} }
@ -580,19 +585,19 @@ function playground_text(playground) {
function hideTooltip(elem) { function hideTooltip(elem) {
elem.firstChild.innerText = ""; elem.firstChild.innerText = "";
elem.className = 'fa fa-copy clip-button'; elem.className = 'clip-button';
} }
function showTooltip(elem, msg) { function showTooltip(elem, msg) {
elem.firstChild.innerText = msg; elem.firstChild.innerText = msg;
elem.className = 'fa fa-copy tooltipped'; elem.className = 'clip-button tooltipped';
} }
var clipboardSnippets = new ClipboardJS('.clip-button', { var clipboardSnippets = new ClipboardJS('.clip-button', {
text: function (trigger) { text: function (trigger) {
hideTooltip(trigger); hideTooltip(trigger);
let playground = trigger.closest("pre"); let playground = trigger.closest("pre");
return playground_text(playground); return playground_text(playground, false);
} }
}); });
@ -667,13 +672,14 @@ function playground_text(playground) {
}, { passive: true }); }, { passive: true });
})(); })();
(function controllBorder() { (function controllBorder() {
menu.classList.remove('bordered'); function updateBorder() {
document.addEventListener('scroll', function () {
if (menu.offsetTop === 0) { if (menu.offsetTop === 0) {
menu.classList.remove('bordered'); menu.classList.remove('bordered');
} else { } else {
menu.classList.add('bordered'); menu.classList.add('bordered');
} }
}, { passive: true }); }
updateBorder();
document.addEventListener('scroll', updateBorder, { passive: true });
})(); })();
})(); })();

0
zsh_guide/book/clipboard.min.js → zsh-guide/book/clipboard.min.js vendored
View File

223
zsh_manual/book/css/chrome.css → zsh-guide/book/css/chrome.css
View File

@ -1,13 +1,5 @@
/* CSS for UI elements (a.k.a. chrome) */ /* CSS for UI elements (a.k.a. chrome) */
@import 'variables.css';
::-webkit-scrollbar {
background: var(--bg);
}
::-webkit-scrollbar-thumb {
background: var(--scrollbar);
}
html { html {
scrollbar-color: var(--scrollbar) var(--bg); scrollbar-color: var(--scrollbar) var(--bg);
} }
@ -18,6 +10,19 @@ a > .hljs {
color: var(--links); 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 */
#menu-bar, #menu-bar,
@ -30,14 +35,14 @@ a > .hljs {
display: flex; display: flex;
flex-wrap: wrap; flex-wrap: wrap;
background-color: var(--bg); background-color: var(--bg);
border-bottom-color: var(--bg); border-block-end-color: var(--bg);
border-bottom-width: 1px; border-block-end-width: 1px;
border-bottom-style: solid; border-block-end-style: solid;
} }
#menu-bar.sticky, #menu-bar.sticky,
.js #menu-bar-hover-placeholder:hover + #menu-bar, #menu-bar-hover-placeholder:hover + #menu-bar,
.js #menu-bar:hover, #menu-bar:hover,
.js.sidebar-visible #menu-bar { html.sidebar-visible #menu-bar {
position: -webkit-sticky; position: -webkit-sticky;
position: sticky; position: sticky;
top: 0 !important; top: 0 !important;
@ -49,7 +54,7 @@ a > .hljs {
height: var(--menu-bar-height); height: var(--menu-bar-height);
} }
#menu-bar.bordered { #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 { #menu-bar i, #menu-bar .icon-button {
position: relative; position: relative;
@ -86,7 +91,7 @@ a > .hljs {
display: flex; display: flex;
margin: 0 5px; margin: 0 5px;
} }
.no-js .left-buttons { html:not(.js) .left-buttons button {
display: none; display: none;
} }
@ -102,7 +107,7 @@ a > .hljs {
overflow: hidden; overflow: hidden;
text-overflow: ellipsis; text-overflow: ellipsis;
} }
.js .menu-title { .menu-title {
cursor: pointer; cursor: pointer;
} }
@ -153,7 +158,7 @@ a > .hljs {
} }
.nav-wrapper { .nav-wrapper {
margin-top: 50px; margin-block-start: 50px;
display: none; display: none;
} }
@ -166,23 +171,34 @@ a > .hljs {
background-color: var(--sidebar-bg); background-color: var(--sidebar-bg);
} }
.previous { /* Only Firefox supports flow-relative values */
float: left; .previous { float: left; }
} [dir=rtl] .previous { float: right; }
/* Only Firefox supports flow-relative values */
.next { .next {
float: right; float: right;
right: var(--page-padding); 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) { @media only screen and (max-width: 1080px) {
.nav-wide-wrapper { display: none; } .nav-wide-wrapper { display: none; }
.nav-wrapper { display: block; } .nav-wrapper { display: block; }
} }
/* sidebar-visible */
@media only screen and (max-width: 1380px) { @media only screen and (max-width: 1380px) {
.sidebar-visible .nav-wide-wrapper { display: none; } #sidebar-toggle-anchor:checked ~ .page-wrapper .nav-wide-wrapper { display: none; }
.sidebar-visible .nav-wrapper { display: block; } #sidebar-toggle-anchor:checked ~ .page-wrapper .nav-wrapper { display: block; }
} }
/* Inline code */ /* Inline code */
@ -229,13 +245,13 @@ pre > .buttons :hover {
background-color: var(--theme-hover); background-color: var(--theme-hover);
} }
pre > .buttons i { pre > .buttons i {
margin-left: 8px; margin-inline-start: 8px;
} }
pre > .buttons button { pre > .buttons button {
cursor: inherit; cursor: inherit;
margin: 0px 5px; margin: 0px 5px;
padding: 3px 5px; padding: 4px 4px 3px 5px;
font-size: 14px; font-size: 23px;
border-style: solid; border-style: solid;
border-width: 1px; border-width: 1px;
@ -246,13 +262,40 @@ pre > .buttons button {
transition-property: color,border-color,background-color; transition-property: color,border-color,background-color;
color: var(--icons); 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) { @media (pointer: coarse) {
pre > .buttons button { pre > .buttons button {
/* On mobile, make it easier to tap buttons. */ /* On mobile, make it easier to tap buttons. */
padding: 0.3rem 1rem; padding: 0.3rem 1rem;
} }
.sidebar-resize-indicator {
/* Hide resize indicator on devices with limited accuracy */
display: none;
}
} }
pre > code { pre > code {
display: block;
padding: 1rem; padding: 1rem;
} }
@ -266,7 +309,7 @@ pre > code {
} }
pre > .result { pre > .result {
margin-top: 10px; margin-block-start: 10px;
} }
/* Search */ /* Search */
@ -277,8 +320,14 @@ pre > .result {
mark { mark {
border-radius: 2px; border-radius: 2px;
padding: 0 3px 1px 3px; padding-block-start: 0;
margin: 0 -3px -1px -3px; 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); background-color: var(--search-mark-bg);
transition: background-color 300ms linear; transition: background-color 300ms linear;
cursor: pointer; cursor: pointer;
@ -290,14 +339,17 @@ mark.fade-out {
} }
.searchbar-outer { .searchbar-outer {
margin-left: auto; margin-inline-start: auto;
margin-right: auto; margin-inline-end: auto;
max-width: var(--content-max-width); max-width: var(--content-max-width);
} }
#searchbar { #searchbar {
width: 100%; 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; padding: 10px 16px;
transition: box-shadow 300ms ease-in-out; transition: box-shadow 300ms ease-in-out;
border: 1px solid var(--searchbar-border-color); border: 1px solid var(--searchbar-border-color);
@ -313,20 +365,23 @@ mark.fade-out {
.searchresults-header { .searchresults-header {
font-weight: bold; font-weight: bold;
font-size: 1em; 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); color: var(--searchresults-header-fg);
} }
.searchresults-outer { .searchresults-outer {
margin-left: auto; margin-inline-start: auto;
margin-right: auto; margin-inline-end: auto;
max-width: var(--content-max-width); 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 { ul#searchresults {
list-style: none; list-style: none;
padding-left: 20px; padding-inline-start: 20px;
} }
ul#searchresults li { ul#searchresults li {
margin: 10px 0px; margin: 10px 0px;
@ -339,7 +394,10 @@ ul#searchresults li.focus {
ul#searchresults span.teaser { ul#searchresults span.teaser {
display: block; display: block;
clear: both; 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; font-size: 0.8em;
} }
ul#searchresults span.teaser em { ul#searchresults span.teaser em {
@ -362,13 +420,33 @@ ul#searchresults span.teaser em {
background-color: var(--sidebar-bg); background-color: var(--sidebar-bg);
color: var(--sidebar-fg); 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 { .sidebar-resizing {
-moz-user-select: none; -moz-user-select: none;
-webkit-user-select: none; -webkit-user-select: none;
-ms-user-select: none; -ms-user-select: none;
user-select: none; user-select: none;
} }
.js:not(.sidebar-resizing) .sidebar { html:not(.sidebar-resizing) .sidebar {
transition: transform 0.3s; /* Animation: slide away */ transition: transform 0.3s; /* Animation: slide away */
} }
.sidebar code { .sidebar code {
@ -387,16 +465,35 @@ ul#searchresults span.teaser em {
position: absolute; position: absolute;
cursor: col-resize; cursor: col-resize;
width: 0; width: 0;
right: 0; right: calc(var(--sidebar-resize-indicator-width) * -1);
top: 0; top: 0;
bottom: 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 { .js .sidebar .sidebar-resize-handle {
cursor: col-resize; cursor: col-resize;
width: 5px; width: calc(var(--sidebar-resize-indicator-width) - var(--sidebar-resize-indicator-space));
} }
.sidebar-hidden .sidebar { /* sidebar-hidden */
transform: translateX(calc(0px - var(--sidebar-width))); #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 { .sidebar::-webkit-scrollbar {
background: var(--sidebar-bg); background: var(--sidebar-bg);
@ -405,19 +502,26 @@ ul#searchresults span.teaser em {
background: var(--scrollbar); background: var(--scrollbar);
} }
.sidebar-visible .page-wrapper { /* sidebar-visible */
transform: translateX(var(--sidebar-width)); #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) { @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; transform: none;
margin-left: var(--sidebar-width);
} }
} }
.chapter { .chapter {
list-style: none outside none; list-style: none outside none;
padding-left: 0; padding-inline-start: 0;
line-height: 2.2em; line-height: 2.2em;
} }
@ -447,7 +551,7 @@ ul#searchresults span.teaser em {
.chapter li > a.toggle { .chapter li > a.toggle {
cursor: pointer; cursor: pointer;
display: block; display: block;
margin-left: auto; margin-inline-start: auto;
padding: 0 10px; padding: 0 10px;
user-select: none; user-select: none;
opacity: 0.68; opacity: 0.68;
@ -464,7 +568,7 @@ ul#searchresults span.teaser em {
.chapter li.chapter-item { .chapter li.chapter-item {
line-height: 1.5em; line-height: 1.5em;
margin-top: 0.6em; margin-block-start: 0.6em;
} }
.chapter li.expanded > a.toggle div { .chapter li.expanded > a.toggle div {
@ -487,7 +591,7 @@ ul#searchresults span.teaser em {
.section { .section {
list-style: none outside none; list-style: none outside none;
padding-left: 20px; padding-inline-start: 20px;
line-height: 1.9em; line-height: 1.9em;
} }
@ -507,7 +611,10 @@ ul#searchresults span.teaser em {
padding: 0; padding: 0;
list-style: none; list-style: none;
display: 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 { .theme-popup .default {
color: var(--icons); color: var(--icons);
} }
@ -515,10 +622,10 @@ ul#searchresults span.teaser em {
width: 100%; width: 100%;
border: 0; border: 0;
margin: 0; margin: 0;
padding: 2px 10px; padding: 2px 20px;
line-height: 25px; line-height: 25px;
white-space: nowrap; white-space: nowrap;
text-align: left; text-align: start;
cursor: pointer; cursor: pointer;
color: inherit; color: inherit;
background: inherit; background: inherit;
@ -527,8 +634,10 @@ ul#searchresults span.teaser em {
.theme-popup .theme:hover { .theme-popup .theme:hover {
background-color: var(--theme-hover); background-color: var(--theme-hover);
} }
.theme-popup .theme:hover:first-child,
.theme-popup .theme:hover:last-child { .theme-selected::before {
border-top-left-radius: inherit; display: inline-block;
border-top-right-radius: inherit; content: "✓";
margin-inline-start: -14px;
width: 14px;
} }

85
zsh_guide/book/css/general.css → zsh-guide/book/css/general.css
View File

@ -1,10 +1,9 @@
/* Base styles and content styles */ /* Base styles and content styles */
@import 'variables.css';
:root { :root {
/* Browser default font-size is 16px, this way 1 rem = 10px */ /* Browser default font-size is 16px, this way 1 rem = 10px */
font-size: 62.5%; font-size: 62.5%;
color-scheme: var(--color-scheme);
} }
html { html {
@ -22,8 +21,9 @@ body {
} }
code { code {
font-family: "Source Code Pro", Consolas, "Ubuntu Mono", Menlo, "DejaVu Sans Mono", monospace, monospace !important; font-family: var(--mono-font) !important;
font-size: 0.875em; /* please adjust the ace font size accordingly in editor.js */ font-size: var(--code-font-size);
direction: ltr !important;
} }
/* make long words/inline code not x overflow */ /* 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; } .hide-boring .boring { display: none; }
.hidden { display: none !important; } .hidden { display: none !important; }
h2, h3 { margin-top: 2.5em; } h2, h3 { margin-block-start: 2.5em; }
h4, h5 { margin-top: 2em; } h4, h5 { margin-block-start: 2em; }
.header + .header h3, .header + .header h3,
.header + .header h4, .header + .header h4,
.header + .header h5 { .header + .header h5 {
margin-top: 1em; margin-block-start: 1em;
} }
h1:target::before, h1:target::before,
@ -64,7 +64,7 @@ h5:target::before,
h6:target::before { h6:target::before {
display: inline-block; display: inline-block;
content: "»"; content: "»";
margin-left: -30px; margin-inline-start: -30px;
width: 30px; width: 30px;
} }
@ -73,28 +73,34 @@ h6:target::before {
https://bugs.webkit.org/show_bug.cgi?id=218076 https://bugs.webkit.org/show_bug.cgi?id=218076
*/ */
:target { :target {
/* Safari does not support logical properties */
scroll-margin-top: calc(var(--menu-bar-height) + 0.5em); scroll-margin-top: calc(var(--menu-bar-height) + 0.5em);
} }
.page { .page {
outline: 0; outline: 0;
padding: 0 var(--page-padding); 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 { .page-wrapper {
box-sizing: border-box; box-sizing: border-box;
background-color: var(--bg);
} }
.no-js .page-wrapper,
.js:not(.sidebar-resizing) .page-wrapper { .js:not(.sidebar-resizing) .page-wrapper {
transition: margin-left 0.3s ease, transform 0.3s ease; /* Animation: slide away */ 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 { .content {
overflow-y: auto; overflow-y: auto;
padding: 0 5px 50px 5px; padding: 0 5px 50px 5px;
} }
.content main { .content main {
margin-left: auto; margin-inline-start: auto;
margin-right: auto; margin-inline-end: auto;
max-width: var(--content-max-width); max-width: var(--content-max-width);
} }
.content p { line-height: 1.45em; } .content p { line-height: 1.45em; }
@ -144,14 +150,61 @@ blockquote {
padding: 0 20px; padding: 0 20px;
color: var(--fg); color: var(--fg);
background-color: var(--quote-bg); background-color: var(--quote-bg);
border-top: .1em solid var(--quote-border); border-block-start: .1em solid var(--quote-border);
border-bottom: .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, .warning:before {
.footnote-definition + :not(.footnote-definition) { position: absolute;
margin-top: 2em; 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 { .footnote-definition {
font-size: 0.9em; font-size: 0.9em;

10
zsh_manual/book/css/print.css → zsh-guide/book/css/print.css
View File

@ -7,8 +7,8 @@
} }
#page-wrapper.page-wrapper { #page-wrapper.page-wrapper {
transform: none; transform: none !important;
margin-left: 0px; margin-inline-start: 0px;
overflow-y: initial; overflow-y: initial;
} }
@ -23,11 +23,7 @@
} }
code { code {
background-color: #666666; direction: ltr !important;
border-radius: 5px;
/* Force background to be printed in Chrome */
-webkit-print-color-adjust: exact;
} }
pre > .buttons { pre > .buttons {

60
zsh_guide/book/css/variables.css → zsh-guide/book/css/variables.css
View File

@ -3,9 +3,13 @@
:root { :root {
--sidebar-width: 300px; --sidebar-width: 300px;
--sidebar-resize-indicator-width: 8px;
--sidebar-resize-indicator-space: 2px;
--page-padding: 15px; --page-padding: 15px;
--content-max-width: 750px; --content-max-width: 750px;
--menu-bar-height: 50px; --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 */ /* Themes */
@ -36,6 +40,8 @@
--quote-bg: hsl(226, 15%, 17%); --quote-bg: hsl(226, 15%, 17%);
--quote-border: hsl(226, 15%, 22%); --quote-border: hsl(226, 15%, 22%);
--warning-border: #ff8e00;
--table-border-color: hsl(210, 25%, 13%); --table-border-color: hsl(210, 25%, 13%);
--table-header-bg: hsl(210, 25%, 28%); --table-header-bg: hsl(210, 25%, 28%);
--table-alternate-bg: hsl(210, 25%, 11%); --table-alternate-bg: hsl(210, 25%, 11%);
@ -48,6 +54,13 @@
--searchresults-border-color: #888; --searchresults-border-color: #888;
--searchresults-li-bg: #252932; --searchresults-li-bg: #252932;
--search-mark-bg: #e3b171; --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 { .coal {
@ -76,6 +89,8 @@
--quote-bg: hsl(234, 21%, 18%); --quote-bg: hsl(234, 21%, 18%);
--quote-border: hsl(234, 21%, 23%); --quote-border: hsl(234, 21%, 23%);
--warning-border: #ff8e00;
--table-border-color: hsl(200, 7%, 13%); --table-border-color: hsl(200, 7%, 13%);
--table-header-bg: hsl(200, 7%, 28%); --table-header-bg: hsl(200, 7%, 28%);
--table-alternate-bg: hsl(200, 7%, 11%); --table-alternate-bg: hsl(200, 7%, 11%);
@ -88,9 +103,16 @@
--searchresults-border-color: #98a3ad; --searchresults-border-color: #98a3ad;
--searchresults-li-bg: #2b2b2f; --searchresults-li-bg: #2b2b2f;
--search-mark-bg: #355c7d; --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%); --bg: hsl(0, 0%, 100%);
--fg: hsl(0, 0%, 0%); --fg: hsl(0, 0%, 0%);
@ -116,6 +138,8 @@
--quote-bg: hsl(197, 37%, 96%); --quote-bg: hsl(197, 37%, 96%);
--quote-border: hsl(197, 37%, 91%); --quote-border: hsl(197, 37%, 91%);
--warning-border: #ff8e00;
--table-border-color: hsl(0, 0%, 95%); --table-border-color: hsl(0, 0%, 95%);
--table-header-bg: hsl(0, 0%, 80%); --table-header-bg: hsl(0, 0%, 80%);
--table-alternate-bg: hsl(0, 0%, 97%); --table-alternate-bg: hsl(0, 0%, 97%);
@ -128,6 +152,13 @@
--searchresults-border-color: #888; --searchresults-border-color: #888;
--searchresults-li-bg: #e4f2fe; --searchresults-li-bg: #e4f2fe;
--search-mark-bg: #a2cff5; --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 { .navy {
@ -156,6 +187,8 @@
--quote-bg: hsl(226, 15%, 17%); --quote-bg: hsl(226, 15%, 17%);
--quote-border: hsl(226, 15%, 22%); --quote-border: hsl(226, 15%, 22%);
--warning-border: #ff8e00;
--table-border-color: hsl(226, 23%, 16%); --table-border-color: hsl(226, 23%, 16%);
--table-header-bg: hsl(226, 23%, 31%); --table-header-bg: hsl(226, 23%, 31%);
--table-alternate-bg: hsl(226, 23%, 14%); --table-alternate-bg: hsl(226, 23%, 14%);
@ -168,6 +201,13 @@
--searchresults-border-color: #5c5c68; --searchresults-border-color: #5c5c68;
--searchresults-li-bg: #242430; --searchresults-li-bg: #242430;
--search-mark-bg: #a2cff5; --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 { .rust {
@ -196,6 +236,8 @@
--quote-bg: hsl(60, 5%, 75%); --quote-bg: hsl(60, 5%, 75%);
--quote-border: hsl(60, 5%, 70%); --quote-border: hsl(60, 5%, 70%);
--warning-border: #ff8e00;
--table-border-color: hsl(60, 9%, 82%); --table-border-color: hsl(60, 9%, 82%);
--table-header-bg: #b3a497; --table-header-bg: #b3a497;
--table-alternate-bg: hsl(60, 9%, 84%); --table-alternate-bg: hsl(60, 9%, 84%);
@ -208,10 +250,15 @@
--searchresults-border-color: #888; --searchresults-border-color: #888;
--searchresults-li-bg: #dec2a2; --searchresults-li-bg: #dec2a2;
--search-mark-bg: #e69f67; --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) { @media (prefers-color-scheme: dark) {
.light.no-js { html:not(.js) {
--bg: hsl(200, 7%, 8%); --bg: hsl(200, 7%, 8%);
--fg: #98a3ad; --fg: #98a3ad;
@ -237,6 +284,8 @@
--quote-bg: hsl(234, 21%, 18%); --quote-bg: hsl(234, 21%, 18%);
--quote-border: hsl(234, 21%, 23%); --quote-border: hsl(234, 21%, 23%);
--warning-border: #ff8e00;
--table-border-color: hsl(200, 7%, 13%); --table-border-color: hsl(200, 7%, 13%);
--table-header-bg: hsl(200, 7%, 28%); --table-header-bg: hsl(200, 7%, 28%);
--table-alternate-bg: hsl(200, 7%, 11%); --table-alternate-bg: hsl(200, 7%, 11%);
@ -249,5 +298,12 @@
--searchresults-border-color: #98a3ad; --searchresults-border-color: #98a3ad;
--searchresults-li-bg: #2b2b2f; --searchresults-li-bg: #2b2b2f;
--search-mark-bg: #355c7d; --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%);
} }
} }

0
zsh_guide/book/elasticlunr.min.js → zsh-guide/book/elasticlunr.min.js vendored
View File

0
zsh_guide/book/favicon.png → zsh-guide/book/favicon.png
View File

Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 5.5 KiB

After

Width:  |  Height:  |  Size: 5.5 KiB

0
zsh_guide/book/favicon.svg → zsh-guide/book/favicon.svg
View File

Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 1.8 KiB

After

Width:  |  Height:  |  Size: 1.8 KiB

0
zsh_guide/book/fonts/OPEN-SANS-LICENSE.txt → zsh-guide/book/fonts/OPEN-SANS-LICENSE.txt
View File

0
zsh_guide/book/fonts/SOURCE-CODE-PRO-LICENSE.txt → zsh-guide/book/fonts/SOURCE-CODE-PRO-LICENSE.txt
View File

0
zsh_guide/book/fonts/fonts.css → zsh-guide/book/fonts/fonts.css
View File

0
zsh_guide/book/fonts/open-sans-v17-all-charsets-300.woff2 → zsh-guide/book/fonts/open-sans-v17-all-charsets-300.woff2
View File

0
zsh_guide/book/fonts/open-sans-v17-all-charsets-300italic.woff2 → zsh-guide/book/fonts/open-sans-v17-all-charsets-300italic.woff2
View File

0
zsh_guide/book/fonts/open-sans-v17-all-charsets-600.woff2 → zsh-guide/book/fonts/open-sans-v17-all-charsets-600.woff2
View File

0
zsh_guide/book/fonts/open-sans-v17-all-charsets-600italic.woff2 → zsh-guide/book/fonts/open-sans-v17-all-charsets-600italic.woff2
View File

0
zsh_guide/book/fonts/open-sans-v17-all-charsets-700.woff2 → zsh-guide/book/fonts/open-sans-v17-all-charsets-700.woff2
View File

0
zsh_guide/book/fonts/open-sans-v17-all-charsets-700italic.woff2 → zsh-guide/book/fonts/open-sans-v17-all-charsets-700italic.woff2
View File

0
zsh_guide/book/fonts/open-sans-v17-all-charsets-800.woff2 → zsh-guide/book/fonts/open-sans-v17-all-charsets-800.woff2
View File

0
zsh_guide/book/fonts/open-sans-v17-all-charsets-800italic.woff2 → zsh-guide/book/fonts/open-sans-v17-all-charsets-800italic.woff2
View File

0
zsh_guide/book/fonts/open-sans-v17-all-charsets-italic.woff2 → zsh-guide/book/fonts/open-sans-v17-all-charsets-italic.woff2
View File

0
zsh_guide/book/fonts/open-sans-v17-all-charsets-regular.woff2 → zsh-guide/book/fonts/open-sans-v17-all-charsets-regular.woff2
View File

0
zsh_guide/book/fonts/source-code-pro-v11-all-charsets-500.woff2 → zsh-guide/book/fonts/source-code-pro-v11-all-charsets-500.woff2
View File

1
zsh_manual/book/highlight.css → zsh-guide/book/highlight.css
View File

@ -16,6 +16,7 @@
.hljs-variable, .hljs-variable,
.hljs-template-variable, .hljs-template-variable,
.hljs-attribute, .hljs-attribute,
.hljs-attr,
.hljs-tag, .hljs-tag,
.hljs-name, .hljs-name,
.hljs-regexp, .hljs-regexp,

54
zsh-guide/book/highlight.js Normal file
View File

File diff suppressed because one or more lines are too long

111
zsh_guide/book/index.html → zsh-guide/book/index.html
View File

@ -1,17 +1,16 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
<title>A User&#x27;s Guide to the Z-Shell - Zsh User&#x27;s Guide</title> <title>A User&#x27;s Guide to the Z-Shell - Zsh Guide</title>
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -116,7 +120,7 @@
</button> </button>
</div> </div>
<h1 class="menu-title">Zsh User&#x27;s Guide</h1> <h1 class="menu-title">Zsh Guide</h1>
<div class="right-buttons"> <div class="right-buttons">
<a href="print.html" title="Print this book" aria-label="Print this book"> <a href="print.html" title="Print this book" aria-label="Print this book">
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
@ -378,7 +382,7 @@ etc.</a></p>
<nav class="nav-wrapper" aria-label="Page navigation"> <nav class="nav-wrapper" aria-label="Page navigation">
<!-- Mobile navigation buttons --> <!-- 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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -389,31 +393,48 @@ etc.</a></p>
<nav class="nav-wide-wrapper" aria-label="Page navigation"> <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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
</div> </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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

0
zsh_guide/book/mark.min.js → zsh-guide/book/mark.min.js vendored
View File

507
zsh_guide/book/print.html → zsh-guide/book/print.html
View File

File diff suppressed because it is too large Load Diff

2
zsh_guide/book/searcher.js → zsh-guide/book/searcher.js
View File

@ -316,7 +316,7 @@ window.search = window.search || {};
// Eventhandler for keyevents on `document` // Eventhandler for keyevents on `document`
function globalKeyHandler(e) { 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) { if (e.keyCode === ESCAPE_KEYCODE) {
e.preventDefault(); e.preventDefault();

1
zsh-guide/book/searchindex.js Normal file
View File

File diff suppressed because one or more lines are too long

1
zsh-guide/book/searchindex.json Normal file
View File

File diff suppressed because one or more lines are too long

836
zsh-guide/book/theme/catppuccin.css Normal file
View 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
View 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&#39;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
View 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&#39;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);

6
zsh_guide/book/tomorrow-night.css → zsh-guide/book/tomorrow-night.css
View File

@ -1,7 +1,7 @@
/* Tomorrow Night Theme */ /* 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 */ /* 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 */ /* Tomorrow Comment */
.hljs-comment { .hljs-comment {
@ -11,6 +11,7 @@
/* Tomorrow Red */ /* Tomorrow Red */
.hljs-variable, .hljs-variable,
.hljs-attribute, .hljs-attribute,
.hljs-attr,
.hljs-tag, .hljs-tag,
.hljs-regexp, .hljs-regexp,
.ruby .hljs-constant, .ruby .hljs-constant,
@ -54,6 +55,7 @@
/* Tomorrow Aqua */ /* Tomorrow Aqua */
.hljs-title, .hljs-title,
.hljs-section,
.css .hljs-hexcolor { .css .hljs-hexcolor {
color: #8abeb7; color: #8abeb7;
} }

111
zsh_guide/book/zshguide.html → zsh-guide/book/zshguide.html
View File

@ -1,17 +1,16 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
<title>A User&#x27;s Guide to the Z-Shell - Zsh User&#x27;s Guide</title> <title>A User&#x27;s Guide to the Z-Shell - Zsh Guide</title>
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -116,7 +120,7 @@
</button> </button>
</div> </div>
<h1 class="menu-title">Zsh User&#x27;s Guide</h1> <h1 class="menu-title">Zsh Guide</h1>
<div class="right-buttons"> <div class="right-buttons">
<a href="print.html" title="Print this book" aria-label="Print this book"> <a href="print.html" title="Print this book" aria-label="Print this book">
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
@ -378,7 +382,7 @@ etc.</a></p>
<nav class="nav-wrapper" aria-label="Page navigation"> <nav class="nav-wrapper" aria-label="Page navigation">
<!-- Mobile navigation buttons --> <!-- 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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -389,31 +393,48 @@ etc.</a></p>
<nav class="nav-wide-wrapper" aria-label="Page navigation"> <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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
</div> </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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

111
zsh_guide/book/zshguide01.html → zsh-guide/book/zshguide01.html
View File

@ -1,17 +1,16 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
<title>A short introduction - Zsh User&#x27;s Guide</title> <title>A short introduction - Zsh Guide</title>
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -116,7 +120,7 @@
</button> </button>
</div> </div>
<h1 class="menu-title">Zsh User&#x27;s Guide</h1> <h1 class="menu-title">Zsh Guide</h1>
<div class="right-buttons"> <div class="right-buttons">
<a href="print.html" title="Print this book" aria-label="Print this book"> <a href="print.html" title="Print this book" aria-label="Print this book">
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
@ -404,7 +408,7 @@ particular PC.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -418,31 +422,48 @@ particular PC.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
</div> </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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

129
zsh_guide/book/zshguide02.html → zsh-guide/book/zshguide02.html
View File

@ -1,17 +1,16 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
<title>What to put in your startup files - Zsh User&#x27;s Guide</title> <title>What to put in your startup files - Zsh Guide</title>
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -116,7 +120,7 @@
</button> </button>
</div> </div>
<h1 class="menu-title">Zsh User&#x27;s Guide</h1> <h1 class="menu-title">Zsh Guide</h1>
<div class="right-buttons"> <div class="right-buttons">
<a href="print.html" title="Print this book" aria-label="Print this book"> <a href="print.html" title="Print this book" aria-label="Print this book">
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
@ -494,7 +498,7 @@ for example,</p>
could still put quotes there anyway.</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. <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 This is important because there is a <code>set</code> command, but it works
differently --- if you try `<code>set var=&quot;this wont't work&quot;</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>' get an error but you won't set the parameter, either. Type `<code>print $1</code>'
to see what you did set instead.</p> to see what you did set instead.</p>
<p>To get back what was stored in a parameter, you use the name somewhere <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 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 expansion, a <strong>parameter expansion</strong>. For example, after the first
assignment above.</p> assignment above.</p>
<pre><code> print -- '$foo is &quot;'$foo'&quot;' <pre><code> print -- '$foo is "'$foo'"'
</code></pre> </code></pre>
<p>gives</p> <p>gives</p>
<pre><code> $foo is &quot;This is a parameter.&quot; <pre><code> $foo is "This is a parameter."
</code></pre> </code></pre>
<p>so you can see what I meant about the effect of single quotes. Note the <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 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> 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 is not set by default. Users of other shells just get used to putting
things in double quotes,</p> things in double quotes,</p>
<pre><code> command &quot;$foo&quot; <pre><code> command "$foo"
</code></pre> </code></pre>
<p>which, unlike single quotes, allow the `<code>$</code>' to remain special, and <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 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 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>, 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 the way around the ksh behaviour if you don't want the value changed is
to use double quotes: <code>&quot;$foo&quot;</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 <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 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 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() { helper() {
# goodness knows what this does # goodness knows what this does
} }
fn &quot;$@&quot; fn "$@"
# this actually calls the function the first time, # this actually calls the function the first time,
# with any arguments passed (see the subsection # with any arguments passed (see the subsection
# `Function Parameters' in the section `Functions' # `Function Parameters' in the section `Functions'
# of the next chapter for the &quot;$@&quot;). # of the next chapter for the "$@").
</code></pre> </code></pre>
<p>That last non-comment line is unnecessary with <code>KSH_AUTOLOAD</code>. The <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, 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 the escape sequences for given colours, for example
<code>${fg[red]}${bg[yellow]}</code> produces the sequences for red text on a <code>${fg[red]}${bg[yellow]}</code> produces the sequences for red text on a
yellow background. So for example,</p> yellow background. So for example,</p>
<pre><code> PS1=&quot;%{${bg[white]}${fg[red]}%}%(?..(%?%))\ <pre><code> PS1="%{${bg[white]}${fg[red]}%}%(?..(%?%))\
%{${fg[yellow]}${bg[black]}%}%# &quot; %{${fg[yellow]}${bg[black]}%}%# "
</code></pre> </code></pre>
<p>produces a red-on-white `<code>(1)</code>' if the previous programme exited with <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 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> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -1995,31 +1999,48 @@ for all interactive shells, and for no others.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
</div> </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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

239
zsh_guide/book/zshguide03.html → zsh-guide/book/zshguide03.html
View File

@ -1,17 +1,16 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
<title>Dealing with basic shell syntax - Zsh User&#x27;s Guide</title> <title>Dealing with basic shell syntax - Zsh Guide</title>
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -116,7 +120,7 @@
</button> </button>
</div> </div>
<h1 class="menu-title">Zsh User&#x27;s Guide</h1> <h1 class="menu-title">Zsh Guide</h1>
<div class="right-buttons"> <div class="right-buttons">
<a href="print.html" title="Print this book" aria-label="Print this book"> <a href="print.html" title="Print this book" aria-label="Print this book">
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
@ -916,11 +920,11 @@ fashion:</p>
emulate -R zsh emulate -R zsh
setopt localoptions setopt localoptions
if [[ ARGC -eq 1 &amp;&amp; &quot;$1&quot; == [+-]&lt;-&gt; ]] then if [[ ARGC -eq 1 &amp;&amp; "$1" == [+-]&lt;-&gt; ]] then
setopt pushdignoredups setopt pushdignoredups
builtin pushd ~$1 builtin pushd ~$1
else else
builtin pushd &quot;$@&quot; builtin pushd "$@"
fi fi
</code></pre> </code></pre>
<p>The `<code>&amp;&amp;</code>' is a logical `and', requiring both tests to be true. The <p>The `<code>&amp;&amp;</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 function, you use `<code>command</code>'. The following works, although it's
obviously not all that useful as it stands:</p> obviously not all that useful as it stands:</p>
<pre><code> ls() { <pre><code> ls() {
command ls &quot;$[@]&quot; command ls "$[@]"
} }
</code></pre> </code></pre>
<p>so when you run `<code>ls</code>', it calls the function, which calls the real <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 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 the usual zsh pattern format, in other words the same one used for
matching files. Thus</p> matching files. Thus</p>
<pre><code> whence -vm &quot;*&quot; <pre><code> whence -vm "*"
</code></pre> </code></pre>
<p>prints out every command the shell knows about, together with what it <p>prints out every command the shell knows about, together with what it
thinks of it.</p> thinks of it.</p>
@ -1219,7 +1223,7 @@ the <code>typeset</code> statement is equivalent to</p>
</code></pre> </code></pre>
<p>which can tell a scalar assignment, and hence knows not to split words, <p>which can tell a scalar assignment, and hence knows not to split words,
or quote the backquotes,</p> or quote the backquotes,</p>
<pre><code> % typeset var=&quot;`echo two words`&quot; <pre><code> % typeset var="`echo two words`"
</code></pre> </code></pre>
<p>There are three important types we haven't talked about; both of these <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 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> 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 <p>There is a builtin called <code>let</code> to handle mathematical expressions, but
since</p> since</p>
<pre><code> let &quot;num = num + 1&quot; <pre><code> let "num = num + 1"
</code></pre> </code></pre>
<p>is equivalent to</p> <p>is equivalent to</p>
<pre><code> (( num = num + 1 )) <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 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> remaining arguments are a list of signals to handle, minus the <code>SIG</code>
prefix. So:</p> prefix. So:</p>
<pre><code> trap &quot;echo I\\'m trapped.&quot; INT <pre><code> trap "echo I\\'m trapped." INT
</code></pre> </code></pre>
<p>tells the shell what to do on <code>SIGINT</code>, i.e. <code>^C</code>. Note the extra layer <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 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 and pretend to anyone watching that the shell didn't handle it. An
example will show this:</p> example will show this:</p>
<pre><code> TRAPINT() { <pre><code> TRAPINT() {
print &quot;Signal caught, stopping anyway.&quot; print "Signal caught, stopping anyway."
return $(( 128 + $1 )) return $(( 128 + $1 ))
} }
</code></pre> </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 to an external command, or set parameters for it, then call that
command. For example:</p> command. For example:</p>
<pre><code> export MOZILLA_HOME=/usr/local/netscape <pre><code> export MOZILLA_HOME=/usr/local/netscape
netscape &quot;$@&quot; netscape "$@"
</code></pre> </code></pre>
<p>Run as a script, this sets an environment variable, then starts <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 <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> shell to do; you'd rather it simply magically turned into the <code>netscape</code>
command. You can actually do this:</p> command. You can actually do this:</p>
<pre><code> export MOZILLA_HOME=/usr/local/netscape <pre><code> export MOZILLA_HOME=/usr/local/netscape
exec netscape &quot;$@&quot; exec netscape "$@"
</code></pre> </code></pre>
<p>`<code>exec</code>' tells the shell that it doesn't need to wait; it can just make <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 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 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 the arguments to these commands can be any single word expression, not
just variables or filenames. You are quite at liberty to test</p> just variables or filenames. You are quite at liberty to test</p>
<pre><code> if [[ -z &quot;$var is sqrt(`print bibble`)&quot; ]]; then <pre><code> if [[ -z "$var is sqrt(`print bibble`)" ]]; then
print Flying pig detected. print Flying pig detected.
fi fi
</code></pre> </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> joining the bits with spaces:</p>
<pre><code> array=(two words) <pre><code> array=(two words)
if [[ $array = 'two words' ]]; then if [[ $array = 'two words' ]]; then
print &quot;The array \$array is OK. O, joy.&quot; print "The array \$array is OK. O, joy."
fi fi
</code></pre> </code></pre>
<p>Apart from `<code>-z</code>' and `<code>-n</code>', most of the two-argument tests are to do <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> </code></pre>
<p>Now here's the difference:</p> <p>Now here's the difference:</p>
<pre><code> % set two words <pre><code> % set two words
% args &quot;$*&quot; % args "$*"
1 two words 1 two words
% args &quot;$@&quot; % args "$@"
2 two words 2 two words
</code></pre> </code></pre>
<p>In quotes, <code>&quot;$*&quot;</code> behaves as a normal array, joining the words with <p>In quotes, <code>"$*"</code> behaves as a normal array, joining the words with
spaces. However, <code>&quot;$@&quot;</code> doesn't --- it still behaves as if it was 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 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> 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 <p>This probably seems pretty silly. Why quote something to have it behave
@ -3082,15 +3086,15 @@ spaces again:</p>
2 one word 2 one word
% args $@ % args $@
2 one word 2 one word
% args &quot;$*&quot; % args "$*"
1 one word 1 one word
% args &quot;$@&quot; % args "$@"
1 one word 1 one word
</code></pre> </code></pre>
<p>Aha! <em>This</em> time <code>&quot;$@&quot;</code> kept the single word with the space intact. In <p>Aha! <em>This</em> time <code>"$@"</code> kept the single word with the space intact. In
other words, <code>&quot;$@&quot;</code> was a slightly primitive mechanism for suppressing other words, <code>"$@"</code> was a slightly primitive mechanism for suppressing
splitting of words, while allowing the splitting of arrays into splitting of words, while allowing the splitting of arrays into
elements. In zsh, you would probably quite often use <code>$*</code>, not <code>&quot;$@&quot;</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; 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 and if you wanted it split, you would use the special form of
substitution <code>${=*}</code> which does that:</p> substitution <code>${=*}</code> which does that:</p>
@ -3123,12 +3127,12 @@ same happens with all empty variables, including scalars:</p>
</code></pre> </code></pre>
<p>But there are times when you don't want that, any more than you want <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 word splitting --- you want <em>all</em> arguments passed just as you gave
them. This is another side effect of the <code>&quot;$@&quot;</code> form.</p> them. This is another side effect of the <code>"$@"</code> form.</p>
<pre><code> % args &quot;$@&quot; <pre><code> % args "$@"
3 hello there 3 hello there
</code></pre> </code></pre>
<p>Here, the empty element was passed in as well. That's why you often find <p>Here, the empty element was passed in as well. That's why you often find
<code>&quot;$@&quot;</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 <p>Another note: why does the following not work like the example with
<code>$*</code>?</p> <code>$*</code>?</p>
<pre><code> % args hello '' there <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> function. The same difference occurs with scalars:</p>
<pre><code> % args $empty <pre><code> % args $empty
0 0
% args &quot;$empty&quot; % args "$empty"
1 1
</code></pre> </code></pre>
<p>The <code>$empty</code> expanded to an empty string in each case. In the first case <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 | 2 1 0 $@ n | 2 1 0
&quot;$*&quot; n | 1 1 1 "$*" n | 1 1 1
&quot;$@&quot; n | 2 1 1 "$@" n | 2 1 1
| |
$* y | 2 2 0 $* y | 2 2 0
$@ y | 2 2 0 $@ y | 2 2 0
&quot;$*&quot; y | 1 1 1 "$*" y | 1 1 1
&quot;$@&quot; y | 2 1 1 "$@" y | 2 1 1
| |
${=*} n | 2 2 0 ${=*} n | 2 2 0
${=@} n | 2 2 0 ${=@} n | 2 2 0
&quot;${=*}&quot; n | 2 2 1 "${=*}" n | 2 2 1
&quot;${=@}&quot; n | 2 2 1 "${=@}" n | 2 2 1
</code></pre> </code></pre>
<p>On the left is shown the expression to be passed to the function, and in <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 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> forces words to be split, even inside quotation marks.</p>
<p>I would recommend that anyone not wedded to the Bourne shell behaviour <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 use the top set as standard: in particular, `<code>$*</code>' for normal array
behaviour with removal of empty items, `<code>&quot;$@&quot;</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>&quot;$*&quot;</code>' for behaviour with empty items left as empty items, and `<code>"$*"</code>' for
turning arrays into single strings. If you need word-splitting, you turning arrays into single strings. If you need word-splitting, you
should use `<code>${=*}</code>' or `<code>&quot;${=@}&quot;</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 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 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> to the Bourne shell behaviour, you're on your own.</p>
<p><strong>It's a bug</strong></p> <p><strong>It's a bug</strong></p>
<p>There's a bug in handling of the the form <code>${1+&quot;$@&quot;}</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 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 get around a bug in some versions of the Bourne shell (which is not in
zsh): that <code>&quot;$@&quot;</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 arguments. The form shown tests whether there is a first argument, and
if so substitutes <code>&quot;$@&quot;</code>, else it doesn't substitute anything, avoiding if so substitutes <code>"$@"</code>, else it doesn't substitute anything, avoiding
the bug.</p> the bug.</p>
<p>Unfortunately, in zsh, when <code>shwordsplit</code> is set --- which is the time <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 you usually run across attempts like this to standardise the way
different shells work --- this will actually cause too much different shells work --- this will actually cause too much
word-splitting. The way the shell is written at the moment, the embedded word-splitting. The way the shell is written at the moment, the embedded
<code>&quot;$@&quot;</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, the first argument is `<code>one word</code>', and <code>shwordsplit</code> is set,
<code>${1+&quot;$@&quot;}</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 <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> for use in the GNU autoconf package: in your initialisation code, have</p>
<pre><code> [ x$ZSH_VERSION != x ] &amp;&amp; alias -g '${1+&quot;$@&quot;}'='&quot;$@&quot;' <pre><code> [ x$ZSH_VERSION != x ] &amp;&amp; alias -g '${1+"$@"}'='"$@"'
</code></pre> </code></pre>
<p>This uses a global alias to turn <code>${1+&quot;$@&quot;}</code> wherever it occurs as a <p>This uses a global alias to turn <code>${1+"$@"}</code> wherever it occurs as a
single word into <code>&quot;$@&quot;</code> which doesn't have the problem. Aliasing occurs 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 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 special meaning to the shell is irrelevant; the shell behaves as if it
read in <code>&quot;$@&quot;</code>. The only catch is that for this to work the script or 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+&quot;$@&quot;}</code>, with no function must use <em>exactly</em> the character string <code>${1+"$@"}</code>, with no
leading or trailing word characters (whitespace, obviously, or leading or trailing word characters (whitespace, obviously, or
characters which terminate parsing such as `<code>;</code>' are all right). Some 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 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 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, 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> you will come a cropper sooner or later.</p>
<p>It looks like you're missing <code>&quot;$@&quot;</code>, but actually you can do that with <p>It looks like you're missing <code>"$@"</code>, but actually you can do that with
<code>&quot;${argv[@]}&quot;</code>. This, like negative indices and slices, works with all <code>"${argv[@]}"</code>. This, like negative indices and slices, works with all
arrays.</p> arrays.</p>
<p>There's one slight oddity with <code>$ARGC</code> and <code>$argv</code>, which isn't really a <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 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> mean is, in</p>
<pre><code> fn() { <pre><code> fn() {
cat $* cat $*
cat &quot;$*&quot; cat "$*"
} }
</code></pre> </code></pre>
<p>the `<code>cat</code>' command will see the differences in behaviour between the <p>the `<code>cat</code>' command will see the differences in behaviour between the
@ -3503,9 +3507,9 @@ bar.</p>
<pre><code> chpwd() { <pre><code> chpwd() {
[[ -t 1 ]] || return [[ -t 1 ]] || return
case $TERM in case $TERM in
(sun-cmd) print -Pn &quot;\e]l%~\e\\&quot; (sun-cmd) print -Pn "\e]l%~\e\\"
;; ;;
(*xterm*|rxvt|(dt|k|E)term) print -Pn &quot;\e]2;%~\a&quot; (*xterm*|rxvt|(dt|k|E)term) print -Pn "\e]2;%~\a"
;; ;;
esac 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 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 you'd typed it. That means you can get away with strange combinations
like</p> like</p>
<pre><code> alias tripe=&quot;echo foo | sed 's/foo/bar/' |&quot; <pre><code> alias tripe="echo foo | sed 's/foo/bar/' |"
tripe cat tripe cat
</code></pre> </code></pre>
<p>which is interpreted exactly the same way as</p> <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 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 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>', an alias `<code>drivel</code>', none of the strings `<code>\drivel</code>', `<code>'d'rivel</code>',
or `<code>drivel&quot;&quot;</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 same effect as proper commands, after the quotes are removed, but as
aliases they appear different. The manual entry also notes that you can 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 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!!' <pre><code> echo 'Hello!!'
</code></pre> </code></pre>
<p>doesn't insert the previous line at that point, but</p> <p>doesn't insert the previous line at that point, but</p>
<pre><code> echo &quot;Hello!!&quot; <pre><code> echo "Hello!!"
</code></pre> </code></pre>
<p>does. You can always quote active `<code>!</code>'s with a backslash, so</p> <p>does. You can always quote active `<code>!</code>'s with a backslash, so</p>
<pre><code> echo &quot;Hello\!\!&quot; <pre><code> echo "Hello\!\!"
</code></pre> </code></pre>
<p>works, with or without the double quotes. Amusingly, since single quotes <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, 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> ever increasing command lines:</p>
<pre><code> % echo 'Hello!!' <pre><code> % echo 'Hello!!'
Hello!! Hello!!
% echo &quot;Hello!!&quot; % echo "Hello!!"
% echo &quot;Helloecho 'Hello!!'&quot; % echo "Helloecho 'Hello!!'"
% echo &quot;Helloecho 'Helloecho 'Hello!!''&quot; % echo "Helloecho 'Helloecho 'Hello!!''"
% echo &quot;Helloecho 'Helloecho 'Helloecho 'Hello!!'''&quot; % echo "Helloecho 'Helloecho 'Helloecho 'Hello!!'''"
</code></pre> </code></pre>
<p>and if you understand why, you have a good grasp of how quotes work.</p> <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 <p>There's another way of quoting exclamation marks in a line: put a
`<code>!&quot;</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 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. disabling any subsequent exclamation marks till the end of the line.
This is the only time quote marks which are significant to the shell 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 $# $*; } <pre><code> % args() { print $# $*; }
% args $(echo two words) % args $(echo two words)
2 two words 2 two words
% args &quot;$(echo one word)&quot; % args "$(echo one word)"
1 one word 1 one word
</code></pre> </code></pre>
<p>The first form will split on newlines, not just spaces, so an equivalent <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, pokery with tildes described below. Other shells do this differently,
and zsh (from 4.0.2 and 4.1.1) provides a compatibility option, 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> <code>KSH_TYPESET</code>. In earlier versions you need to use quotes:</p>
<pre><code> % typeset foo=&quot;`echo words words`&quot; <pre><code> % typeset foo="`echo words words`"
% print $foo % print $foo
words words words words
</code></pre> </code></pre>
@ -5157,7 +5161,7 @@ bug. Use <code>{ cmd1 &amp;&amp; cmd2 } &amp;</code> as a workaround.</li>
</li> </li>
<li> <li>
<p>* The results of parameter substitutions are treated as plain <p>* The results of parameter substitutions are treated as plain
text: <code>foo=&quot;*&quot;; 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> zsh (unset <code>GLOB_SUBST</code>).</p>
</li> </li>
<li> <li>
@ -5248,7 +5252,7 @@ default.</li>
<ul> <ul>
<li>Some built-ins (<code>r</code>, <code>autoload</code>, <code>history</code>, <code>integer</code> ...) were <li>Some built-ins (<code>r</code>, <code>autoload</code>, <code>history</code>, <code>integer</code> ...) were
aliases in ksh.</li> aliases in ksh.</li>
<li>There is no built-in command newgrp: use e.g. <code>alias newgrp=&quot;exec newgrp&quot;</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>jobs</code> has no <code>-n</code> flag.</li>
<li><code>read</code> has no <code>-s</code> flag.</li> <li><code>read</code> has no <code>-s</code> flag.</li>
</ul> </ul>
@ -5357,7 +5361,7 @@ example:</p>
# Put the right path in here --- # Put the right path in here ---
# or just rely on finding zsh in # or just rely on finding zsh in
# $path, since `exec' handles that. # $path, since `exec' handles that.
exec /usr/local/bin/zsh $0 &quot;$@&quot; exec /usr/local/bin/zsh $0 "$@"
fi fi
print $ZSH_VERSION 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, <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 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 than fix the script, I suggest you upgrade the shell. Also, on some old
Bourne shells you might need to replace <code>&quot;$@&quot;</code> with <code>${1+&quot;$@&quot;}</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 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>). is the sort of thing we'll see in <a href="zshguide05.html#subst">chapter 5</a>).
Usually this isn't necessary.</p> Usually this isn't necessary.</p>
@ -5409,7 +5413,7 @@ life's not that simple.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -5423,31 +5427,48 @@ life's not that simple.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
</div> </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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

157
zsh_guide/book/zshguide04.html → zsh-guide/book/zshguide04.html
View File

@ -1,17 +1,16 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
<title>The Z-Shell Line Editor - Zsh User&#x27;s Guide</title> <title>The Z-Shell Line Editor - Zsh Guide</title>
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -116,7 +120,7 @@
</button> </button>
</div> </div>
<h1 class="menu-title">Zsh User&#x27;s Guide</h1> <h1 class="menu-title">Zsh Guide</h1>
<div class="right-buttons"> <div class="right-buttons">
<a href="print.html" title="Print this book" aria-label="Print this book"> <a href="print.html" title="Print this book" aria-label="Print this book">
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { 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 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 convention, were not supported at all and you had to bind the keys
yourself. This was done by something like:</p> yourself. This was done by something like:</p>
<pre><code> bindkey &quot;\eOA&quot; up-line-or-history <pre><code> bindkey "\eOA" up-line-or-history
bindkey &quot;\eOB&quot; down-line-or-history bindkey "\eOB" down-line-or-history
bindkey &quot;\eOC&quot; forward-char bindkey "\eOC" forward-char
bindkey &quot;\eOD&quot; backward-char bindkey "\eOD" backward-char
</code></pre> </code></pre>
<p>The shell tries harder now, and provided your system has the correct <p>The shell tries harder now, and provided your system has the correct
information about your terminal (zsh uses an old system called 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 are the two hex digits for the key. In the case of delete, it is
`<code>\x7f</code>'. You can confirm this by:</p> `<code>\x7f</code>'. You can confirm this by:</p>
<pre><code> % bindkey '\x7f' <pre><code> % bindkey '\x7f'
&quot;^?&quot; backward-delete-char "^?" backward-delete-char
</code></pre> </code></pre>
<p><span id="l82"></span></p> <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> <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) you can jump over real shell words (i.e. individual command arguments)
by using some more substitution trickery, or you can consider only 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 space-delimited words (though that's not so far from what you get with
<code>$WORDCHARS</code> by adding `<code>&quot;`'\@</code>').</p> <code>$WORDCHARS</code> by adding `<code>"`'\@</code>').</p>
<p><span id="l88"></span></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> <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 <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 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 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> control with the left-cursor key to send an escape sequence: insert</p>
<pre><code> Ctrl&lt;Key&gt;Left: string(0x1b) string(&quot;[159q&quot;) \n\ <pre><code> Ctrl&lt;Key&gt;Left: string(0x1b) string("[159q") \n\
</code></pre> </code></pre>
<p>into the middle of the example above --- this shows how multiple <p>into the middle of the example above --- this shows how multiple
definitions are handled. Modern xterms already send special escape 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 of this sort are going a little out of fashion. However, they do provide
quick shortcuts. Two from Oliver Kiddle:</p> quick shortcuts. Two from Oliver Kiddle:</p>
<pre><code> bindkey -s '^[[072q' '^V^I' # Ctrl-Tab <pre><code> bindkey -s '^[[072q' '^V^I' # Ctrl-Tab
bindkey -s &quot;\C-x\C-z&quot; &quot;\eqsuspend\n&quot; bindkey -s "\C-x\C-z" "\eqsuspend\n"
</code></pre> </code></pre>
<p>You can also quite easily do some of the things you can do with global <p>You can also quite easily do some of the things you can do with global
aliases.</p> 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) 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> 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> <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 &quot;\e[OA&quot; up-line-or-history <pre><code> bindkey -M vicmd "\e[OA" up-line-or-history
</code></pre> </code></pre>
<p>binds the usual up-cursor key in <code>vicmd</code> mode, whatever keymap is <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 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 finishes, and then use `<code>zle -N accept-line</code>. Here's a trivial but not
entirely stupid example:</p> entirely stupid example:</p>
<pre><code> accept-line() { <pre><code> accept-line() {
print -n &quot;\e]2;Executing $BUFFER\a&quot; print -n "\e]2;Executing $BUFFER\a"
zle .accept-line zle .accept-line
} }
zle -N accept-line zle -N accept-line
@ -1753,8 +1757,8 @@ and execute this widget.</p>
word2=$match[2] word2=$match[2]
if [[ -n $word1 &amp;&amp; -n $word2 ]]; then if [[ -n $word1 &amp;&amp; -n $word2 ]]; then
LBUFFER=&quot;$pat1$word2$ws1&quot; LBUFFER="$pat1$word2$ws1"
RBUFFER=&quot;$ws2$word1$pat2&quot; RBUFFER="$ws2$word1$pat2"
else else
zle beep zle beep
fi fi
@ -1792,11 +1796,11 @@ one heavy going. you probably don't want to look too closely at this.</p>
(shell) local bufwords (shell) local bufwords
# This splits the line into words as the shell understands them. # This splits the line into words as the shell understands them.
bufwords=(${(z)LBUFFER}) bufwords=(${(z)LBUFFER})
wordpat1=&quot;${(q)bufwords[-1]}&quot; wordpat1="${(q)bufwords[-1]}"
# Take substring of RBUFFER to skip over first character, # Take substring of RBUFFER to skip over first character,
# which is the one under the cursor. # which is the one under the cursor.
bufwords=(${(z)RBUFFER[2,-1]}) bufwords=(${(z)RBUFFER[2,-1]})
wordpat2=&quot;${(q)bufwords[1]}&quot; wordpat2="${(q)bufwords[1]}"
blankpat='[[:blank:]]#' blankpat='[[:blank:]]#'
;; ;;
(space) 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. # of alphanumerics and the characters in $wc.
# Quote $wc where necessary, because we don't want those # Quote $wc where necessary, because we don't want those
# characters to be considered as pattern characters later on. # characters to be considered as pattern characters later on.
blankpat=&quot;[^${(q)wc}a-zA-Z0-9]#&quot; blankpat="[^${(q)wc}a-zA-Z0-9]#"
# and a word character is anything else. # and a word character is anything else.
wordpat1=&quot;[${(q)wc}a-zA-Z0-9]##&quot; wordpat1="[${(q)wc}a-zA-Z0-9]##"
wordpat2=$wordpat1 wordpat2=$wordpat1
;; ;;
esac esac
@ -1835,8 +1839,8 @@ one heavy going. you probably don't want to look too closely at this.</p>
word2=$match[2] word2=$match[2]
if [[ -n $word1 &amp;&amp; -n $word2 ]]; then if [[ -n $word1 &amp;&amp; -n $word2 ]]; then
LBUFFER=&quot;$pat1$word2$ws1&quot; LBUFFER="$pat1$word2$ws1"
RBUFFER=&quot;$ws2$word1$pat2&quot; RBUFFER="$ws2$word1$pat2"
else else
zle beep zle beep
fi fi
@ -1896,15 +1900,15 @@ decimal.</p>
local msg modes key mode=dec code char local msg modes key mode=dec code char
# Prompt for and read a base. # Prompt for and read a base.
integer base=10 integer base=10
zle -R &quot;ASCII code (o -&gt; oct, x -&gt; hex) [$mode]: &quot; zle -R "ASCII code (o -&gt; oct, x -&gt; hex) [$mode]: "
read -k key read -k key
case $key in case $key in
(o) base=8 mode=oct (o) base=8 mode=oct
zle -R &quot;ASCII code [$mode]: &quot; zle -R "ASCII code [$mode]: "
read -k key read -k key
;; ;;
(x) base=16 mode=hex (x) base=16 mode=hex
zle -R &quot;ASCII code [$mode]: &quot; zle -R "ASCII code [$mode]: "
read -k key read -k key
;; ;;
esac esac
@ -1924,7 +1928,7 @@ decimal.</p>
# is an abnormal termination. # is an abnormal termination.
return 1 return 1
else else
code=&quot;${code}${key}&quot; code="${code}${key}"
fi fi
char= char=
if [[ -n $code ]]; then if [[ -n $code ]]; then
@ -1941,7 +1945,7 @@ decimal.</p>
# Prompt for any more digits, showing # Prompt for any more digits, showing
# the character as it would be inserted. # the character as it would be inserted.
zle -R &quot;ASCII code [$mode]: $code${char:+ = $char}&quot; zle -R "ASCII code [$mode]: $code${char:+ = $char}"
read -k key || return 1 read -k key || return 1
done done
# If aborted with no code, return # If aborted with no code, return
@ -1989,7 +1993,7 @@ character sets for now.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -2003,31 +2007,48 @@ character sets for now.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
</div> </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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

197
zsh_guide/book/zshguide05.html → zsh-guide/book/zshguide05.html
View File

@ -1,17 +1,16 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
<title>Substitutions - Zsh User&#x27;s Guide</title> <title>Substitutions - Zsh Guide</title>
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -116,7 +120,7 @@
</button> </button>
</div> </div>
<h1 class="menu-title">Zsh User&#x27;s Guide</h1> <h1 class="menu-title">Zsh Guide</h1>
<div class="right-buttons"> <div class="right-buttons">
<a href="print.html" title="Print this book" aria-label="Print this book"> <a href="print.html" title="Print this book" aria-label="Print this book">
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { 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 print 'a quoted string' and\ another\ argument
% read -r line &lt;file % read -r line &lt;file
% for word in ${(z)line}; do % for word in ${(z)line}; do
for&gt; print -r &quot;quoted: $word&quot; for&gt; print -r "quoted: $word"
for&gt; print -r &quot;unquoted: ${(Q)word}&quot; for&gt; print -r "unquoted: ${(Q)word}"
for&gt; done for&gt; done
quoted: print quoted: print
unquoted: print unquoted: print
@ -434,7 +438,7 @@ using `<code>print -l</code>', which prints one argument per line:</p>
bar bar
one one
two two
% print -l &quot;$(echo foo bar) $array&quot; % print -l "$(echo foo bar) $array"
foo bar one two foo bar one two
</code></pre> </code></pre>
<p>The reason this is `almost' invariable is that parameter substitution <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> 3</a>.</p>
<p>This is extended for other parameters in the following way:</p> <p>This is extended for other parameters in the following way:</p>
<pre><code> % array=(one two three) <pre><code> % array=(one two three)
% print -l &quot;${array[@]}&quot; % print -l "${array[@]}"
one one
two two
three three
</code></pre> </code></pre>
<p>and more generally for all forms of substitution using another flag, <p>and more generally for all forms of substitution using another flag,
<code>(@)</code>:</p> <code>(@)</code>:</p>
<pre><code> % print -l &quot;${(@)array}&quot; <pre><code> % print -l "${(@)array}"
one one
two two
three 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 <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> square brackets are referred to as subscripts. This can get the <code>(@)</code>
treatment, too:</p> treatment, too:</p>
<pre><code> % print -l &quot;${(@)array[2,-1]}&quot; <pre><code> % print -l "${(@)array[2,-1]}"
two two
three three
</code></pre> </code></pre>
<p>Although it's probably not obvious, you can use the other notation in <p>Although it's probably not obvious, you can use the other notation in
this case:</p> this case:</p>
<pre><code> % print -l &quot;${array[@][2,-1]}&quot; <pre><code> % print -l "${array[@][2,-1]}"
two two
three three
</code></pre> </code></pre>
<p>The shell will actually handle arbitrary numbers of subscripts in <p>The shell will actually handle arbitrary numbers of subscripts in
parameter substitutions, not just one; each applies to the result of the parameter substitutions, not just one; each applies to the result of the
previous one:</p> previous one:</p>
<pre><code> % print -l &quot;${array[@][2,-1][1]}&quot; <pre><code> % print -l "${array[@][2,-1][1]}"
two two
</code></pre> </code></pre>
<p>What you have to watch out for is that that last subscript selected a <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 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> only on the <em>characters</em> in that word, not on array elements:</p>
<pre><code> % print -l &quot;${array[@][2,1][1][2,-1]}&quot; <pre><code> % print -l "${array[@][2,1][1][2,-1]}"
wo wo
</code></pre> </code></pre>
<p>We've now strayed severely off topic: the subscripts will of course work <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 Words on line two
% args $(&lt;file) % args $(&lt;file)
8 8
% args &quot;$(&lt;file)&quot; % args "$(&lt;file)"
1 1
</code></pre> </code></pre>
<p>The unquoted substitution split the file into individual words; the <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 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 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> expansion, one word per line'. Here's how to use it in this case:</p>
<pre><code> % args &quot;${(f)$(&lt;file)}&quot; <pre><code> % args "${(f)$(&lt;file)}"
2 2
</code></pre> </code></pre>
<p>Where you would usually put the name of a parameter, you put the command <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 <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 difficult to decide how many levels of quotes are required inside a
backquoted expression. Consider:</p> backquoted expression. Consider:</p>
<pre><code> % print &quot;`echo \&quot;hello\&quot;`&quot; <pre><code> % print "`echo \"hello\"`"
hello hello
% print &quot;$(echo \&quot;hello\&quot;)&quot; % print "$(echo \"hello\")"
&quot;hello&quot; "hello"
</code></pre> </code></pre>
<p>It's hard to explain quite what the difference here is without waving my <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 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 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. 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, So in the second case there is no doubt that the embedded command line,
`<code>echo \&quot;hello\&quot;</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 outside the command substitution; whereas in the first place, the quotes
within quotes had to be, um, quoted.</p> within quotes had to be, um, quoted.</p>
<p>As a consequence, in</p> <p>As a consequence, in</p>
<pre><code> % print &quot;$(echo &quot;hello&quot;)&quot; <pre><code> % print "$(echo "hello")"
hello hello
</code></pre> </code></pre>
<p>you need to be careful: at first glance, the pairs of double quotes <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 virtue of the substitution. You see the same thing with parameter
substitution:</p> substitution:</p>
<pre><code> % unset foo <pre><code> % unset foo
% print &quot;${foo:-&quot;a string&quot;}&quot; % print "${foo:-"a string"}"
a string a string
</code></pre> </code></pre>
<p>A third, less good, reason for using the form with parentheses is that <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 for arg in $*; do
case $arg in case $arg in
(*.bz2) args[$i]=&quot;=(bunzip2 -c ${(q)arg})&quot; (*.bz2) args[$i]="=(bunzip2 -c ${(q)arg})"
;; ;;
# this assumes your zcat is the one installed with gzip: # this assumes your zcat is the one installed with gzip:
(*.(gz|Z)) args[$i]=&quot;=(zcat ${(q)arg})&quot; (*.(gz|Z)) args[$i]="=(zcat ${(q)arg})"
;; ;;
(*) args=${(q)arg} (*) args=${(q)arg}
;; ;;
@ -850,7 +854,7 @@ passed to a command again:</p>
1 1
% args ${array[(r)X*]} % args ${array[(r)X*]}
0 0
% args &quot;${array[(r)X*]}&quot; % args "${array[(r)X*]}"
1 1
</code></pre> </code></pre>
<p>where in the last case the empty string was quoted, and passed down as a <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) <pre><code> array=(three egregious words)
for pat in '*e*e*' '*a*a*'; do for pat in '*e*e*' '*a*a*'; do
if [[ ${array[(i)$pat]} -le ${#array} ]]; then if [[ ${array[(i)$pat]} -le ${#array} ]]; then
print &quot;Pattern $pat matched in array: ${array[(r)$pat]}.&quot; print "Pattern $pat matched in array: ${array[(r)$pat]}."
else else
print &quot;Pattern $pat failed to match in array&quot; print "Pattern $pat failed to match in array"
fi fi
done done
</code></pre> </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 <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>, 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> whether as a flag or a subscript, and double quotes, will always work:</p>
<pre><code> % print -l &quot;${(@kv)assoc}&quot; <pre><code> % print -l "${(@kv)assoc}"
* *
asterisk asterisk
] ]
@ -1076,7 +1080,7 @@ in perl and zsh.</p>
$hash{key} ${hash[key]} $hash{key} ${hash[key]}
keys %hash ${(k)hash} keys %hash ${(k)hash}
values %hash ${(v)hash} values %hash ${(v)hash}
%hash2 = %hash; typeset -A hash2; hash2=(&quot;${(@kv)hash}&quot;) %hash2 = %hash; typeset -A hash2; hash2=("${(@kv)hash}")
unset %hash; unset hash unset %hash; unset hash
if (exists $hash{key}) { if (( ${+hash[key]} )); then 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 84
% print ${(c)#path} % print ${(c)#path}
84 84
% foo=&quot;three scalar words&quot; % foo="three scalar words"
% print ${(w)#foo} % print ${(w)#foo}
3 3
</code></pre> </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 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 <code>(W)</code>, which treats multiple word separators as having zero-length words
in between:</p> in between:</p>
<pre><code> % foo=&quot;three well-spaced word&quot; <pre><code> % foo="three well-spaced word"
% print ${(w)#foo} % print ${(w)#foo}
3 3
% print ${(W)#foo} % 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 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 length. In this case, <em>value</em> will often be another parameter
substitution:</p> substitution:</p>
<pre><code> print ${value:+&quot;the value of value is $value&quot;} <pre><code> print ${value:+"the value of value is $value"}
</code></pre> </code></pre>
<p>prints the string only if <code>$#value</code> is greater than zero. Note that what <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 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 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 applies to the values after `<code>:-</code>' and `<code>:=</code>', too. One other commonly
seen trick might be worth mentioning:</p> seen trick might be worth mentioning:</p>
<pre><code> print ${1+&quot;$@&quot;} <pre><code> print ${1+"$@"}
</code></pre> </code></pre>
<p>substitutes all the positional parameters as they were passed if the <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 first one was set (here you don't want the colon). This was necessary in
some old shells because <code>&quot;$@&quot;</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 argument instead of no arguments when no arguments were passed. This
workaround isn't necessary in zsh, nor in most modern Bourne-derived 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 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 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 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> <code>SH_WORD_SPLIT</code> (my personal preference), or use quotes:</p>
<pre><code> % print -l &quot;${(j.:.)foo}&quot; <pre><code> % print -l "${(j.:.)foo}"
another array:of:words with spaces another array:of:words with spaces
</code></pre> </code></pre>
<p>The elements of an array would normally be joined by spaces in this <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 the string to split on, but also ensures the split will take place even
if the expression is quoted:</p> if the expression is quoted:</p>
<pre><code> % array=('element one' 'element two' 'element three') <pre><code> % array=('element one' 'element two' 'element three')
% print -l &quot;${=array}&quot; % print -l "${=array}"
element element
one one
element element
@ -1525,7 +1529,7 @@ array.</p>
<p>I will talk shortly about nested parameter substitution; you should also <p>I will talk shortly about nested parameter substitution; you should also
note that splitting and joining will if necessary take place at all note that splitting and joining will if necessary take place at all
levels of a nested substitution, not just the outermost one:</p> levels of a nested substitution, not just the outermost one:</p>
<pre><code> % foo=&quot;three blind words&quot; <pre><code> % foo="three blind words"
% print ${#${(z)foo}} % print ${#${(z)foo}}
3 3
</code></pre> </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 <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 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 effect of perl's `<code>x</code>' operator (for those not familiar with perl, the
expression `<code>&quot;string&quot; 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 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 width, not the number of repetitions, so you need to multiply it by the
length of the string:</p> length of the string:</p>
@ -1682,7 +1686,7 @@ probably be the neatest way of doing the same thing:</p>
<pre><code> # Perl code. <pre><code> # Perl code.
@p = qw(/dir1/file1.ext1 /dir2/file2.ext2); @p = qw(/dir1/file1.ext1 /dir2/file2.ext2);
@q = map { m%^(?:.*/)(.*?)(?:\.[^.]*|)$%; } @p; @q = map { m%^(?:.*/)(.*?)(?:\.[^.]*|)$%; } @p;
print &quot;@q\n&quot;;' print "@q\n";'
</code></pre> </code></pre>
<p>or numerous possible variants. In a shell, there's no way of putting <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 functions like that into the command line without complicating the basic
@ -1826,7 +1830,7 @@ remember the longest element:</p>
$newl = length $_; $newl = length $_;
$elt = $_, $l = $newl if $l &gt; $newl; $elt = $_, $l = $newl if $l &gt; $newl;
} }
print $elt, &quot;\n&quot;; print $elt, "\n";
</code></pre> </code></pre>
<p>You can do just the same thing in zsh easily enough in this case;</p> <p>You can do just the same thing in zsh easily enough in this case;</p>
<pre><code> local val elt <pre><code> local val elt
@ -2082,7 +2086,7 @@ confused:</p>
<p>because `<code>$s</code>' evaluates to an empty string before the arithmetic <p>because `<code>$s</code>' evaluates to an empty string before the arithmetic
evaluation proper, which spoils the syntax. There's one common case evaluation proper, which spoils the syntax. There's one common case
where you need to do that, and that's with positional parameters:</p> where you need to do that, and that's with positional parameters:</p>
<pre><code> % fn() { print &quot;Twice $1 is $(( 2 * $1 ))&quot;; } <pre><code> % fn() { print "Twice $1 is $(( 2 * $1 ))"; }
% fn 3 % fn 3
Twice 3 is 6 Twice 3 is 6
% fn % fn
@ -2090,7 +2094,7 @@ where you need to do that, and that's with positional parameters:</p>
</code></pre> </code></pre>
<p>Obviously turning the `<code>$1</code>' into `<code>1</code>' means something completely <p>Obviously turning the `<code>$1</code>' into `<code>1</code>' means something completely
different. You can guard against this with default values:</p> different. You can guard against this with default values:</p>
<pre><code> % fn() { print &quot;Twice ${1:=0} is $(( 2 * $1 ))&quot;; } <pre><code> % fn() { print "Twice ${1:=0} is $(( 2 * $1 ))"; }
% fn % fn
Twice 0 is 0 Twice 0 is 0
</code></pre> </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 combination with <code>MAGIC_EQUAL_SUBST</code>, you will get the same behaviour
with any command argument that looks like an assignment --- actually, 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 anything following an `<code>=</code>' which wasn't at the start of the word, so
`<code>&quot;hello mother, =&gt; I'm home &quot;$(echo right now)</code>' qualifies.</p> `<code>"hello mother, =&gt; 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> <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> <code>MAGIC_EQUAL_SUBST</code> are always in effect.</p>
<p><span id="l135"></span></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 setopt localoptions extendedglob
if [[ $1 = ([-+]|)([0-9]##.[0-9]#|[0-9]#.[0-9]##)\ if [[ $1 = ([-+]|)([0-9]##.[0-9]#|[0-9]#.[0-9]##)\
([eE]([-+]|)[0-9]##|) ]]; then ([eE]([-+]|)[0-9]##|) ]]; then
print -r -- &quot;$1 is a floating point number&quot; print -r -- "$1 is a floating point number"
else else
print -r -- &quot;$1 is not a floating point number&quot; print -r -- "$1 is not a floating point number"
fi fi
} }
</code></pre> </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 happen, such as a case statement label, you can omit any parentheses
that would completely surround the pattern. So in</p> that would completely surround the pattern. So in</p>
<pre><code> case $foo in <pre><code> case $foo in
(bar|rod|pipe) print &quot;foo represents a piece of metal&quot; (bar|rod|pipe) print "foo represents a piece of metal"
;; ;;
(*) print &quot;Are you trying to be different?&quot; (*) print "Are you trying to be different?"
;; ;;
esac esac
</code></pre> </code></pre>
@ -3265,7 +3269,7 @@ function to correct misspelled filenames.</p>
fi fi
for (( approx = 1; approx &lt;= max_approx; approx++ )); do for (( approx = 1; approx &lt;= max_approx; approx++ )); do
trylist=( (#a$approx)&quot;$file&quot;(N) ) trylist=( (#a$approx)"$file"(N) )
(( $#trylist )) &amp;&amp; break (( $#trylist )) &amp;&amp; break
done done
(( $#trylist )) || return 1 (( $#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> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -3489,31 +3493,48 @@ generic way of passing down options to the programmes executed, using
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
</div> </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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

229
zsh_guide/book/zshguide06.html → zsh-guide/book/zshguide06.html
View File

@ -1,17 +1,16 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
<title>Completion, old and new - Zsh User&#x27;s Guide</title> <title>Completion, old and new - Zsh Guide</title>
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -116,7 +120,7 @@
</button> </button>
</div> </div>
<h1 class="menu-title">Zsh User&#x27;s Guide</h1> <h1 class="menu-title">Zsh Guide</h1>
<div class="right-buttons"> <div class="right-buttons">
<a href="print.html" title="Print this book" aria-label="Print this book"> <a href="print.html" title="Print this book" aria-label="Print this book">
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { 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 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 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 to make arrangements for completing after every alias which does not
already match the name of a command. Hence `<code>alias zcat=&quot;myzcat -dc&quot;</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 will work with the option set, even if you haven't told the system about
`<code>myzcat</code>', while `<code>alias myzcat=&quot;gzip -dc&quot;</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 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 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>, 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/ rod/ stick/
</code></pre> </code></pre>
<p>There's more you can do with the <code>tag-order</code> style: if you put the tags <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>&quot;local-directories path-directories&quot;</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 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 much work to know what tags are going to be available for every single
possible completion, the default when there is no appropriate 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 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> 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 <p>Note that the rule for testing patterns means that you can always
specify a catch-all worst case by `<code>zstyle &quot;*&quot; 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 always be tried last --- not just in completion, in fact, since other
parts of the shell use the styles mechanism, and without the parts of the shell use the styles mechanism, and without the
`<code>:completion:</code>' at the start of the context this style definition will `<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 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, 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> while having the style set to the empty string is equivalent to:</p>
<pre><code> ZLS_COLORS=&quot;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:\ 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 ex=01;32:lc=\e[:rm=m:tc=00:sp=00:ma=07:hi=00:du=00
</code></pre> </code></pre>
<p>It has essentially the same format as <code>$LS_COLORS</code>, and indeed you can <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 get a more useful set of values by using the <code>dircolors</code> command which
comes with <code>ls</code>:</p> comes with <code>ls</code>:</p>
<pre><code> ZLS_COLORS=&quot;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:\ 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:\ 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:\ *.arj=01;31:*.taz=01;31:*.lzh=01;31:*.zip=01;31:\
*.z=01;31:*.Z=01;31:*.gz=01;31:*.deb=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:\ *.jpg=01;35:*.gif=01;35:*.bmp=01;35:*.ppm=01;35:\
*.tga=01;35:*.xbm=01;35:*.xpm=01;35:*.tif=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:&quot; *.mpg=01;37:*.avi=01;37:*.gl=01;37:*.dl=01;37:"
</code></pre> </code></pre>
<p>You should see the manual for the <code>zsh/complist</code> module for details, but <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 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 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 the value it has found has come from the user or is a previous value
taken from some style. That takes this format:</p> taken from some style. That takes this format:</p>
<pre><code> zstyle ':completion:*' list-colors &quot;no=00&quot; &quot;fi=00&quot; ... <pre><code> zstyle ':completion:*' list-colors "no=00" "fi=00" ...
</code></pre> </code></pre>
<p>You can use an already defined <code>$LS_COLORS</code>:</p> <p>You can use an already defined <code>$LS_COLORS</code>:</p>
<pre><code> zstyle ':completion:*' list-colors ${(s.:.)LS_COLORS} <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 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> default to avoid clashes. This will do it:</p>
<pre><code> for key in '!' '$' '@' '/'; do <pre><code> for key in '!' '$' '@' '/'; do
bindkey &quot;\e$key&quot; _bash_complete-word bindkey "\e$key" _bash_complete-word
bindkey &quot;^X$key&quot; _bash_list-choices bindkey "^X$key" _bash_list-choices
done done
</code></pre> </code></pre>
<p>Unlike most widgets, which are tied to functions of the same name to <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 # Code to make sure _perforce is run when we load it
_perforce &quot;$@&quot; _perforce "$@"
</code></pre> </code></pre>
<p>That last line is probably the least obvious. It's because of the fact <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 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 # Remember the subcommand name
local cmd=${words[2]} local cmd=${words[2]}
# Set the context for the subcommand. # Set the context for the subcommand.
curcontext=&quot;${curcontext%:*:*}:p4-$cmd&quot; curcontext="${curcontext%:*:*}:p4-$cmd"
# Narrow the range of words we are looking at to exclude `p4' # Narrow the range of words we are looking at to exclude `p4'
(( CURRENT-- )) (( CURRENT-- ))
shift words 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 _call_program help-commands p4 help commands | while read -A hline; do
(( ${#hline} &lt; 2 )) &amp;&amp; continue (( ${#hline} &lt; 2 )) &amp;&amp; continue
[[ $hline[1] = (#i)perforce ]] &amp;&amp; continue [[ $hline[1] = (#i)perforce ]] &amp;&amp; continue
cmdlist=($cmdlist &quot;${hline[1]}:${hline[2,-1]}&quot;) cmdlist=($cmdlist "${hline[1]}:${hline[2,-1]}")
done done
_describe -t p4-commands 'Perforce command' cmdlist _describe -t p4-commands 'Perforce command' cmdlist
fi fi
@ -3170,7 +3174,7 @@ version.</p>
'-d-[select diff option]:diff option:'\ '-d-[select diff option]:diff option:'\
'((b\:ignore\ blanks c\:context n\:RCS s\:summary'\ '((b\:ignore\ blanks c\:context n\:RCS s\:summary'\
'u\:unified w\:ignore\ all\ whitespace))' \ 'u\:unified w\:ignore\ all\ whitespace))' \
&quot;*::file:_perforce_files&quot; "*::file:_perforce_files"
} }
</code></pre> </code></pre>
<p>I've split the argument beginning <code>-d</code> into three lines to fit, but it's <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> this.)</p>
<p>I'm going to say we can complete both like this:</p> <p>I'm going to say we can complete both like this:</p>
<pre><code> _alternative \ <pre><code> _alternative \
&quot;files:file:_path_files&quot; \ "files:file:_path_files" \
&quot;subdirs:subdirectory search:_perforce_subdir_search&quot; "subdirs:subdirectory search:_perforce_subdir_search"
</code></pre> </code></pre>
<p>The function <code>_alternative</code> is a little bit like <code>_arguments</code>, but <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 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> completion. This is quite simple:</p>
<pre><code> _perforce_subdir_search() { <pre><code> _perforce_subdir_search() {
compset -P '*/' compset -P '*/'
compadd &quot;$@&quot; '...' compadd "$@" '...'
} }
</code></pre> </code></pre>
<p>The first line tells the completion system to ignore anything up to the <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 <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 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 some on the arguments which we got to `<code>_perforce_subdir_search</code>' via
`<code>&quot;$@&quot;</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 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 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>subdirs</code>' and the description `<code>subdirectory search</code>'. So that extra
`<code>&quot;$@&quot;</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 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 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 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 # add other alternatives, such as the `...' thing
altfiles=($altfiles altfiles=($altfiles
&quot;subdirs:subdirectory search:_perforce_subdir_search&quot; "subdirs:subdirectory search:_perforce_subdir_search"
) )
_alternative $altfiles _alternative $altfiles
else else
_alternative \ _alternative \
&quot;files:file:_path_files&quot; \ "files:file:_path_files" \
&quot;subdirs:subdirectory search:_perforce_subdir_search&quot; "subdirs:subdirectory search:_perforce_subdir_search"
fi fi
</code></pre> </code></pre>
<p>where we are still to write the functions for the first two alternatives <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 local -a files
compset -P '*/' compset -P '*/'
files=(${${${(f)&quot;$(\ files=(${${${(f)"$(\
_call_program files p4 files \ _call_program files p4 files \
\&quot;\$pfx\*\$\{\(Q\)SUFFIX\}\&quot; 2&gt;/dev/null)&quot;}%\#*}##*/}) \"\$pfx\*\$\{\(Q\)SUFFIX\}\" 2&gt;/dev/null)"}%\#*}##*/})
[[ $#files -eq 1 &amp;&amp; $files[1] = '' ]] &amp;&amp; files=() [[ $#files -eq 1 &amp;&amp; $files[1] = '' ]] &amp;&amp; files=()
compadd &quot;$@&quot; -a files compadd "$@" -a files
} }
</code></pre> </code></pre>
<p>A little messy (and still not quite the full horror). I've split the key <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 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 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 how Perforce knows the file, using the <code>(Q)</code> parameter flag. We then
pass the argument <code>&quot;$pfx*${(Q)SUFFIX}&quot;</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 matching files internally. The extra layer of backslash-quoting is for
the benefit of <code>_call_program</code>, which re-evaluates its arguments; this 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 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> right can be.</p>
<p>Once we've got the list of bare filenames, we check to see if the list <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 is just one element with no length. That's an artefact of the the
<code>&quot;$(cmd)&quot;</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> 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 <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 description have already been handled and we just need to make sure the
appropriate options get passed in with <code>&quot;$@&quot;</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, `<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 not a list of completions. This is more efficient; compadd only needs to
expand the array internally instead of the shell passing a potentially 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> historically where this feature came from).</p>
<p>The method is to add an extra argument everywhere we complete a file <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> name. For example, change the <code>compadd</code> in <code>_perforce_depot_files</code> to:</p>
<pre><code> compadd &quot;$@&quot; -R _perforce_file_suffix -a files <pre><code> compadd "$@" -R _perforce_file_suffix -a files
</code></pre> </code></pre>
<p>where the option argument specifies a function:</p> <p>where the option argument specifies a function:</p>
<pre><code> _perforce_file_suffix() { <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 [[ $LBUFFER[-1] = ' ' ]]; then
if [[ $KEYS = '#' ]]; then if [[ $KEYS = '#' ]]; then
# Suffix removal with an added backslash # Suffix removal with an added backslash
LBUFFER=&quot;$LBUFFER[1,-2]\\&quot; LBUFFER="$LBUFFER[1,-2]\\"
elif [[ $KEYS = (*[^[:print:]]*|[[:blank:]\;\&amp;\|@]) ]]; then elif [[ $KEYS = (*[^[:print:]]*|[[:blank:]\;\&amp;\|@]) ]]; then
# Normal suffix removal # Normal suffix removal
LBUFFER=&quot;$LBUFFER[1,-2]&quot; LBUFFER="$LBUFFER[1,-2]"
fi fi
fi fi
} }
@ -3572,7 +3576,7 @@ numbers with the all-important descriptions.</p>
_call_program filelog p4 filelog \$pfx 2&gt;/dev/null | _call_program filelog p4 filelog \$pfx 2&gt;/dev/null |
while read rline; do while read rline; do
if [[ $rline = (#b)'... #'(&lt;-&gt;)*\'(*)\' ]]; then if [[ $rline = (#b)'... #'(&lt;-&gt;)*\'(*)\' ]]; then
rl=($l &quot;${match[1]}:${match[2]}&quot;) rl=($l "${match[1]}:${match[2]}")
fi fi
done done
fi fi
@ -3634,7 +3638,7 @@ function are called <code>_gunzip</code>:</p>
local expl local expl
_description files expl 'compressed file' _description files expl 'compressed file'
_files &quot;$expl[@]&quot; -g '*.[gG][zZ]' _files "$expl[@]" -g '*.[gG][zZ]'
</code></pre> </code></pre>
<p>You can probably see straight away that if you want to design your own <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 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 simply adds all possible files as completions, taking account of the
word on the command line to establish directories and so on.</p> 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 <p>For more specific use, you can give it various options: `<code>-/</code>' means
complete directories, and, as you saw, `<code>-g &quot;&lt;pattern&gt;&quot;</code>' gives a complete directories, and, as you saw, `<code>-g "&lt;pattern&gt;"</code>' gives a
filename generation pattern to produce matching files.</p> filename generation pattern to produce matching files.</p>
<p>A couple of other options, which can be combined with the ones above, <p>A couple of other options, which can be combined with the ones above,
are worthy of mention. If you use `<code>-W &lt;dir&gt;</code>', then completion takes are worthy of mention. If you use `<code>-W &lt;dir&gt;</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, <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> 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 <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 &quot;&lt;pat&gt;&quot;</code>'; can be intercepted, if you need to, with the option `<code>-F "&lt;pat&gt;"</code>';
`<code>&lt;pat&gt;</code>' is an array of patterns to ignore, in the usual completion `<code>&lt;pat&gt;</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 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 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> strong stomach will be useful here.</p>
<p>For example, here is the expansion used by the <code>_limits</code> function to <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> retrieve the names of resource limits from the <code>limit</code> command itself:</p>
<pre><code> print ${${(f)&quot;$(limit)&quot;}%% *} <pre><code> print ${${(f)"$(limit)"}%% *}
</code></pre> </code></pre>
<p>which you can test does the right thing. Here's a translation: <p>which you can test does the right thing. Here's a translation:
<code>&quot;$(limit)&quot;</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 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 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. 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> <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 functions for filename completion. Also, you can get some help using the
<code>compset</code> builtin command. In this case, the incantation is</p> <code>compset</code> builtin command. In this case, the incantation is</p>
<pre><code> if compset -P &quot;*/&quot;; then <pre><code> if compset -P "*/"; then
# do whatever you need to with the leading # do whatever you need to with the leading
# string up to / stripped off # string up to / stripped off
else 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 <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> effect of changing the prefixes and suffixes, there are tests like this:</p>
<pre><code> if [[ -prefix */ ]]; then <pre><code> if [[ -prefix */ ]]; then
# same as with `compset -P &quot;*/&quot;', except prefixes were left alone. # same as with `compset -P "*/"', except prefixes were left alone.
fi fi
</code></pre> </code></pre>
<p>These have the advantage of looking like all the standard tests <p>These have the advantage of looking like all the standard tests
understood by the shell.</p> understood by the shell.</p>
<p>There are three other parameters special to completion. The <code>$QIPREFIX</code> <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 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 &quot;echo hi&quot;</code>', the dividing up a quoted word --- for example, in `<code>zsh -c "echo hi"</code>', the
word <code>&quot;echo hi&quot;</code> is going to be used as a command line in its own right, 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 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> 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 <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> to extract the <code>$NUMERIC</code>th (default first) most recently modified file.</p>
<pre><code> local file <pre><code> local file
file=($~PREFIX*$~SUFFIX(om[${NUMERIC:-1}]N)) file=($~PREFIX*$~SUFFIX(om[${NUMERIC:-1}]N))
(( $#file )) &amp;&amp; compadd -U -i &quot;$IPREFIX&quot; -I &quot;$ISUFFIX&quot; -f -Q - $file (( $#file )) &amp;&amp; compadd -U -i "$IPREFIX" -I "$ISUFFIX" -f -Q - $file
</code></pre> </code></pre>
<p>Instead of doing it with mirrors, this uses globbing qualifiers to <p>Instead of doing it with mirrors, this uses globbing qualifiers to
extract the required file; <code>om</code> specifies ordering by modification time, 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 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 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 the command line. However, `<code>-U</code>' would delete that too. Hence the
`<code>-i &quot;$IPREFIX&quot;</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 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 <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 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> example,</p>
<pre><code> local expl <pre><code> local expl
_description files expl 'my special files' _description files expl 'my special files'
_files &quot;$expl[@]&quot; _files "$expl[@]"
</code></pre> </code></pre>
<p>This sets the files tag; <code>_description</code> sets <code>$expl</code> to pass on the <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 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> like this:</p>
<pre><code> _wanted files expl 'my special files' _files <pre><code> _wanted files expl 'my special files' _files
</code></pre> </code></pre>
<p>Note that you now don't pass the <code>&quot;$expl[@]&quot;</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 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 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 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 <pre><code> local expl ret=1
_tags foo bar rod _tags foo bar rod
while _tags; do while _tags; do
_requested foo expl &quot;This is the description for tag foo&quot; \ _requested foo expl "This is the description for tag foo" \
compadd all foos completions &amp;&amp; ret=0 compadd all foos completions &amp;&amp; ret=0
_requested bar expl &quot;This is the description for tag bar&quot; \ _requested bar expl "This is the description for tag bar" \
compadd all bars completions &amp;&amp; ret=0 compadd all bars completions &amp;&amp; ret=0
_requested rod expl &quot;This is the description for tag rod&quot; \ _requested rod expl "This is the description for tag rod" \
compadd all rods completions &amp;&amp; ret=0 compadd all rods completions &amp;&amp; ret=0
(( ret )) || return 0 # leave if matches were generated (( ret )) || return 0 # leave if matches were generated
done done
@ -4257,7 +4261,7 @@ valid tag is its argument and acts accordingly, and can be used only for
simple, `one-shot' completions.</p> simple, `one-shot' completions.</p>
<p>With <code>_requested</code>, unlike <code>_wanted</code>, you can separate out the arguments <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 to the completion generator itself --- here <code>compadd</code> --- into a
different statement, remembering the <code>&quot;$expl[@]&quot;</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 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 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 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 <pre><code> _tags sequences
while _tags; do while _tags; do
while _next_label sequences expl sequence; do while _next_label sequences expl sequence; do
compadd &quot;$expl[@]&quot; $(mark $foldnam 2&gt;/dev/null | compadd "$expl[@]" $(mark $foldnam 2&gt;/dev/null |
awk -F: '{ print $1 }') &amp;&amp; ret=0 awk -F: '{ print $1 }') &amp;&amp; ret=0
compadd &quot;$expl[@]&quot; reply next cur prev \ compadd "$expl[@]" reply next cur prev \
first last all unseen &amp;&amp; ret=0 first last all unseen &amp;&amp; ret=0
_files &quot;$expl[@]&quot; -W folddir -g '&lt;-&gt;' &amp;&amp; ret=0 _files "$expl[@]" -W folddir -g '&lt;-&gt;' &amp;&amp; ret=0
done done
(( ret )) || return 0 (( ret )) || return 0
done 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 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 tag. When you need to look something up, you pass this context to
<code>zstyle</code> with `<code>:completion:</code>' stuck in front:</p> <code>zstyle</code> with `<code>:completion:</code>' stuck in front:</p>
<pre><code> zstyle -b &quot;:completion:${curcontext}:tag&quot; style-name parameter <pre><code> zstyle -b ":completion:${curcontext}:tag" style-name parameter
</code></pre> </code></pre>
<p>If the tag is irrelevant, you can leave it empty, but you still need the <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 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 status zero if and only if the <code>pattern</code> matches one of the values
stored in the style for the given context.</p> stored in the style for the given context.</p>
<p>Typical usages are thus:</p> <p>Typical usages are thus:</p>
<pre><code> if zstyle -t &quot;:completion:${curcontext}:&quot; foo; then <pre><code> if zstyle -t ":completion:${curcontext}:" foo; then
# do things in a fooish way # do things in a fooish way
else else
# do things in an unfooish way # do things in an unfooish way
@ -4435,7 +4439,7 @@ stored in the style for the given context.</p>
</code></pre> </code></pre>
<p>or to use the value:</p> <p>or to use the value:</p>
<pre><code> local val <pre><code> local val
if zstyle -s &quot;:completion:${curcontext}:&quot; foo val; then if zstyle -s ":completion:${curcontext}:" foo val; then
# use $val to establish how fooish to be # use $val to establish how fooish to be
else else
# be defaultly fooish # be defaultly fooish
@ -4491,7 +4495,7 @@ These are the possible completions, passed straight down to
<li> <li>
<p>The same, but with double parentheses; the list in this case <p>The same, but with double parentheses; the list in this case
consists of the completion, a backslashed colon, and a description. 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> other colons inside the specifications in this way, too.</p>
</li> </li>
<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 that with several different sets of completions that may require
different options to <code>compadd</code>. The general form looks something like different options to <code>compadd</code>. The general form looks something like
this:</p> this:</p>
<pre><code> _describe &quot;description of set 1&quot; descs1 compls1 \ <pre><code> _describe "description of set 1" descs1 compls1 \
&lt;compadd-opts-1&gt; -- \ &lt;compadd-opts-1&gt; -- \
&quot;description of set 2&quot; ... "description of set 2" ...
</code></pre> </code></pre>
<p>where you can have any number of sets separated by the `<code>-``-</code>'. The <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 <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> reasonable usage:</p>
<pre><code> local groups expl <pre><code> local groups expl
groups=($(awk -F: '{ print $1 }' ~/.newsrc)) groups=($(awk -F: '{ print $1 }' ~/.newsrc))
_wanted groups expl 'newsgroup' _multi_parts &quot;$expl[@]&quot; . groups _wanted groups expl 'newsgroup' _multi_parts "$expl[@]" . groups
</code></pre> </code></pre>
<p>The generated array contains names of Usenet newsgroups, i.e. names with <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 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> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -4928,31 +4932,48 @@ using just the tab key and ordinary characters.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
</div> </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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

107
zsh_guide/book/zshguide07.html → zsh-guide/book/zshguide07.html
View File

@ -1,17 +1,16 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
<title>Modules and other bits and pieces Not written - Zsh User&#x27;s Guide</title> <title>Modules and other bits and pieces Not written - Zsh Guide</title>
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -116,7 +120,7 @@
</button> </button>
</div> </div>
<h1 class="menu-title">Zsh User&#x27;s Guide</h1> <h1 class="menu-title">Zsh Guide</h1>
<div class="right-buttons"> <div class="right-buttons">
<a href="print.html" title="Print this book" aria-label="Print this book"> <a href="print.html" title="Print this book" aria-label="Print this book">
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
@ -211,24 +215,41 @@
</div> </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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

0
zsh_guide/src/SUMMARY.md → zsh-guide/src/SUMMARY.md
View File

0
zsh_guide/src/zshguide.md → zsh-guide/src/zshguide.md
View File

0
zsh_guide/src/zshguide01.md → zsh-guide/src/zshguide01.md
View File

0
zsh_guide/src/zshguide02.md → zsh-guide/src/zshguide02.md
View File

0
zsh_guide/src/zshguide03.md → zsh-guide/src/zshguide03.md
View File

0
zsh_guide/src/zshguide04.md → zsh-guide/src/zshguide04.md
View File

0
zsh_guide/src/zshguide05.md → zsh-guide/src/zshguide05.md
View File

0
zsh_guide/src/zshguide06.md → zsh-guide/src/zshguide06.md
View File

0
zsh_guide/src/zshguide07.md → zsh-guide/src/zshguide07.md
View File

0
zsh_guide/src/zshguide08.md → zsh-guide/src/zshguide08.md
View File

836
zsh-guide/theme/catppuccin.css Normal file
View 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;
}

112
zsh_manual/theme/index.hbs → zsh-guide/theme/index.hbs
View File

@ -1,11 +1,11 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="{{ language }}" class="sidebar-visible no-js {{ default_theme }}"> <html lang="{{ language }}" class="{{ default_theme }} sidebar-visible" dir="{{ text_direction }}">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
<title>{{ title }}</title> <title>{{ title }}</title>
{{#if is_print }} {{#if is_print }}
<meta name="robots" content="noindex" /> <meta name="robots" content="noindex">
{{/if}} {{/if}}
{{#if base_url}} {{#if base_url}}
<base href="{{ base_url }}"> <base href="{{ base_url }}">
@ -15,10 +15,9 @@
<!-- Custom HTML head --> <!-- Custom HTML head -->
{{> head}} {{> head}}
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content="{{ description }}"> <meta name="description" content="{{ description }}">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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}} {{#if favicon_svg}}
<link rel="icon" href="{{ path_to_root }}favicon.svg"> <link rel="icon" href="{{ path_to_root }}favicon.svg">
@ -51,18 +50,21 @@
{{#if mathjax_support}} {{#if mathjax_support}}
<!-- MathJax --> <!-- 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}} {{/if}}
</head>
<body>
<!-- Provide site root to javascript --> <!-- Provide site root to javascript -->
<script type="text/javascript"> <script>
var path_to_root = "{{ path_to_root }}"; var path_to_root = "{{ path_to_root }}";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "{{ preferred_dark_theme }}" : "{{ default_theme }}"; var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "{{ preferred_dark_theme }}" : "{{ default_theme }}";
</script> </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 --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -78,34 +80,42 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js')
html.classList.remove('{{ default_theme }}') html.classList.remove('{{ default_theme }}')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
{{#toc}}{{/toc}} <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
@ -113,24 +123,19 @@
<div class="page"> <div class="page">
{{> header}} {{> header}}
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="latte">Latte</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="frappe">Frappe</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="macchiato">Macchiato</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="mocha">Mocha</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>
</ul> </ul>
{{#if search_enabled}} {{#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"> <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}} {{/if}}
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
@ -197,7 +202,7 @@
{{/previous}} {{/previous}}
{{#next}} {{#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> <i class="fa fa-angle-right"></i>
</a> </a>
{{/next}} {{/next}}
@ -215,7 +220,7 @@
{{/previous}} {{/previous}}
{{#next}} {{#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> <i class="fa fa-angle-right"></i>
</a> </a>
{{/next}} {{/next}}
@ -225,7 +230,7 @@
{{#if live_reload_endpoint}} {{#if live_reload_endpoint}}
<!-- Livereload script (if served using the cli tool) --> <!-- Livereload script (if served using the cli tool) -->
<script type="text/javascript"> <script>
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:'; const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsAddress = wsProtocol + "//" + location.host + "/" + "{{{live_reload_endpoint}}}"; const wsAddress = wsProtocol + "//" + location.host + "/" + "{{{live_reload_endpoint}}}";
const socket = new WebSocket(wsAddress); const socket = new WebSocket(wsAddress);
@ -244,7 +249,7 @@
{{#if google_analytics}} {{#if google_analytics}}
<!-- Google Analytics Tag --> <!-- Google Analytics Tag -->
<script type="text/javascript"> <script>
var localAddrs = ["localhost", "127.0.0.1", ""]; var localAddrs = ["localhost", "127.0.0.1", ""];
// make sure we don't activate google analytics if the developer is // make sure we don't activate google analytics if the developer is
@ -262,43 +267,43 @@
{{/if}} {{/if}}
{{#if playground_line_numbers}} {{#if playground_line_numbers}}
<script type="text/javascript"> <script>
window.playground_line_numbers = true; window.playground_line_numbers = true;
</script> </script>
{{/if}} {{/if}}
{{#if playground_copyable}} {{#if playground_copyable}}
<script type="text/javascript"> <script>
window.playground_copyable = true; window.playground_copyable = true;
</script> </script>
{{/if}} {{/if}}
{{#if playground_js}} {{#if playground_js}}
<script src="{{ path_to_root }}ace.js" type="text/javascript" charset="utf-8"></script> <script src="{{ path_to_root }}ace.js"></script>
<script src="{{ path_to_root }}editor.js" type="text/javascript" charset="utf-8"></script> <script src="{{ path_to_root }}editor.js"></script>
<script src="{{ path_to_root }}mode-rust.js" type="text/javascript" charset="utf-8"></script> <script src="{{ path_to_root }}mode-rust.js"></script>
<script src="{{ path_to_root }}theme-dawn.js" type="text/javascript" charset="utf-8"></script> <script src="{{ path_to_root }}theme-dawn.js"></script>
<script src="{{ path_to_root }}theme-tomorrow_night.js" type="text/javascript" charset="utf-8"></script> <script src="{{ path_to_root }}theme-tomorrow_night.js"></script>
{{/if}} {{/if}}
{{#if search_js}} {{#if search_js}}
<script src="{{ path_to_root }}elasticlunr.min.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" type="text/javascript" charset="utf-8"></script> <script src="{{ path_to_root }}mark.min.js"></script>
<script src="{{ path_to_root }}searcher.js" type="text/javascript" charset="utf-8"></script> <script src="{{ path_to_root }}searcher.js"></script>
{{/if}} {{/if}}
<script src="{{ path_to_root }}clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="{{ path_to_root }}clipboard.min.js"></script>
<script src="{{ path_to_root }}highlight.js" type="text/javascript" charset="utf-8"></script> <script src="{{ path_to_root }}highlight.js"></script>
<script src="{{ path_to_root }}book.js" type="text/javascript" charset="utf-8"></script> <script src="{{ path_to_root }}book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
{{#each additional_js}} {{#each additional_js}}
<script type="text/javascript" src="{{ ../path_to_root }}{{this}}"></script> <script src="{{ ../path_to_root }}{{this}}"></script>
{{/each}} {{/each}}
{{#if is_print}} {{#if is_print}}
{{#if mathjax_support}} {{#if mathjax_support}}
<script type="text/javascript"> <script>
window.addEventListener('load', function() { window.addEventListener('load', function() {
MathJax.Hub.Register.StartupHook('End', function() { MathJax.Hub.Register.StartupHook('End', function() {
window.setTimeout(window.print, 100); window.setTimeout(window.print, 100);
@ -306,7 +311,7 @@
}); });
</script> </script>
{{else}} {{else}}
<script type="text/javascript"> <script>
window.addEventListener('load', function() { window.addEventListener('load', function() {
window.setTimeout(window.print, 100); window.setTimeout(window.print, 100);
}); });
@ -314,5 +319,6 @@
{{/if}} {{/if}}
{{/if}} {{/if}}
</div>
</body> </body>
</html> </html>

11
zsh-manual/book.toml Normal file
View 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"

0
zsh_manual/book/.nojekyll → zsh-manual/book/.nojekyll
View File

89
zsh_manual/book/404.html → zsh-manual/book/404.html
View File

@ -1,5 +1,5 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
@ -8,11 +8,10 @@
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -32,18 +31,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -59,56 +60,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -139,7 +143,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
@ -170,7 +174,7 @@
</div> </div>
<!-- Livereload script (if served using the cli tool) --> <!-- Livereload script (if served using the cli tool) -->
<script type="text/javascript"> <script>
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:'; const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload"; const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
const socket = new WebSocket(wsAddress); const socket = new WebSocket(wsAddress);
@ -188,21 +192,22 @@
<script type="text/javascript"> <script>
window.playground_copyable = true; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

97
zsh_manual/book/Arithmetic-Evaluation.html → zsh-manual/book/Arithmetic-Evaluation.html
View File

@ -1,5 +1,5 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
@ -7,11 +7,10 @@
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { 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 command which begins with a ‘((’, all the characters until a matching
‘))’ are treated as a double-quoted expression and arithmetic expansion ‘))’ are treated as a double-quoted expression and arithmetic expansion
performed as for an argument of let. More precisely, ‘((<code>...</code>))’ is performed as for an argument of let. More precisely, ‘((<code>...</code>))’ is
equivalent to ‘let &quot;<code>...</code>&quot;’. 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 value of the expression is non-zero, 1 if it is zero, and 2 if an error
occurred.</p> occurred.</p>
<p>For example, the following statement</p> <p>For example, the following statement</p>
@ -185,7 +189,7 @@ occurred.</p>
</div> </div>
<p>is equivalent to</p> <p>is equivalent to</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">let &quot;val = 2 + 1&quot; <pre><code class="language-zsh">let "val = 2 + 1"
</code></pre> </code></pre>
</div> </div>
<p>both assigning the value 3 to the shell variable val and returning a <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> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -443,7 +447,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
@ -451,7 +455,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
</div> </div>
<!-- Livereload script (if served using the cli tool) --> <!-- Livereload script (if served using the cli tool) -->
<script type="text/javascript"> <script>
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:'; const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload"; const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
const socket = new WebSocket(wsAddress); 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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

107
zsh_manual/book/Calendar-Function-System.html → zsh-manual/book/Calendar-Function-System.html
View File

@ -1,5 +1,5 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
@ -7,11 +7,10 @@
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { 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 there is no localization support; month and day names must be in English
and separator characters are fixed. Matching is case insensitive, and and separator characters are fixed. Matching is case insensitive, and
only the first three letters of the names are significant, although as a only the first three letters of the names are significant, although as a
special case a form beginning &quot;month&quot; does not match &quot;Monday&quot;. special case a form beginning "month" does not match "Monday".
Furthermore, time zones are not handled; all times are assumed to be Furthermore, time zones are not handled; all times are assumed to be
local.</p> local.</p>
<p>It is recommended that, rather than exploring the intricacies of the <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> junta, etc. are happily handled.</p>
<p>Where the year is shown as optional, the current year is assumed. There <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 are only two such cases, the form Jun 20 or 14 September (the only two
commonly occurring forms, apart from a &quot;the&quot; 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 which isn’t currently supported). Such dates will of course become
ambiguous in the future, so should ideally be avoided.</p> 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 <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 Explicitly specify a calendar file instead of the value of the
calendar-file style or the default ~/calendar.</p> calendar-file style or the default ~/calendar.</p>
<p>-d<br /> <p>-d<br />
Move any events that have passed from the calendar file to the &quot;done&quot; 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 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 calendar file with .done appended. This option is implied by the -s
option.</p> 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 keyword, followed by whitespace and the date and time of the
occurrence in the regular sequence, followed by whitespace and either occurrence in the regular sequence, followed by whitespace and either
the date and time of the rescheduled event or the exact string 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 &quot;date CANCELLED. In this case the date and time must be in exactly the "date
with local time&quot; format used by the text/calendar MIME type (RFC 2445), with local time" format used by the text/calendar MIME type (RFC 2445),
<code>&lt;YYYY&gt;&lt;MM&gt;&lt;DD&gt;</code>T<code>&lt;hh&gt;&lt;mm&gt;&lt;ss&gt;</code> (note the presence of the literal <code>&lt;YYYY&gt;&lt;MM&gt;&lt;DD&gt;</code>T<code>&lt;hh&gt;&lt;mm&gt;&lt;ss&gt;</code> (note the presence of the literal
character T). The first word (the regular recurrence) may be something character T). The first word (the regular recurrence) may be something
other than a proper date/time to indicate that the event is additional 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 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 multiples instances of the shell since the calendar file is locked when
in use.</p> in use.</p>
<p>By default, expired events are moved to the &quot;done&quot; 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> option. Use -D to prevent this.</p>
<p>-S <code>showprog</code><br /> <p>-S <code>showprog</code><br />
Explicitly specify a programme to be used for showing events instead of 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>done-file</p>
<p>The location of the file to which events which have passed are appended. <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 The default is the calendar file location with the suffix .done. The
style may be set to an empty string in which case a &quot;done&quot; file will not style may be set to an empty string in which case a "done" file will not
be maintained.</p> be maintained.</p>
<p><span id="index-reformat_002ddate"></span></p> <p><span id="index-reformat_002ddate"></span></p>
<p>reformat-date</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> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -958,7 +962,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
@ -966,7 +970,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
</div> </div>
<!-- Livereload script (if served using the cli tool) --> <!-- Livereload script (if served using the cli tool) -->
<script type="text/javascript"> <script>
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:'; const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload"; const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
const socket = new WebSocket(wsAddress); 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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

93
zsh_manual/book/Command-Execution.html → zsh-manual/book/Command-Execution.html
View File

@ -1,5 +1,5 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
@ -7,11 +7,10 @@
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { 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> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -215,7 +219,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
@ -223,7 +227,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
</div> </div>
<!-- Livereload script (if served using the cli tool) --> <!-- Livereload script (if served using the cli tool) -->
<script type="text/javascript"> <script>
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:'; const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload"; const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
const socket = new WebSocket(wsAddress); 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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

141
zsh_manual/book/Completion-System.html → zsh-manual/book/Completion-System.html
View File

@ -1,5 +1,5 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
@ -7,11 +7,10 @@
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { 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 not clash with the name of any existing widget: names based on the name
of the function are most useful. For example,</p> of the function are most useful. For example,</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">#compdef -K _foo_complete complete-word &quot;^X^C&quot; \ <pre><code class="language-zsh">#compdef -K _foo_complete complete-word "^X^C" \
_foo_list list-choices &quot;^X^D&quot; _foo_list list-choices "^X^D"
</code></pre> </code></pre>
</div> </div>
<p>(all on one line) defines a widget _foo_complete for completion, bound <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> function to handle the context.</p>
<p>As an example:</p> <p>As an example:</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">compdef '_files -g &quot;*.log&quot;' '-redirect-,2&gt;,-default-' <pre><code class="language-zsh">compdef '_files -g "*.log"' '-redirect-,2&gt;,-default-'
</code></pre> </code></pre>
</div> </div>
<p>completes files matching ‘*.log’ after ‘2&gt; &lt;TAB&gt;’ for any command with <p>completes files matching ‘*.log’ after ‘2&gt; &lt;TAB&gt;’ 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 completion function. For example, to complete files ending in ‘.h’ as
arguments to the command foo:</p> arguments to the command foo:</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">compdef '_files -g &quot;*.h&quot;' foo <pre><code class="language-zsh">compdef '_files -g "*.h"' foo
</code></pre> </code></pre>
</div> </div>
<p>The option -n prevents any completions already defined for the command <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’) 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 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> ‘-o’ option to zsh which takes a shell option as an argument).</p>
<p>The context starts out very generic (&quot;we are beginning a completion&quot;) <p>The context starts out very generic ("we are beginning a completion")
and becomes more specific as more is learned (&quot;the current word is in a and becomes more specific as more is learned ("the current word is in a
position that is usually a command name&quot; or &quot;the current word might be a position that is usually a command name" or "the current word might be a
variable name&quot; and so on). Therefore the context will vary during the variable name" and so on). Therefore the context will vary during the
same call to the completion system.</p> same call to the completion system.</p>
<p>This context information is condensed into a string consisting of <p>This context information is condensed into a string consisting of
multiple fields separated by colons, referred to simply as ‘the context’ 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> environment before the completion for the target command is invoked.</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">zstyle ':completion:*:sudo::' environ \ <pre><code class="language-zsh">zstyle ':completion:*:sudo::' environ \
PATH=&quot;/sbin:/usr/sbin:$PATH&quot; HOME=&quot;/root&quot; PATH="/sbin:/usr/sbin:$PATH" HOME="/root"
</code></pre> </code></pre>
</div> </div>
<p><span id="index-expand_002c-completion-style"></span></p> <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> completion is attempted a second time on the same string, e.g.:</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">zstyle -e ':completion:*' completer ' <pre><code class="language-zsh">zstyle -e ':completion:*' completer '
if [[ $_last_try != &quot;$HISTNO$BUFFER$CURSOR&quot; ]]; then if [[ $_last_try != "$HISTNO$BUFFER$CURSOR" ]]; then
_last_try=&quot;$HISTNO$BUFFER$CURSOR&quot; _last_try="$HISTNO$BUFFER$CURSOR"
reply=(_complete _match _prefix) reply=(_complete _match _prefix)
else else
reply=(_ignored _correct _approximate) 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> added to .zshrc after compinit has been run:</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">for key in '!' '$' '@' '/' '~'; do <pre><code class="language-zsh">for key in '!' '$' '@' '/' '~'; do
bindkey &quot;\e$key&quot; _bash_complete-word bindkey "\e$key" _bash_complete-word
bindkey &quot;^X$key&quot; _bash_list-choices bindkey "^X$key" _bash_list-choices
done done
</code></pre> </code></pre>
</div> </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 arguments. For example, to make _arguments stop completing options
after the first normal argument, but ignoring all strings starting with 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 a hyphen even if they are not described by one of the <code>optspec</code>s, the
form is ‘-A &quot;-*&quot;’.</p> form is ‘-A "-*"’.</p>
<p>-O <code>name</code><br /> <p>-O <code>name</code><br />
Pass the elements of the array <code>name</code> as arguments to functions called 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> 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 back the modified value and should be initialised to the current value
at the start of the function:</p> at the start of the function:</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">local curcontext=&quot;$curcontext&quot; <pre><code class="language-zsh">local curcontext="$curcontext"
</code></pre> </code></pre>
</div> </div>
<p>This is useful where it is not possible for multiple states to be valid <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> parentheses. For example,</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">_arguments -- -i \ <pre><code class="language-zsh">_arguments -- -i \
&quot;(--(en|dis)able-FEATURE*)&quot; "(--(en|dis)able-FEATURE*)"
</code></pre> </code></pre>
</div> </div>
<p>will cause completion to ignore the options ‘--enable-FEATURE’ and <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 ‘--enable-foo’, but the script also accepts the negated form
‘--disable-foo’. To allow completion of the second form:</p> ‘--disable-foo’. To allow completion of the second form:</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">_arguments -- -s &quot;((#s)--enable- --disable-)&quot; <pre><code class="language-zsh">_arguments -- -s "((#s)--enable- --disable-)"
</code></pre> </code></pre>
</div> </div>
<p><em>Miscellaneous notes</em></p> <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 () { <pre><code class="language-zsh">_example_caching_policy () {
# rebuild if cache is more than a week old # rebuild if cache is more than a week old
local -a oldp local -a oldp
oldp=( &quot;$1&quot;(Nm+7) ) oldp=( "$1"(Nm+7) )
(( $#oldp )) (( $#oldp ))
} }
</code></pre> </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 appropriate order (users, hosts, ports in the example above). The values
for the different fields are separated by colons. This can be altered for the different fields are separated by colons. This can be altered
with the option -s to _combination which specifies a pattern. Typically with the option -s to _combination which specifies a pattern. Typically
this is a character class, as for example ‘-s &quot;[:@]&quot;’ 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 users-hosts style. Each ‘<code>field</code>=<code>pattern</code>’ specification restricts
the completions which apply to elements of the style with appropriately the completions which apply to elements of the style with appropriately
matching fields.</p> matching fields.</p>
@ -3919,7 +3923,7 @@ the option ‘-V’, ‘-1V’, or ‘-2V’.</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">local expl <pre><code class="language-zsh">local expl
_description files expl file _description files expl file
compadd &quot;$expl[@]&quot; - &quot;$files[@]&quot; compadd "$expl[@]" - "$files[@]"
</code></pre> </code></pre>
</div> </div>
<p>Note the use of the parameter expl, the hyphen, and the list of matches. <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 <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> -n must be followed by a numeric value in the same word. By using:</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">_arguments '-n-: :_guard &quot;[0-9]#&quot; &quot;numeric value&quot;' '-none' <pre><code class="language-zsh">_arguments '-n-: :_guard "[0-9]#" "numeric value"' '-none'
</code></pre> </code></pre>
</div> </div>
<p>_arguments can be made to both display the message ‘numeric value’ and <p>_arguments can be made to both display the message ‘numeric value’ and
@ -4084,7 +4088,7 @@ style.</p>
if _requested foo; then if _requested foo; then
... ...
while _next_label foo expl '...'; do while _next_label foo expl '...'; do
compadd &quot;$expl[@]&quot; ... &amp;&amp; ret=0 compadd "$expl[@]" ... &amp;&amp; ret=0
done done
... ...
fi fi
@ -4379,8 +4383,8 @@ the generated array at that point.</p>
_regex_words mydb-commands 'mydb commands' \ _regex_words mydb-commands 'mydb commands' \
'add:add an entry to mydb:$mydb_add_cmds' \ 'add:add an entry to mydb:$mydb_add_cmds' \
'show:show entries in mydb' 'show:show entries in mydb'
_regex_arguments _mydb &quot;$reply[@]&quot; _regex_arguments _mydb "$reply[@]"
_mydb &quot;$@&quot; _mydb "$@"
</code></pre> </code></pre>
</div> </div>
<p>This shows a completion function for a command mydb which takes two <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> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -4713,7 +4717,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
@ -4721,7 +4725,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
</div> </div>
<!-- Livereload script (if served using the cli tool) --> <!-- Livereload script (if served using the cli tool) -->
<script type="text/javascript"> <script>
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:'; const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload"; const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
const socket = new WebSocket(wsAddress); 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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

99
zsh_manual/book/Completion-Using-compctl.html → zsh-manual/book/Completion-Using-compctl.html
View File

@ -1,5 +1,5 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
@ -7,11 +7,10 @@
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { 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 which any delimiter may be escaped with a backslash; in this case the
argument should be quoted. For example,</p> argument should be quoted. For example,</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">compctl -k &quot;(cputime filesize datasize stacksize <pre><code class="language-zsh">compctl -k "(cputime filesize datasize stacksize
coredumpsize resident descriptors)&quot; limit coredumpsize resident descriptors)" limit
</code></pre> </code></pre>
</div> </div>
<p>-g <code>globstring</code><br /> <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 part already typed will be completed and the whole <code>prefix</code> ignored for
completion purposes. For example,</p> completion purposes. For example,</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">compctl -j -P &quot;%&quot; kill <pre><code class="language-zsh">compctl -j -P "%" kill
</code></pre> </code></pre>
</div> </div>
<p>inserts a ‘%’ after the kill command and then completes job names.</p> <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> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -732,7 +736,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
@ -740,7 +744,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
</div> </div>
<!-- Livereload script (if served using the cli tool) --> <!-- Livereload script (if served using the cli tool) -->
<script type="text/javascript"> <script>
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:'; const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload"; const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
const socket = new WebSocket(wsAddress); 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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

111
zsh_manual/book/Completion-Widgets.html → zsh-manual/book/Completion-Widgets.html
View File

@ -1,5 +1,5 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
@ -7,11 +7,10 @@
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { 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><span id="index-QIPREFIX"></span></p>
<p>QIPREFIX</p> <p>QIPREFIX</p>
<p>This parameter is read-only and contains the quoted string up to the <p>This parameter is read-only and contains the quoted string up to the
word being completed. E.g. when completing ‘&quot;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 contains the double quote. If the -q option of compset is used (see
below), and the original string was ‘&quot;foo bar’ with the cursor on the below), and the original string was ‘"foo bar’ with the cursor on the
‘bar’, this parameter contains ‘&quot;foo ’.</p> ‘bar’, this parameter contains ‘"foo ’.</p>
<p><span id="index-QISUFFIX"></span></p> <p><span id="index-QISUFFIX"></span></p>
<p>QISUFFIX</p> <p>QISUFFIX</p>
<p>Like QIPREFIX, but containing the suffix.</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 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 given in the <code>remove-chars</code>. This string is parsed as a
characters class and understands the backslash sequences used by the characters class and understands the backslash sequences used by the
print command. For example, ‘-r &quot;a-z\t&quot;’ removes the suffix if the next 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 &quot;^0-9&quot;’ 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 removes the suffix if the next character typed inserts anything but a
digit. One extra backslash sequence is understood in this string: ‘\-’ digit. One extra backslash sequence is understood in this string: ‘\-’
stands for all characters that insert nothing. Thus ‘-S &quot;=&quot; -q’ is the stands for all characters that insert nothing. Thus ‘-S "=" -q’ is the
same as ‘-S &quot;=&quot; -r &quot;= \t\n\-&quot;’.</p> same as ‘-S "=" -r "= \t\n\-"’.</p>
<p>This option may also be used without the -S option; then any <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 automatically added space will be removed when one of the characters in
the list is typed.</p> 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 Specifies an array containing patterns. <code>completions</code> that match one of
these patterns are ignored, that is, not considered to be matches.</p> 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 <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 &quot;(*?.o *?.h)&quot;’. 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 If the name of an array is given, the elements of the array are taken as
the patterns.</p> the patterns.</p>
<p>-Q<br /> <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> 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 which match being stored in <code>array</code>, the strings generated internally by
the completion code are stored. For example, with a match specification the completion code are stored. For example, with a match specification
of ‘-M &quot;L:|no=&quot;’, 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 this option stores the string ‘nofoo’ in the array, whereas the -O
option stores the ‘foo’ originally given.</p> option stores the ‘foo’ originally given.</p>
<p>-D <code>array</code><br /> <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> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -1108,7 +1112,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
@ -1116,7 +1120,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
</div> </div>
<!-- Livereload script (if served using the cli tool) --> <!-- Livereload script (if served using the cli tool) -->
<script type="text/javascript"> <script>
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:'; const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload"; const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
const socket = new WebSocket(wsAddress); 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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

93
zsh_manual/book/Conditional-Expressions.html → zsh-manual/book/Conditional-Expressions.html
View File

@ -1,5 +1,5 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
@ -7,11 +7,10 @@
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { 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> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -368,7 +372,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
@ -376,7 +380,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
</div> </div>
<!-- Livereload script (if served using the cli tool) --> <!-- Livereload script (if served using the cli tool) -->
<script type="text/javascript"> <script>
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:'; const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload"; const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
const socket = new WebSocket(wsAddress); 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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

167
zsh_manual/book/Expansion.html → zsh-manual/book/Expansion.html
View File

@ -1,5 +1,5 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
@ -7,11 +7,10 @@
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { 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. of the five steps that are needed are performed one after the other.
Hence, for example, all the parts of parameter expansion are completed Hence, for example, all the parts of parameter expansion are completed
before command substitution is started. After these expansions, all before command substitution is started. After these expansions, all
unquoted occurrences of the characters ‘\’,‘’’ and ‘&quot;’ are removed.</p> unquoted occurrences of the characters ‘\’,‘’’ and ‘"’ are removed.</p>
<p><em>Filename Expansion</em><br /> <p><em>Filename Expansion</em><br />
If the SH_FILE_EXPANSION option is set, the order of expansion is 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 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 ‘^<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 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> particular, ‘^<code>foo</code>^<code>bar</code>^:G’ performs a global substitution.</p>
<p>If the shell encounters the character sequence ‘!&quot;’ 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 history mechanism is temporarily disabled until the current list (see
<a href="Shell-Grammar.html#Shell-Grammar">Shell Grammar</a>) is fully parsed. The <a href="Shell-Grammar.html#Shell-Grammar">Shell Grammar</a>) is fully parsed. The
‘!&quot;’ is removed from the input, and any subsequent ‘!’ characters have ‘!"’ is removed from the input, and any subsequent ‘!’ characters have
no special significance.</p> no special significance.</p>
<p><span id="index-fc_002c-use-of"></span></p> <p><span id="index-fc_002c-use-of"></span></p>
<p>A less convenient but more comprehensible form of command history <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> null words are elided from unquoted parameters’ expansions.</p>
<p>With default options, after the assignments:</p> <p>With default options, after the assignments:</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">array=(&quot;first word&quot; &quot;&quot; &quot;third word&quot;) <pre><code class="language-zsh">array=("first word" "" "third word")
scalar=&quot;only word&quot; scalar="only word"
</code></pre> </code></pre>
</div> </div>
<p>then $array substitutes two words, ‘first word’ and ‘third word’, and <p>then $array substitutes two words, ‘first word’ and ‘third word’, and
$scalar substitutes a single word ‘only word’. Note that second element $scalar substitutes a single word ‘only word’. Note that second element
of array was elided. Scalar parameters can be elided too if their value of array was elided. Scalar parameters can be elided too if their value
is null (empty). To avoid elision, use quoting as follows: &quot;$scalar&quot; for is null (empty). To avoid elision, use quoting as follows: "$scalar" for
scalars and &quot;${array[@]}&quot; or &quot;${(@)array}&quot; for arrays. (The last two scalars and "${array[@]}" or "${(@)array}" for arrays. (The last two
forms are equivalent.)</p> forms are equivalent.)</p>
<p>Parameter expansions can involve <em>flags</em>, as in ‘${(@kv)aliases}’, and <p>Parameter expansions can involve <em>flags</em>, as in ‘${(@kv)aliases}’, and
other operators, such as ‘${PREFIX:-&quot;/usr/local&quot;}’. Parameter expansions other operators, such as ‘${PREFIX:-"/usr/local"}’. Parameter expansions
can also be nested. These topics will be introduced below. The full can also be nested. These topics will be introduced below. The full
rules are complicated and are noted at the end.</p> rules are complicated and are noted at the end.</p>
<p>In the expansions discussed below that require a pattern, the form of <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 elements, which can be unexpected. The second print provides a
workaround which should continue to work if this is changed.</p> workaround which should continue to work if this is changed.</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">a=(a b); b=(1 2); print -l &quot;${a:^b}&quot;; print -l &quot;${${a:^b}}&quot; <pre><code class="language-zsh">a=(a b); b=(1 2); print -l "${a:^b}"; print -l "${${a:^b}}"
</code></pre> </code></pre>
</div> </div>
<p>${<code>name</code>:<code>offset</code>}<br /> <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> E and N are not useful.</p>
<p>For example,</p> <p>For example,</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">foo=&quot;twinkle twinkle little star&quot; sub=&quot;t*e&quot; rep=&quot;spy&quot; <pre><code class="language-zsh">foo="twinkle twinkle little star" sub="t*e" rep="spy"
print ${foo//${~sub}/$rep} print ${foo//${~sub}/$rep}
print ${(S)foo//${~sub}/$rep} print ${(S)foo//${~sub}/$rep}
</code></pre> </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> <a href="Parameters.html#Array-Parameters">Array Parameters</a>.</p>
<p>Note that double quotes may appear around nested expressions, in which <p>Note that double quotes may appear around nested expressions, in which
case only the part inside is treated as quoted; for example, case only the part inside is treated as quoted; for example,
${(f)&quot;$(foo)&quot;} 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 below) is applied using the rules for unquoted expansions. Note further
that quotes are themselves nested in this context; for example, in that quotes are themselves nested in this context; for example, in
&quot;${(@f)&quot;$(foo)&quot;}&quot;, 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 whole expression, the other (redundant) surrounding the $(foo) as
before.</p> before.</p>
<hr /> <hr />
@ -1000,8 +1004,8 @@ depending on the setting of the PROMPT_PERCENT, PROMPT_SUBST and
PROMPT_BANG options.</p> PROMPT_BANG options.</p>
<p>@<br /> <p>@<br />
In double quotes, array elements are put into separate words. E.g., In double quotes, array elements are put into separate words. E.g.,
‘&quot;${(@)foo}&quot;’ is equivalent to ‘&quot;${foo[@]}&quot;’ and ‘&quot;${(@)foo[1,2]}&quot;’ ‘"${(@)foo}"’ is equivalent to ‘"${foo[@]}"’ and ‘"${(@)foo[1,2]}"’
is the same as ‘&quot;$foo[1]&quot; &quot;$foo[2]&quot;’. This is distinct from <em>field 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 splitting</em> by the f, s or z flags, which still applies within each array
element.</p> element.</p>
<p>A<br /> <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 parentheses, which forces the entire substituted string to be treated as
a pattern. Hence, for example,</p> a pattern. Hence, for example,</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">[[ &quot;?&quot; = ${(~j.|.)array} ]] <pre><code class="language-zsh">[[ "?" = ${(~j.|.)array} ]]
</code></pre> </code></pre>
</div> </div>
<p>treats ‘|’ as a pattern and succeeds if and only if $array contains the <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 are retained inside double quotes is disabled for arrays generated by
splitting; hence the following:</p> splitting; hence the following:</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">line=&quot;one::three&quot; <pre><code class="language-zsh">line="one::three"
print -l &quot;${(s.:.)line}&quot; print -l "${(s.:.)line}"
</code></pre> </code></pre>
</div> </div>
<p>produces two lines of output for one and three and elides the empty <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. field. To override this behaviour, supply the ‘(@)’ flag as well, i.e.
&quot;${(@s.:.)line}&quot;.</p> "${(@s.:.)line}".</p>
<p>Z:<code>opts</code>:<br /> <p>Z:<code>opts</code>:<br />
As z but takes a combination of option letters between a following pair 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. 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 the string (a ‘substring match’). Of all matches at a particular
position, # selects the shortest and ## the longest:</p> position, # selects the shortest and ## the longest:</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">% str=&quot;aXbXc&quot; <pre><code class="language-zsh">% str="aXbXc"
% echo ${(S)str#X*} % echo ${(S)str#X*}
abXc abXc
% echo ${(S)str##X*} % echo ${(S)str##X*}
@ -1353,7 +1357,7 @@ a
<p>With % or %%, search for the match that starts closest to the end of the <p>With % or %%, search for the match that starts closest to the end of the
string:</p> string:</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">% str=&quot;aXbXc&quot; <pre><code class="language-zsh">% str="aXbXc"
% echo ${(S)str%X*} % echo ${(S)str%X*}
aXbc aXbc
% echo ${(S)str%%X*} % 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 matching, i.e. that the shortest instead of the longest match should be
replaced:</p> replaced:</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">% str=&quot;abab&quot; <pre><code class="language-zsh">% str="abab"
% echo ${str/*b/_} % echo ${str/*b/_}
_ _
% echo ${(S)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 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 with 3., multiple subscripts can appear. Note that ${foo[2,4][2]} is
thus equivalent to ${${foo[2,4]}[2]} and also to thus equivalent to ${${foo[2,4]}[2]} and also to
&quot;${${(@)foo[2,4]}[2]}&quot; (the nested substitution returns an array in "${${(@)foo[2,4]}[2]}" (the nested substitution returns an array in
both cases), but not to &quot;${${foo[2,4]}[2]}&quot; (the nested substitution both cases), but not to "${${foo[2,4]}[2]}" (the nested substitution
returns a scalar because of the quotes).</p> returns a scalar because of the quotes).</p>
<p>7. <em>Modifiers</em><br /> <p>7. <em>Modifiers</em><br />
Any modifiers, as specified by a trailing ‘#’, ‘%’, ‘/’ (possibly 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> <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><span id="index-parameter-expansion_002c-examples"></span></p>
<p>The flag f is useful to split a double-quoted substitution line by line. <p>The flag f is useful to split a double-quoted substitution line by line.
For example, ${(f)&quot;$(&lt;<code>file</code>)&quot;} substitutes the contents of <code>file</code> For example, ${(f)"$(&lt;<code>file</code>)"} substitutes the contents of <code>file</code>
divided so that each line is an element of the resulting array. Compare divided so that each line is an element of the resulting array. Compare
this with the effect of $(&lt;<code>file</code>) alone, which divides the file up by this with the effect of $(&lt;<code>file</code>) alone, which divides the file up by
words, or the same inside double quotes, which makes the entire content words, or the same inside double quotes, which makes the entire content
of the file a single string.</p> of the file a single string.</p>
<p>The following illustrates the rules for nested parameter expansions. <p>The following illustrates the rules for nested parameter expansions.
Suppose that $foo contains the array (bar baz):</p> Suppose that $foo contains the array (bar baz):</p>
<p>&quot;${(@)${foo}[1]}&quot;<br /> <p>"${(@)${foo}[1]}"<br />
This produces the result b. First, the inner substitution &quot;${foo}&quot;, This produces the result b. First, the inner substitution "${foo}",
which has no array (@) flag, produces a single word result &quot;bar baz&quot;. which has no array (@) flag, produces a single word result "bar baz".
The outer substitution &quot;${(@)...[1]}&quot; detects that this is a scalar, The outer substitution "${(@)...[1]}" detects that this is a scalar,
so that (despite the ‘(@)’ flag) the subscript picks the first so that (despite the ‘(@)’ flag) the subscript picks the first
character.</p> character.</p>
<p>&quot;${${(@)foo}[1]}&quot;<br /> <p>"${${(@)foo}[1]}"<br />
This produces the result ‘bar’. In this case, the inner substitution This produces the result ‘bar’. In this case, the inner substitution
&quot;${(@)foo}&quot; produces the array ‘(bar baz)’. The outer substitution "${(@)foo}" produces the array ‘(bar baz)’. The outer substitution
&quot;${...[1]}&quot; detects that this is an array and picks the first word. "${...[1]}" detects that this is an array and picks the first word.
This is similar to the simple case &quot;${foo[1]}&quot;.</p> This is similar to the simple case "${foo[1]}".</p>
<p>As an example of the rules for word splitting and joining, suppose $foo <p>As an example of the rules for word splitting and joining, suppose $foo
contains the array ‘(ax1 bx1)’. Then</p> contains the array ‘(ax1 bx1)’. Then</p>
<p>${(s/x/)foo}<br /> <p>${(s/x/)foo}<br />
@ -1610,7 +1614,7 @@ produces ‘a’, ‘1’, ‘b’ and ‘1’.</p>
<p>${(s/x/)foo%%1*}<br /> <p>${(s/x/)foo%%1*}<br />
produces ‘a’ and ‘ b’ (note the extra space). As substitution occurs produces ‘a’ and ‘ b’ (note the extra space). As substitution occurs
before either joining or splitting, the operation first generates the before either joining or splitting, the operation first generates the
modified array (ax bx), which is joined to give &quot;ax bx&quot;, 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 to give ‘a’, ‘ b’ and ‘’. The final empty string will then be elided, as
it is not in double quotes.</p> it is not in double quotes.</p>
<hr /> <hr />
@ -2078,7 +2082,7 @@ flags are not considered parenthesised groups; only the first nine
active parentheses can be referenced.</p> active parentheses can be referenced.</p>
<p>For example,</p> <p>For example,</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">foo=&quot;a_string_with_a_message&quot; <pre><code class="language-zsh">foo="a_string_with_a_message"
if [[ $foo = (a|an)_(#b)(*) ]]; then if [[ $foo = (a|an)_(#b)(*) ]]; then
print ${foo[$mbegin[1],$mend[1]]} print ${foo[$mbegin[1],$mend[1]]}
fi 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 <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 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 ‘anything except a zero-length portion at the start of the string’; you
need to use ‘(&quot;&quot;~(#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> not at the start.</p>
<p>q<br /> <p>q<br />
A ‘q’ and everything up to the closing parenthesis of the globbing flags 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 kilobytes, megabytes, or blocks (of 512 bytes) instead. (On some systems
additional specifiers are available for gigabytes, ‘g’ or ‘G’, and additional specifiers are available for gigabytes, ‘g’ or ‘G’, and
terabytes, ‘t’ or ‘T’.) If a size specifier is used a file is regarded terabytes, ‘t’ or ‘T’.) If a size specifier is used a file is regarded
as &quot;exactly&quot; 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 equal to the test size. Hence ‘*(Lm1)’ matches files from 1 byte up to
1 Megabyte inclusive. Note also that the set of files &quot;less than&quot; 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; test size only includes files that would not match the equality test;
hence ‘*(Lm-1)’ only matches files of zero size.</p> hence ‘*(Lm-1)’ only matches files of zero size.</p>
<p>^<br /> <p>^<br />
@ -2651,7 +2655,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -2665,7 +2669,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
@ -2673,7 +2677,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
</div> </div>
<!-- Livereload script (if served using the cli tool) --> <!-- Livereload script (if served using the cli tool) -->
<script type="text/javascript"> <script>
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:'; const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload"; const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
const socket = new WebSocket(wsAddress); 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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

93
zsh_manual/book/Files.html → zsh-manual/book/Files.html
View File

@ -1,5 +1,5 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
@ -7,11 +7,10 @@
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { 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> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -254,7 +258,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
@ -262,7 +266,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
</div> </div>
<!-- Livereload script (if served using the cli tool) --> <!-- Livereload script (if served using the cli tool) -->
<script type="text/javascript"> <script>
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:'; const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload"; const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
const socket = new WebSocket(wsAddress); 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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

0
zsh_manual/book/FontAwesome/css/font-awesome.css → zsh-manual/book/FontAwesome/css/font-awesome.css vendored
View File

0
zsh_manual/book/FontAwesome/fonts/FontAwesome.ttf → zsh-manual/book/FontAwesome/fonts/FontAwesome.ttf
View File

0
zsh_manual/book/FontAwesome/fonts/fontawesome-webfont.eot → zsh-manual/book/FontAwesome/fonts/fontawesome-webfont.eot
View File

0
zsh_manual/book/FontAwesome/fonts/fontawesome-webfont.svg → zsh-manual/book/FontAwesome/fonts/fontawesome-webfont.svg
View File

Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 434 KiB

After

Width:  |  Height:  |  Size: 434 KiB

0
zsh_manual/book/FontAwesome/fonts/fontawesome-webfont.ttf → zsh-manual/book/FontAwesome/fonts/fontawesome-webfont.ttf
View File

0
zsh_manual/book/FontAwesome/fonts/fontawesome-webfont.woff → zsh-manual/book/FontAwesome/fonts/fontawesome-webfont.woff
View File

0
zsh_manual/book/FontAwesome/fonts/fontawesome-webfont.woff2 → zsh-manual/book/FontAwesome/fonts/fontawesome-webfont.woff2
View File

101
zsh_manual/book/Functions.html → zsh-manual/book/Functions.html
View File

@ -1,5 +1,5 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
@ -7,11 +7,10 @@
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { 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 <p>In fact, the functions command outputs ‘builtin autoload -X’ as the body
of an autoloaded function. This is done so that</p> of an autoloaded function. This is done so that</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">eval &quot;$(functions)&quot; <pre><code class="language-zsh">eval "$(functions)"
</code></pre> </code></pre>
</div> </div>
<p>produces a reasonable result. A true autoloaded function can be <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 <pre><code class="language-zsh">variable=outside
function { function {
local variable=inside local variable=inside
print &quot;I am $variable with arguments $*&quot; print "I am $variable with arguments $*"
} this and that } this and that
print &quot;I am $variable&quot; print "I am $variable"
</code></pre> </code></pre>
</div> </div>
<p>outputs the following:</p> <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> SIGINT to print a message, then mimic the usual effect of the signal.</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">TRAPINT() { <pre><code class="language-zsh">TRAPINT() {
print &quot;Caught SIGINT, aborting.&quot; print "Caught SIGINT, aborting."
return $(( 128 + $1 )) return $(( 128 + $1 ))
} }
</code></pre> </code></pre>
@ -536,7 +540,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </a>
<a rel="next" href="Jobs-&amp;-Signals.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right"> <a rel="next prefetch" href="Jobs-&amp;-Signals.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
<i class="fa fa-angle-right"></i> <i class="fa fa-angle-right"></i>
</a> </a>
@ -550,7 +554,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </a>
<a rel="next" href="Jobs-&amp;-Signals.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right"> <a rel="next prefetch" href="Jobs-&amp;-Signals.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
<i class="fa fa-angle-right"></i> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
@ -558,7 +562,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
</div> </div>
<!-- Livereload script (if served using the cli tool) --> <!-- Livereload script (if served using the cli tool) -->
<script type="text/javascript"> <script>
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:'; const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload"; const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
const socket = new WebSocket(wsAddress); 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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

93
zsh_manual/book/Introduction.html → zsh-manual/book/Introduction.html
View File

@ -1,5 +1,5 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
@ -7,11 +7,10 @@
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { 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> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -291,7 +295,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
@ -299,7 +303,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
</div> </div>
<!-- Livereload script (if served using the cli tool) --> <!-- Livereload script (if served using the cli tool) -->
<script type="text/javascript"> <script>
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:'; const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload"; const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
const socket = new WebSocket(wsAddress); 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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

93
zsh_manual/book/Invocation.html → zsh-manual/book/Invocation.html
View File

@ -1,5 +1,5 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
@ -7,11 +7,10 @@
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { 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> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -385,7 +389,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
@ -393,7 +397,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
</div> </div>
<!-- Livereload script (if served using the cli tool) --> <!-- Livereload script (if served using the cli tool) -->
<script type="text/javascript"> <script>
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:'; const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload"; const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
const socket = new WebSocket(wsAddress); 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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

93
zsh_manual/book/Jobs-&-Signals.html → zsh-manual/book/Jobs-&-Signals.html
View File

@ -1,5 +1,5 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
@ -7,11 +7,10 @@
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { 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> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -304,7 +308,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
@ -312,7 +316,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
</div> </div>
<!-- Livereload script (if served using the cli tool) --> <!-- Livereload script (if served using the cli tool) -->
<script type="text/javascript"> <script>
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:'; const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload"; const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
const socket = new WebSocket(wsAddress); 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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

99
zsh_manual/book/Options.html → zsh-manual/book/Options.html
View File

@ -1,5 +1,5 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
@ -7,11 +7,10 @@
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { 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> inside the function nested as that overrides the value within toplevel</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">toplevel() { <pre><code class="language-zsh">toplevel() {
local foo=&quot;in fn&quot; local foo="in fn"
nested nested
} }
nested() { nested() {
foo=&quot;in nested&quot; foo="in nested"
} }
setopt warn_nested_var setopt warn_nested_var
toplevel 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 <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; csh. These require that embedded newlines be preceded by a backslash;
unescaped newlines will cause an error message. In double-quoted unescaped newlines will cause an error message. In double-quoted
strings, it is made impossible to escape ‘$’, ‘‘’ or ‘&quot;’ (and ‘\’ strings, it is made impossible to escape ‘$’, ‘‘’ or ‘"’ (and ‘\’
itself no longer needs escaping). Command substitutions are only itself no longer needs escaping). Command substitutions are only
expanded once, and cannot be nested.</p> expanded once, and cannot be nested.</p>
<p><span id="index-CSH_005fNULLCMD"></span> <span <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> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -2559,7 +2563,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
@ -2567,7 +2571,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
</div> </div>
<!-- Livereload script (if served using the cli tool) --> <!-- Livereload script (if served using the cli tool) -->
<script type="text/javascript"> <script>
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:'; const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload"; const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
const socket = new WebSocket(wsAddress); 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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

119
zsh_manual/book/Parameters.html → zsh-manual/book/Parameters.html
View File

@ -1,5 +1,5 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
@ -7,11 +7,10 @@
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { 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> <em>Subscript Parsing</em> below for details.</p>
<p>A subscript of the form ‘[*]’ or ‘[@]’ evaluates to all elements of <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 an array; there is no difference between the two except when they appear
within double quotes. ‘&quot;$foo[*]&quot;’ evaluates to ‘&quot;$foo[1] $foo[2] within double quotes. ‘"$foo[*]"’ evaluates to ‘"$foo[1] $foo[2]
...&quot;’, whereas ‘&quot;$foo[@]&quot;’ evaluates to ‘&quot;$foo[1]&quot; &quot;$foo[2]&quot; ...’. ..."’, whereas ‘"$foo[@]"’ evaluates to ‘"$foo[1]" "$foo[2]" ...’.
For associative arrays, ‘[*]’ or ‘[@]’ evaluate to all the values, For associative arrays, ‘[*]’ or ‘[@]’ evaluate to all the values,
in no particular order. Note that this does not substitute the keys; see 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 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 first subscript to the end of the match of the second subscript. For
example,</p> example,</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">string=&quot;abcdefghijklm&quot; <pre><code class="language-zsh">string="abcdefghijklm"
print ${string[(r)d?,(r)h?]} print ${string[(r)d?,(r)h?]}
</code></pre> </code></pre>
</div> </div>
@ -442,7 +446,7 @@ the other elements to accommodate the new values. (This is not supported
for associative arrays.)</p> for associative arrays.)</p>
<p>This syntax also works as an argument to the typeset command:</p> <p>This syntax also works as an argument to the typeset command:</p>
<blockquote> <blockquote>
<p>typeset &quot;<code>name</code>[<code>exp</code>]&quot;=<code>value</code></p> <p>typeset "<code>name</code>[<code>exp</code>]"=<code>value</code></p>
</blockquote> </blockquote>
<p>The <code>value</code> may <em>not</em> be a parenthesized list in this case; only <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 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. <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> To delete an element of an associative array, use the unset command:</p>
<blockquote> <blockquote>
<p>unset &quot;<code>name</code>[<code>exp</code>]&quot;</p> <p>unset "<code>name</code>[<code>exp</code>]"</p>
</blockquote> </blockquote>
<hr /> <hr />
<p><span id="Subscript-Flags"></span></p> <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 <p>To avoid subscript parsing limitations in assignments to associative
array elements, use the append syntax:</p> array elements, use the append syntax:</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">aa+=('key with &quot;*strange*&quot; characters' 'value string') <pre><code class="language-zsh">aa+=('key with "*strange*" characters' 'value string')
</code></pre> </code></pre>
</div> </div>
<p>The basic rule to remember when writing a subscript expression is that <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 removed during parsing. This is because parameter expansions may be
surrounded by balanced braces, and subscript flags are introduced by surrounded by balanced braces, and subscript flags are introduced by
balanced parentheses.</p> balanced parentheses.</p>
<p>The second difference is that a double-quote (‘&quot;’) 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 a subscript expression without being preceded by a backslash, and
therefore that the two characters ‘\&quot;’ remain as two characters in the therefore that the two characters ‘\"’ remain as two characters in the
subscript (in true double-quoting, ‘\&quot;’ becomes ‘&quot;’). However, because subscript (in true double-quoting, ‘\"’ becomes ‘"’). However, because
of the standard shell quoting rules, any double-quotes that appear must of the standard shell quoting rules, any double-quotes that appear must
occur in balanced pairs unless preceded by a backslash. This makes it occur in balanced pairs unless preceded by a backslash. This makes it
more difficult to write a subscript expression that contains an odd more difficult to write a subscript expression that contains an odd
number of double-quote characters, but the reason for this difference is number of double-quote characters, but the reason for this difference is
so that when a subscript expression appears inside true double-quotes, so that when a subscript expression appears inside true double-quotes,
one can still write ‘\&quot;’ (rather than ‘\\\&quot;’) for ‘&quot;’.</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 <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 typeset builtin and an enclosing pair of double quotes; to refer to the
value of that key, again use double quotes:</p> value of that key, again use double quotes:</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">typeset -A aa <pre><code class="language-zsh">typeset -A aa
typeset &quot;aa[one\&quot;two\&quot;three\&quot;quotes]&quot;=QQQ typeset "aa[one\"two\"three\"quotes]"=QQQ
print &quot;$aa[one\&quot;two\&quot;three\&quot;quotes]&quot; print "$aa[one\"two\"three\"quotes]"
</code></pre> </code></pre>
</div> </div>
<p>It is important to note that the quoting rules do not change when a <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 have timing statistics reported. The format used to output statistics is
the value of the TIMEFMT parameter, which is the same as for the 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 REPORTTIME variable and the time builtin; note that by default this does
not output memory usage. Appending &quot; max RSS %M&quot; 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 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. is also in use, at most a single report is printed for both triggers.
This feature requires the getrusage() system call, commonly supported by 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> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -1701,7 +1705,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
@ -1709,7 +1713,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
</div> </div>
<!-- Livereload script (if served using the cli tool) --> <!-- Livereload script (if served using the cli tool) -->
<script type="text/javascript"> <script>
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:'; const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload"; const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
const socket = new WebSocket(wsAddress); 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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

95
zsh_manual/book/Prompt-Expansion.html → zsh-manual/book/Prompt-Expansion.html
View File

@ -1,5 +1,5 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
@ -7,11 +7,10 @@
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
@ -468,7 +472,7 @@ to ‘..e/pike’. In this string, the terminating character (‘&lt;’, ‘&gt
when using print -P, however, that this must be doubled as the string is when using print -P, however, that this must be doubled as the string is
also subject to standard print processing, in addition to any also subject to standard print processing, in addition to any
backslashes removed by a double quoted string: the worst case is backslashes removed by a double quoted string: the worst case is
therefore ‘print -P &quot;%&lt;\\\\&lt;&lt;...&quot;’.</p> therefore ‘print -P "%&lt;\\\\&lt;&lt;..."’.</p>
<p>If the <code>string</code> is longer than the specified truncation length, it will <p>If the <code>string</code> is longer than the specified truncation length, it will
appear in full, completely replacing the truncated string.</p> 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 <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> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -517,7 +521,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
@ -525,7 +529,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
</div> </div>
<!-- Livereload script (if served using the cli tool) --> <!-- Livereload script (if served using the cli tool) -->
<script type="text/javascript"> <script>
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:'; const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload"; const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
const socket = new WebSocket(wsAddress); 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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

93
zsh_manual/book/Redirection.html → zsh-manual/book/Redirection.html
View File

@ -1,5 +1,5 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
@ -7,11 +7,10 @@
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { 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> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -493,7 +497,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
@ -501,7 +505,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
</div> </div>
<!-- Livereload script (if served using the cli tool) --> <!-- Livereload script (if served using the cli tool) -->
<script type="text/javascript"> <script>
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:'; const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload"; const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
const socket = new WebSocket(wsAddress); 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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

93
zsh_manual/book/Roadmap.html → zsh-manual/book/Roadmap.html
View File

@ -1,5 +1,5 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
@ -7,11 +7,10 @@
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { 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> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -358,7 +362,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
@ -366,7 +370,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
</div> </div>
<!-- Livereload script (if served using the cli tool) --> <!-- Livereload script (if served using the cli tool) -->
<script type="text/javascript"> <script>
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:'; const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload"; const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
const socket = new WebSocket(wsAddress); 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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

117
zsh_manual/book/Shell-Builtin-Commands.html → zsh-manual/book/Shell-Builtin-Commands.html
View File

@ -1,5 +1,5 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
@ -7,11 +7,10 @@
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { 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 words. Without arguments printed. With the -m flag the arguments are
taken as patterns disabled with the disable builtin command.</p> taken as patterns disabled with the disable builtin command.</p>
<p>enable -p reenables patterns disabled with disable -p. Note that it does <p>enable -p reenables patterns disabled with disable -p. Note that it does
not override globbing options; for example, ‘enable -p &quot;~&quot;’ does not not override globbing options; for example, ‘enable -p "~"’ does not
cause the pattern character ~ to be active unless the EXTENDED_GLOB 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 option is also set. To enable all possible patterns (so that they may be
individually disabled with disable -p), use ‘setopt EXTENDED_GLOB 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 (assuming that $HISTFILE and $SAVEHIST are set appropriately, of
course). The values of $HISTFILE, $HISTSIZE, and $SAVEHIST are restored course). The values of $HISTFILE, $HISTSIZE, and $SAVEHIST are restored
to the values they had when ‘fc -p’ was called. Note that this to the values they had when ‘fc -p’ was called. Note that this
restoration can conflict with making these variables &quot;local&quot;, so your restoration can conflict with making these variables "local", so your
best bet is to avoid local declarations for these variables in functions best bet is to avoid local declarations for these variables in functions
that use ‘fc -p’. The one other guaranteed-safe combination is declaring 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 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"> <div class="example">
<pre><code class="language-zsh">sleep 10 &amp; # Job in background <pre><code class="language-zsh">sleep 10 &amp; # Job in background
( # Shell forks ( # Shell forks
jobs # Shows information about &quot;sleep 10 &amp;&quot; jobs # Shows information about "sleep 10 &amp;"
sleep 5 &amp; # Process in background (no job control) sleep 5 &amp; # Process in background (no job control)
jobs # Shows information about &quot;sleep 5 &amp;&quot; jobs # Shows information about "sleep 5 &amp;"
) )
</code></pre> </code></pre>
</div> </div>
@ -1232,7 +1236,7 @@ case-independently.</p>
Print the arguments separated by newlines instead of spaces. Note: if Print the arguments separated by newlines instead of spaces. Note: if
the list of arguments is empty, print -l will still output one empty 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 line. To print a possibly-empty list of arguments one per line, use
print -C1, as in ‘print -rC1 – &quot;$list[@]&quot;’.</p> print -C1, as in ‘print -rC1 – "$list[@]"’.</p>
<p>-m<br /> <p>-m<br />
Take the first argument as a pattern (should be quoted), and remove it Take the first argument as a pattern (should be quoted), and remove it
from the argument list together with subsequent arguments that do not 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> Do not add a newline to the output.</p>
<p>-N<br /> <p>-N<br />
Print the arguments separated and terminated by nulls. Again, print Print the arguments separated and terminated by nulls. Again, print
-rNC1 – &quot;$list[@]&quot; 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> null-delimited records.</p>
<p>-o<br /> <p>-o<br />
Print the arguments sorted in ascending order.</p> 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 with the return status specified by an arithmetic expression <code>n</code>. For
example, the following prints ‘42’:</p> example, the following prints ‘42’:</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">() { integer foo=40; return &quot;foo + 2&quot; } <pre><code class="language-zsh">() { integer foo=40; return "foo + 2" }
echo $? echo $?
</code></pre> </code></pre>
</div> </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 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 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 the trap is passed as the first argument, so the statement ‘return
&quot;128+$1&quot;’ 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> trapped.</p>
<p>sched</p> <p>sched</p>
<p>See <a href="Zsh-Modules.html#The-zsh_002fsched-Module">The zsh/sched Module</a>.</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 <p>The above creates a scalar parameter svar and an array parameter avar as
if the assignments had been</p> if the assignments had been</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">svar=&quot;one word&quot; <pre><code class="language-zsh">svar="one word"
avar=(several words) avar=(several words)
</code></pre> </code></pre>
</div> </div>
@ -1808,10 +1812,10 @@ in a command substitution, separate the declaration of the parameter
from its initialization:</p> from its initialization:</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh"># WRONG <pre><code class="language-zsh"># WRONG
typeset var1=$(exit 1) || echo &quot;Trouble with var1&quot; typeset var1=$(exit 1) || echo "Trouble with var1"
# RIGHT # RIGHT
typeset var1 &amp;&amp; var1=$(exit 1) || echo &quot;Trouble with var1&quot; typeset var1 &amp;&amp; var1=$(exit 1) || echo "Trouble with var1"
</code></pre> </code></pre>
</div> </div>
<p>To initialize a parameter <code>param</code> to a command output and mark it <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 names of all arrays having the uniqueness attribute, whereas ‘typeset -f
-U +’ displays the names of all autoloadable functions. If + is the only -U +’ displays the names of all autoloadable functions. If + is the only
option, then type information (array, readonly, etc.) is also printed option, then type information (array, readonly, etc.) is also printed
for each parameter, in the same manner as ‘typeset +m &quot;*&quot;’.</p> for each parameter, in the same manner as ‘typeset +m "*"’.</p>
<p>-g<br /> <p>-g<br />
The -g (global) means that any resulting parameter will not be The -g (global) means that any resulting parameter will not be
restricted to local scope. Note that this does not necessarily mean that 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> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -2607,7 +2611,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
@ -2615,7 +2619,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
</div> </div>
<!-- Livereload script (if served using the cli tool) --> <!-- Livereload script (if served using the cli tool) -->
<script type="text/javascript"> <script>
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:'; const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload"; const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
const socket = new WebSocket(wsAddress); 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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

97
zsh_manual/book/Shell-Grammar.html → zsh-manual/book/Shell-Grammar.html
View File

@ -1,5 +1,5 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
@ -7,11 +7,10 @@
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { 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> </div>
<p>outputs nothing apart from a newline if RC_QUOTES is not set, but one <p>outputs nothing apart from a newline if RC_QUOTES is not set, but one
single quote if it is set.</p> single quote if it is set.</p>
<p>Inside double quotes (&quot;&quot;), parameter and command substitution occur, and <p>Inside double quotes (""), parameter and command substitution occur, and
‘\’ quotes the characters ‘\’, ‘‘’, ‘&quot;’, ‘$’, and the first character ‘\’ quotes the characters ‘\’, ‘‘’, ‘"’, ‘$’, and the first character
of $histchars (default ‘!’).</p> of $histchars (default ‘!’).</p>
<hr /> <hr />
<p>This document was generated on <em>May 14, 2022</em> using <a href="http://www.nongnu.org/texi2html/"><em>texi2html <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> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -757,7 +761,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
@ -765,7 +769,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
</div> </div>
<!-- Livereload script (if served using the cli tool) --> <!-- Livereload script (if served using the cli tool) -->
<script type="text/javascript"> <script>
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:'; const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload"; const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
const socket = new WebSocket(wsAddress); 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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

95
zsh_manual/book/TCP-Function-System.html → zsh-manual/book/TCP-Function-System.html
View File

@ -1,5 +1,5 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
@ -7,11 +7,10 @@
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { 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 <p>The following chunk of code puts a list of sessions into an xterm
header, with the current session followed by a star.</p> header, with the current session followed by a star.</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">print -n &quot;\033]2;TCP:&quot; ${(k)tcp_by_name:/$TCP_SESS/$TCP_SESS\*} &quot;\a&quot; <pre><code class="language-zsh">print -n "\033]2;TCP:" ${(k)tcp_by_name:/$TCP_SESS/$TCP_SESS\*} "\a"
</code></pre> </code></pre>
</div> </div>
<hr /> <hr />
@ -849,7 +853,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -863,7 +867,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
@ -871,7 +875,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
</div> </div>
<!-- Livereload script (if served using the cli tool) --> <!-- Livereload script (if served using the cli tool) -->
<script type="text/javascript"> <script>
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:'; const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload"; const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
const socket = new WebSocket(wsAddress); 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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

93
zsh_manual/book/The-Z-Shell-Manual.html → zsh-manual/book/The-Z-Shell-Manual.html
View File

@ -1,5 +1,5 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
@ -7,11 +7,10 @@
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { 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"> <nav class="nav-wrapper" aria-label="Page navigation">
<!-- Mobile navigation buttons --> <!-- 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> <i class="fa fa-angle-right"></i>
</a> </a>
@ -209,7 +213,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
<nav class="nav-wide-wrapper" aria-label="Page navigation"> <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> <i class="fa fa-angle-right"></i>
</a> </a>
</nav> </nav>
@ -217,7 +221,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
</div> </div>
<!-- Livereload script (if served using the cli tool) --> <!-- Livereload script (if served using the cli tool) -->
<script type="text/javascript"> <script>
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:'; const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload"; const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
const socket = new WebSocket(wsAddress); 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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

193
zsh_manual/book/User-Contributions.html → zsh-manual/book/User-Contributions.html
View File

@ -1,5 +1,5 @@
<!DOCTYPE HTML> <!DOCTYPE HTML>
<html lang="en" class="sidebar-visible no-js light"> <html lang="en" class="mocha sidebar-visible" dir="ltr">
<head> <head>
<!-- Book generated using mdBook --> <!-- Book generated using mdBook -->
<meta charset="UTF-8"> <meta charset="UTF-8">
@ -7,11 +7,10 @@
<!-- Custom HTML head --> <!-- Custom HTML head -->
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<meta name="description" content=""> <meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1"> <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="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png"> <link rel="shortcut icon" href="favicon.png">
@ -31,18 +30,20 @@
<!-- Custom theme stylesheets --> <!-- Custom theme stylesheets -->
<link rel="stylesheet" href="./theme/catppuccin.css"> <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> </head>
<body> <body>
<!-- Provide site root to javascript --> <div id="body-container">
<script type="text/javascript">
var path_to_root = "";
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "light";
</script>
<!-- Work around some values being stored in localStorage wrapped in quotes --> <!-- Work around some values being stored in localStorage wrapped in quotes -->
<script type="text/javascript"> <script>
try { try {
var theme = localStorage.getItem('mdbook-theme'); var theme = localStorage.getItem('mdbook-theme');
var sidebar = localStorage.getItem('mdbook-sidebar'); var sidebar = localStorage.getItem('mdbook-sidebar');
@ -58,56 +59,59 @@
</script> </script>
<!-- Set the theme before any content is loaded, prevents flash --> <!-- Set the theme before any content is loaded, prevents flash -->
<script type="text/javascript"> <script>
var theme; var theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { } try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; } if (theme === null || theme === undefined) { theme = default_theme; }
var html = document.querySelector('html'); const html = document.documentElement;
html.classList.remove('no-js') html.classList.remove('mocha')
html.classList.remove('light')
html.classList.add(theme); html.classList.add(theme);
html.classList.add('js'); html.classList.add("js");
</script> </script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed --> <!-- Hide / unhide sidebar before it is displayed -->
<script type="text/javascript"> <script>
var html = document.querySelector('html'); var sidebar = null;
var sidebar = 'hidden'; var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) { if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { } try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible'; sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
} }
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible'); html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar); html.classList.add("sidebar-" + sidebar);
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<div class="sidebar-scrollbox"> <!-- populated by js -->
<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> <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>
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
<div class="page"> <div class="page">
<div id="menu-bar-hover-placeholder"></div> <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"> <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> <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"> <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> <i class="fa fa-paint-brush"></i>
</button> </button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu"> <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="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="macchiato">Macchiato</button></li>
<li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li> <li role="none"><button role="menuitem" class="theme" id="mocha">Mocha</button></li>
</ul> </ul>
@ -138,7 +142,7 @@
</div> </div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM --> <!-- 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-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible'); document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) { 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> commands, like this:</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">source ${ZDOTDIR:-$HOME}/.zkbd/$TERM-$VENDOR-$OSTYPE <pre><code class="language-zsh">source ${ZDOTDIR:-$HOME}/.zkbd/$TERM-$VENDOR-$OSTYPE
[[ -n ${key[Left]} ]] &amp;&amp; bindkey &quot;${key[Left]}&quot; backward-char [[ -n ${key[Left]} ]] &amp;&amp; bindkey "${key[Left]}" backward-char
[[ -n ${key[Right]} ]] &amp;&amp; bindkey &quot;${key[Right]}&quot; forward-char [[ -n ${key[Right]} ]] &amp;&amp; bindkey "${key[Right]}" forward-char
# etc. # etc.
</code></pre> </code></pre>
</div> </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 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> context. Widgets are invoked in the order they were added, with</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">zle widgetname -Nw -f &quot;nolast&quot; -- &quot;$@&quot; <pre><code class="language-zsh">zle widgetname -Nw -f "nolast" -- "$@"
</code></pre> </code></pre>
</div> </div>
<p><span id="index-WIDGET_002c-in-hooks"></span></p> <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 /> <p>recent-dirs-default<br />
If true, and the command is expecting a recent directory index, and 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 either there is more than one argument or the argument is not an
integer, then fall through to &quot;cd&quot;. 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 command for directory changing. Completion recognises this, too; see
recent-dirs-insert for how to control completion when this option is in recent-dirs-insert for how to control completion when this option is in
use.</p> 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 naming: converting from a name to a directory, converting in the reverse
direction to find a short name, and completion of names.</p> direction to find a short name, and completion of names.</p>
<p>The main feature of this function is a path-like syntax, combining <p>The main feature of this function is a path-like syntax, combining
abbreviations at multiple levels separated by &quot;:&quot;. As an example, abbreviations at multiple levels separated by ":". As an example,
~[g:p:s] might specify:</p> ~[g:p:s] might specify:</p>
<p>g<br /> <p>g<br />
The top level directory for your git area. This first component has to 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 not needed if you did this at initialisation...
autoload -Uz zsh_directory_name_generic autoload -Uz zsh_directory_name_generic
zsh_directory_name_generic &quot;$@ zsh_directory_name_generic "$@
</code></pre> </code></pre>
</div> </div>
<p>It is also possible to use global associative arrays, suitably named, <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> </div>
<p>and the function zdn_mywrapper would contain only the following:</p> <p>and the function zdn_mywrapper would contain only the following:</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">zsh_directory_name_generic &quot;$@&quot; <pre><code class="language-zsh">zsh_directory_name_generic "$@"
</code></pre> </code></pre>
</div> </div>
<hr /> <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> you modify how that string should look.</p>
<p><span id="index-nvcsformats"></span></p> <p><span id="index-nvcsformats"></span></p>
<p>nvcsformats</p> <p>nvcsformats</p>
<p>These &quot;formats&quot; 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 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 want vcs_info to completely take over the generation of your prompt.
You would do something like PS1=’${vcs_info_msg_0_}’ to accomplish 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 <p>Say, ~/.zsh is a directory under version control, in which you do not
want vcs_info to be active, do:</p> want vcs_info to be active, do:</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">zstyle ':vcs_info:*' disable-patterns &quot;${(b)HOME}/.zsh(|/*)&quot; <pre><code class="language-zsh">zstyle ':vcs_info:*' disable-patterns "${(b)HOME}/.zsh(|/*)"
</code></pre> </code></pre>
</div> </div>
<p><span id="index-use_002dquilt"></span></p> <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>Used by the quilt, hg, and git backends.</p>
<p>The default values for these styles in all contexts are:</p> <p>The default values for these styles in all contexts are:</p>
<p>formats<br /> <p>formats<br />
&quot; (%s)-[%b]%u%c-&quot;</p> " (%s)-[%b]%u%c-"</p>
<p>actionformats<br /> <p>actionformats<br />
&quot; (%s)-[%b|%a]%u%c-&quot;</p> " (%s)-[%b|%a]%u%c-"</p>
<p>branchformat<br /> <p>branchformat<br />
&quot;%b:%r&quot; (for bzr, svn, svk and hg)</p> "%b:%r" (for bzr, svn, svk and hg)</p>
<p>nvcsformats<br /> <p>nvcsformats<br />
&quot;&quot;</p> ""</p>
<p>hgrevformat<br /> <p>hgrevformat<br />
&quot;%r:%h&quot;</p> "%r:%h"</p>
<p>max-exports<br /> <p>max-exports<br />
2</p> 2</p>
<p>enable<br /> <p>enable<br />
@ -1331,9 +1335,9 @@ false</p>
<p>check-for-staged-changes<br /> <p>check-for-staged-changes<br />
false</p> false</p>
<p>stagedstr<br /> <p>stagedstr<br />
(string: &quot;S&quot;)</p> (string: "S")</p>
<p>unstagedstr<br /> <p>unstagedstr<br />
(string: &quot;U&quot;)</p> (string: "U")</p>
<p>command<br /> <p>command<br />
(empty string)</p> (empty string)</p>
<p>use-server<br /> <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> /foo/bar/repoXY/beer/tasty, %S is beer/tasty.</p>
<!-- --> <!-- -->
<p>%m<br /> <p>%m<br />
A &quot;misc&quot; 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> what this replacement expands to.</p>
<p>The hg and git backends use this expando to display patch information. <p>The hg and git backends use this expando to display patch information.
hg sources patch information from the mq extensions; git from 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 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 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 second element. vcs_info will have filled in a proper value for the
&quot;repository’s&quot; 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 about quilt’s state will be available as the ‘misc’ replacement (and %Q
for compatibility with ‘addon’ mode).</p> for compatibility with ‘addon’ mode).</p>
<p>What is left to discuss is how ‘standalone’ mode is detected. The <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 passed as arguments to the hook: 1. the quilt-support mode (‘addon’ or
‘standalone’); 2. the directory that contains the patch series; 3. the ‘standalone’); 2. the directory that contains the patch series; 3. the
directory that holds quilt’s status information (the ‘.pc’ directory) or directory that holds quilt’s status information (the ‘.pc’ directory) or
the string &quot;-nopc-&quot; 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>The ‘hook_com’ parameter is not used.</p>
<p>set-branch-format<br /> <p>set-branch-format<br />
Called before ‘branchformat’ is set. The only argument to the hook is 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> vcs_info.</p>
<p>pre-addon-quilt<br /> <p>pre-addon-quilt<br />
This hook is used when vcs_info’s quilt functionality is active in This hook is used when vcs_info’s quilt functionality is active in
&quot;addon&quot; 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> 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 <p>Setting the ‘ret’ variable in this hook to a non-zero value avoids any
quilt specific actions from being run at all.</p> 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. # commas. This mixes things up a little.
# Imagine, there's one type of bookmarks that is # Imagine, there's one type of bookmarks that is
# special to you. Say, because it's *your* work. # special to you. Say, because it's *your* work.
# Those bookmarks look always like this: &quot;sh/*&quot; # Those bookmarks look always like this: "sh/*"
# (because your initials are sh, for example). # (because your initials are sh, for example).
# This makes the bookmarks string use only those # This makes the bookmarks string use only those
# bookmarks. If there's more than one, it # bookmarks. If there's more than one, it
# concatenates them using commas. # concatenates them using commas.
# The bookmarks returned by `hg' are available in # The bookmarks returned by `hg' are available in
# the function's positional parameters. # the function's positional parameters.
local s=&quot;${(Mj:,:)@:#sh/*}&quot; local s="${(Mj:,:)@:#sh/*}"
# Now, the communication with the code that calls # Now, the communication with the code that calls
# the hook functions is done via the hook_com[] # the hook functions is done via the hook_com[]
# hash. The key at which the `gen-hg-bookmark-string' # 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 defining additional functions. To make some complex tasks easier, your
setup function may also do any of the following:</p> setup function may also do any of the following:</p>
<p>Assign prompt_opts<br /> <p>Assign prompt_opts<br />
The array prompt_opts may be assigned any of &quot;bang&quot;, &quot;cr&quot;, &quot;percent&quot;, The array prompt_opts may be assigned any of "bang", "cr", "percent",
&quot;sp&quot;, and/or &quot;subst&quot; as values. The corresponding setopts (promptbang, "sp", and/or "subst" as values. The corresponding setopts (promptbang,
etc.) are turned on, all other prompt-related options are turned off. etc.) are turned on, all other prompt-related options are turned off.
The prompt_opts array preserves setopts even beyond the scope of The prompt_opts array preserves setopts even beyond the scope of
localoptions, should your function need that.</p> 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> context.</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">zstyle ':zle:*' word-context \ <pre><code class="language-zsh">zstyle ':zle:*' word-context \
&quot;*/*&quot; filename &quot;[[:space:]]&quot; whitespace "*/*" filename "[[:space:]]" whitespace
zstyle ':zle:transpose-words:whitespace' word-style shell zstyle ':zle:transpose-words:whitespace' word-style shell
zstyle ':zle:transpose-words:filename' word-style normal zstyle ':zle:transpose-words:filename' word-style normal
zstyle ':zle:transpose-words:filename' word-chars '' zstyle ':zle:transpose-words:filename' word-chars ''
@ -2617,7 +2621,7 @@ Cedilla.</p>
Underline, however there are currently no underlined characters.</p> Underline, however there are currently no underlined characters.</p>
<p>/<br /> <p>/<br />
Stroke through the base character.</p> Stroke through the base character.</p>
<p>&quot;<br /> <p>"<br />
Double acute (only supported on a few letters).</p> Double acute (only supported on a few letters).</p>
<p>;<br /> <p>;<br />
Ogonek. (A little forward facing hook at the bottom right of the Ogonek. (A little forward facing hook at the bottom right of the
@ -2685,8 +2689,8 @@ Yen</p>
<p>Eu<br /> <p>Eu<br />
Euro (N.B. not in RFC 1345)</p> Euro (N.B. not in RFC 1345)</p>
<p>Punctuation characters<br /> <p>Punctuation characters<br />
References to &quot;right&quot; quotes indicate the shape (like a 9 rather than 6) References to "right" quotes indicate the shape (like a 9 rather than 6)
rather than their grammatical use. (For example, a &quot;right&quot; low double rather than their grammatical use. (For example, a "right" low double
quote is used to open quotations in German.)</p> quote is used to open quotations in German.)</p>
<p>!I<br /> <p>!I<br />
Inverted exclamation mark</p> Inverted exclamation mark</p>
@ -2733,17 +2737,17 @@ Left single quote</p>
<p>’9<br /> <p>’9<br />
Right single quote</p> Right single quote</p>
<p>.9<br /> <p>.9<br />
&quot;Right&quot; low quote</p> "Right" low quote</p>
<p>9’<br /> <p>9’<br />
Reversed &quot;right&quot; quote</p> Reversed "right" quote</p>
<p>&quot;6<br /> <p>"6<br />
Left double quote</p> Left double quote</p>
<p>&quot;9<br /> <p>"9<br />
Right double quote</p> Right double quote</p>
<p>:9<br /> <p>:9<br />
&quot;Right&quot; low double quote</p> "Right" low double quote</p>
<p>9&quot;<br /> <p>9"<br />
Reversed &quot;right&quot; double quote</p> Reversed "right" double quote</p>
<p>/-<br /> <p>/-<br />
Dagger</p> Dagger</p>
<p>/=<br /> <p>/=<br />
@ -3037,7 +3041,7 @@ quotes, a backslash is inserted before the input character.</p>
<p>Styles to control quoting behavior:</p> <p>Styles to control quoting behavior:</p>
<p>url-metas<br /> <p>url-metas<br />
This style is looked up in the context ‘:url-quote-magic:<code>scheme</code>’ 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. &quot;ftp&quot;). 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 string listing the characters to be treated as globbing metacharacters
when appearing in a URL using that scheme. The default is to quote all when appearing in a URL using that scheme. The default is to quote all
zsh extended globbing characters, excluding ’&lt;’ and ’&gt;’ but including zsh extended globbing characters, excluding ’&lt;’ and ’&gt;’ 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 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 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 their real local path names, as opposed to files which are specified
relative to a web-server-defined document root. The defaults are &quot;ftp&quot; relative to a web-server-defined document root. The defaults are "ftp"
and &quot;file&quot;.</p> and "file".</p>
<p>url-other-schema<br /> <p>url-other-schema<br />
Like url-local-schema, but lists all other URI schema upon which 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 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 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 url-local-schema, it is not magically quoted. The default values are
&quot;http&quot;, &quot;https&quot;, and &quot;ftp&quot;. 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 url-local-schema, it is quoted differently depending on whether the
command name appears in url-globbers.</p> command name appears in url-globbers.</p>
<p>Loading url-quote-magic also defines a helper function ‘urlglobber’ and <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 href="#Mathematical-Functions">Mathematical Functions</a>. It should be bound to
a key representing a binary operator such as ‘+’, ‘-’, ‘*’ or ‘/’. When a key representing a binary operator such as ‘+’, ‘-’, ‘*’ or ‘/’. When
running in zcalc, if the key occurs at the start of the line or running in zcalc, if the key occurs at the start of the line or
immediately following an open parenthesis, the text &quot;ans &quot; 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 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 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 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:]/\\])*' <pre><code class="language-zsh">zstyle :insert-last-word match '*([[:digit:]]?|[[:alpha:]/\\])*'
</code></pre> </code></pre>
</div> </div>
<p>The above example causes redirections like &quot;2&gt;&quot; to be included.</p> <p>The above example causes redirections like "2&gt;" to be included.</p>
<p><span id="index-prompt_002c-widget-style"></span></p> <p><span id="index-prompt_002c-widget-style"></span></p>
<p>prompt</p> <p>prompt</p>
<p>The incremental-complete-word widget shows the value of this style in <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> for exceptions. A typical example is as follows.</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">{ <pre><code class="language-zsh">{
# &quot;try&quot; block # "try" block
# ... nested code here calls &quot;throw MyExcept&quot; # ... nested code here calls "throw MyExcept"
} always { } always {
# &quot;always&quot; block # "always" block
if catch MyExcept; then if catch MyExcept; then
print &quot;Caught exception MyExcept&quot; print "Caught exception MyExcept"
elif catch ''; then elif catch ''; then
print &quot;Caught a shell error. Propagating...&quot; print "Caught a shell error. Propagating..."
throw '' throw ''
fi fi
# Other exceptions are not handled but may be caught further # Other exceptions are not handled but may be caught further
@ -3380,10 +3384,10 @@ preferable.</p>
if catch *; then if catch *; then
case $CAUGHT in case $CAUGHT in
(MyExcept) (MyExcept)
print &quot;Caught my own exception&quot; print "Caught my own exception"
;; ;;
(*) (*)
print &quot;Caught some other exception&quot; print "Caught some other exception"
;; ;;
esac esac
fi 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 instances is equivalent to %b %u and the defaults for using running
browsers are equivalent to the values kfmclient openURL %u for browsers are equivalent to the values kfmclient openURL %u for
Konqueror, firefox -new-tab %u for Firefox, opera -newpage %u for Opera, Konqueror, firefox -new-tab %u for Firefox, opera -newpage %u for Opera,
and %b -remote &quot;openUrl(%u)&quot; for all others.</p> and %b -remote "openUrl(%u)" for all others.</p>
<hr /> <hr />
<p><span id="Mathematical-Functions"></span> <span <p><span id="Mathematical-Functions"></span> <span
id="Mathematical-Functions-1"></span></p> id="Mathematical-Functions-1"></span></p>
@ -4004,7 +4008,7 @@ not available in all versions of zsh.</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">is-at-least 3.1.6-15 &amp;&amp; setopt NO_GLOBAL_RCS <pre><code class="language-zsh">is-at-least 3.1.6-15 &amp;&amp; setopt NO_GLOBAL_RCS
is-at-least 3.1.0 &amp;&amp; setopt HIST_REDUCE_BLANKS is-at-least 3.1.0 &amp;&amp; setopt HIST_REDUCE_BLANKS
is-at-least 2.6-17 || print &quot;You can't use is-at-least here.&quot; is-at-least 2.6-17 || print "You can't use is-at-least here."
</code></pre> </code></pre>
</div> </div>
<p><span id="index-nslookup"></span></p> <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 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 (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> file nor assistant is found, the external command ‘man <code>cmd</code>’ is run.</p>
<p>An example assistant for the &quot;ssh&quot; command:</p> <p>An example assistant for the "ssh" command:</p>
<div class="example"> <div class="example">
<pre><code class="language-zsh">run-help-ssh() { <pre><code class="language-zsh">run-help-ssh() {
emulate -LR zsh emulate -LR zsh
local -a args local -a args
# Delete the &quot;-l username&quot; option # Delete the "-l username" option
zparseopts -D -E -a args l: zparseopts -D -E -a args l:
# Delete other options, leaving: host command # Delete other options, leaving: host command
args=(${@:#-*}) args=(${@:#-*})
@ -4381,7 +4385,7 @@ Zsh version 5.9, released on May 14, 2022.</p>
</div> </div>
<!-- Livereload script (if served using the cli tool) --> <!-- Livereload script (if served using the cli tool) -->
<script type="text/javascript"> <script>
const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:'; const wsProtocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload"; const wsAddress = wsProtocol + "//" + location.host + "/" + "__livereload";
const socket = new WebSocket(wsAddress); 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; window.playground_copyable = true;
</script> </script>
<script src="elasticlunr.min.js" type="text/javascript" charset="utf-8"></script> <script src="elasticlunr.min.js"></script>
<script src="mark.min.js" type="text/javascript" charset="utf-8"></script> <script src="mark.min.js"></script>
<script src="searcher.js" type="text/javascript" charset="utf-8"></script> <script src="searcher.js"></script>
<script src="clipboard.min.js" type="text/javascript" charset="utf-8"></script> <script src="clipboard.min.js"></script>
<script src="highlight.js" type="text/javascript" charset="utf-8"></script> <script src="highlight.js"></script>
<script src="book.js" type="text/javascript" charset="utf-8"></script> <script src="book.js"></script>
<!-- Custom JS scripts --> <!-- Custom JS scripts -->
</div>
</body> </body>
</html> </html>

Some files were not shown because too many files have changed in this diff Show More