Add docs for ignored_resources

Signed-off-by: Ayan Sinha Mahapatra <[email protected]>

Author: AyanSinhaMahapatra

docs/source/general.rst

@@ -85,6 +85,9 @@ it will copy and store next to the .ABOUT files.
     * - name
       - Component name
       - Mandatory
+    * - ignored_resources
+      - List of paths ignored from the ``about_resource``
+      - Optional
     * - version
       - Component version
       - Optional

docs/source/specification.rst

@@ -218,11 +218,14 @@ in any case combination.
 Referencing the file or directory documented by an ABOUT file
 -------------------------------------------------------------
 
-An ABOUT file documents one file or directory. The mandatory "about_resource"
-field reference the documented file or directory. The value of the "about_resource"
-field is the name or path of the referenced file or directory.
+An ABOUT file documents one file or directory. The mandatory ``about_resource``
+field reference the documented file or directory. The value of the ``about_resource``
+field is the name or path of the referenced file or directory. There is also a
+``ignored_resources`` field which can be used to ignore a set of subpaths inside the
+directory which is being documented in the ABOUT file.
 
-A tool processing an ABOUT file must report an error if this field is missing.
+A tool processing an ABOUT file must report an error if the ``about_resource``
+field is missing.
 
 By convention, an ABOUT file is often stored in the same directory side-by-side
 to the file or directory that it documents, but this is not mandatory.
@@ -240,6 +243,14 @@ In this example, the ABOUT file documents a whole sub-directory:
 
                 about_resource: linux-kernel-2.6.23
 
+In this example, the ABOUT file documents a whole sub-directory, with some
+sub-paths under the directory ignored:
+
+        ..  code-block:: none
+
+                about_resource: linux-kernel-2.6.23
+                ignored_resources: linux-kernel-2.6.23/Documentation
+
 In this example, the ABOUT file documents the current directory, using a "." period to reference it:
 
         ..  code-block:: none
@@ -258,6 +269,9 @@ mandatory field are missing.
 Optional Information fields
 ---------------------------
 
+-   ignored_resources: A list of paths under the ``about_resource`` path, which are
+    not documented in the ABOUT file, and the information in the ABOUT file does not
+    apply to these subpaths.
 -   version: Component or package version. A component or package usually has a version,
     such as a revision number or hash from a version control system (for a snapshot checked
     out from VCS such as Subversion or Git). If not available, the version should be the date