3337 def command(table):

  3338 command = registrar.command

  3338     """Returns a function object to be used as a decorator for making commands.

  3339 

  3340     This function receives a command table as its argument. The table should

  3341     be a dict.

  3342 

  3343     The returned function can be used as a decorator for adding commands

  3344     to that command table. This function accepts multiple arguments to define

  3345     a command.

  3346 

  3347     The first argument is the command name.

  3348 

  3349     The options argument is an iterable of tuples defining command arguments.

  3350     See ``mercurial.fancyopts.fancyopts()`` for the format of each tuple.

  3351 

  3352     The synopsis argument defines a short, one line summary of how to use the

  3353     command. This shows up in the help output.

  3354 

  3355     The norepo argument defines whether the command does not require a

  3356     local repository. Most commands operate against a repository, thus the

  3357     default is False.

  3358 

  3359     The optionalrepo argument defines whether the command optionally requires

  3360     a local repository.

  3361 

  3362     The inferrepo argument defines whether to try to find a repository from the

  3363     command line arguments. If True, arguments will be examined for potential

  3364     repository locations. See ``findrepo()``. If a repository is found, it

  3365     will be used.

  3366     """

  3367     def cmd(name, options=(), synopsis=None, norepo=False, optionalrepo=False,

  3368             inferrepo=False):

  3369         def decorator(func):

  3370             func.norepo = norepo

  3371             func.optionalrepo = optionalrepo

  3372             func.inferrepo = inferrepo

  3373             if synopsis:

  3374                 table[name] = func, list(options), synopsis

  3375             else:

  3376                 table[name] = func, list(options)

  3377             return func

  3378         return decorator

  3379 

  3380     return cmd