fish shell tab completion program short description - howto?

Question

With fish shell there is (among many others) a nice feature that displays a short description of the possible commands, like that:

How can I write such a description for my own commands? Specifically I would like to do that for python console_scripts.

10x.

Answer 1

You can add such descriptions to your Fish functions, such as this example from VirtualFish's activate sub-command:

function __vf_activate --description "Activate a virtualenv"
    […]
end

You can see the resulting output when typing vf and then the Tab key: