[PATCH 3/3] Simplify SPDX-License-Identifier comment

Sebastian Huber sebastian.huber at embedded-brains.de
Thu Jan 10 07:01:51 UTC 2019


On 10/01/2019 00:49, Chris Johns wrote:
> On 10/1/19 2:14 am, Sebastian Huber wrote:
>> -.. comment SPDX-License-Identifier: CC-BY-SA-4.0
>> +.. SPDX-License-Identifier: CC-BY-SA-4.0
> Hmm, I must be missing something here with the handling of directives.
>
> What does sphinx-build show if you can -v to the build via the waf configure
> options?

http://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#comments

"Every explicit markup block which isn’t a valid markup construct (like 
the footnotes above) is regarded as a comment"

The main reason to cut the "comment" is the long OAR copyright line 
which would otherwise exceed 80 characters:

.. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)

-- 
Sebastian Huber, embedded brains GmbH

Address : Dornierstr. 4, D-82178 Puchheim, Germany
Phone   : +49 89 189 47 41-16
Fax     : +49 89 189 47 41-09
E-Mail  : sebastian.huber at embedded-brains.de
PGP     : Public key available on request.

Diese Nachricht ist keine geschäftliche Mitteilung im Sinne des EHUG.




More information about the devel mailing list