> -----Original Message----- > From: Christian Hammers [mailto:[email protected]] > Sent: Saturday, 10 October 2009 7:39 PM > To: Log4PHP Dev > Cc: [email protected] > Subject: Licence headers in examples/ > > Hi > > Oh, wait... Licence headers in the examples/ directory are kind of > problematic: > > First those files are meant to be included in both the > apidocs and the *.apt documentation. The latter relies on the SNIPPET > tags but the former looks pretty ugly if every 4-line example has a > 20 lines licence headers in the middle of the class documentation. > > Secondly the examples show what the users are supposed to write in > their applications. If we put a licence header on those examples we > do kind of claim a copyright on it, right? Not only that seems > questionable given the small size of the examples, wouldn't that > also mean that we also claim a copyright on the users application if > he just copy & paste the examples to his program? :)
Right, I think we are ok for these snippets, so I'll remove those 2 headers I put in and then configure RAT to ignore those files (currently it tells us we have 58 files without licenses). > > Also I found http://www.apache.org/legal/src-headers.html#headers: > > What files in an Apache release do not require a license > header? > > A file without any degree of creativity in either its literal > elements or its structure is not protected by copyright law; > therefore, such a file does not require a license header. If in > doubt about the extent of the file's creativity, add the license > header to the file. > > The same page also says that files which are meant to be displayed on > the web page (i.e. apidocs and documentation) do not need to carry > a licence header. > > What do you think? That's a fine line; it also depends on whether we distribute the docs and website with a release, or just simply provide instructions on how to build those locally. These are the sorts of things we can find out as we go ahead and do an incubating release - the incubator folks will provide us with plenty of feedback as to where we are going wrong (so our first release process will likely take a bit of time to get right.) Gav... > > bye, > > -christian- > > > Am Sat, 10 Oct 2009 08:18:01 -0000 > schrieb [email protected]: > > > Author: gmcdonald > > Date: Sat Oct 10 08:18:01 2009 > > New Revision: 823816 > > > > URL: http://svn.apache.org/viewvc?rev=823816&view=rev > > Log: > > Another license header addition to trigger site build > > > > Modified: > > incubator/log4php/trunk/src/examples/php/appender_console.php > > > > Modified: > > incubator/log4php/trunk/src/examples/php/appender_console.php URL: > > > http://svn.apache.org/viewvc/incubator/log4php/trunk/src/examples/php/appe > nder_console.php?rev=823816&r1=823815&r2=823816&view=diff > > > ========================================================================== > ==== > > --- incubator/log4php/trunk/src/examples/php/appender_console.php > > (original) +++ > > incubator/log4php/trunk/src/examples/php/appender_console.php Sat Oct > > 10 08:18:01 2009 @@ -1,4 +1,21 @@ <?php +/** > > + * Licensed to the Apache Software Foundation (ASF) under one or more > > + * contributor license agreements. See the NOTICE file distributed > > with > > + * this work for additional information regarding copyright > > ownership. > > + * The ASF licenses this file to You under the Apache License, > > Version 2.0 > > + * (the "License"); you may not use this file except in compliance > > with > > + * the License. You may obtain a copy of the License at > > + * > > + * http://www.apache.org/licenses/LICENSE-2.0 > > + * > > + * Unless required by applicable law or agreed to in writing, > > software > > + * distributed under the License is distributed on an "AS IS" BASIS, > > + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or > > implied. > > + * See the License for the specific language governing permissions > > and > > + * limitations under the License. > > + */ > > + > > // START SNIPPET: doxia > > require_once dirname(__FILE__).'/../../main/php/Logger.php'; > > > Logger::configure(dirname(__FILE__).'/../resources/appender_console.proper > ties'); > > > > > No virus found in this incoming message. > Checked by AVG - www.avg.com > Version: 8.5.421 / Virus Database: 270.14.8/2423 - Release Date: 10/09/09 > 18:43:00
