From 945e15624bd7d5baa28ea00dc8ef97c8abf3c79a Mon Sep 17 00:00:00 2001
From: Jilles Tjoelker <jilles@FreeBSD.org>
Date: Fri, 7 Nov 2014 21:30:16 +0000
Subject: [PATCH] sh(1): Mention portability issue with shifting zero
 positional parameters.

Per Austin Group issue #459, shifting zero positional parameters may or may
not be considered an operand error (which causes the shell to exit in most
cases).
---
 bin/sh/sh.1 | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/bin/sh/sh.1 b/bin/sh/sh.1
index 47b1b36c59f1..c770aca07d59 100644
--- a/bin/sh/sh.1
+++ b/bin/sh/sh.1
@@ -32,7 +32,7 @@
 .\"	from: @(#)sh.1	8.6 (Berkeley) 5/4/95
 .\" $FreeBSD$
 .\"
-.Dd September 21, 2014
+.Dd November 7, 2014
 .Dt SH 1
 .Os
 .Sh NAME
@@ -2522,7 +2522,8 @@ and so on,
 decreasing the value of
 .Li $#
 by one.
-If there are zero positional parameters, shifting does not do anything.
+For portability, shifting if there are zero positional parameters
+should be avoided, since the shell may abort.
 .It Ic test
 A built-in equivalent of
 .Xr test 1 .