Doxygen features/Frameworks updates to not produce warnings and errors [DOC Changes Only]

[kegilbert]

NOTE The commit history is not cleaned up and pulls in a lot of duplicate changes from @sg-'s pull request linked below. Putting this review up to get eyes on the doxygen changes as the structure changed a decent amount for how I documented the overloaded functions. This also pulls in Jimmy's CI changes so I can get a CI run in.

Rebased to remove references to Makefile I accidentally added in my template branch.
Note to reviewers: In particular look at the following diff to see what files to review:
https://github.com/kegilbert/mbed-os/compare/kg-doxygen-template...kegilbert:kg-doxygen-framework2?expand=1

---

Documentation changes to Doxygen descriptions for the features/Frameworks module to allow Doxygen to build without errors/warnings.

Related PRs

#4425
#4434
#4435

Todos

• Tests/CI
• Review

[kegilbert]

The following errors are known and being resolved in the RTOS PR (pending).

/home/travis/build/ARMmbed/mbed-os/platform/FileSystemHandle.h:44: warning: argument 'path' of command @param is not found in the argument list of FileSystemHandle::open(FileHandle **file, const char *filename, int flags)=0
/home/travis/build/ARMmbed/mbed-os/platform/FileSystemHandle.h:44: warning: The following parameters of mbed::FileSystemHandle::open(FileHandle **file, const char *filename, int flags)=0 are not documented:
parameter 'filename'
/home/travis/build/ARMmbed/mbed-os/platform/FileSystemHandle.h:33: warning: Found unknown command \Note' /home/travis/build/ARMmbed/mbed-os/platform/FileSystemHandle.h:44: warning: argument 'path' of command @param is not found in the argument list of FileSystemHandle::open(FileHandle **file, const char *filename, int flags)=0 /home/travis/build/ARMmbed/mbed-os/platform/FileSystemHandle.h:44: warning: The following parameters of mbed::FileSystemHandle::open(FileHandle **file, const char *filename, int flags)=0 are not documented: parameter 'filename' /home/travis/build/ARMmbed/mbed-os/platform/FileSystemHandle.h:33: warning: Found unknown command \Note'
/home/travis/build/ARMmbed/mbed-os/platform/FileSystemHandle.h:44: warning: argument 'path' of command @param is not found in the argument list of FileSystemHandle::open(FileHandle **file, const char *filename, int flags)=0
/home/travis/build/ARMmbed/mbed-os/platform/FileSystemHandle.h:44: warning: The following parameters of mbed::FileSystemHandle::open(FileHandle **file, const char *filename, int flags)=0 are not documented:
parameter 'filename'
/home/travis/build/ARMmbed/mbed-os/platform/FileSystemHandle.h:44: warning: argument 'path' of command @param is not found in the argument list of FileSystemHandle::open(FileHandle **file, const char *filename, int flags)=0
/home/travis/build/ARMmbed/mbed-os/platform/FileSystemHandle.h:44: warning: The following parameters of mbed::FileSystemHandle::open(FileHandle **file, const char *filename, int flags)=0 are not documented:
parameter 'filename'

[theotherjimmy]

@kegilbert So it can't come in until that aforementioned, pending PR does.

[theotherjimmy]

The person who's github name is param must have a bad time with doxygen output.

[kegilbert]

Rebased against master following sg-'s merged doxygen-template branch (#4425) and squashed changes.

[sg-]

@kegilbert needs a rebase and should probably be consolidated into one PR at this point. The conflict will happen for each PR

[kegilbert]

Good point, I'll consolidate everything to make this easier.

[kegilbert]

Combined remaining doc PRs into one to avoid causing merge conflicts on each submission, follow this changeset to here: #4508