Re: Cosmetic JFFS patch.

From: Linus Torvalds (torvalds@transmeta.com)
Date: Thu Jun 28 2001 - 12:55:23 EST


On Thu, 28 Jun 2001 chuckw@altaserv.net wrote:
>
> Taking that one step further, isn't it a developer's right to "toot their
> own horn" in their code?

You can do whatever you want in your own code.

But if it makes the code behave badly, others have the right to change it.
That's what the GPL is all about (you have the right to change it even if
it _doesn't_ "behave badly", of course ;)

You mustn't remove copyright messages, but you can certainly move them (as
long as they are prominently displayed in the source - see §1 in the GPL
about "conspicuously and appropriately publish"). But that certainly
doesn't preclude moving it into a comment, for example. So that it doesn't
end up disturbing users who have nothing to do with it.

(Note: the "conspicuously and appropriately publish" thing is obviously a
matter of taste, especially the "appropriately". So it would easily be
considered non-appropriate to move _one_ copyright holder into a comment,
while printing out the names of the others. But if you make it a policy to
do it across the board, that's clearly "appripriately publishing").

The GPL requires that you "keep intact all the notices that refer to this
License and to the absence of any warranty" in the verbatim copy of the
programs source code. It doesn't require that you print it out on use (it
has that silly "interactive program that is already verbose about the
copyright" thing in 2c, but happily that doesn't cover the kernel anyway).

There's another side to "drumming your own drum": it is often seen as
actively offensive to some people who don't want to do the same thing.

Copyright messages often disturb developers even when they are only in the
code. Which is why they should be at the top, and ONLY at the top. That's
where they are most visible for people who search for them (remember: the
copyright message is not primarily for tooting your own horn, it's
primarily there to inform people who _wonder_ about whom to contact about
the copyright status of the file).

And that's also where they aren't in the way for development, and for
making changes (what should you do if you change some piece of code, and
the comment above it has somebody elses copyright in it - while you've now
change the code to make the comment meaningless?)

And note that this is not actually a hypothetical example. There have been
real-world cases where major developers have complained about other
developers copyright notices being disturbingly "in the way".

So there's "drumming your own drum", but there's also "being a loudmouth".

                Linus

-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/



This archive was generated by hypermail 2b29 : Sat Jun 30 2001 - 21:00:19 EST