Release v7.24.0 (#6162)

* Add notes about releases and self-written samples * Update all grammars * Update cached licenses * v7.24.0 * Remove link that snuck in
github-linguist · Nov 15, 2022 · 59b2d88 · 59b2d88
1 parent ece5f4f
commit 59b2d88
Show file tree

Hide file tree

Showing 146 changed files with 227 additions and 157 deletions.
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -65,6 +65,7 @@ To add support for a new extension:
 1. Open a pull request, linking to a [GitHub search result][search-example] showing in-the-wild usage.
    If you are adding a sample, please state clearly the license covering the code.
    If possible, link to the original source of the sample.
+   If you wrote the sample specifically for the PR and are happy for it to be included under the MIT license that covers Linguist, you can state this instead.
 
 Additionally, if this extension is already listed in [`languages.yml`][languages] and associated with another language, then sometimes a few more steps will need to be taken:
 
@@ -73,6 +74,7 @@ Additionally, if this extension is already listed in [`languages.yml`][languages
    This ensures we're not misclassifying files.
 1. If the Bayesian classifier does a bad job with the sample `.yourextension` files then a [heuristic][] may need to be written to help.
 
+See [My Linguist PR has been merged but GitHub doesn't reflect my changes][merged-pr] for details on when your changes will appear on GitHub after your PR has been merged.
 
 ## Adding a language
 
@@ -96,6 +98,7 @@ To add support for a new language:
 1. Open a pull request, linking to [GitHub search results][search-example] showing in-the-wild usage.
    Please state clearly the license covering the code in the samples.
    Link directly to the original source if possible.
+   If you wrote the sample specifically for the PR and are happy for it to be included under the MIT license that covers Linguist, you can state this instead.
 
 In addition, if your new language defines an extension that's already listed in [`languages.yml`][languages] (such as `.foo`) then sometimes a few more steps will need to be taken:
 
@@ -106,9 +109,7 @@ In addition, if your new language defines an extension that's already listed in
 
 Remember, the goal here is to try and avoid false positives!
 
-Note: New languages will not appear in GitHub's search results for some time after the pull request has been merged and the new Linguist release deployed to GitHub.com.
-This is because GitHub's search uses [go-enry](https://github.com/go-enry/go-enry) for language detection but tends to lag behind Linguist by a few weeks to months.
-This in turn requires an update to the underlying search code once go-enry is inline with Linguist.
+See [My Linguist PR has been merged but GitHub doesn't reflect my changes][merged-pr] for details on when your changes will appear on GitHub after your PR has been merged.
 
 ## Fixing a misclassified language
 
@@ -139,6 +140,7 @@ Linguist's grammar compiler will highlight any problems when the grammar is upda
 
 Once the bug has been fixed upstream, we'll pick it up for GitHub in the next release of Linguist.
 
+See [My Linguist PR has been merged but GitHub doesn't reflect my changes][merged-pr] for details on when the upstream changes will appear on GitHub.
 
 ## Changing the source of a syntax highlighting grammar
 
@@ -158,6 +160,8 @@ If problems are found, please report these problems to the grammar maintainer as
 
 Please then open a pull request for the updated grammar.
 
+See [My Linguist PR has been merged but GitHub doesn't reflect my changes][merged-pr] for details on when your changes will appear on GitHub after your PR has been merged.
+
 ## Changing the color associated with a language
 
 Many of the colors associated with the languages within Linguist have been in place for a very long time.
@@ -176,6 +180,12 @@ You can run the tests locally with:
 bundle exec rake test
 ```
 
+You can test the classifier locally with:
+
+```bash
+bundle exec script/cross-validation --test
+```
+
 Sometimes getting the tests running can be too much work, especially if you don't have much Ruby experience.
 It's okay: be lazy and let [GitHub Actions](https://github.com/features/actions) run the tests for you.
 Just open a pull request and the bot will start cranking away.
@@ -207,3 +217,4 @@ As Linguist is a production dependency for GitHub we have a couple of workflow r
 [search-example]: https://github.com/search?utf8=%E2%9C%93&q=extension%3Aboot+NOT+nothack&type=Code&ref=searchresults
 [gpr]: https://docs.github.com/packages/using-github-packages-with-your-projects-ecosystem/configuring-rubygems-for-use-with-github-packages
 [#5756]: https://github.com/github/linguist/issues/5756
+[merged-pr]: /docs/troubleshooting.md#my-linguist-pr-has-been-merged-but-gitHub-doesnt-reflect-my-changes
diff --git a/Rakefile b/Rakefile
@@ -59,7 +59,7 @@ end
 # The error count will need to be adjusted here until such time as all grammars are 100% error free.
 desc "Check that compiling the grammars doesn't introduce any new unexpected errors"
 task :check_grammars do
-  expected_error_count = 32  # This count should only ever go down. If it goes up, there's a new issue that needs to be addressed before updating the grammar.
+  expected_error_count = 31  # This count should only ever go down. If it goes up, there's a new issue that needs to be addressed before updating the grammar.
   rm_rf "linguist-grammars"
   output, status = Open3.capture2e("script/grammar-compiler", "compile", "-o", "linguist-grammars")
   errors_found = output[/The grammar library contains ([0-9]+) errors/, 1].to_i

diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
@@ -58,3 +58,16 @@ Alternatively you can run Linguist on individual files, see [here](/README.md#si
 
 There are several known issues with the version of Ruby shipped with macOS that cause problems when it comes to installing the charlock-holmes gem which is a Linguist dependency.
 As this is a problem with the Ruby shipped by Apple and not Linguist or charlock-holmes, we recommend you install a version of Ruby using Homebrew, `rbenv`, `rvm`, `ruby-build`, `asdf` or other packaging system, before attempting to install Linguist.
+
+## My Linguist PR has been merged but GitHub doesn't reflect my changes
+
+Changes to Linguist will only appear on GitHub when a new Linguist release is made and this is deployed to GitHub.com.
+There is no set release timeframe, but the intention is at least once every three-to-four months so the latest version ships with each new major version of GitHub Enterprise Server.
+A PR like [this](https://github.com/github/linguist/pull/6051) will be created for the release with checkmarks for each stage of the release process.
+
+All syntax highlighting grammars will also be updated in all major and minor releases.
+Grammars will only be updated in patch releases if the patch release is specifically for that language and it requires a grammar update to address the issue.
+
+Note: New languages will not appear in GitHub's search results for some time after the pull request has been merged and the new Linguist release deployed to GitHub.com.
+This is because GitHub's search uses [go-enry](https://github.com/go-enry/go-enry) for language detection which tends to lag behind Linguist by a few weeks to months.
+This in turn requires an update to the underlying search code once go-enry is inline with Linguist.
diff --git a/lib/linguist/VERSION b/lib/linguist/VERSION
@@ -1 +1 @@
-7.23.0
+7.24.0
diff --git a/vendor/CodeMirror b/vendor/CodeMirror
diff --git a/vendor/grammars/AL b/vendor/grammars/AL
diff --git a/vendor/grammars/Atom-PostScript b/vendor/grammars/Atom-PostScript
diff --git a/vendor/grammars/MagicPython b/vendor/grammars/MagicPython
diff --git a/vendor/grammars/PHP-Twig.tmbundle b/vendor/grammars/PHP-Twig.tmbundle
diff --git a/vendor/grammars/Scenic-tmLanguage b/vendor/grammars/Scenic-tmLanguage
diff --git a/vendor/grammars/Sublime-HTTP b/vendor/grammars/Sublime-HTTP
diff --git a/vendor/grammars/Sublime-SQF-Language b/vendor/grammars/Sublime-SQF-Language
diff --git a/vendor/grammars/TypeScript-TmLanguage b/vendor/grammars/TypeScript-TmLanguage
diff --git a/vendor/grammars/VscodeAdblockSyntax b/vendor/grammars/VscodeAdblockSyntax
diff --git a/vendor/grammars/XojoSyntaxTM b/vendor/grammars/XojoSyntaxTM
diff --git a/vendor/grammars/abap-cds-grammar b/vendor/grammars/abap-cds-grammar
diff --git a/vendor/grammars/astro b/vendor/grammars/astro
diff --git a/vendor/grammars/atom-editorconfig b/vendor/grammars/atom-editorconfig
diff --git a/vendor/grammars/atom-language-cairo b/vendor/grammars/atom-language-cairo
diff --git a/vendor/grammars/bicep b/vendor/grammars/bicep
diff --git a/vendor/grammars/bikeshed b/vendor/grammars/bikeshed
diff --git a/vendor/grammars/boogie-vscode b/vendor/grammars/boogie-vscode
diff --git a/vendor/grammars/csharp-tmLanguage b/vendor/grammars/csharp-tmLanguage
diff --git a/vendor/grammars/dart-syntax-highlight b/vendor/grammars/dart-syntax-highlight
diff --git a/vendor/grammars/data-weave-tmLanguage b/vendor/grammars/data-weave-tmLanguage
diff --git a/vendor/grammars/denizenscript-grammar b/vendor/grammars/denizenscript-grammar
diff --git a/vendor/grammars/elvish b/vendor/grammars/elvish
diff --git a/vendor/grammars/godot-vscode-plugin b/vendor/grammars/godot-vscode-plugin
diff --git a/vendor/grammars/graphiql b/vendor/grammars/graphiql
diff --git a/vendor/grammars/haxe-TmLanguage b/vendor/grammars/haxe-TmLanguage
diff --git a/vendor/grammars/imba-linguist-grammar b/vendor/grammars/imba-linguist-grammar
diff --git a/vendor/grammars/language-clojure b/vendor/grammars/language-clojure
diff --git a/vendor/grammars/language-coffee-script b/vendor/grammars/language-coffee-script
diff --git a/vendor/grammars/language-css b/vendor/grammars/language-css
diff --git a/vendor/grammars/language-etc b/vendor/grammars/language-etc
diff --git a/vendor/grammars/language-gfm b/vendor/grammars/language-gfm
diff --git a/vendor/grammars/language-html b/vendor/grammars/language-html
diff --git a/vendor/grammars/language-javascript b/vendor/grammars/language-javascript
diff --git a/vendor/grammars/language-less b/vendor/grammars/language-less
diff --git a/vendor/grammars/language-property-list b/vendor/grammars/language-property-list
diff --git a/vendor/grammars/language-restructuredtext b/vendor/grammars/language-restructuredtext
diff --git a/vendor/grammars/language-roff b/vendor/grammars/language-roff
diff --git a/vendor/grammars/language-ruby b/vendor/grammars/language-ruby
diff --git a/vendor/grammars/language-sass b/vendor/grammars/language-sass
diff --git a/vendor/grammars/language-shellscript b/vendor/grammars/language-shellscript
diff --git a/vendor/grammars/language-toc-wow b/vendor/grammars/language-toc-wow
diff --git a/vendor/grammars/language-yaml b/vendor/grammars/language-yaml
diff --git a/vendor/grammars/latex.tmbundle b/vendor/grammars/latex.tmbundle
diff --git a/vendor/grammars/llvm.tmbundle b/vendor/grammars/llvm.tmbundle
diff --git a/vendor/grammars/qsharp-compiler b/vendor/grammars/qsharp-compiler
diff --git a/vendor/grammars/razor-plus b/vendor/grammars/razor-plus
diff --git a/vendor/grammars/rescript-vscode b/vendor/grammars/rescript-vscode
diff --git a/vendor/grammars/sas.tmbundle b/vendor/grammars/sas.tmbundle
diff --git a/vendor/grammars/svelte-atom b/vendor/grammars/svelte-atom
diff --git a/vendor/grammars/textproto-grammar b/vendor/grammars/textproto-grammar
diff --git a/vendor/grammars/vscode-antlers-language-server b/vendor/grammars/vscode-antlers-language-server
diff --git a/vendor/grammars/vscode-brightscript-language b/vendor/grammars/vscode-brightscript-language
diff --git a/vendor/grammars/vscode-cadence b/vendor/grammars/vscode-cadence
diff --git a/vendor/grammars/vscode-codeql b/vendor/grammars/vscode-codeql
diff --git a/vendor/grammars/vscode-fluent b/vendor/grammars/vscode-fluent
diff --git a/vendor/grammars/vscode-gcode-syntax b/vendor/grammars/vscode-gcode-syntax
diff --git a/vendor/grammars/vscode-gleam b/vendor/grammars/vscode-gleam
diff --git a/vendor/grammars/vscode-go b/vendor/grammars/vscode-go
diff --git a/vendor/grammars/vscode-hack b/vendor/grammars/vscode-hack
diff --git a/vendor/grammars/vscode-ibmi-languages b/vendor/grammars/vscode-ibmi-languages
diff --git a/vendor/grammars/vscode-jest b/vendor/grammars/vscode-jest
diff --git a/vendor/grammars/vscode-lean b/vendor/grammars/vscode-lean
diff --git a/vendor/grammars/vscode-motoko b/vendor/grammars/vscode-motoko
diff --git a/vendor/grammars/vscode-move-syntax b/vendor/grammars/vscode-move-syntax
diff --git a/vendor/grammars/vscode-pddl b/vendor/grammars/vscode-pddl
diff --git a/vendor/grammars/vscode-prisma b/vendor/grammars/vscode-prisma
diff --git a/vendor/grammars/vscode-scala-syntax b/vendor/grammars/vscode-scala-syntax
diff --git a/vendor/grammars/vscode-vlang b/vendor/grammars/vscode-vlang
diff --git a/vendor/grammars/vscode-yara b/vendor/grammars/vscode-yara
diff --git a/vendor/grammars/vscode_cobol b/vendor/grammars/vscode_cobol
diff --git a/vendor/licenses/git_submodule/AL.dep.yml b/vendor/licenses/git_submodule/AL.dep.yml
@@ -1,6 +1,6 @@
 ---
 name: AL
-version: 4318c49202c12979a191893817dfd567ed037ce7
+version: dc19e2e4a67e2615ca9f96ea5f8e8971956e7e3c
 type: git_submodule
 homepage: https://github.com/microsoft/AL
 license: mit

diff --git a/vendor/licenses/git_submodule/Atom-PostScript.dep.yml b/vendor/licenses/git_submodule/Atom-PostScript.dep.yml
@@ -1,13 +1,13 @@
 ---
 name: Atom-PostScript
-version: 192c11a0776f45a2dd4cf4209b2a2d77c741c35b
+version: 46641c3c77f043a3f358c6299e5bb3052f9e8dbd
 type: git_submodule
 homepage: https://github.com/Alhadis/Atom-PostScript
 license: isc
 licenses:
 - sources: LICENSE.md
   text: |
-    Copyright (c) 2019-2021, John Gardner
+    Copyright (c) 2019-2022, John Gardner
 
     Permission to use, copy, modify, and/or distribute this software for any
     purpose with or without fee is hereby granted, provided that the above

diff --git a/vendor/licenses/git_submodule/CodeMirror.dep.yml b/vendor/licenses/git_submodule/CodeMirror.dep.yml
@@ -1,6 +1,6 @@
 ---
 name: CodeMirror
-version: ccacc382636a8f892f665b0eb49dcdce99593ae3
+version: 9296326b0a9e37489e00d4d7bfabd4725f6bfb7b
 type: git_submodule
 homepage: https://github.com/codemirror/CodeMirror
 license: mit
@@ -967,6 +967,7 @@ notices:
     vf
     Victor Bocharsky
     Vincent Woo
+    Vladislav Voitenok
     Volker Mische
     vtripolitakis
     wdouglashall

diff --git a/vendor/licenses/git_submodule/MagicPython.dep.yml b/vendor/licenses/git_submodule/MagicPython.dep.yml
@@ -1,6 +1,6 @@
 ---
 name: MagicPython
-version: 2802ded681e0ab1a1057821c1da287147d639505
+version: 7d0f2b22a5ad8fccbd7341bc7b7a715169283044
 type: git_submodule
 homepage: https://github.com/MagicStack/MagicPython
 license: mit

diff --git a/vendor/licenses/git_submodule/PHP-Twig.tmbundle.dep.yml b/vendor/licenses/git_submodule/PHP-Twig.tmbundle.dep.yml
@@ -1,6 +1,6 @@
 ---
 name: PHP-Twig.tmbundle
-version: 77def406d70b90dff33d006478198b729e23d22c
+version: aedf955eba9753554815b2cbef5e072415e42068
 type: git_submodule
 homepage: https://github.com/Anomareh/PHP-Twig.tmbundle
 license: bsd-3-clause

diff --git a/vendor/licenses/git_submodule/Scenic-tmLanguage.dep.yml b/vendor/licenses/git_submodule/Scenic-tmLanguage.dep.yml
@@ -1,6 +1,6 @@
 ---
 name: Scenic-tmLanguage
-version: f9eee39fd54e9aefea507d404f10847b0fe01123
+version: 9782b8dc12b90ec3406177d5b85a16ce1b061841
 type: git_submodule
 homepage: https://github.com/UCSCFormalMethods/Scenic-tmLanguage.git
 license: mit

diff --git a/vendor/licenses/git_submodule/Sublime-HTTP.dep.yml b/vendor/licenses/git_submodule/Sublime-HTTP.dep.yml
@@ -1,6 +1,6 @@
 ---
 name: Sublime-HTTP
-version: 778e663213ca966c1b04b43bd7c0bee59e217bd8
+version: 9938a52ba113bb1e58eee8fc91878827c2967f59
 type: git_submodule
 homepage: https://github.com/samsalisbury/Sublime-HTTP
 license: mit

diff --git a/vendor/licenses/git_submodule/Sublime-SQF-Language.dep.yml b/vendor/licenses/git_submodule/Sublime-SQF-Language.dep.yml
@@ -1,6 +1,6 @@
 ---
 name: Sublime-SQF-Language
-version: d270fd8bba79e6239bc993660657f275ba529ea8
+version: 2f68c33f2f66a7c0f9427a4e0ab918201bdc7f56
 type: git_submodule
 homepage: https://github.com/JonBons/Sublime-SQF-Language
 license: apache-2.0

diff --git a/vendor/licenses/git_submodule/TypeScript-TmLanguage.dep.yml b/vendor/licenses/git_submodule/TypeScript-TmLanguage.dep.yml
@@ -1,6 +1,6 @@
 ---
 name: TypeScript-TmLanguage
-version: 448f712d525026502b5ad8b2e50dceab303cb88a
+version: 359e091c0a83a45e20aefc13111ed4a19e201f97
 type: git_submodule
 homepage: https://github.com/Microsoft/TypeScript-TmLanguage
 license: mit