On 12/19/24 12:06 PM, Marc Mutz via Development wrote:
1/ I today refused to perform a re-licensing of a .cpp file being renamed to .qdoc.¹ QUIP-18² has no provisions for files transitioning between what QUIP-18 calls file "classifications"³, even if they have different required license specifiers. Can someone please clarify the process here?
Inofficial stance, IANAL disclaimer applies: the file in question has a "Copyright (C) 2016 The Qt Company Ltd." note. The copyright and IP holder has decided to change the license from one liberal license to another. The practical effect this has on anyone is zero. But it makes the license checker happy, which sees ".qdoc file extension, this must be documentation".
Even without the sole TQtC copyright the CLA has been signed by all contributors and to my understanding enables us to change the license. There's no official process to my knowledge. But some official clarification might be in order here.
2/ In the same vein, it seems to me to be illogical to require to have a class-only .qdoc file have a different license from the equivalent .cpp file. These files may change from .cpp to .qdoc back back several times, depending on whether there is some C++ code in the file or not (doesn't have to be the implementation of a member function, could just be a static_assert() that we don't want to waste CPU cycles on by including it in the header). Should be make a distinction between "pure" .qdoc files and those that are essentially .cpp files that just lack (C++) content?
It seems logical to me to categorize .cpp files as source code and .qdoc as documentation. If the files *really* tend to oscillate between .cpp and .qdoc, let the license oscillate as well. Proposed process: match what has been agreed on in QUIP-18.
I'd refrain from adding heuristics to the license checker to determine whether a .qdoc file looks a bit too much like a C++ file.
3/ And, finally, shouldn't .cpp files that contain qdoc comment blocks contain the "right" license for documentation, as it's different from code? Then a rename would also not require a re-licensing.
Theoretically supercorrect would be a strict separation between "documentation" and "source code". Such an endeavor would be quite costly. I wonder, what problem are we trying to solve here?
Cheers, Joerg -- Jörg Bornemann | The Qt Company -- Development mailing list Development@qt-project.org https://lists.qt-project.org/listinfo/development