Documentation and implementation of sidebar_short_path do not coincide

[whitney-cumber]

Expected Behaviour

The description of $sidebar_short_path and its actual effect should coincide.

Actual Behaviour

The description does not match its effect.

Steps to Reproduce

1. Create mailboxes

$ mkdir /tmp/testmails
$ mkdir /tmp/testmails/foo/{cur,tmp,new}

$ mkdir /tmp/testmails/foo.bar.baz
$ mkdir /tmp/testmails/foo.bar.baz{cur,tmp,new}

2. Create test neomuttrc

$ cat > /tmp/testneomuttrc
set folder=/tmp/testmails
mailboxes /tmp/testmails/foo
mailboxes /tmp/testmails/foo.bar.baz
set sidebar_visible
set sidebar_short_path

3. Start Neomutt neomutt -F /tmp/testneomuttrc

4. Observe that the mailboxes are listed as foo and baz

The documentation in neomuttrc states:

Setting sidebar_shortpath=yes will shorten the names relative to the previous name.

So I expect it to be foo and bar/baz as the previous mailbox name is foo and not foo/bar.

How often does this happen?

• Always

When did it start to happen?

When I enabled $sidebar_short_path

NeoMutt Version

20220429

Extra Info

If it is concluded that the documentation needs to be adapted, I'm willing to provide an draft/PR.

Personally I find the documented behaviour to be the better one as it does not require to insert a dummy mailbox foo/bar when using indention in the sidebar.

Compare:

foo
  bar.baz

vs

foo
  bar
    baz