<div dir="auto"><div><br><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Fri, Nov 22, 2019, 7:15 AM Joel Sherrill <<a href="mailto:joel@rtems.org">joel@rtems.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div dir="ltr"><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Fri, Nov 22, 2019 at 8:10 AM Sebastian Huber <<a href="mailto:sebastian.huber@embedded-brains.de" target="_blank" rel="noreferrer">sebastian.huber@embedded-brains.de</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">On 22/11/2019 14:51, Joel Sherrill wrote:<br>
>     So, my proposal is to add two<br>
>     attributes to every specification item:<br>
> <br>
>     1.<br>
> <br>
>     license: 'SPDX-License-Identifier: BSD-2-Clause OR CC-BY-SA-4.0'<br>
> <br>
>     This allows the use of content from specification items as source code<br>
>     and documentation input.<br>
> <br>
>     2.<br>
> <br>
>     copyrights:<br>
>     - 'Copyright (C) 2019 John Doe'<br>
> <br>
> <br>
> I think I am OK with this as long as we only accept requirements with<br>
> a single license type. We just need to pick a license. If we go to <br>
> BSD-2-Clause,<br>
> then we don't have to give credit in generated documents.<br>
> <br>
> For CC-BY-SA, I believe any generated document would have to give<br>
> credit to every entity with a copyright listed.<br>
> <br>
> If everyone agrees that is the primary practical difference between the<br>
> two licenses, I would prefer we require all to be BSD-2-Clause.<br>
> <br>
> But I am happy with the license and copyright being attributes<br>
> that are generally treated as comments.<br>
<br>
I would like to generate the API documentation (e.g. the stuff in the <br>
"Directive" sections) in the RTEMS Classic API Guide from specification <br>
items. During this process documentation content will move from <br>
documentation *.rst files (CC-BY-SA license) to *.yml files in the RTEMS <br>
sources repository.  The content will flow back to the RTEMS <br>
documentation repository to *.rst files with the help of a generator <br>
program. The API header files with Doxygen markup can also be generated. <br>
This is why I would like to dual-license the *.yml files.<br></blockquote><div><br></div><div>Wouldn't the BSD-2-Clause then be sufficient to do all that?</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
This would be a re-licensing of parts of the documentation.<br>
<br>
If we solely use the BSD-2-Clause license, then we need a BSD-2-Clause <br>
copyright information in the documents.<br></blockquote><div><br></div><div>Your right. I must not be awake this morning. They are basically equivalent.</div><div></div></div></div></blockquote></div></div><div dir="auto"><br></div><div dir="auto">I think we had this discussion before. The stock bsd licenses aren't so clear on how they protect documentation. CC are better in such cases, so providing the dual license makes it easier to use code in either doco or compiled.</div><div dir="auto"><br></div><div dir="auto"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div class="gmail_quote"><div><br></div><div>--joel </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
-- <br>
Sebastian Huber, embedded brains GmbH<br>
<br>
Address : Dornierstr. 4, D-82178 Puchheim, Germany<br>
Phone   : +49 89 189 47 41-16<br>
Fax     : +49 89 189 47 41-09<br>
E-Mail  : <a href="mailto:sebastian.huber@embedded-brains.de" target="_blank" rel="noreferrer">sebastian.huber@embedded-brains.de</a><br>
PGP     : Public key available on request.<br>
<br>
Diese Nachricht ist keine geschäftliche Mitteilung im Sinne des EHUG.<br>
</blockquote></div></div>
_______________________________________________<br>
devel mailing list<br>
<a href="mailto:devel@rtems.org" target="_blank" rel="noreferrer">devel@rtems.org</a><br>
<a href="http://lists.rtems.org/mailman/listinfo/devel" rel="noreferrer noreferrer" target="_blank">http://lists.rtems.org/mailman/listinfo/devel</a></blockquote></div></div></div>