rootiest
e651566e14
RETURNS previously conflated fish's $status exit code with genuine stdout/printed output, e.g. rm listing "0/1" as if they were print values rather than exit codes. Rename RETURNS to EXIT STATUS across all 83 documented functions, and reintroduce RETURNS as a distinct label reserved for the 15 functions that actually print to stdout. Update build-manual.py's ENTRY_HEADS to render Exit Status before Returns, manualtools.py's SECTIONS constant, and AGENTS.md's label order and label-usage guidance to match. Add two verify-manual.py regression tests: EXIT STATUS bodies must never contain stray stdout/printed language, and Returns: must always render after Exit Status: when both are present. Regenerate docs/fish-config.md.
85 lines
2.6 KiB
Fish
85 lines
2.6 KiB
Fish
# Copyright (C) 2026 Rootiest
|
|
# SPDX-License-Identifier: AGPL-3.0-or-later
|
|
|
|
# CATEGORY
|
|
# 01-file-and-directory
|
|
#
|
|
# SYNOPSIS
|
|
# mkcd [-s | --silent] <dir>
|
|
#
|
|
# DESCRIPTION
|
|
# Creates a directory (including any missing parent directories) and
|
|
# immediately changes into it. Prints a tree of created directories by
|
|
# default, or suppresses output with -s. Delegates creation to
|
|
# _fish_mkdir_p.
|
|
#
|
|
# ARGUMENTS
|
|
# -h, --help Show usage help
|
|
# -s, --silent Suppress directory creation output
|
|
# <dir> Directory to create and enter
|
|
#
|
|
# EXIT STATUS
|
|
# 0 Directory created (or already existed) and entered successfully
|
|
# 1 Directory creation or cd failed
|
|
#
|
|
# EXAMPLE
|
|
# mkcd ~/projects/myapp
|
|
# mkcd ~/projects/newapp/src
|
|
function mkcd --description 'Create a directory (with parents) and cd into it'
|
|
set -l c_head (set_color --bold cyan)
|
|
set -l c_cmd (set_color --bold white)
|
|
set -l c_arg (set_color cyan)
|
|
set -l c_flag (set_color yellow)
|
|
set -l c_ok (set_color green)
|
|
set -l c_warn (set_color yellow)
|
|
set -l c_err (set_color red)
|
|
set -l c_dim (set_color brblack)
|
|
set -l c_rst (set_color normal)
|
|
|
|
if contains -- -h $argv; or contains -- --help $argv; or test (count $argv) -eq 0
|
|
echo "$c_head""Usage:$c_rst $c_cmd""mkcd$c_rst $c_arg""<dir>$c_rst"
|
|
echo
|
|
echo " Create $c_arg""<dir>$c_rst (including missing parents) and cd into it."
|
|
echo
|
|
echo "$c_head""Arguments:$c_rst"
|
|
echo " $c_arg""<dir>$c_rst Directory to create and enter"
|
|
echo
|
|
echo "$c_head""Flags:$c_rst"
|
|
echo " $c_flag-h$c_rst, $c_flag--help$c_rst Show this help message"
|
|
echo " $c_flag-s$c_rst, $c_flag--silent$c_rst Suppress directory creation output"
|
|
echo
|
|
echo "$c_head""Examples:$c_rst"
|
|
echo " $c_cmd""mkcd$c_rst $c_arg~/projects/myapp$c_rst"
|
|
echo " $c_cmd""mkcd$c_rst $c_arg~/projects/myapp$c_rst""$c_dim""; git init$c_rst"
|
|
return 0
|
|
end
|
|
|
|
set -l silent 0
|
|
set -l dir
|
|
for _arg in $argv
|
|
switch $_arg
|
|
case -s --silent
|
|
set silent 1
|
|
case '*'
|
|
set dir $_arg
|
|
end
|
|
end
|
|
|
|
set -l is_new 0
|
|
test -d $dir; or set is_new 1
|
|
if test $silent -eq 1
|
|
_fish_mkdir_p --silent $dir; or return $status
|
|
else
|
|
_fish_mkdir_p --tree $dir; or return $status
|
|
end
|
|
|
|
cd $dir
|
|
or return $status
|
|
|
|
if test $is_new -eq 1
|
|
echo "$c_ok""✔$c_rst Created and entered $c_arg$dir$c_rst"
|
|
else
|
|
echo "$c_warn""→$c_rst $c_arg$dir$c_rst already exists — entered"
|
|
end
|
|
end
|