Bash case syntax - meaning of "-@"

Question

I'm not familiar with the semantics of the "-@" in the bash script snippet below, which is from /etc/bash_completion.d/subversion. I'm trying to understand why bash reports "syntax error near unexpected token '(' on this line, I have two questions:

1. What is "-@()" expected to do here?

2. Why might bash be unhappy with this statement?

   case $prev in
                   # other cases omitted
       -@(F|-file|-targets))
           _filedir
           return 0;
           ;;
                   # other cases omitted
           esac
   

Answer 1

The '@(...)' here is part of Bash's pattern matching syntax. It's an "or", it simply matches one of the listed patterns, separated by pipe characters.

The initial dash has simply been factored out of the expression; "-@(a|b|c)" is the same as "@(-a|-b|-c)", but shorter.

As pointed out by a commenter (thanks!) this requires Bash's extglob enabled to work. This is done like so:

shopt -s extglob

You can check if you already have it enabled like this:

shopt extglob

Answer 2

I've found the answer to the second part of my question, which is that in order for the "@(...)" to be enabled, the "extglob" shell option needs to be on. Executing:

shopt -s extglob

before executing the script eliminates the error.