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

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

wpilibc/src/main/native/cpp/IterativeRobot.cpp

@@ -18,12 +18,6 @@ IterativeRobot::IterativeRobot() {
              HALUsageReporting::kFramework_Iterative);
 }
 
-/**
- * Provide an alternate "main loop" via StartCompetition().
- *
- * This specific StartCompetition() implements "main loop" behaviour synced with
- * the DS packets.
- */
 void IterativeRobot::StartCompetition() {
   RobotInit();