From ec415ad9705fe642d00ea8aa7abcb2f4b47992bd Mon Sep 17 00:00:00 2001
From: Alejandro Colomar <alx.manpages@gmail.com>
Date: Wed, 28 Jul 2021 22:20:03 +0200
Subject: [PATCH] strstr.3: Document special case for empty needle

Reported-by: Stefan Kanthak <stefan.kanthak@nexgo.de>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
---
 man3/strstr.3 | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/man3/strstr.3 b/man3/strstr.3
index e085409c2..41ee87489 100644
--- a/man3/strstr.3
+++ b/man3/strstr.3
@@ -61,6 +61,14 @@ but ignores the case of both arguments.
 .SH RETURN VALUE
 These functions return a pointer to the beginning of the
 located substring, or NULL if the substring is not found.
+.PP
+Note the special case:
+If
+.I needle
+is the empty string,
+the return value is always
+.I haystack
+itself.
 .SH ATTRIBUTES
 For an explanation of the terms used in this section, see
 .BR attributes (7).