docs(functions): add missing EXIT STATUS header docs

Fills the gaps recorded in JOB-BRIEF-FINDINGS.md for the functions
converted to header-driven --help: 16 argument-less functions gain an
EXIT STATUS section (check_fish_deps, claude-docs, claude-pr, cleanup,
fast, fzf-update, gip, gip4, hist, limine-edit, lock, ports,
screensleep, steam-dl, swapstat, tmux-clean), and 8 functions that
already document ARGUMENTS gain EXIT STATUS too (lD, lsr, lss, lstree,
lt, ltr, lx, qr).

Not touched: gip6, ld, parur, sudo-toggle, upgrade, the JOB-BRIEF's
'missing ARGUMENTS' group. Re-checked their bodies against that claim
-- none of the five take a positional argument ($argv only appears
forwarded to the --help check), so an ARGUMENTS section would document
something that doesn't exist. All five already have EXIT STATUS.

This commit is contained in:

rootiest

2026-09-08 01:12:04 -04:00

parent 3aa462a2b8

commit dccf897c9f

24 changed files with 75 additions and 0 deletions

									
										functions/ltr.fish
									
		+3
		
												View File
												
				@@ -15,6 +15,9 @@

				# ARGUMENTS

				#   args...  Arguments forwarded to the listing command

				#

				# EXIT STATUS

				#   Exit status of eza, lsd, or ls, whichever ran

				#

				# EXAMPLE

				#   ltr ~/projects

				function ltr --description 'Reversed time-sorted listing'