Changeset 82494 in vbox for trunk/include

Timestamp:

Dec 7, 2019 12:01:19 PM (5 years ago)

Author:

vboxsync

Message:

VBox/HostServices/VBoxClipboardSvc.h: Moved the protocol change log up to the @file section as doxygen would attach it to the next thing following it, like the VBOX_SHCL_MODE_XXX section. Also edited it as it sounded like a sales pitch for the new protocol and a bashing of the previous stuff, which isn't very helpful nor much of a changelog/history. What's there now is incomplete, but at least it says so. bugref:9437

File:

• trunk/include/VBox/HostServices/VBoxClipboardSvc.h (modified) (2 diffs)

trunk/include/VBox/HostServices/VBoxClipboardSvc.h

@@ -1 +1 @@
 /** @file
  * Shared Clipboard - Common header for host service and guest clients.
+ *
+ * Protocol history notes (incomplete):
+ *
+ *  - VirtualBox 6.1.0 betas:  Started work on adding support for copying &
+ *    pasting files and directories, refactoring the protocol in the process.
+ *      - Adds guest/host feature flags.
+ *      - Adds context IDs (via guest feature flags).
+ *      - Borrowed the message handling from guest controls.
+ *      - Adds a multitude of functions and messages for dealing with file & dir
+ *        copying, most inte
+ *
+ *  - VirtualBox x.x.x: Missing a lot of gradual improvements here.
+ *
+ *  - VirtualBox 1.3.2 (r17182): Initial implementation, supporting text.
  */
 
@@ -22 +36 @@
  * You may elect to license modified versions of this file under the
  * terms and conditions of either the GPL or the CDDL or both.
- */
-
-/**
- * Protocol handling and notes:
- *     All client/server components should be backwards compatible.
- *
- ******************************************************************************
- *
- * Protocol changelog:
- *
- *     VBox < 6.1, deprecated:
- *         | First, initial implementation since feature was developed.
- *           Has no protocol handshake or support for feature exchange,
- *           the client's waiting message also acted as retrieving the
- *           parameters from the host (always and only *exactly* two
- *           parameters). Does not have the ability to control / handle parallel
- *           transfers.
- *
- *     VBox >= 6.1:
- *         + Adds host/guest feature flags and context IDs for parallel,
- *           asynchronous transfers.
- *         | Keeps backwards-compatbility with by translating messages to
- *           the older protocol (< 6.1), to not break compatibility with older
- *           Guest Additions.
  */