Updating documentation on 0.27-maintenance to respect ctest

[clanmills]

Initial changes to documentation to support CTest. I intend to integrate changes from main/README.md in this PR.

[codecov]

Codecov Report

Merging #2033 (5e2b777) into 0.27-maintenance (959f452) will decrease coverage by 0.02%.
The diff coverage is n/a.

@@                 Coverage Diff                  @@
##           0.27-maintenance    #2033      +/-   ##
====================================================
- Coverage             58.74%   58.72%   -0.03%     
====================================================
  Files                   146      146              
  Lines                 23004    23004              
  Branches              12596    12596              
====================================================
- Hits                  13513    13508       -5     
- Misses                 6689     6693       +4     
- Partials               2802     2803       +1     

Impacted Files	Coverage Δ
src/actions.cpp	62.09% <0.00%> (-0.32%)	⬇️
src/tiffvisitor_int.cpp	76.65% <0.00%> (-0.12%)	⬇️

---

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 959f452...5e2b777. Read the comment docs.

[clanmills]

@kmilos. I'm getting 100% test failure with the Visual Studio build. I have to provide -C Release to get ctest to run at all. I'll update README.md about that.

You mentioned something about 'git config'. Is that something I need to deal with? Any ideas what might be the matter?

I'm sure it's related to line-endings.

[kmilos]

No, that was very Cygwin specific.

I can take a look, but might be a while, the dad hat rarely comes off during the weekend...

[kmilos]

@clanmills The Windows CI seems to be ok? I see only codecov failing (no idea why)....

[clanmills]

Keep the Dad hat on. The CI is happy.

I installed cmake 3.22, pulled down fresh code and built. Looks good.

C:\Users\rmills\gnu\github\exiv2\0.27-maintenance\build>ctest -C Release
Test project C:/Users/rmills/gnu/github/exiv2/0.27-maintenance/build
    Start 1: bashTests
1/5 Test #1: bashTests ........................   Passed   46.33 sec
    Start 2: bugfixes
2/5 Test #2: bugfixes .........................   Passed  101.32 sec
    Start 3: tiffTests
3/5 Test #3: tiffTests ........................   Passed    0.45 sec
    Start 4: versionTest
4/5 Test #4: versionTest ......................   Passed    0.28 sec
    Start 5: unit_tests
5/5 Test #5: unit_tests .......................   Passed    0.07 sec

100% tests passed, 0 tests failed out of 5

Total Test time (real) = 481.96 sec

C:\Users\rmills\gnu\github\exiv2\0.27-maintenance\build>

Grampa is talking shit as always.

[clanmills]

Codecov is a "bloody old woman!". It's complaining because code coverage has gone down (by almost nothing). We'll ignore that.

I'm sure I'll add more polish/fixes to this PR over the weekend.

Pull request has been modified.

[clanmills]

This PR has been sitting in MSYS2 doing "setup" for 5 hours, so I cancelled it. Everything else passed and this PR cannot be involved in setting up the build machine.

I looked at the documentation concerning codecov. I think we can set threshold in codecov.yml to ignore negative code coverage. The codecov documentation needs more careful investigation to decide what should be done.

I'm going to merge.

[kmilos]

Yeah, I've seen GHA jobs get stuck before on occasion...