Index: /trunk/src/VBox/Main/include/ProgressCombinedImpl.h
===================================================================
--- /trunk/src/VBox/Main/include/ProgressCombinedImpl.h	(revision 29922)
+++ /trunk/src/VBox/Main/include/ProgressCombinedImpl.h	(revision 29923)
@@ -31,4 +31,9 @@
  * that follow each other in the same order as progress objects are passed to
  * the #init() method.
+ *
+ * @note CombinedProgress is legacy code and deprecated. It does not support
+ *       weighted operations, all suboperations are assumed to take the same
+ *       amount of time. For new code, please use IProgress directly which
+ *       has supported multiple weighted suboperations since VirtualBox 3.0.
  *
  * Individual progress objects are sequentially combined so that this progress