From fea5d7c6128e8df8bbeff1fb082c663a6ace8111 Mon Sep 17 00:00:00 2001
From: Benno Schulenberg <bensberg@telfort.nl>
Date: Mon, 20 Apr 2020 19:15:43 +0200
Subject: [PATCH] syntaxes: uniformize the initial comment

---
 syntax/asm.nanorc        | 2 +-
 syntax/autoconf.nanorc   | 2 +-
 syntax/awk.nanorc        | 2 +-
 syntax/c.nanorc          | 2 +-
 syntax/changelog.nanorc  | 2 +-
 syntax/css.nanorc        | 2 +-
 syntax/default.nanorc    | 2 +-
 syntax/elisp.nanorc      | 2 +-
 syntax/fortran.nanorc    | 4 ++--
 syntax/go.nanorc         | 2 +-
 syntax/groff.nanorc      | 2 +-
 syntax/guile.nanorc      | 2 +-
 syntax/html.nanorc       | 2 +-
 syntax/java.nanorc       | 2 +-
 syntax/json.nanorc       | 5 ++---
 syntax/lua.nanorc        | 6 +++---
 syntax/makefile.nanorc   | 2 +-
 syntax/nanorc.nanorc     | 2 +-
 syntax/nftables.nanorc   | 2 +-
 syntax/objc.nanorc       | 2 +-
 syntax/patch.nanorc      | 2 +-
 syntax/perl.nanorc       | 2 +-
 syntax/php.nanorc        | 2 +-
 syntax/po.nanorc         | 2 +-
 syntax/postgresql.nanorc | 2 +-
 syntax/pov.nanorc        | 2 +-
 syntax/python.nanorc     | 2 +-
 syntax/ruby.nanorc       | 5 +++--
 syntax/rust.nanorc       | 3 +--
 syntax/sh.nanorc         | 2 +-
 syntax/tex.nanorc        | 2 +-
 syntax/texinfo.nanorc    | 2 +-
 syntax/xml.nanorc        | 2 +-
 33 files changed, 39 insertions(+), 40 deletions(-)

diff --git a/syntax/asm.nanorc b/syntax/asm.nanorc
index d85226c6..525dd100 100644
--- a/syntax/asm.nanorc
+++ b/syntax/asm.nanorc
@@ -1,4 +1,4 @@
-## Here is an example for assembler.
+## Syntax highlighting for assembler.
 
 syntax asm "\.(S|s|asm)$"
 magic "assembler source"
diff --git a/syntax/autoconf.nanorc b/syntax/autoconf.nanorc
index a5e839fc..6c80d0c9 100644
--- a/syntax/autoconf.nanorc
+++ b/syntax/autoconf.nanorc
@@ -1,4 +1,4 @@
-## Here is an example for Autoconf.
+## Syntax highlighting for Autoconf.
 
 syntax autoconf "\.(ac|m4)$"
 comment "#"
diff --git a/syntax/awk.nanorc b/syntax/awk.nanorc
index 1e4569ec..b9771bfd 100644
--- a/syntax/awk.nanorc
+++ b/syntax/awk.nanorc
@@ -1,4 +1,4 @@
-## Here is an example for awk.
+## Syntax highlighting for AWK scripts.
 
 syntax awk "\.awk$"
 header "^#!.*awk"
diff --git a/syntax/c.nanorc b/syntax/c.nanorc
index c8c7259b..58c97d12 100644
--- a/syntax/c.nanorc
+++ b/syntax/c.nanorc
@@ -1,4 +1,4 @@
-## Here is an example for C/C++.
+## Syntax highlighting for C and C++ files.
 
 syntax c "\.([ch](pp|xx)?|C|cc|c\+\+|cu|H|hh|ii?)$"
 header "-\*-.*\<C(\+\+)?((;|\s).*)?-\*-"
diff --git a/syntax/changelog.nanorc b/syntax/changelog.nanorc
index bf442425..268479e0 100644
--- a/syntax/changelog.nanorc
+++ b/syntax/changelog.nanorc
@@ -1,4 +1,4 @@
-## Colouring for Changelogs.
+## Syntax highlighting for Changelogs.
 
 syntax changelog "Change[Ll]og[^/]*$"
 
diff --git a/syntax/css.nanorc b/syntax/css.nanorc
index 27801640..2900252e 100644
--- a/syntax/css.nanorc
+++ b/syntax/css.nanorc
@@ -1,4 +1,4 @@
-## Here is an example for CSS files.
+## Syntax highlighting for CSS files.
 
 syntax css "\.css$"
 comment "/*|*/"
diff --git a/syntax/default.nanorc b/syntax/default.nanorc
index c481e011..525d38a8 100644
--- a/syntax/default.nanorc
+++ b/syntax/default.nanorc
@@ -1,4 +1,4 @@
-## An example of a default syntax.  The default syntax is used for
+## This is an example of a default syntax.  The default syntax is used for
 ## files that do not match any other syntax.
 
 syntax default
diff --git a/syntax/elisp.nanorc b/syntax/elisp.nanorc
index 0622bd69..409c1f44 100644
--- a/syntax/elisp.nanorc
+++ b/syntax/elisp.nanorc
@@ -1,4 +1,4 @@
-## Here is an example for Emacs Lisp.
+## Syntax highlighting for Emacs Lisp.
 
 syntax elisp "\.el$"
 magic "Lisp/Scheme program"
diff --git a/syntax/fortran.nanorc b/syntax/fortran.nanorc
index fb2ff0b9..7704ab92 100644
--- a/syntax/fortran.nanorc
+++ b/syntax/fortran.nanorc
@@ -1,6 +1,6 @@
-## Here is an example for Fortran 90/95.
+## Syntax highlighting for Fortran 90/95.
 
-syntax fortran "\.(f|f90|f95)$"
+syntax fortran "\.(f|for|f90|f95)$"
 comment "!"
 
 color red "\<[0-9]+\>"
diff --git a/syntax/go.nanorc b/syntax/go.nanorc
index 03f3d673..c8fb2bb2 100644
--- a/syntax/go.nanorc
+++ b/syntax/go.nanorc
@@ -1,4 +1,4 @@
-## Here is an example for Go.
+## Syntax highlighting for Go.
 
 syntax go "\.go$"
 comment "//"
diff --git a/syntax/groff.nanorc b/syntax/groff.nanorc
index a24c40bd..59bd7c32 100644
--- a/syntax/groff.nanorc
+++ b/syntax/groff.nanorc
@@ -1,4 +1,4 @@
-## Here is an example for groff.
+## Syntax highlighting for groff.
 
 syntax groff "(/tmac\.[^/]+$|\.(m[ems]|rof|tmac)$)"
 comment ".\""
diff --git a/syntax/guile.nanorc b/syntax/guile.nanorc
index c7db3ded..0997130a 100644
--- a/syntax/guile.nanorc
+++ b/syntax/guile.nanorc
@@ -1,4 +1,4 @@
-## Here is an example for Guile Scheme.
+## Syntax highlighting for Guile Scheme.
 
 syntax guile "\.scm$"
 header "^#!.*guile"
diff --git a/syntax/html.nanorc b/syntax/html.nanorc
index 6916b6a7..d34fe5a9 100644
--- a/syntax/html.nanorc
+++ b/syntax/html.nanorc
@@ -1,4 +1,4 @@
-## Here is an example for HTML.
+## Syntax highlighting for HTML.
 
 syntax html "\.html?$"
 magic "HTML document"
diff --git a/syntax/java.nanorc b/syntax/java.nanorc
index 5bb294f4..e431b6d7 100644
--- a/syntax/java.nanorc
+++ b/syntax/java.nanorc
@@ -1,4 +1,4 @@
-## Here is an example for Java.
+## Syntax highlighting for Java.
 
 syntax java "\.java$"
 magic "Java "
diff --git a/syntax/json.nanorc b/syntax/json.nanorc
index 185c08f3..d25a788e 100644
--- a/syntax/json.nanorc
+++ b/syntax/json.nanorc
@@ -1,8 +1,7 @@
 ## Syntax highlighting for JSON files.
 
-# See:  http://www.json.org/
-# Original author:  Aapo Rantalainen
-# License:  GPLv3 or newer
+## Original author:  Aapo Rantalainen
+## License:  GPL version 3 or newer
 
 syntax json "\.json$"
 # No comments are permitted in JSON.
diff --git a/syntax/lua.nanorc b/syntax/lua.nanorc
index d0e93c56..e7e3ac16 100644
--- a/syntax/lua.nanorc
+++ b/syntax/lua.nanorc
@@ -1,7 +1,7 @@
 ## Syntax highlighting for Lua.
-#
-## Original author:  Matthew Wild <mwild1 (at) gmail.com>
-## License: GPL 3 or later
+
+## Original author:  Matthew Wild
+## License:  GPL version 3 or newer
 
 syntax lua "\.lua$"
 magic "Lua script"
diff --git a/syntax/makefile.nanorc b/syntax/makefile.nanorc
index a1c116c0..c1f487ff 100644
--- a/syntax/makefile.nanorc
+++ b/syntax/makefile.nanorc
@@ -1,4 +1,4 @@
-## Here is an example for Makefiles.
+## Syntax highlighting for Makefiles.
 
 syntax makefile "(/((GNU)?m|M)akefile[^/]*$|\.(make|mk)$)"
 magic "makefile script"
diff --git a/syntax/nanorc.nanorc b/syntax/nanorc.nanorc
index ea982096..de147787 100644
--- a/syntax/nanorc.nanorc
+++ b/syntax/nanorc.nanorc
@@ -1,4 +1,4 @@
-## Here is an example for nanorc files.
+## Syntax highlighting for nanorc files.
 
 syntax nanorc "\.?nanorc$"
 comment "#"
diff --git a/syntax/nftables.nanorc b/syntax/nftables.nanorc
index 328f31ef..443387bd 100644
--- a/syntax/nftables.nanorc
+++ b/syntax/nftables.nanorc
@@ -1,4 +1,4 @@
-## Here is an example for nftables.
+## Syntax highlighting for the packet-filtering rules of Netfilter.
 
 syntax nftables "\.(nft|nftables)$"
 header "^#!.*(nft|nftables)"
diff --git a/syntax/objc.nanorc b/syntax/objc.nanorc
index 7fb0bd72..0f6dc6b3 100644
--- a/syntax/objc.nanorc
+++ b/syntax/objc.nanorc
@@ -1,4 +1,4 @@
-## Here is an example for C/C++/Obj-C.
+## Syntax highlighting for C/C++/Obj-C files.
 
 syntax m "\.m$"
 magic "Objective-C source"
diff --git a/syntax/patch.nanorc b/syntax/patch.nanorc
index 8d9e0aa9..13bbb5a0 100644
--- a/syntax/patch.nanorc
+++ b/syntax/patch.nanorc
@@ -1,4 +1,4 @@
-## Here is an example for patch files.
+## Syntax highlighting for patch and diff files.
 
 syntax patch "\.(patch|diff|debdiff)$"
 magic "diff output"
diff --git a/syntax/perl.nanorc b/syntax/perl.nanorc
index f5657ae6..1457d7db 100644
--- a/syntax/perl.nanorc
+++ b/syntax/perl.nanorc
@@ -1,4 +1,4 @@
-## Here is an example for Perl.
+## Syntax highlighting for Perl.
 
 syntax perl "\.p[lm]$"
 header "^#!.*perl"
diff --git a/syntax/php.nanorc b/syntax/php.nanorc
index 1a61f066..668b9d3a 100644
--- a/syntax/php.nanorc
+++ b/syntax/php.nanorc
@@ -1,4 +1,4 @@
-## Here is an example for PHP.
+## Syntax highlighting for PHP.
 
 syntax php "\.(php[23457s~]?|phtml|ctp)$"
 magic "PHP script"
diff --git a/syntax/po.nanorc b/syntax/po.nanorc
index ecbfb7db..19000959 100644
--- a/syntax/po.nanorc
+++ b/syntax/po.nanorc
@@ -1,4 +1,4 @@
-## Colouring for PO files.
+## Syntax highlighting for PO files.
 
 syntax po "\.pot?$"
 comment "#"
diff --git a/syntax/postgresql.nanorc b/syntax/postgresql.nanorc
index d90344a7..eee38e45 100644
--- a/syntax/postgresql.nanorc
+++ b/syntax/postgresql.nanorc
@@ -1,4 +1,4 @@
-## Here is an example for PostgreSQL.
+## Syntax highlighting for Postgres SQL scripts.
 
 syntax sql "\.sql[2345s~]?$"
 comment "-- "
diff --git a/syntax/pov.nanorc b/syntax/pov.nanorc
index ad1e4e7c..dbf99d2f 100644
--- a/syntax/pov.nanorc
+++ b/syntax/pov.nanorc
@@ -1,4 +1,4 @@
-## Here is an example for POV-Ray.
+## Syntax highlighting for POV-Ray files.
 
 syntax pov "\.(pov|POV|povray|POVRAY)$"
 comment "//"
diff --git a/syntax/python.nanorc b/syntax/python.nanorc
index 7b9fe8bb..10147456 100644
--- a/syntax/python.nanorc
+++ b/syntax/python.nanorc
@@ -1,4 +1,4 @@
-## Here is an example for Python.
+## Syntax highlighting for Python.
 
 syntax python "\.py$"
 header "^#!.*python"
diff --git a/syntax/ruby.nanorc b/syntax/ruby.nanorc
index bff07fc2..2b742c6c 100644
--- a/syntax/ruby.nanorc
+++ b/syntax/ruby.nanorc
@@ -1,11 +1,12 @@
-## Here is an example for Ruby.
+## Syntax highlighting for Ruby.
 
 syntax ruby "\.rb$"
 header "^#!.*ruby"
 magic "Ruby script"
-linter ruby -w -c
 comment "#"
 
+linter ruby -w -c
+
 # Constants.
 color brightblue "\<[A-Z]+[0-9A-Z_a-z]*|(\$|@|@@)[0-9A-Z_a-z]+"
 # Reserved words.
diff --git a/syntax/rust.nanorc b/syntax/rust.nanorc
index 694269df..a1fef8f0 100644
--- a/syntax/rust.nanorc
+++ b/syntax/rust.nanorc
@@ -1,9 +1,8 @@
 ## Syntax highlighting for Rust.
+
 ## Copyright 2015 Luke Francl.
 ## Licensed under GPL version 3.
 
-## NOTE: Rules are applied in order: later rules re-colorize matching text.
-
 syntax rust "\.(rlib|rs)$"
 comment "//"
 
diff --git a/syntax/sh.nanorc b/syntax/sh.nanorc
index eabc394d..2a8abb32 100644
--- a/syntax/sh.nanorc
+++ b/syntax/sh.nanorc
@@ -1,4 +1,4 @@
-## Here is an example for Bourne shell scripts.
+## Syntax highlighting for Bourne shell scripts.
 
 syntax sh "(\.sh|(\.|/)(a|ba|c|da|k|mk|pdk|tc|z)sh(rc|_profile)?|/(etc/|\.)profile)$"
 header "^#!.*/(((a|ba|c|da|k|mk|pdk|tc|z)?sh)|(busybox|env) +sh|openrc-run|runscript)"
diff --git a/syntax/tex.nanorc b/syntax/tex.nanorc
index de611fcf..30bbd372 100644
--- a/syntax/tex.nanorc
+++ b/syntax/tex.nanorc
@@ -1,4 +1,4 @@
-## Here is a short example for TeX files.
+## Syntax highlighting for TeX files.
 
 syntax tex "\.tex$"
 magic "(La)?TeX document"
diff --git a/syntax/texinfo.nanorc b/syntax/texinfo.nanorc
index 2b8251be..e0080b96 100644
--- a/syntax/texinfo.nanorc
+++ b/syntax/texinfo.nanorc
@@ -1,4 +1,4 @@
-## Here is an example for Texinfo files.
+## Syntax highlighting for Texinfo files.
 
 syntax texinfo "\.texi$"
 header "^\\input texinfo"
diff --git a/syntax/xml.nanorc b/syntax/xml.nanorc
index c13c5ebc..212b2c15 100644
--- a/syntax/xml.nanorc
+++ b/syntax/xml.nanorc
@@ -1,4 +1,4 @@
-## Here is an example for XML files.
+## Syntax highlighting for XML files.
 
 syntax xml "\.([jrsx]html?|jnlp|mml|pom|rng|sgml?|svg|w[as]dl|wsdd|xjb|xml|xs(d|lt?)|xul)$"
 header "<\?xml.*version=.*\?>"