You are viewing a plain text version of this content. The canonical link for it is here.
Posted to log4php-dev@logging.apache.org by Christian Hammers <ch...@lathspell.de> on 2009/10/10 11:39:04 UTC
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? :)
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 gmcdonald@apache.org:
> 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');
>
>
RE: Licence headers in examples/
Posted by Gavin <ga...@16degrees.com.au>.
> -----Original Message-----
> From: Christian Hammers [mailto:ch@lathspell.de]
> Sent: Saturday, 10 October 2009 7:39 PM
> To: Log4PHP Dev
> Cc: gmcdonald@apache.org
> 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 gmcdonald@apache.org:
>
> > 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