mercurial/commands.py

15202:0150741caace

            data.append((so, lo, desc))

        rst = minirst.maketable(data, 1)

        if multioccur:
            rst += _("\n[+] marked option can be specified multiple times")

        return rst

    # list all option lists
    def opttext(optlist, width):
        rst = ''
        if not optlist:
            return ''

        for title, options in optlist:
            rst += '\n%s\n\n' % title
            rst += optrst(options)
            rst += '\n'

        return '\n' + minirst.format(rst, width)

    def addglobalopts(optlist, aliases):
        if ui.quiet:

            else:
                msg = _('use "hg -v help %s" to show more info') % name
            optlist.append((msg, ()))

    def helpcmd(name):
        optlist = []
        try:
            aliases, entry = cmdutil.findcmd(name, table, strict=unknowncmd)
        except error.AmbiguousCommand, inst:
            # py3k fix: except vars can't be used outside the scope of the
            # except block, nor can be used inside a lambda. python issue4617

        if getattr(entry[0], 'badalias', False):
            if not unknowncmd:
                entry[0](ui)
            return

        # synopsis
        if len(entry) > 2:
            if entry[2].startswith('hg'):
                ui.write("%s\n" % entry[2])
            else:
                ui.write('hg %s %s\n' % (aliases[0], entry[2]))
        else:
            ui.write('hg %s\n' % aliases[0])

        # aliases
        if full and not ui.quiet and len(aliases) > 1:
            ui.write(_("\naliases: %s\n") % ', '.join(aliases[1:]))

        # description
        doc = gettext(entry[0].__doc__)
        if not doc:
            doc = _("(no help text available)")

                doc = _('shell alias for::\n\n    %s') % entry[0].definition[1:]
            else:
                doc = _('alias for: hg %s\n\n%s') % (entry[0].definition, doc)
        if ui.quiet or not full:
            doc = doc.splitlines()[0]
        keep = ui.verbose and ['verbose'] or []
        formatted, pruned = minirst.format(doc, textwidth, keep=keep)
        ui.write("\n%s" % formatted)

        if not ui.quiet:
            # options
            if entry[1]:
                optlist.append((_("options:\n"), entry[1]))

        # check if this command shadows a non-trivial (multi-line)
        # extension help text
        try:
            mod = extensions.find(name)
            doc = gettext(mod.__doc__) or ''
            if '\n' in doc.strip():
                msg = _('use "hg help -e %s" to show help for '
                        'the %s extension') % (name, name)
                ui.write('\n%s\n' % msg)
        except KeyError:
            pass

        addglobalopts(optlist, False)
        ui.write(opttext(optlist, textwidth))

    def helplist(select=None):
        # list of commands
        if name == "shortlist":
            header = _('basic commands:\n\n')

15203:c7ce651a6bc9

            data.append((so, lo, desc))

        rst = minirst.maketable(data, 1)

        if multioccur:
            rst += _("\n[+] marked option can be specified multiple times\n")

        return rst

    # list all option lists
    def opttext(optlist, width):
        rst = ''
        if not optlist:
            return ''

        for title, options in optlist:
            rst += '\n%s\n' % title
            if options:
                rst += "\n"
                rst += optrst(options)
                rst += '\n'

        return '\n' + minirst.format(rst, width)

    def addglobalopts(optlist, aliases):
        if ui.quiet:

            else:
                msg = _('use "hg -v help %s" to show more info') % name
            optlist.append((msg, ()))

    def helpcmd(name):
        try:
            aliases, entry = cmdutil.findcmd(name, table, strict=unknowncmd)
        except error.AmbiguousCommand, inst:
            # py3k fix: except vars can't be used outside the scope of the
            # except block, nor can be used inside a lambda. python issue4617

        if getattr(entry[0], 'badalias', False):
            if not unknowncmd:
                entry[0](ui)
            return

        rst = ""

        # synopsis
        if len(entry) > 2:
            if entry[2].startswith('hg'):
                rst += "%s\n" % entry[2]
            else:
                rst += 'hg %s %s\n' % (aliases[0], entry[2])
        else:
            rst += 'hg %s\n' % aliases[0]

        # aliases
        if full and not ui.quiet and len(aliases) > 1:
            rst += _("\naliases: %s\n") % ', '.join(aliases[1:])

        # description
        doc = gettext(entry[0].__doc__)
        if not doc:
            doc = _("(no help text available)")

                doc = _('shell alias for::\n\n    %s') % entry[0].definition[1:]
            else:
                doc = _('alias for: hg %s\n\n%s') % (entry[0].definition, doc)
        if ui.quiet or not full:
            doc = doc.splitlines()[0]
        rst += "\n" + doc + "\n"

        # check if this command shadows a non-trivial (multi-line)
        # extension help text
        try:
            mod = extensions.find(name)
            doc = gettext(mod.__doc__) or ''
            if '\n' in doc.strip():
                msg = _('use "hg help -e %s" to show help for '
                        'the %s extension') % (name, name)
                rst += '\n%s\n' % msg
        except KeyError:
            pass

        # options
        if not ui.quiet and entry[1]:
            rst += '\noptions:\n\n'
            rst += optrst(entry[1])

        if ui.verbose:
            rst += '\nglobal options:\n\n'
            rst += optrst(globalopts)

        keep = ui.verbose and ['verbose'] or []
        formatted, pruned = minirst.format(rst, textwidth, keep=keep)
        ui.write(formatted)

        if not ui.verbose:
            if not full:
                ui.write(_('\nuse "hg help %s" to show the full help text\n')
                           % name)
            elif not ui.quiet:
                ui.write(_('\nuse "hg -v help %s" to show more info\n') % name)


    def helplist(select=None):
        # list of commands
        if name == "shortlist":
            header = _('basic commands:\n\n')