-Suspend the execution of this shell until it receives a SIGCONT
-signal. The `-f' if specified says not to complain about this
-being a login shell if it is; just suspend anyway.
+Suspend shell execution.
+
+Suspend the execution of this shell until it receives a SIGCONT signal.
+Unless forced, login shells cannot be suspended.
+
+Options:
+ -f force the suspend, even if the shell is a login shell
+
+Exit Status:
+Returns success unless job control is not enabled or an error occurs.