sh.1: Document the exit status of return

It's not obvious that if `exitstatus` is omitted,
the exit status of the function is taken from the last executed command.

MFC after:		3 days
Reviewed by:		jilles, ziaee
Differential Revision:	https://reviews.freebsd.org/D55026

This commit is contained in:

Artem Bunichev

2026-02-16 12:14:00 -05:00

committed by

Alexander Ziaee

parent f1f142c01d

commit 931d4f0ae4

1 changed files with 5 additions and 1 deletions

									
										bin/sh/sh.1
									
		+5
		-1
	
												View File
												
				@@ -41,7 +41,7 @@

				.\" the referee document.  The original Standard can be obtained online at

				.\"     http://www.opengroup.org/unix/online.html.

				.\"

				.Dd February 3, 2026

				.Dd February 9, 2026

				.Dt SH 1

				.Os

				.Sh NAME

				@@ -1223,6 +1223,10 @@ It terminates the current executional scope, returning from the closest

				nested function or sourced script;

				if no function or sourced script is being executed,

				it exits the shell instance.

				If

				.Ar exitstatus

				is specified, the exit status is set to its value,

				otherwise it is set to the exit status of the last executed command.

				The

				.Ic return

				command is implemented as a special built-in command.