Doxygen warnings

[abitmore]

User Story

There are quite some warnings when generating documentation via the doxygen tool.

Details: #2213 (comment).

Impacts
Describe which portion(s) of BitShares Core may be impacted by your request. Please tick at least one box.

• API (the application programming interface)
• Build (the build process or something prior to compiled code)
• CLI (the command line wallet)
• Deployment (the deployment process after building such as Docker, Travis, etc.)
• DEX (the Decentralized EXchange, market engine, etc.)
• P2P (the peer-to-peer network for transaction/block propagation)
• Performance (system or user efficiency, etc.)
• Protocol (the blockchain logic, consensus, validation, etc.)
• Security (the security of system or user data, etc.)
• UX (the User Experience)
• Other: documentation

CORE TEAM TASK LIST

• Evaluate / Prioritize Feature Request
• Refine User Stories / Requirements
• Define Test Cases
• Design / Develop Solution
• Perform QA/Testing
• Update Documentation

[abitmore]

Item(s) unable to fix so far:

• warning: documented symbol `graphene::chain::decltype' was not declared or defined on several files
  • see https://sourceforge.net/p/doxygen/mailman/message/36304025/ - Doxygen doesn’t support decltype() yet
• warning: no uniquely matching class member found for (some methods in some template classes), E.G.

libraries/fc/include/fc/fwd_impl.hpp:128: warning: no uniquely matching class member found for
  template < T, S, A >
  T & fc::fwd< T, S, A >::operator=(fc::fwd< T, S, A > &&u)
Possible candidates:
  'template < U >
  T & fc::fwd< T, S, Align >::operator=(U &&u)' at line 31 of file /home/ubuntu/bitshares-core-dev/libraries/fc/include/fc/fwd.hpp
  T & fc::fwd< T, S, Align >::operator=(fwd &&u)' at line 33 of file /home/ubuntu/bitshares-core-dev/libraries/fc/include/fc/fwd.hpp
  T & fc::fwd< T, S, Align >::operator=(const fwd &u)' at line 34 of file /home/ubuntu/bitshares-core-dev/libraries/fc/include/fc/fwd.hpp

• libraries/fc/include/fc/thread/parallel.hpp:91: warning: argument 'desc' of command @param is not found in the argument list of fc::do_parallel(Functor &&f, const char *desc FC_TASK_NAME_DEFAULT_ARG) ->-> fc::future< decltype(f())> (and some other files), and parameter 'FC_TASK_NAME_DEFAULT_ARG' is "not documented"
  • Doxygen thinks FC_TASK_NAME_DEFAULT_ARG is the argument
• README.md:6: warning: Unexpected html tag <img> found within <a href=...> context
  • The section will be removed from the generated HTML file anyway

[abitmore]

Mostly fixed by #2324. Moving the issue to the next milestone.