Repository: guacamole-manual
Updated Branches:
  refs/heads/master 03c612cc2 -> fadba6446


GUACAMOLE-661: Document deprecation of "nest" instruction.


Project: http://git-wip-us.apache.org/repos/asf/guacamole-manual/repo
Commit: http://git-wip-us.apache.org/repos/asf/guacamole-manual/commit/206400f0
Tree: http://git-wip-us.apache.org/repos/asf/guacamole-manual/tree/206400f0
Diff: http://git-wip-us.apache.org/repos/asf/guacamole-manual/diff/206400f0

Branch: refs/heads/master
Commit: 206400f063b7e04e6350fb368fa9506193601b57
Parents: 03c612c
Author: Michael Jumper <mjum...@apache.org>
Authored: Mon Jan 7 09:47:14 2019 -0800
Committer: Michael Jumper <mjum...@apache.org>
Committed: Mon Jan 7 09:47:14 2019 -0800

----------------------------------------------------------------------
 src/references/instructions/server/stream/nest.xml | 14 ++++++++++++++
 1 file changed, 14 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/guacamole-manual/blob/206400f0/src/references/instructions/server/stream/nest.xml
----------------------------------------------------------------------
diff --git a/src/references/instructions/server/stream/nest.xml 
b/src/references/instructions/server/stream/nest.xml
index 207d5c7..50119f9 100644
--- a/src/references/instructions/server/stream/nest.xml
+++ b/src/references/instructions/server/stream/nest.xml
@@ -6,6 +6,20 @@
     <indexterm>
         <primary>nest</primary>
     </indexterm>
+    <important>
+        <para><emphasis>The <function>nest</function> instruction has been
+            deprecated.</emphasis></para>
+        <para>The <function>nest</function> instruction is no longer 
necessary, having been replaced
+            by other streaming instructions (such as <link
+                xmlns:xlink="http://www.w3.org/1999/xlink"; 
linkend="blob-instruction"
+                    ><function>blob</function></link>, <link
+                xmlns:xlink="http://www.w3.org/1999/xlink"; 
linkend="ack-instruction"
+                    ><function>ack</function></link>, and <link
+                xmlns:xlink="http://www.w3.org/1999/xlink"; 
linkend="end-instruction"
+                    ><function>end</function></link>). Code using the 
<function>nest</function>
+            instruction should instead write instructions directly without 
wrapping those
+            instructions within <function>nest</function>.</para>
+    </important>
     <para>Encodes part of one or more instructions within a single instruction,
         associating that packet of data with a stream index. Future nest
         instructions with the same stream index will append their data to the

Reply via email to