Fix PCL_DEPRECATED usage in doxygen for a proper Deprecation List in documentation

[aPonza]

Close #3825

So the error itself is because "." ends the period if JAVADOC_AUTOBRIEF= YES so the solution is either to set it to = NO or escape the dot like .\ (notice the trailing whitespace). In both cases the version number becomes "1 . 12" which is ugly and I think there is no solution to inserted whitespace since I found the unresolved doxygen/doxygen#6154 bug report.

from #3825 (comment)

I also added a sed invocation to deal with the whitespace, thanks Sergey.

[kunaltyagi]

This is 3 PRs:

• Change for the title (sed, doxygen, etc.)
• Using the macro instead of warning/doxygen
• Changes in pcl_visualizer.cpp

[aPonza]

The commits' names aren't sufficient to address the related-but-different scopes here? I'll split this up, sure.

I've had this for 3 iterations now, though (link):

Scanning dependencies of target test_organized_search
[ 45%] Building CXX object test/search/CMakeFiles/test_organized_search.dir/test_organized.cpp.o
/Users/runner/runners/2.165.2/work/1/s/visualization/src/pcl_visualizer.cpp:1936:1: error: 'deprecated' attribute cannot be applied to types
PCL_DEPRECATED(1, 12, "pcl::visualization::PCLVisualizer::updateCamera is deprecated, just re-rendering all scenes now.")
^
/Users/runner/runners/2.165.2/work/1/s/common/include/pcl/pcl_macros.h:122:17: note: expanded from macro 'PCL_DEPRECATED'
                PCL_DEPRECATED_MINOR(Minor,                             \
                ^
/Users/runner/runners/2.165.2/work/1/s/common/include/pcl/pcl_macros.h:108:17: note: expanded from macro 'PCL_DEPRECATED_MINOR'
                PCL_DEPRECATED_IMPL(Msg),           \
                ^
/Users/runner/runners/2.165.2/work/1/s/common/include/pcl/pcl_macros.h:89:42: note: expanded from macro 'PCL_DEPRECATED_IMPL'
  #define PCL_DEPRECATED_IMPL(message) [[deprecated(message)]]
                                         ^

Why doesn't it like the macro? I'll think about it in the morning.

[aPonza]

I stashed the changes in visualizer as they'll most likely come around again while clang-doxy-ing [visualization]