Fix source code file license headers#303
Conversation
marmoure
left a comment
There was a problem hiding this comment.
LGTM thanks @adamretter for template.
8d596e0 to
f1c5f62
Compare
|
Thnx @adamretter for the PR. In the community notes we discussed the 'license bloat', from which we'd like to get rid of; We'll probably introduce a 'spdx statement' for each of all source files (instead). |
@dizzzz I am not sure what you mean by 'license bloat'. Can you explain please?
@dizzzz That would seem to be incompatible with LGPL 2.1. See: https://opensource.org/license/lgpl-2-1#:~:text=How%20to%20Apply%20These%20Terms%20to%20Your%20New%20Libraries |
|
'license bloat' is al about the extremely large headers in the code base, partly contributed by you. |
@dizzzz What do you consider to be extremely large? We were simply following the prescribed instructions for applying the relevant licensing in the code base.
Yes, it was a lot of work. I had to email and get consent from many past contributors. The PR was here - eXist-db/exist#3305. You yourself approved it, and @joewiz merged it.
As it should. As this PR improves the current situation significantly, and already has two approvals (the required amount), and there is no other alternative PR available right now, why not merge this? If someone wants to improve it later they are welcome to do so when they are ready of course. |
|
The spdx remark from my side was not specific targeted on monex. Large is for me all larger than a few lines e.g. the full LGPL header; A good example are the duplicate headers that have been added by you on a many places. There is a consensus that the headers of all source files are just too large whilst they have no added value, except adding lines of code; @reinhapa pointed out that many projects, e.g. the Linux kernel, changed the source code headers style in something much compacter and more comprehensible example: https://github.com/torvalds/linux/blob/master/block/badblocks.c in the community call we really liked this idea. |
@dizzzz Can you provide an example(s) please? |
|
I did tried to remember from the top of my head, but then realized I checked the wrong repo; it is in the exist-db files in the elemental repo :-) eg https://github.com/evolvedbinary/elemental/blob/main/extensions/webdav/src/main/java/org/exist/webdav/ExistResourceFactory.java |
@dizzzz So not a problem for you in Monex or eXist-db then :-) Can we get this merged now then please? |
…code file headers are correct, consistent, and follow eXist-db
…ders in the source code files
f1c5f62 to
8a89f81
Compare
@duncdrum Tests are passing.
I am wondering who is making the decision on that. I can see this PR already has 2 approvals from reviewers and no rejections. So it would seem that the reviewers want this. Why just not merge this, and then if someone wants to do the SPDX change in future they are free to send a PR to do that. |
line-o
left a comment
There was a problem hiding this comment.
The community decided to not follow this approach but use SPDX headers instead.
|
@reinhapa Thanks for replying, can you tell us which meeting that was? |
It was discussed in the 2025-06-23 - eXist Community Call |
|
@wolfgangmm At the Community Call last night, you said you saw no reason not to merge this one. As it now has +2 reviews and your approval. Could you merge it please? |
Previously the files had a jumble of varying license header definitions that were all LGPL 2.1. I have added the license-maven-plugin and configured it to be the same as eXist-db so that you have consistent LGPL 2.1 header definitions. I then applied the plugin over the source files, it added license headers where they were missing, and corrected the incorrect ones.
From now on the plugin will enforce that all source files have the correct license header at build time, if they don't the build will fail with details of which files need to be updated with the correct license header.
NOTE This should be merged before #298