Mercurial > public > mercurial-scm > hg-stable

comparison mercurial/help.py @ 21289:c3784e3c3e8d

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
help: suggest keyword search when no topic is found When `hg help foobar` fails, it now suggests using `hg help --keyword foobar` instead of printing a full page of basic commands. This should greatly increases discoverability of the `hg help --keyword` argument.
author Pierre-Yves David <pierre-yves.david@fb.com>
date Wed, 16 Apr 2014 19:55:40 -0400
parents eb6eaef7ae44
children 8225bb1f0ad3
comparison
equal deleted inserted replaced
21288:eb6eaef7ae44 21289:c3784e3c3e8d
484 if not rst: 484 if not rst:
485 msg = _('no matches') 485 msg = _('no matches')
486 hint = _('try "hg help" for a list of topics') 486 hint = _('try "hg help" for a list of topics')
487 raise util.Abort(msg, hint=hint) 487 raise util.Abort(msg, hint=hint)
488 elif name and name != 'shortlist': 488 elif name and name != 'shortlist':
489 i = None
490 if unknowncmd: 489 if unknowncmd:
491 queries = (helpextcmd,) 490 queries = (helpextcmd,)
492 elif opts.get('extension'): 491 elif opts.get('extension'):
493 queries = (helpext,) 492 queries = (helpext,)
494 elif opts.get('command'): 493 elif opts.get('command'):
496 else: 495 else:
497 queries = (helptopic, helpcmd, helpext, helpextcmd) 496 queries = (helptopic, helpcmd, helpext, helpextcmd)
498 for f in queries: 497 for f in queries:
499 try: 498 try:
500 rst = f(name) 499 rst = f(name)
501 i = None
502 break 500 break
503 except error.UnknownCommand, inst: 501 except error.UnknownCommand:
504 i = inst 502 pass
505 if i: 503 else:
506 raise i 504 if unknowncmd:
505 raise error.UnknownCommand(name)
506 else:
507 msg = _('no such help topic: %s') % name
508 hint = _('try "hg help --keyword %s"') % name
509 raise util.Abort(msg, hint=hint)
507 else: 510 else:
508 # program name 511 # program name
509 if not ui.quiet: 512 if not ui.quiet:
510 rst = [_("Mercurial Distributed SCM\n"), '\n'] 513 rst = [_("Mercurial Distributed SCM\n"), '\n']
511 rst.extend(helplist()) 514 rst.extend(helplist())