Merge pull request #6868 from rolandwalker/doc_gpg_stub

basic docs for stub gpg stanza

doc/CASK_LANGUAGE_REFERENCE.md

@@ -17,6 +17,7 @@ Cask Domain-Specific Language (DSL) which are not needed in most cases.
  * [Appcast Stanza Details](#appcast-stanza-details)
  * [Tags Stanza Details](#tags-stanza-details)
  * [License Stanza Details](#license-stanza-details)
+ * [GPG Stanza Details](#gpg-stanza-details)
  * [App Stanza Details](#app-stanza-details)
  * [Suite Stanza Details](#suite-stanza-details)
  * [Pkg Stanza Details](#pkg-stanza-details)
@@ -117,6 +118,7 @@ Each Cask must declare one or more *artifacts* (i.e. something to install)
 | `container :nested =>` | no                            | relative path to an inner container that must be extracted before moving on with the installation; this allows us to support dmg inside tar, zip inside dmg, etc.
 | `container :type =>`   | no                            | a symbol to override container-type autodetect. may be one of: `:air`, `:bz2`, `:cab`, `:dmg`, `:generic_unar`, `:gzip`, `:otf`, `:pkg`, `:rar`, `:seven_zip`, `:sit`, `:tar`, `:ttf`, `:xar`, `:zip`, `:naked`.  (example [parse.rb](../Casks/parse.rb))
 | `tags`                 | no                            | a list of key-value pairs for Cask annotation.  Not free-form.  (see also [Tags Stanza Details](#tags-stanza-details))
+| `gpg`                  | no                            | *stub: not yet functional.*  (see also [GPG Stanza Details](#gpg-stanza-details))
 
 
 ## Legacy Stanzas
@@ -390,6 +392,22 @@ using the information stored in the `tags` stanza.
 | `:vendor`     | The full-text official name of the producer of the software: an author or corporate name, as appropriate.  As the value is intended as a search target, commonly shared abbreviations such as `Dr.` or `Inc.` should be omitted. (example [google-chrome.rb](../Casks/google-chrome.rb))
 
 
+## GPG Stanza Details
+
+**This is a stub for upcoming functionality, and is not fully documented**.
+
+The `gpg` stanza contains signature information for GPG-signed distributions.
+The form is
+
+```ruby
+gpg <signature>, <parameter> => <value>
+```
+
+where `<parameter>` is one of `:key_id` or `:key_url`, and `<signature>` points
+to the detached signature of the distribution.  Commonly, the signature
+follows the `url` value.  Example: [libreoffice.rb](../Casks/libreoffice.rb).
+
+
 ## App Stanza Details
 
 In the simple case of a string argument to `app`, a symlink is created in

doc/cask_language_deltas.md

@@ -45,6 +45,7 @@ This notice will be removed for the final form.**
    * *stub* - not yet functional
  * `conflicts_with`
    * *stub* - not yet functional
+ * `gpg`
  * `installer :script`
  * `license`
  * `suite`