Maintainers.txt: update for filesystem area descriptions

Add comment describing new F: and X: tags for associating maintainership
sections with specific filesystem paths, including wildcards.

Add global section associating *all* code with devel@edk2.groups.io,
with a default '*' F: tag directing all modifications that do not hit a
rule to the stewards.

Also tag all files in top directory as maintained by the stewards.

Signed-off-by: Leif Lindholm <leif.lindholm@linaro.org>
Reviewed-by: Philippe Mathieu-Daude <philmd@redhat.com>
Tested-by: Philippe Mathieu-Daude <philmd@redhat.com>
Reviewed-by: Laszlo Ersek <lersek@redhat.com>

diff --git a/Maintainers.txt b/Maintainers.txt
index eb41dba7b128fdd2ea9a58a26f7027d475e57d62..3102b16b2f0689218d34adad23c86db97ff00ba7 100644 (file)
--- a/Maintainers.txt
+++ b/Maintainers.txt
@@ -36,6 +36,22 @@ Descriptions of section entries:
      Obsolete:   Old code. Something tagged obsolete generally means\r
                  it has been replaced by a better system and you\r
                  should be using that.\r
+  F: Files and directories with wildcard patterns.\r
+     A trailing slash includes all files and subdirectory files.\r
+     F:   MdeModulePkg/   all files in and below MdeModulePkg\r
+     F:   MdeModulePkg/*  all files in MdeModulePkg, but not below\r
+     F:   */Pci/*         all files in a directory called Pci, at any depth in\r
+                          the hierarchy, but not below\r
+     One pattern per line.  Multiple F: lines per section acceptable.\r
+  X: Files and directories that are NOT maintained, same rules as F:\r
+     Files exclusions are tested after file matches.\r
+     Can be useful for excluding a specific subdirectory, for instance:\r
+     F:   NetworkPkg/\r
+     X:   NetworkPkg/Ip6Dxe/\r
+     matches all files in and below NetworkPkg excluding NetworkPkg/Ip6Dxe/\r
+  Filenames not caught by any F: rule get matched as being located in the top-\r
+  level directory. (Internally, the script looks for a match called '<default>',\r
+  so please don't add a file called that in the top-level directory.)\r
 \r
 EDK II\r
 ------\r
@@ -44,8 +60,14 @@ L: https://edk2.groups.io/g/devel/
 T: git - https://github.com/tianocore/edk2.git\r
 T: git (mirror) - https://bitbucket.org/tianocore/edk2.git\r
 \r
+All patches CC:d here\r
+L: devel@edk2.groups.io\r
+F: *\r
+F: */\r
+\r
 Tianocore Stewards\r
 ------------------\r
+F: *\r
 M: Andrew Fish <afish@apple.com>\r
 M: Laszlo Ersek <lersek@redhat.com>\r
 M: Leif Lindholm <leif.lindholm@linaro.org>\r
@@ -63,16 +85,19 @@ M: Liming Gao <liming.gao@intel.com>
 EDK II Packages:\r
 ----------------\r
 ArmPkg\r
+F: ArmPkg/\r
 W: https://github.com/tianocore/tianocore.github.io/wiki/ArmPkg\r
 M: Leif Lindholm <leif.lindholm@linaro.org>\r
 M: Ard Biesheuvel <ard.biesheuvel@linaro.org>\r
 \r
 ArmPlatformPkg\r
+F: ArmPlatformPkg/\r
 W: https://github.com/tianocore/tianocore.github.io/wiki/ArmPlatformPkg\r
 M: Leif Lindholm <leif.lindholm@linaro.org>\r
 M: Ard Biesheuvel <ard.biesheuvel@linaro.org>\r
 \r
 ArmVirtPkg\r
+F: ArmVirtPkg/\r
 W: https://github.com/tianocore/tianocore.github.io/wiki/ArmVirtPkg\r
 M: Laszlo Ersek <lersek@redhat.com>\r
 M: Ard Biesheuvel <ard.biesheuvel@linaro.org>\r
@@ -81,26 +106,31 @@ R: Julien Grall <julien.grall@arm.com>
 R: Leif Lindholm <leif.lindholm@linaro.org>\r
 \r
 BaseTools\r
+F: BaseTools/\r
 W: https://github.com/tianocore/tianocore.github.io/wiki/BaseTools\r
 M: Bob Feng <bob.c.feng@intel.com>\r
 M: Liming Gao <liming.gao@intel.com>\r
 \r
 CryptoPkg\r
+F: CryptoPkg/\r
 W: https://github.com/tianocore/tianocore.github.io/wiki/CryptoPkg\r
 M: Jian Wang <jian.j.wang@intel.com>\r
 R: Ting Ye <ting.ye@intel.com>\r
 \r
 DynamicTablesPkg\r
+F: DynamicTablesPkg/\r
 W: https://github.com/tianocore/tianocore.github.io/wiki/DynamicTablesPkg\r
 M: Sami Mujawar <Sami.Mujawar@arm.com>\r
 M: Alexei Fedorov <Alexei.Fedorov@arm.com>\r
 \r
 EmbeddedPkg\r
+F: EmbeddedPkg/\r
 W: https://github.com/tianocore/tianocore.github.io/wiki/EmbeddedPkg\r
 M: Leif Lindholm <leif.lindholm@linaro.org>\r
 M: Ard Biesheuvel <ard.biesheuvel@linaro.org>\r
 \r
 EmulatorPkg\r
+F: EmulatorPkg/\r
 W: https://github.com/tianocore/tianocore.github.io/wiki/EmulatorPkg\r
 M: Jordan Justen <jordan.l.justen@intel.com>\r
 M: Andrew Fish <afish@apple.com>\r
@@ -108,29 +138,34 @@ M: Ray Ni <ray.ni@intel.com>
 S: Maintained\r
 \r
 FatPkg\r
+F: FatPkg/\r
 W: https://github.com/tianocore/tianocore.github.io/wiki/Edk2-fat-driver\r
 M: Ray Ni <ray.ni@intel.com>\r
 T: svn - https://svn.code.sf.net/p/edk2-fatdriver2/code/trunk/EnhancedFat\r
 T: git - https://github.com/tianocore/edk2-FatPkg.git\r
 \r
 FmpDevicePkg\r
+F: FmpDevicePkg/\r
 W: https://github.com/tianocore/tianocore.github.io/wiki/FmpDevicePkg\r
 M: Liming Gao <liming.gao@intel.com>\r
 M: Michael D Kinney <michael.d.kinney@intel.com>\r
 \r
 IntelFsp2Pkg\r
+F: IntelFsp2Pkg/\r
 W: https://github.com/tianocore/tianocore.github.io/wiki/IntelFsp2Pkg\r
 M: Chasel Chiu <chasel.chiu@intel.com>\r
 R: Nate DeSimone <nathaniel.l.desimone@intel.com>\r
 R: Star Zeng <star.zeng@intel.com>\r
 \r
 IntelFsp2WrapperPkg\r
+F: IntelFsp2WrapperPkg/\r
 W: https://github.com/tianocore/tianocore.github.io/wiki/IntelFsp2WrapperPkg\r
 M: Chasel Chiu <chasel.chiu@intel.com>\r
 R: Nate DeSimone <nathaniel.l.desimone@intel.com>\r
 R: Star Zeng <star.zeng@intel.com>\r
 \r
 MdeModulePkg\r
+F: MdeModulePkg/\r
 W: https://github.com/tianocore/tianocore.github.io/wiki/MdeModulePkg\r
 M: Jian J Wang <jian.j.wang@intel.com>\r
 M: Hao A Wu <hao.a.wu@intel.com>\r
@@ -140,16 +175,19 @@ R: Ray Ni <ray.ni@intel.com>
 R: Star Zeng <star.zeng@intel.com>\r
 \r
 MdePkg\r
+F: MdePkg/\r
 W: https://github.com/tianocore/tianocore.github.io/wiki/MdePkg\r
 M: Michael D Kinney <michael.d.kinney@intel.com>\r
 M: Liming Gao <liming.gao@intel.com>\r
 \r
 NetworkPkg\r
+F: NetworkPkg/\r
 W: https://github.com/tianocore/tianocore.github.io/wiki/NetworkPkg\r
 M: Siyuan Fu <siyuan.fu@intel.com>\r
 M: Jiaxin Wu <jiaxin.wu@intel.com>\r
 \r
 OvmfPkg\r
+F: OvmfPkg/\r
 W: http://www.tianocore.org/ovmf/\r
 M: Jordan Justen <jordan.l.justen@intel.com>\r
 M: Laszlo Ersek <lersek@redhat.com>\r
@@ -167,16 +205,19 @@ R: David Woodhouse <dwmw2@infradead.org>
 S: Maintained\r
 \r
 PcAtChipsetPkg\r
+F: PcAtChipsetPkg/\r
 W: https://github.com/tianocore/tianocore.github.io/wiki/PcAtChipsetPkg\r
 M: Ray Ni <ray.ni@intel.com>\r
 \r
 SecurityPkg\r
+F: SecurityPkg/\r
 W: https://github.com/tianocore/tianocore.github.io/wiki/SecurityPkg\r
 M: Jiewen Yao <jiewen.yao@intel.com>\r
 M: Jian Wang <jian.j.wang@intel.com>\r
 R: Chao Zhang <chao.b.zhang@intel.com>\r
 \r
 ShellPkg\r
+F: ShellPkg/\r
 W: https://github.com/tianocore/tianocore.github.io/wiki/ShellPkg\r
 M: Jaben Carsey <jaben.carsey@intel.com>\r
 M: Ray Ni <ray.ni@intel.com>\r
@@ -190,21 +231,25 @@ M: Leif Lindholm <leif.lindholm@linaro.org>   (ARM/AArch64)
 M: Ard Biesheuvel <ard.biesheuvel@linaro.org> (ARM/AArch64)\r
 \r
 SignedCapsulePkg\r
+F: SignedCapsulePkg/\r
 W: https://github.com/tianocore/tianocore.github.io/wiki/SignedCapsulePkg\r
 M: Jiewen Yao <jiewen.yao@intel.com>\r
 M: Chao Zhang <chao.b.zhang@intel.com>\r
 \r
 SourceLevelDebugPkg\r
+F: SourceLevelDebugPkg/\r
 W: https://github.com/tianocore/tianocore.github.io/wiki/SourceLevelDebugPkg\r
 M: Hao A Wu <hao.a.wu@intel.com>\r
 \r
 UefiCpuPkg\r
+F: UefiCpuPkg/\r
 W: https://github.com/tianocore/tianocore.github.io/wiki/UefiCpuPkg\r
 M: Eric Dong <eric.dong@intel.com>\r
 M: Ray Ni <ray.ni@intel.com>\r
 R: Laszlo Ersek <lersek@redhat.com>\r
 \r
 UefiPayloadPkg\r
+F: UefiPayloadPkg/\r
 W: https://github.com/tianocore/tianocore.github.io/wiki/UefiPayloadPkg\r
 M: Maurice Ma <maurice.ma@intel.com>\r
 M: Guo Dong <guo.dong@intel.com>\r
@@ -212,6 +257,7 @@ M: Benjamin You <benjamin.you@intel.com>
 S: Maintained\r
 \r
 StandaloneMmPkg\r
+F: StandaloneMmPkg/\r
 M: Achin Gupta <achin.gupta@arm.com>\r
 M: Jiewen Yao <jiewen.yao@intel.com>\r
 R: Supreeth Venkatesh <supreeth.venkatesh@arm.com>\r