SITL: Document Airspeed Params

[antholuo]

Unsure how to document ARSPD2 Params

[IamPete1]

The prefix is in the wrong spot, This should just be FAILP. The one level up where these are included you add the prefix. Like gripper for example.

ardupilot/libraries/SITL/SITL.cpp

Lines 217 to 219 in 9b06395

	// @Group: GRPE_
	// @Path: ./SIM_Gripper_EPM.cpp
	AP_SUBGROUPINFO(gripper_epm_sim, "GRPE_", 24, SIM, Gripper_EPM),

Then the documentation should work for both airspeed 1 and 2.

[peterbarker]

Suggested change

	// @Group: ARPSD_
	// @Group: ARSPD_

[peterbarker]

OK, so the parser isn't coping with the setup for these parameters, and I don't think it will be easy to make it do so.

It believes that anything that looks like a parameter or group in this file is at the same level. So here we get SIM_PITOT, SIM_FAILP etc etc. The ARSPD group parameter declaration comment is missing @Path, and we can't specify "this file" in there as that's infinite recursion. It's the @path and recursion thing which would tack on ARSPD_ to the parameter name base to get SIM_ARSPD_FAILP.

Easiest fix is to move the definition of const AP_Param::GroupInfo SIM::AirspeedParm::var_info[] = { into a SITL_airspeed.cpp into AP_HAL_SITL/sitl_airspeed.cpp - and I don't think that's a terrible thing. Then just add @Path to point to that file.

[peterbarker]

Merged, thanks!