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? :) 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? 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/appender_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.properties'); > >
