OWNERS File Syntax

Owner approval is based on OWNERS files located in the same repository and top of the merge-to branch of a patch set.

The syntax is:

lines      := (SPACE* line? SPACE* EOL)*
line       := "set" SPACE+ "noparent"
           |  "per-file" SPACE+ globs SPACE* "=" SPACE* directives
           |  comment
           |  directive
directives := directive (SPACE* "," SPACE* directive)*
directive  := email
           |  "*"
globs      := glob (SPACE* "," SPACE* glob)*
glob       := [a-zA-Z0-9_-*?.]+
comment    := "#" ANYCHAR*
email      := [^ @]+@[^ #]+
ANYCHAR    := any character but EOL
EOL        := end of line characters
SPACE      := any white space character

• per-file globs = directives applies each directive only to files matching any of the glob.

• A ‘glob’ does not contain directory path.

• The email addresses should belong to registered Gerrit users.

• The * directive means that no owner is specified for the directory or file. Any user can approve that directory or file.