Minor documentation corrections.
authorDean Camera <dean@fourwalledcubicle.com>
Mon, 27 Aug 2012 16:55:52 +0000 (16:55 +0000)
committerDean Camera <dean@fourwalledcubicle.com>
Mon, 27 Aug 2012 16:55:52 +0000 (16:55 +0000)
LUFA/Drivers/USB/Core/AVR8/EndpointStream_AVR8.h
LUFA/Drivers/USB/Core/UC3/EndpointStream_UC3.h
LUFA/Drivers/USB/Core/XMEGA/EndpointStream_XMEGA.h

index eb1f928..9cd8d58 100644 (file)
                         *  in both failure and success states; the user is responsible for manually clearing the status OUT packet
                         *  to finalize the transfer's status stage via the \ref Endpoint_ClearOUT() macro.
                         *
-                        *  \note This function automatically clears the control transfer's status stage. Do not manually attempt
-                        *        to clear the status stage when using this routine in a control transaction.
+                        *  \note This function automatically sends the last packet in the data stage of the transaction; when the
+                        *        function returns, the user is responsible for clearing the <b>status</b> stage of the transaction.
+                        *        Note that the status stage packet is sent or received in the opposite direction of the data flow.
                         *        \n\n
                         *
                         *  \note This routine should only be used on CONTROL type endpoints.
                         *  in both failure and success states; the user is responsible for manually clearing the status OUT packet
                         *  to finalize the transfer's status stage via the \ref Endpoint_ClearOUT() macro.
                         *
-                        *  \note This function automatically clears the control transfer's status stage. Do not manually attempt
-                        *        to clear the status stage when using this routine in a control transaction.
+                        *  \note This function automatically sends the last packet in the data stage of the transaction; when the
+                        *        function returns, the user is responsible for clearing the <b>status</b> stage of the transaction.
+                        *        Note that the status stage packet is sent or received in the opposite direction of the data flow.
                         *        \n\n
                         *
                         *  \note This routine should only be used on CONTROL type endpoints.
                         *  automatically sent after success or failure states; the user is responsible for manually sending the
                         *  status IN packet to finalize the transfer's status stage via the \ref Endpoint_ClearIN() macro.
                         *
-                        *  \note This function automatically clears the control transfer's status stage. Do not manually attempt
-                        *        to clear the status stage when using this routine in a control transaction.
+                        *  \note This function automatically sends the last packet in the data stage of the transaction; when the
+                        *        function returns, the user is responsible for clearing the <b>status</b> stage of the transaction.
+                        *        Note that the status stage packet is sent or received in the opposite direction of the data flow.
                         *        \n\n
                         *
                         *  \note This routine should only be used on CONTROL type endpoints.
                         *  automatically sent after success or failure states; the user is responsible for manually sending the
                         *  status IN packet to finalize the transfer's status stage via the \ref Endpoint_ClearIN() macro.
                         *
-                        *  \note This function automatically clears the control transfer's status stage. Do not manually attempt
-                        *        to clear the status stage when using this routine in a control transaction.
+                        *  \note This function automatically sends the last packet in the data stage of the transaction; when the
+                        *        function returns, the user is responsible for clearing the <b>status</b> stage of the transaction.
+                        *        Note that the status stage packet is sent or received in the opposite direction of the data flow.
                         *        \n\n
                         *
                         *  \note This routine should only be used on CONTROL type endpoints.
 
                        /** EEPROM buffer source version of Endpoint_Write_Control_Stream_LE.
                         *
-                        *  \note This function automatically clears the control transfer's status stage. Do not manually attempt
-                        *        to clear the status stage when using this routine in a control transaction.
+                        *  \note This function automatically sends the last packet in the data stage of the transaction; when the
+                        *        function returns, the user is responsible for clearing the <b>status</b> stage of the transaction.
+                        *        Note that the status stage packet is sent or received in the opposite direction of the data flow.
                         *        \n\n
                         *
                         *  \note This routine should only be used on CONTROL type endpoints.
 
                        /** EEPROM buffer source version of \ref Endpoint_Write_Control_Stream_BE().
                         *
-                        *  \note This function automatically clears the control transfer's status stage. Do not manually attempt
-                        *        to clear the status stage when using this routine in a control transaction.
+                        *  \note This function automatically sends the last packet in the data stage of the transaction; when the
+                        *        function returns, the user is responsible for clearing the <b>status</b> stage of the transaction.
+                        *        Note that the status stage packet is sent or received in the opposite direction of the data flow.
                         *        \n\n
                         *
                         *  \note This routine should only be used on CONTROL type endpoints.
 
                        /** EEPROM buffer source version of \ref Endpoint_Read_Control_Stream_LE().
                         *
-                        *  \note This function automatically clears the control transfer's status stage. Do not manually attempt
-                        *        to clear the status stage when using this routine in a control transaction.
+                        *  \note This function automatically sends the last packet in the data stage of the transaction; when the
+                        *        function returns, the user is responsible for clearing the <b>status</b> stage of the transaction.
+                        *        Note that the status stage packet is sent or received in the opposite direction of the data flow.
                         *        \n\n
                         *
                         *  \note This routine should only be used on CONTROL type endpoints.
 
                        /** EEPROM buffer source version of \ref Endpoint_Read_Control_Stream_BE().
                         *
-                        *  \note This function automatically clears the control transfer's status stage. Do not manually attempt
-                        *        to clear the status stage when using this routine in a control transaction.
+                        *  \note This function automatically sends the last packet in the data stage of the transaction; when the
+                        *        function returns, the user is responsible for clearing the <b>status</b> stage of the transaction.
+                        *        Note that the status stage packet is sent or received in the opposite direction of the data flow.
                         *        \n\n
                         *
                         *  \note This routine should only be used on CONTROL type endpoints.
                         *
                         *  \pre The FLASH data must be located in the first 64KB of FLASH for this function to work correctly.
                         *
-                        *  \note This function automatically clears the control transfer's status stage. Do not manually attempt
-                        *        to clear the status stage when using this routine in a control transaction.
+                        *  \note This function automatically sends the last packet in the data stage of the transaction; when the
+                        *        function returns, the user is responsible for clearing the <b>status</b> stage of the transaction.
+                        *        Note that the status stage packet is sent or received in the opposite direction of the data flow.
                         *        \n\n
                         *
                         *  \note This routine should only be used on CONTROL type endpoints.
                         *
                         *  \pre The FLASH data must be located in the first 64KB of FLASH for this function to work correctly.
                         *
-                        *  \note This function automatically clears the control transfer's status stage. Do not manually attempt
-                        *        to clear the status stage when using this routine in a control transaction.
+                        *  \note This function automatically sends the last packet in the data stage of the transaction; when the
+                        *        function returns, the user is responsible for clearing the <b>status</b> stage of the transaction.
+                        *        Note that the status stage packet is sent or received in the opposite direction of the data flow.
                         *        \n\n
                         *
                         *  \note This routine should only be used on CONTROL type endpoints.
index 551cf4b..9a0d06b 100644 (file)
                         *  in both failure and success states; the user is responsible for manually clearing the status OUT packet
                         *  to finalize the transfer's status stage via the \ref Endpoint_ClearOUT() macro.
                         *
-                        *  \note This function automatically clears the control transfer's status stage. Do not manually attempt
-                        *        to clear the status stage when using this routine in a control transaction.
+                        *  \note This function automatically sends the last packet in the data stage of the transaction; when the
+                        *        function returns, the user is responsible for clearing the <b>status</b> stage of the transaction.
+                        *        Note that the status stage packet is sent or received in the opposite direction of the data flow.
                         *        \n\n
                         *
                         *  \note This routine should only be used on CONTROL type endpoints.
                         *  in both failure and success states; the user is responsible for manually clearing the status OUT packet
                         *  to finalize the transfer's status stage via the \ref Endpoint_ClearOUT() macro.
                         *
-                        *  \note This function automatically clears the control transfer's status stage. Do not manually attempt
-                        *        to clear the status stage when using this routine in a control transaction.
+                        *  \note This function automatically sends the last packet in the data stage of the transaction; when the
+                        *        function returns, the user is responsible for clearing the <b>status</b> stage of the transaction.
+                        *        Note that the status stage packet is sent or received in the opposite direction of the data flow.
                         *        \n\n
                         *
                         *  \note This routine should only be used on CONTROL type endpoints.
                         *  automatically sent after success or failure states; the user is responsible for manually sending the
                         *  status IN packet to finalize the transfer's status stage via the \ref Endpoint_ClearIN() macro.
                         *
-                        *  \note This function automatically clears the control transfer's status stage. Do not manually attempt
-                        *        to clear the status stage when using this routine in a control transaction.
+                        *  \note This function automatically sends the last packet in the data stage of the transaction; when the
+                        *        function returns, the user is responsible for clearing the <b>status</b> stage of the transaction.
+                        *        Note that the status stage packet is sent or received in the opposite direction of the data flow.
                         *        \n\n
                         *
                         *  \note This routine should only be used on CONTROL type endpoints.
                         *  automatically sent after success or failure states; the user is responsible for manually sending the
                         *  status IN packet to finalize the transfer's status stage via the \ref Endpoint_ClearIN() macro.
                         *
-                        *  \note This function automatically clears the control transfer's status stage. Do not manually attempt
-                        *        to clear the status stage when using this routine in a control transaction.
+                        *  \note This function automatically sends the last packet in the data stage of the transaction; when the
+                        *        function returns, the user is responsible for clearing the <b>status</b> stage of the transaction.
+                        *        Note that the status stage packet is sent or received in the opposite direction of the data flow.
                         *        \n\n
                         *
                         *  \note This routine should only be used on CONTROL type endpoints.
index f2fe289..211f335 100644 (file)
                         *  in both failure and success states; the user is responsible for manually clearing the status OUT packet
                         *  to finalize the transfer's status stage via the \ref Endpoint_ClearOUT() macro.
                         *
-                        *  \note This function automatically clears the control transfer's status stage. Do not manually attempt
-                        *        to clear the status stage when using this routine in a control transaction.
+                        *  \note This function automatically sends the last packet in the data stage of the transaction; when the
+                        *        function returns, the user is responsible for clearing the <b>status</b> stage of the transaction.
+                        *        Note that the status stage packet is sent or received in the opposite direction of the data flow.
                         *        \n\n
                         *
                         *  \note This routine should only be used on CONTROL type endpoints.
                         *  in both failure and success states; the user is responsible for manually clearing the status OUT packet
                         *  to finalize the transfer's status stage via the \ref Endpoint_ClearOUT() macro.
                         *
-                        *  \note This function automatically clears the control transfer's status stage. Do not manually attempt
-                        *        to clear the status stage when using this routine in a control transaction.
+                        *  \note This function automatically sends the last packet in the data stage of the transaction; when the
+                        *        function returns, the user is responsible for clearing the <b>status</b> stage of the transaction.
+                        *        Note that the status stage packet is sent or received in the opposite direction of the data flow.
                         *        \n\n
                         *
                         *  \note This routine should only be used on CONTROL type endpoints.
                         *  automatically sent after success or failure states; the user is responsible for manually sending the
                         *  status IN packet to finalize the transfer's status stage via the \ref Endpoint_ClearIN() macro.
                         *
-                        *  \note This function automatically clears the control transfer's status stage. Do not manually attempt
-                        *        to clear the status stage when using this routine in a control transaction.
+                        *  \note This function automatically sends the last packet in the data stage of the transaction; when the
+                        *        function returns, the user is responsible for clearing the <b>status</b> stage of the transaction.
+                        *        Note that the status stage packet is sent or received in the opposite direction of the data flow.
                         *        \n\n
                         *
                         *  \note This routine should only be used on CONTROL type endpoints.
                         *  automatically sent after success or failure states; the user is responsible for manually sending the
                         *  status IN packet to finalize the transfer's status stage via the \ref Endpoint_ClearIN() macro.
                         *
-                        *  \note This function automatically clears the control transfer's status stage. Do not manually attempt
-                        *        to clear the status stage when using this routine in a control transaction.
+                        *  \note This function automatically sends the last packet in the data stage of the transaction; when the
+                        *        function returns, the user is responsible for clearing the <b>status</b> stage of the transaction.
+                        *        Note that the status stage packet is sent or received in the opposite direction of the data flow.
                         *        \n\n
                         *
                         *  \note This routine should only be used on CONTROL type endpoints.
 
                        /** EEPROM buffer source version of Endpoint_Write_Control_Stream_LE.
                         *
-                        *  \note This function automatically clears the control transfer's status stage. Do not manually attempt
-                        *        to clear the status stage when using this routine in a control transaction.
+                        *  \note This function automatically sends the last packet in the data stage of the transaction; when the
+                        *        function returns, the user is responsible for clearing the <b>status</b> stage of the transaction.
+                        *        Note that the status stage packet is sent or received in the opposite direction of the data flow.
                         *        \n\n
                         *
                         *  \note This routine should only be used on CONTROL type endpoints.
 
                        /** EEPROM buffer source version of \ref Endpoint_Write_Control_Stream_BE().
                         *
-                        *  \note This function automatically clears the control transfer's status stage. Do not manually attempt
-                        *        to clear the status stage when using this routine in a control transaction.
+                        *  \note This function automatically sends the last packet in the data stage of the transaction; when the
+                        *        function returns, the user is responsible for clearing the <b>status</b> stage of the transaction.
+                        *        Note that the status stage packet is sent or received in the opposite direction of the data flow.
                         *        \n\n
                         *
                         *  \note This routine should only be used on CONTROL type endpoints.
 
                        /** EEPROM buffer source version of \ref Endpoint_Read_Control_Stream_LE().
                         *
-                        *  \note This function automatically clears the control transfer's status stage. Do not manually attempt
-                        *        to clear the status stage when using this routine in a control transaction.
+                        *  \note This function automatically sends the last packet in the data stage of the transaction; when the
+                        *        function returns, the user is responsible for clearing the <b>status</b> stage of the transaction.
+                        *        Note that the status stage packet is sent or received in the opposite direction of the data flow.
                         *        \n\n
                         *
                         *  \note This routine should only be used on CONTROL type endpoints.
 
                        /** EEPROM buffer source version of \ref Endpoint_Read_Control_Stream_BE().
                         *
-                        *  \note This function automatically clears the control transfer's status stage. Do not manually attempt
-                        *        to clear the status stage when using this routine in a control transaction.
+                        *  \note This function automatically sends the last packet in the data stage of the transaction; when the
+                        *        function returns, the user is responsible for clearing the <b>status</b> stage of the transaction.
+                        *        Note that the status stage packet is sent or received in the opposite direction of the data flow.
                         *        \n\n
                         *
                         *  \note This routine should only be used on CONTROL type endpoints.
                         *
                         *  \pre The FLASH data must be located in the first 64KB of FLASH for this function to work correctly.
                         *
-                        *  \note This function automatically clears the control transfer's status stage. Do not manually attempt
-                        *        to clear the status stage when using this routine in a control transaction.
+                        *  \note This function automatically sends the last packet in the data stage of the transaction; when the
+                        *        function returns, the user is responsible for clearing the <b>status</b> stage of the transaction.
+                        *        Note that the status stage packet is sent or received in the opposite direction of the data flow.
                         *        \n\n
                         *
                         *  \note This routine should only be used on CONTROL type endpoints.
                         *
                         *  \pre The FLASH data must be located in the first 64KB of FLASH for this function to work correctly.
                         *
-                        *  \note This function automatically clears the control transfer's status stage. Do not manually attempt
-                        *        to clear the status stage when using this routine in a control transaction.
+                        *  \note This function automatically sends the last packet in the data stage of the transaction; when the
+                        *        function returns, the user is responsible for clearing the <b>status</b> stage of the transaction.
+                        *        Note that the status stage packet is sent or received in the opposite direction of the data flow.
                         *        \n\n
                         *
                         *  \note This routine should only be used on CONTROL type endpoints.