[CM T0] update array tutorial

[markus2330]

for natural sorting (_ are not needed anymore)

https://www.libelektra.org/tutorials/arrays

see also #4249

[kodebach]

Probably best if we check all tutorials/docs and mark everything outdated with e.g. [Deprecated] in the title (since I doubt we have time to update everything).

[markus2330]

For 1.0 we should either update or remove. Before 1.0 it is enough to have issues that say that something is outdated/missing.

[kodebach]

For 1.0 we should either update or remove.

Of course, but...

Before 1.0 it is enough to have issues that say that something is outdated/missing.

... since people are still using Elektra before 1.0, we should probably mark outdated stuff inside the docs themselves and not hope they see the related issue.

[markus2330]

Ok, then let us add TODO marker? [Deprecated] sounds like that the thing the tutorial is about (like arrays) is out-of-date not that there are issues in the tutorial itself.

[lukashartl]

We ( @leothetryhard and @lukashartl ) would like to work on this issue.

• Should we go with TODO or DEPRECATED?
• What exactly do you mean with marker? Is this something out of Doxygen, or just a prefix in the header?
• Should we work through all the docs or just the mentioned array tutorial?

[markus2330]

If you want to work on the issue forget about TODO or DEPRECATED :wink: This was only for the case if nobody wants to update the tutorial.

The proper fix is to update the tutorial to the new array syntax (i.e. without leading underscores) and also explain that these underscores get added for arrays. In doc/KEYNAMES.md you can read about how the syntax currently is.

[markus2330]

Should we work through all the docs or just the mentioned array tutorial?

You probably will not spot what is outdated. Afaik the array tutorial is the only one that has a known problem.

But of course: if you go through some docu and spot a problem, please report.