groff(1) comment syntax is not supported

[alejandro-colomar]

As reported in spdx/license-list-XML#1319, the comment syntax of groff, and therefore that of the man-pages, isn't supported.

The implementation is here:

Spdx-Java-Library/src/main/java/org/spdx/utility/compare/LicenseCompareHelper.java

Line 138 in e47801c

static final String START_COMMENT_CHAR_PATTERN = "(//|/\\*|\\*|#|' |REM |<!--|--|;|\\(\\*|\\{-)";

groff comments basically start with .\". If I have some time, I'll try and fix it, but in the meantime I'll report it :)

[goneall]

@alejandro-colomar Can you point me to a a typical document with a license I can use for a test case? I'm working on a new release of the library and may be able to get a fix in before the release.

[alejandro-colomar]

Yes, I'll look it up tomorrow. Thanks!

[alejandro-colomar]

membarrier.2 seems to be using that license.

You can check it in your system: At least on Debian, you can zcat /usr/share/man/man2/membarrier.2.gz

If you need to download it, you could either clone the man-pages repo and find ./man2/membarrier.2, or you can download just that page from the kernel git website: https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/plain/man2/membarrier.2

[goneall]

Thanks @alejandro-colomar - I copied the license text and used it for the unit test.

[goneall]

Resolved with PR #64