update Doxygen config and run auto doc update on F34

[lukaszstolarczuk]

A new config file format is updated automatically using Doxygen 1.9.1 (doxygen -u <file> command).
And additional extra changes to fix some docs issues.

Preview: https://lukaszstolarczuk.github.io/libpmemobj-cpp/master/doxygen/index.html

• merge Update dockers #1073 first
• drop 2 first commits
• check generated docs

---

This change is 

[codecov]

Codecov Report

Merging #1074 (e4b82b3) into master (2a0b54f) will decrease coverage by 0.28%.
The diff coverage is 0.00%.

@@            Coverage Diff             @@
##           master    #1074      +/-   ##
==========================================
- Coverage   94.07%   93.79%   -0.29%     
==========================================
  Files          49       49              
  Lines        4726     4670      -56     
==========================================
- Hits         4446     4380      -66     
- Misses        280      290      +10     

Flag	Coverage Δ
tests_clang_debug_cpp17	93.18% <0.00%> (-0.31%)	⬇️
tests_gcc_debug	91.47% <0.00%> (-0.35%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files	Coverage Δ
...j++/container/detail/concurrent_skip_list_impl.hpp	97.02% <ø> (+0.02%)	⬆️
include/libpmemobj++/detail/ctl.hpp	100.00% <ø> (ø)
include/libpmemobj++/detail/pair.hpp	100.00% <ø> (ø)
...nclude/libpmemobj++/detail/persistent_pool_ptr.hpp	100.00% <ø> (ø)
include/libpmemobj++/detail/tagged_ptr.hpp	100.00% <ø> (ø)
include/libpmemobj++/detail/temp_value.hpp	100.00% <ø> (ø)
...memobj++/experimental/atomic_self_relative_ptr.hpp	100.00% <ø> (ø)
...clude/libpmemobj++/experimental/concurrent_map.hpp	100.00% <ø> (ø)
...nclude/libpmemobj++/experimental/inline_string.hpp	98.57% <ø> (-0.06%)	⬇️
include/libpmemobj++/pexceptions.hpp	34.92% <0.00%> (-9.70%)	⬇️
... and 14 more

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 2a0b54f...e4b82b3. Read the comment docs.

[karczex]

Reviewable status: 0 of 1 files reviewed, 5 unresolved discussions (waiting on @lukaszstolarczuk)

---

doc/libpmemobj++.Doxyfile.in, line 154 at r1 (raw file):

# The default value is: NO.

INLINE_INHERITED_MEMB  = NO

We probably should enable it to properly display documentation for pool.

---

doc/libpmemobj++.Doxyfile.in, line 474 at r1 (raw file):

# Minimum value: 0, maximum value: 32, default value: 1.

NUM_PROC_THREADS       = 1

Did you test, how setting it to 0 fits into libpmemobj-cpp build system when building

make -j$(nproc)

?

---

doc/libpmemobj++.Doxyfile.in, line 552 at r1 (raw file):

# The default value is: NO.

HIDE_UNDOC_MEMBERS     = YES

Are you sure it should be enabled?

---

doc/libpmemobj++.Doxyfile.in, line 1119 at r1 (raw file):

# The default value is: NO.

CLANG_ASSISTED_PARSING = NO

Probably not for this PR, but it may be good idea to enable this option.

---

doc/libpmemobj++.Doxyfile.in, line 2316 at r1 (raw file):

# The default value is: NO.

HAVE_DOT               = NO

We should check what happened if we enable this, and some related options

[lukaszstolarczuk]

Reviewable status: 0 of 18 files reviewed, 3 unresolved discussions (waiting on @karczex)

---

doc/libpmemobj++.Doxyfile.in, line 154 at r1 (raw file):

Previously, karczex (Paweł Karczewski) wrote…

We probably should enable it to properly display documentation for pool.

Done.

---

doc/libpmemobj++.Doxyfile.in, line 474 at r1 (raw file):

Previously, karczex (Paweł Karczewski) wrote…

Did you test, how setting it to 0 fits into libpmemobj-cpp build system when building

make -j$(nproc)

?

I'm not sure if we can do anything to make "-j" speed our docs building, but:

• I've set the above variable to 0, so it should take all the available cores
• docs are built within 10 seconds, so it's not a biggie, I believe

---

doc/libpmemobj++.Doxyfile.in, line 552 at r1 (raw file):

Previously, karczex (Paweł Karczewski) wrote…

Are you sure it should be enabled?

Done.

---

doc/libpmemobj++.Doxyfile.in, line 1119 at r1 (raw file):

Previously, karczex (Paweł Karczewski) wrote…

Probably not for this PR, but it may be good idea to enable this option.

I've tried and:

• there were so many issues with this approach
• when I finally made it work, it wasn't worth it - I didn't see any improvements

---

doc/libpmemobj++.Doxyfile.in, line 2316 at r1 (raw file):

Previously, karczex (Paweł Karczewski) wrote…

We should check what happened if we enable this, and some related options

graphs look ok, enabled it

---

doc/libpmemobj++.Doxyfile.in, line 841 at r2 (raw file):

# XXX: temporarily disabled, until all members are documented
# or unneeded files are turned off (from doxygen)
#WARN_AS_ERROR          = @DOXYGEN_WARN_AS_ERROR@

temporarily disabled, until we skip all the docs we don't want to include or we add all the missing docs :)

---

doc/libpmemobj++.Doxyfile.in, line 1546 at r2 (raw file):

# This tag requires that the tag GENERATE_HTML is set to YES.

GENERATE_TREEVIEW      = YES

this is the new tree on the left-hand side of the docs - pls let me know if we want to keep it...

[KFilipek]

Reviewed 18 of 18 files at r2.
Reviewable status: all files reviewed, 3 unresolved discussions (waiting on @karczex)

[igchor]

, please just rebase to include changes in inline_string

Reviewable status: all files reviewed, 3 unresolved discussions (waiting on @karczex)

[lukaszstolarczuk]

continued in linked (above) PR