Re: Guidance on copyrights in sample code.

2017-07-03 Thread Justin Mclean
Hi, > That's actually why I asked James to pose the question on the general > list. I wasn't particularly sure if he found the right file, based on the > comments made by Justin and was hoping Justin could speak up to explain why > it is or isn't an issue I believe it wasn’t this example but tha

Re: Guidance on copyrights in sample code.

2017-07-03 Thread Craig Russell
> On Jul 3, 2017, at 5:08 PM, James Bognar wrote: > > Hrm...that sort of complicates the example. > > Here's the example code that creates an Atom feed DTO with a copyright... > File file = new File("fileName"); Charset charset = Charset.forName("utf-8"); // read the copyright notice from the

Re: Guidance on copyrights in sample code.

2017-07-03 Thread James Bognar
Hrm...that sort of complicates the example. Here's the example code that creates an Atom feed DTO with a copyright... Feed f = new Feed() ... .rights("Copyright (c) 2016, Apache Foundation") ... How about just "Copyright (c) ..."? On Mon, Jul 3, 2017 at 8:02 PM, Craig Russell wrote:

Re: Guidance on copyrights in sample code.

2017-07-03 Thread Craig Russell
Hi James, Instead of including "Copyright (c) 2001, Apache Foobar Foundation" in the sample code, would it be possible/easy to "assume the copyright notice is in a file and include the file contents here". That is probably how you would want to do it anyway, considering the task of updating c

Re: Guidance on copyrights in sample code.

2017-07-03 Thread James Bognar
> Also, why make the example strange? Why not take a real copyright header > for an example? A real copyright header can be mistaken for an actual copyright which gets flagged during releases. On Mon, Jul 3, 2017 at 7:52 PM, Ted Dunning wrote: > On Jul 3, 2017 3:43 PM, "John D. Ament" wrote:

Re: Guidance on copyrights in sample code.

2017-07-03 Thread Ted Dunning
On Jul 3, 2017 3:43 PM, "John D. Ament" wrote: On Mon, Jul 3, 2017 at 6:28 PM Ted Dunning wrote: > That's confusing. Here are some questions and thoughts. > ... > > wouldn't get flagged. I had posed on the list "1955 - 1971, Fake Atom Enterprises" which obviously would be an invalid copyrig

Re: Guidance on copyrights in sample code.

2017-07-03 Thread James Bognar
Yes...to clarify, it's not a real copyright. It's an example of a copyright. So the question is what copyright should I use so that it's not mistaken for a real copyright. On Mon, Jul 3, 2017 at 6:43 PM, John D. Ament wrote: > On Mon, Jul 3, 2017 at 6:28 PM Ted Dunning wrote: > > > That's co

Re: Guidance on copyrights in sample code.

2017-07-03 Thread John D. Ament
On Mon, Jul 3, 2017 at 6:28 PM Ted Dunning wrote: > That's confusing. Here are some questions and thoughts. > > A) 2001? > > B) the only Apache foundation is the Apache software foundation. What did > you mean by foobar? > > C) you don't need a copyright notice on code included in the documentati

Re: Guidance on copyrights in sample code.

2017-07-03 Thread Ted Dunning
That's confusing. Here are some questions and thoughts. A) 2001? B) the only Apache foundation is the Apache software foundation. What did you mean by foobar? C) you don't need a copyright notice on code included in the documentation. Save that for the copy of the sample code that you put into a

Guidance on copyrights in sample code.

2017-07-03 Thread James Bognar
Need some quick guidance. On the release vote for Juneau 6.3.0, Justin Mclean made this note... "There's a number of "Copyright (c) 2016, Apache Foundation” in the documentation you may want to update the year." I tracked it down to sample code where the copyright statement itself was sample code