docs(functions): add man-page headers to branch, fc, gitup, sudo-toggle

These four were the only documented functions with no comment header,
carrying just a one-line description. Content is merged from their manual
entries plus what the implementations actually do (fc's vi fallback and
empty-buffer abort, sudo-toggle's credential-cache clear), so the headers
are a superset of Section 5 rather than a copy of it.
This commit is contained in:
2026-07-26 03:45:03 -04:00
parent 4c51ef7a33
commit 5f4306b6ca
4 changed files with 90 additions and 3 deletions
+25 -1
View File
@@ -1,4 +1,28 @@
# Edit and execute the last command (Bash-style fc)
# Copyright (C) 2026 Rootiest
# SPDX-License-Identifier: AGPL-3.0-or-later
# CATEGORY
# 03-editors-and-viewers
#
# SYNOPSIS
# fc [command_prefix]
#
# DESCRIPTION
# Edits the last shell command -- or the most recent one matching a
# prefix -- in $EDITOR, then executes the result. Bash-style fc
# behaviour. Falls back to vi when $EDITOR is unset, and aborts without
# executing if the buffer is left empty.
#
# ARGUMENTS
# command_prefix Search history for the newest command matching this
#
# RETURNS
# The edited command's exit status, or a message when history lookup
# found nothing.
#
# EXAMPLE
# fc
# fc git
function fc --description 'Edit and execute the last command (Bash-style fc)'
set -l tmpfile (mktemp /tmp/fish_fc.XXXXXX).fish