* This class solves the complexity of adding a webcam view,
* by using the cross-platform available OpenCV library.
*
- * Limitations, i.e. reasons to read this code and reimplement,
- * are: saving or streaming video is not really available (unless
- * you do repeated timer-triggered connections to the startSnap slot),
- * the widget size is identical to the video source dimensions (it
- * resizes the wodget using setMinimuSize to the video dimensions,
- * and does not handle resizing to sizes above this dimension.
+ * Limitations, i.e. reasons to read this code and reimplement, are:
+ *
+ * \li saving or streaming video is not really available (unless you do
+ * repeated timer-triggered connections to the startSnap slot).
+ * \li this is a crude and simple implementation, created to solve
+ * the problem of creating a "view-and-shoot" camera app.
+ * If your needs are more complex than that, read the code,
+ * and reimplement.
+ *
+ * Note that even tough the main file here totals some ~250 lines,
+ * only about 90 of those are actual code lines, and and even those
+ * contain a lot of "air"...
*
* A brief summary of how to use this class:
* \code