Moved C++ comments from source files to headers (#1111)

Also sorted functions in C++ sources to match order in related headers.

cameraserver/src/main/native/include/vision/VisionRunner.h

@@ -21,16 +21,47 @@ namespace frc {
  */
 class VisionRunnerBase {
  public:
+  /**
+   * Creates a new vision runner. It will take images from the {@code
+   * videoSource}, and call the virtual DoProcess() method.
+   *
+   * @param videoSource the video source to use to supply images for the
+   *                    pipeline
+   */
   explicit VisionRunnerBase(cs::VideoSource videoSource);
+
   ~VisionRunnerBase();
 
   VisionRunnerBase(const VisionRunnerBase&) = delete;
   VisionRunnerBase& operator=(const VisionRunnerBase&) = delete;
 
+  /**
+   * Runs the pipeline one time, giving it the next image from the video source
+   * specified in the constructor. This will block until the source either has
+   * an image or throws an error. If the source successfully supplied a frame,
+   * the pipeline's image input will be set, the pipeline will run, and the
+   * listener specified in the constructor will be called to notify it that the
+   * pipeline ran. This must be run in a dedicated thread, and cannot be used in
+   * the main robot thread because it will freeze the robot program.
+   *
+   * <p>This method is exposed to allow teams to add additional functionality or
+   * have their own ways to run the pipeline. Most teams, however, should just
+   * use {@link #runForever} in its own thread using a std::thread.</p>
+   */
   void RunOnce();
 
+  /**
+   * A convenience method that calls {@link #runOnce()} in an infinite loop.
+   * This must be run in a dedicated thread, and cannot be used in the main
+   * robot thread because it will freeze the robot program.
+   *
+   * <strong>Do not call this method directly from the main thread.</strong>
+   */
   void RunForever();
 
+  /**
+   * Stop a RunForever() loop.
+   */
   void Stop();
 
  protected: