Fix man page heading formatting

[saschagrunert]

What type of PR is this?

• bug
• cleanup
• documentation
• feature

What this PR does / why we need it:

Fixing the man page header to display the section correctly

Which issue(s) this PR fixes:

Fixes #1040

Special notes for your reviewer:

None

Testing

Adapted the unit test results

Release Notes

- Fixed invalid man page header generation
- Removed the author from generated man pages

[zhsj]

Is the author section rendered as expected? The first author is title, and the email and other are body.

[saschagrunert]

Is the author section rendered as expected? The first author is title, and the email and other are body.

That's a good question, I think we should put the author to the bottom of the man page, right?

[asahasrabuddhe]

Is the author section rendered as expected? The first author is title, and the email and other are body.

That's a good question, I think we should put the author to the bottom of the man page, right?

I think you should check this out https://linux.die.net/man/7/man-pages

Although this page discourages adding an Authors section, it is worth noting that the position of the Authors section is second to last.

[coilysiren]

There are some quirks of man page formatting that I haven't taken to the time look into, but this PR LGTM

[saschagrunert]

Okay, I removed the author completely I think that might be something we can agree on.

[codecov]

Codecov Report

Merging #1041 into master will not change coverage.
The diff coverage is n/a.

@@          Coverage Diff           @@
##           master   #1041   +/-   ##
======================================
  Coverage    72.6%   72.6%           
======================================
  Files          33      33           
  Lines        2482    2482           
======================================
  Hits         1802    1802           
  Misses        569     569           
  Partials      111     111

---

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 ee9b3fc...5b3508d. Read the comment docs.

[asahasrabuddhe]

LGTM 👍