]> git.donarmstrong.com Git - debian/debian-policy.git/blobdiff - copyright-format/copyright-format.xml
Fix typo (thanks, Niels Thykier)
[debian/debian-policy.git] / copyright-format / copyright-format.xml
index a62da994b103154fcb3041606395ab87829f77b4..e854c2a1464c842bcbb3262847607b5697d02503 100644 (file)
         standard, machine-readable format for
         <filename>debian/copyright</filename> files within packages and
         facilitate automated checking and reporting of licenses for packages and
-        sets of packages. The DEP drivers were Steve Langasek
-        <email>vorlon@debian.org</email> and Lars Wirzenius
-        <email>liw@liw.fi</email>.
+        sets of packages.
       </para>
     </abstract>
   </articleinfo>
-  
+
   <section id="introduction">
     <title>Introduction</title>
     <para>
@@ -54,7 +52,7 @@
       <filename>debian/copyright</filename>.
     </para>
   </section>
-  
+
   <section id="rationale">
     <title>Rationale</title>
     <para>
       Lars Wirzenius.
     </para>
   </section>
-  
+
   <section id="file-syntax">
     <title>File syntax</title>
     <para>
       There are four kinds values for fields.  Each field specifies which kind
       is allowed.
     </para>
-    
+
     <section id="single-line">
       <title>Single-line values</title>
       <para>
         that is used.
       </para>
     </section>
-    
+
     <section id="white-space-lists">
       <title>White space separated lists</title>
       <para>
         A white space separated list means that the field value may be on one
         line or many, but values in the list are separated by one or more white
         space characters (including space, TAB, and newline).  For example, the
-        <varname>Files</varname>field has a list of filename patterns.
+        <varname>Files</varname> field has a list of filename patterns.
       </para>
     </section>
-    
+
     <section id="line-based-lists">
       <title>Line based lists</title>
       <para>
         line.
       </para>
     </section>
-    
+
     <section id="formatted-text">
       <title>Text formatted like package long descriptions</title>
       <para>
       </para>
     </section>
   </section>
-  
+
   <section id="paragraphs">
     <title>Paragraphs</title>
     <para>
       license</link> paragraph.  This is similar to source and binary package
       paragraphs in <filename>debian/control</filename> files.
     </para>
-    
+
     <section id="header-paragraph">
       <title>Header paragraph (Once)</title>
       <section id="format-header-field">
         <title><varname>Format</varname></title>
         <para>
           Required single line: URI of the format specification, such as:
-          <literal>http://www.debian.org/doc/copyright-format/1.0</literal>
+          <literal>http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/</literal>
         </para>
       </section>
-      
+
       <section id="upstream-name-header-field">
         <title><varname>Upstream-Name</varname></title>
         <para>
           Optional single line: the name upstream uses for the software
         </para>
       </section>
-      
+
       <section id="upstream-contact-header-field">
         <title><varname>Upstream-Contact</varname></title>
         <para>
           usually be written as a list of RFC5322 addresses or URIs.
         </para>
       </section>
-      
+
       <section id="source-header-field">
         <title><varname>Source</varname></title>
         <para>
           in this field.
         </para>
       </section>
-      
+
       <section id="disclaimer-header-field">
         <title><varname>Disclaimer</varname></title>
         <para>
           url="http://www.debian.org/doc/debian-policy/ch-docs#s-copyrightfile">12.5</ulink>)
         </para>
       </section>
-      
+
       <section id="comment-header-field">
         <title><varname>Comment</varname></title>
         <para>
           version is not.
         </para>
       </section>
-      
+
       <section id="license-header-field">
         <title><varname>License</varname></title>
         <para>
           linkend="files-paragraph">Files paragraph</link> section.
         </para>
       </section>
-      
+
       <section id="copyright-header-field">
         <title><varname>Copyright</varname></title>
         <para>
           package, for instance when a work combines a permissive and a copyleft
           license, or to document a <emphasis>compilation copyright</emphasis>
           and license.  It is possible to use only <varname>License</varname> in
-          the header paragraph, but <varname>Copyright</varname>alone makes no
+          the header paragraph, but <varname>Copyright</varname> alone makes no
           sense.
         </para>
       </section>
-      
+
       <section id="example-header-paragraph">
         <title>Example header paragraph</title>
-<programlisting>Format: &lt;VERSIONED_FORMAT_URL&gt;
+<programlisting>Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
 Upstream-Name: SOFTware
 Upstream-Contact: John Doe &lt;john.doe@example.com&gt;
 Source: http://www.example.com/software/project</programlisting>
       </section>
     </section>
-     
+
     <section id="files-paragraph">
       <title>Files paragraph (Repeatable)</title>
       <para>
@@ -295,7 +293,7 @@ Source: http://www.example.com/software/project</programlisting>
         which applies to all files and lists all applicable copyrights and
         licenses.
       </para>
-       
+
       <section id="files-files-field">
         <title><varname>Files</varname></title>
         <para>
@@ -366,7 +364,7 @@ Source: http://www.example.com/software/project</programlisting>
         paragraphs.
       </para>
       </section>
-         
+
       <section id="copyright-files-field">
         <title><varname>Copyright</varname></title>
         <para>
@@ -431,7 +429,7 @@ Copyright 2009, 2010 Angela Watts</programlisting>
           notices with the binary package.
         </para>
       </section>
-          
+
       <section id="comment-files-field">
         <title><varname>Comment</varname></title>
         <para>
@@ -439,7 +437,7 @@ Copyright 2009, 2010 Angela Watts</programlisting>
           <varname>Comment</varname></link> field in the header paragraph.
         </para>
       </section>
-      
+
       <section id="example-files-paragraph">
         <title>Example files paragraphs</title>
 <programlisting>Files: *
@@ -467,7 +465,7 @@ License: GPL-2+</programlisting>
         </para>
       </section>
     </section>
-    
+
     <section id="stand-alone-license-paragraph">
       <title>Standalone License Paragraph (Optional, Repeatable)</title>
       <para>
@@ -490,9 +488,9 @@ License: GPL-2
  [LICENSE TEXT]
 
 License: LGPL-2.1
- LICENSE TEXT]</programlisting>
[LICENSE TEXT]</programlisting>
       </example>
-      
+
       <example>
         <title>recurrent license</title>
 <programlisting>Files: src/js/editline/*
@@ -512,7 +510,7 @@ License: MPL-1.1
 
   <section id="license-specification">
     <title>License specification</title>
-    
+
     <section id="license-short-name">
       <title>Short name</title>
       <para>
@@ -523,7 +521,7 @@ License: MPL-1.1
         <varname>License</varname> field.
       </para>
       <para>
-        These short names have the specified meanings across all uses of this 
+        These short names have the specified meanings across all uses of this
         file format, and <emphasis>must not</emphasis> be used to refer to any
         other licenses.  Parsers may thus rely on these short names referring to
         the same licenses wherever they occur, without needing to parse or
@@ -558,8 +556,7 @@ License: MPL-1.1
       </para>
       <para>
         Currently, the full text of the licenses is only available in the <ulink
-        url="http://spdx.org/wiki/working-version-license-list">working version
-        of the SPDX license list</ulink>.
+        url="http://spdx.org/licenses">SPDX Open Source License Registry</ulink>.
       </para>
       <informaltable>
         <tgroup cols="2">
@@ -582,9 +579,9 @@ License: MPL-1.1
                 Apache
               </entry>
               <entry>
-                Apache license 
-                <ulink url="http://spdx.org/licenses/ASL-1.0">1.0</ulink>,
-                <ulink url="http://spdx.org/licenses/ASL-2.0">2.0</ulink>.
+                Apache license
+                <ulink url="http://spdx.org/licenses/Apache-1.0">1.0</ulink>,
+                <ulink url="http://spdx.org/licenses/Apache-2.0">2.0</ulink>.
               </entry>
             </row>
             <row>
@@ -592,7 +589,7 @@ License: MPL-1.1
                 Artistic
               </entry>
               <entry>
-                Artistic license 
+                Artistic license
                 <ulink url="http://spdx.org/licenses/Artistic-1.0">1.0</ulink>,
                 <ulink url="http://spdx.org/licenses/Artistic-2.0">2.0</ulink>.
               </entry>
@@ -713,9 +710,8 @@ License: MPL-1.1
                 CC0
               </entry>
               <entry>
-                Creative Commons <ulink
-                url="http://creativecommons.org/license/zero/">Universal
-                waiver</ulink>.
+                Creative Commons Zero 1.0 Universal
+                <ulink url="http://spdx.org/licenses/CC0-1.0">1.0</ulink>.
               </entry>
             </row>
             <row>
@@ -723,8 +719,8 @@ License: MPL-1.1
                 CDDL
               </entry>
               <entry>
-                <ulink url="http://spdx.org/licenses/CDDL">Common Development
-                and Distribution License</ulink>.
+                Common Development and Distribution License
+                <ulink url="http://spdx.org/licenses/CDDL-1.0">1.0</ulink>.
               </entry>
             </row>
             <row>
@@ -742,7 +738,8 @@ License: MPL-1.1
               </entry>
               <entry>
                 The Eiffel Forum License
-                <ulink url="http://spdx.org/licenses/EPL-1.0">1.0</ulink>.
+                <ulink url="http://spdx.org/licenses/EFL-1.0">1.0</ulink>,
+                <ulink url="http://spdx.org/licenses/EFL-2.0">2.0</ulink>.
               </entry>
             </row>
             <row>
@@ -774,7 +771,6 @@ License: MPL-1.1
                 <ulink url="http://spdx.org/licenses/LGPL-2.1">2.1</ulink>,
                 <ulink url="http://spdx.org/licenses/LGPL-3.0">3.0</ulink>, or
                 GNU Library General Public License
-                <ulink url="http://spdx.org/licenses/LGPL-1.0">1.0</ulink>,
                 <ulink url="http://spdx.org/licenses/LGPL-2.0">2.0</ulink>.
               </entry>
             </row>
@@ -783,8 +779,8 @@ License: MPL-1.1
                 GFDL
               </entry>
               <entry>
-                <ulink url="http://spdx.org/licenses/FDL-1.0">GNU Free
-                Documentation License</ulink>.
+                GNU Free Documentation License 1.0, or
+                <ulink url="http://spdx.org/licenses/GFDL-1.1">1.1</ulink>.
               </entry>
             </row>
             <row>
@@ -829,12 +825,13 @@ License: MPL-1.1
             </row>
             <row>
               <entry>
-                Python-CNRI
+                Python
               </entry>
               <entry>
-                <ulink url="http://spdx.org/licenses/Python-CNRI">Python
-                license</ulink>.
+                Python license
+                <ulink url="http://spdx.org/licenses/Python-2.0">2.0</ulink>.
               </entry>
+              <!-- See https://fossbazaar.org/pipermail/spdx-legal/2011-February/000010.html -->
             </row>
             <row>
               <entry>
@@ -871,8 +868,8 @@ License: MPL-1.1
                 Zope
               </entry>
               <entry>
-                Zope Public License
-                  <ulink url="http://spdx.org/licenses/ZPL-1.0">1.0</ulink>,
+                Zope Public License 1.0,
+                  <ulink url="http://spdx.org/licenses/ZPL-1.1">1.1</ulink>,
                   <ulink url="http://spdx.org/licenses/ZPL-2.0">2.0</ulink>,
                   <ulink url="http://spdx.org/licenses/ZPL-2.1">2.1</ulink>.
               </entry>
@@ -887,10 +884,22 @@ License: MPL-1.1
         matches.
       </para>
       <para>
-        Exceptions and clarifications are signaled in plain text, by appending
+        An exception or clarification to a license is signaled in plain text, by appending
         <literal>with <varname><replaceable>keywords</replaceable></varname>
         exception</literal> to the short name.  This document provides a list of
-        keywords that refer to the most frequent exceptions.
+        keywords that must be used when referring to the most frequent
+        exceptions.  When exceptions other than these are in effect that modify
+        a common license by granting additional permissions, you may use an
+        arbitrary keyword not taken from the below list of keywords.  When a
+        license differs from a common license because of added restrictions
+        rather than because of added permissions, a distinct short name should
+        be used instead of <literal>with
+        <varname><replaceable>keywords</replaceable></varname>exception</literal>.
+      </para>
+      <para>
+        Only one exception may be specified for each license within a given
+        license specification.  If more than one exception applies to a single
+        license, an arbitrary short name must be used instead.
       </para>
       <para>
         The GPL <literal>Font</literal> exception refers to the text added to the
@@ -933,7 +942,7 @@ so, delete this exception statement from your version. If you delete
 this exception statement from all source files in the program, then
 also delete it here.</programlisting>
         </para>
-        
+
         <section id="public-domain">
           <title>Public domain</title>
           <para>
@@ -962,7 +971,7 @@ also delete it here.</programlisting>
         </para>
       </section>
     </section>
-    
+
     <section id="license-syntax">
       <title>Syntax</title>
       <para>
@@ -1011,12 +1020,12 @@ also delete it here.</programlisting>
  version.
  .
  In addition, as a special exception, the author of this
- program gives permission to link the code of its 
+ program gives permission to link the code of its
  release with the OpenSSL project's "OpenSSL" library (or
  with modified versions of it that use the same license as
  the "OpenSSL" library), and distribute the linked
- executables. You must obey the GNU General Public 
- License in all respects for all of the code used other 
+ executables. You must obey the GNU General Public
+ License in all respects for all of the code used other
  than "OpenSSL".  If you modify this file, you may extend
  this exception to your version of the file, but you are
  not obligated to do so.  If you do not wish to do so,
@@ -1062,7 +1071,7 @@ also delete it here.</programlisting>
         A possible <filename>debian/copyright</filename> file for the program
         <quote>X Solitaire</quote> distributed in the Debian source package
         <literal>xsol</literal>:
-<programlisting><![CDATA[Format: <VERSIONED_FORMAT_URL>
+<programlisting><![CDATA[Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
 Upstream-Name: X Solitaire
 Source: ftp://ftp.example.com/pub/games
 
@@ -1092,7 +1101,7 @@ License: GPL-2+
 
 Files: debian/*
 Copyright: Copyright 1998 Jane Smith <jsmith@example.net>
-License:
+License: GPL-2+
  [LICENSE TEXT]]]></programlisting>
       </para>
     </example>
@@ -1103,7 +1112,7 @@ License:
         A possible <filename>debian/copyright</filename> file for the program
         <quote>Planet Venus</quote>, distributed in the Debian source
         package <literal>planet-venus</literal>:
-<programlisting><![CDATA[Format: <VERSIONED_FORMAT_URL>
+<programlisting><![CDATA[Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
 Upstream-Name: Planet Venus
 Upstream-Contact: John Doe <jdoe@example.com>
 Source: http://www.example.com/code/venus
@@ -1118,7 +1127,7 @@ License: PSF-2
 
 Files: debian/*
 Copyright: 2008, Dan Developer <dan@debian.example.com>
-License:
+License: permissive
  Copying and distribution of this package, with or without
  modification, are permitted in any medium without royalty
  provided the copyright notice and this notice are
@@ -1170,28 +1179,5 @@ License: GPL-2+
       </para>
     </example>
   </section>
-  
-  <section id="appendix">
-    <title>
-      Appendix: Note about the use of this format in Debian
-    </title>
-    <para>
-      The Debian Policy (ยง<ulink
-      url="http://www.debian.org/doc/debian-policy/ch-docs#s-copyrightfile">12.5</ulink>)
-      demands that each package is accompanied by a file,
-      <filename>debian/copyright</filename> in source packages and
-      <filename>/usr/share/doc/package/copyright</filename> in binary packages,
-      that contains a verbatim copy of its copyright and distribution license.
-      In addition, it requires that copyrights must be extractable by mechanical
-      means.  This proposal for machine-readable copyright and license summary
-      files has been crafted for Debian's use, but it is our hope that other
-      software distributions, as well as upstream developers will adopt it, so
-      that review efforts can be easily reproduced and shared.
-    </para>
-    <para>
-      The copyright of the Debian packaging and the history of package
-      maintainers is simply indicated in a <literal>Files: debian/*</literal>
-      paragraph.
-    </para>
-  </section>
+
 </article>