occ LDAP update

[mmattel]

This PR is a bigger update of the occ ldap command set as it was a complete mess.

Fixes: #3901 (New LDAP command to invalidate the cache)

Merging when owncloud/user_ldap#681 (LDAP 0.16.0) is close to final.

When merged, the occ ldap command reference can safely be included in the ldap documentation when it gets revised.

Backport to 10.9 and 10.8

@jvillafanez fyi

[EParzefall]

Minor language improvements.

[jnweiger]

Some added details and precision.

[mmattel]

@jvillafanez info: the texts from the options and arguments are not freely written but come when you use --help and are printed to the screen. I am just copying that... In case you need a change, pls change the texts in the app - where I guess it is still time before a new release is out.

[jvillafanez]

Ok, got it. The first one (the search argument) has a different help message in the release: just "the search string (can be empty)", which seems lacking. That's why I thought the documentation would include some additional information. We can't write a wall of text in a help message.

For the second one, I don't think it's critical, so we can leave it as it is.

[mmattel]

That's why I thought the documentation would include some additional information.

Will do my very best (Dinner for One) 😅

[mmattel]

@jvillafanez mind to have a look at the search changes if they are ok to you (pls try to reword in case they are not...)

outdated

[mmattel]

It needs more clarification text with regards of multiple values when using ldap:set-config.
Will work on it asap (in this PR).

[mmattel]

The document is updated and contains now all changes and explanations.
You can view a rendered version here: https://github.com/owncloud/docs/blob/5b9717ec42666600fd41b74368c71fd16db135c1/modules/admin_manual/pages/configuration/server/occ_commands/app_commands/_ldap_integration_commands.adoc

@jvillafanez mind to have a final look on it before we merge?