#8273 Man page syntax issue detected by rpminspect
Closed: fixed by fcami. Opened by frenaud.

rpminspect detected the following syntax issues in the man pages:

        {
            "details": "Error parsing ipa-cacert-manage.1.gz:82:1: ERROR: skipping end of block that is not open: RE\nError parsing ipa-cacert-manage.1.gz:115:1: ERROR: skipping end of block that is not open: RE\nErrors found validating /usr/share/man/man1/ipa-cacert-manage.1.gz\n",
            "message": "Man page checker reported problems with /usr/share/man/man1/ipa-cacert-manage.1.gz on x86_64",
            "remedy": "Correct the errors in the man page as reported by the libmandoc parser.",
            "result": "VERIFY",
            "waiver authorization": "Anyone"
        },
        {
            "details": "Error parsing default.conf.5.gz:50:1: ERROR: skipping unknown macro: .DS L\nError parsing default.conf.5.gz:57:1: ERROR: skipping unknown macro: .DE\nErrors found validating /usr/share/man/man5/default.conf.5.gz\n",
            "message": "Man page checker reported problems with /usr/share/man/man5/default.conf.5.gz on noarch",
            "remedy": "Correct the errors in the man page as reported by the libmandoc parser.",
            "result": "VERIFY",
            "waiver authorization": "Anyone"
        }

To reproduce, install mandoc package and run:
mandoc -T lint -W error client/man/default.conf.5


Metadata Update from @frenaud:
- Issue assigned to frenaud

Metadata Update from @frenaud:
- Custom field on_review adjusted to https://github.com/freeipa/freeipa/pull/4539

I'm currently working on getting our man pages integrated in sphinx documentation. I found a whole lot of other problems, too.

master:

  • 7ac60a87bccb8f6e05d0eab33cab4139ddcd2d0a Man pages: fix syntax issues

ipa-4-8:

  • 98045dc4a3b3be21c9badf75ce1b62df27fa5be0 Man pages: fix syntax issues

ipa-4-6:

  • b8d9d3c762c81780ed83769eba98499382d44ea0 Man pages: fix syntax issues

Metadata Update from @fcami:
- Issue close_status updated to: fixed
- Issue status updated to: Closed (was: Open)

Metadata Update from @frenaud:
- Custom field rhbz adjusted to https://bugzilla.redhat.com/show_bug.cgi?id=1834385

Issue linked to Bugzilla: Bug 1834385

Metadata