This is the reason I will never ever write (parts of a) book, as producers force ugly style and code layout and even uglier font defaults.

Has it ever been easier to self-publish? Donald Knuth shared your sentiments but he did something about it. Now you too can publish your own works leveraging the fruits of Knuth's labours. Of course this means either writing the whole book yourself or else finding contributors who share your preferences. Either way, I look forward to your magnum opus.

But please tell me

• Does this statement cover code in tutorials/how to sections?
• which licence do you use to enforce your wishes?

I have no specific license for this (sadly). I also think that it would be hard to make legal.

Tutorials and how-to sections are documentation, and IMHO would fall under such a restriction.

Artistic license probably allows any reformatting. Anywhere.

I have never seen a license that enforces style and/or formatting. I also think that using such a licence would make many companies forbid the use of such code.

My wish is not to enforce my style on real-life code. My docs just should how *I* think it should be done most efficiently and most maintainable, but code and code style consistency in any project is way more important than the code (style) of a single sub/method/class.

However I would love to see the rest of the world to use my style, I know it is not going to happen. People think different.

My post was aimed at blogs, documentation, learning/teaching content that just copies from the documentation but then alters the style. However I understand that learning materials should also be consistent, I find this unacceptable.


Enjoy, Have FUN! H.Merijn

> Tutorials and how-to sections are documentation, and IMHO would fall under such a restriction.

Sorry I don't understand.

I've sold a lot of code already that contained (altered) snippets copied from POD. And I'm certainly not alone.

How can this have restricted rights?

Cheers Rolf
_{(addicted to the Perl Programming Language :)
Wikisyntax for the Monastery FootballPerl is like chess, only without the dice}

which licence do you use to enforce your wishes?

Copyright is what makes it illegal, not the license. As seen here, Copyright grants the exclusive right to prepare derivative works based upon the copyrighted work. Noone else is allowed to do with without first getting permission (in the form of a license).

Of course, open source licenses allows others to make modifications of the work, though they were often some conditions attached (inclusion of Copyright notice, inclusion of license, publication of the modified work until the same license, etc.