From a57f482b31fb449a3110fbe35171830d944c77a3 Mon Sep 17 00:00:00 2001
From: Sara Golemon <pollita@php.net>
Date: Fri, 11 Apr 2003 05:44:46 +0000
Subject: [PATCH] Add <tip> regarding use of IPv6 numerical addresses

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@123119 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/network/functions/fsockopen.xml           | 8 +++++++-
 reference/stream/functions/stream-socket-client.xml | 8 +++++++-
 reference/stream/functions/stream-socket-server.xml | 8 +++++++-
 3 files changed, 21 insertions(+), 3 deletions(-)

diff --git a/reference/network/functions/fsockopen.xml b/reference/network/functions/fsockopen.xml
index 0dbde807a1..dde2b19dd3 100644
--- a/reference/network/functions/fsockopen.xml
+++ b/reference/network/functions/fsockopen.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/network.xml, last change in rev 1.2 -->
   <refentry id="function.fsockopen">
    <refnamediv>
@@ -125,6 +125,12 @@ if (!$fp) {
         a link for the socket until it actually needs to send or receive data.
       </simpara>
      </warning>
+     <tip>
+      <simpara>
+       When specifying a numerical IPv6 address (i.e. fe80::1) you must enclose
+       the IP in square brackets.  <literal>fsockopen("tcp://[fe80::1]", 80)</literal>.
+      </simpara>
+     </tip>
      <note>
       <para>The timeout parameter was introduced in PHP 3.0.9 and
       UDP support was added in PHP 4.
diff --git a/reference/stream/functions/stream-socket-client.xml b/reference/stream/functions/stream-socket-client.xml
index 0022b8422a..83f618f784 100644
--- a/reference/stream/functions/stream-socket-client.xml
+++ b/reference/stream/functions/stream-socket-client.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
   <refentry id="function.stream-socket-client">
    <refnamediv>
     <refname>stream_socket_client</refname>
@@ -124,6 +124,12 @@ if (!$fp) {
         a link for the socket until it actually needs to send or receive data.
       </simpara>
      </warning>
+     <tip>
+      <simpara>
+       When specifying a numerical IPv6 address (i.e. fe80::1) you must enclose
+       the IP in square brackets.  <literal>stream_socket_client("tcp://[fe80::1]:80")</literal>.
+      </simpara>
+     </tip>
      See also <function>stream_socket_server</function>, 
      <function>stream_set_blocking</function>,
      <function>stream_set_timeout</function>, 
diff --git a/reference/stream/functions/stream-socket-server.xml b/reference/stream/functions/stream-socket-server.xml
index a9e8a587ca..297f46bb7c 100644
--- a/reference/stream/functions/stream-socket-server.xml
+++ b/reference/stream/functions/stream-socket-server.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
   <refentry id="function.stream-socket-server">
    <refnamediv>
     <refname>stream_socket_server</refname>
@@ -102,6 +102,12 @@ if (!$socket) {
 ]]>
      </programlisting>
      </example>
+     <tip>
+      <simpara>
+       When specifying a numerical IPv6 address (i.e. fe80::1) you must enclose
+       the IP in square brackets.  <literal>stream_socket_server("tcp://[fe80::1]:80")</literal>.
+      </simpara>
+     </tip>
      See also <function>stream_socket_client</function>, 
      <function>stream_set_blocking</function>,
      <function>stream_set_timeout</function>,