PureBasic Forums - English

The german help for NewMap does not reflect the new behaviour of maps in PB 6.0

It is written:

Wenn ein neuer Schlüssel für eine Zuweisung verwendet wird, wird automatisch ein neues Element zur Map hinzugefügt.

This is now incomplete, since also a new element is created when an element is accessed in any way.

This is not a 'Zuweisung', but an element is created: Maybe this is a better description:

Wenn mit einem neuen Schlüssel auf eine Map zugegriffen wird (lesend oder schreibend), wird ein neues Element hinzugefügt.

Also the german help of AddMapElement() does not reflect the new behaviour.

Many people on this forum don't speak German, so it's much better to discuss anything related to the German language on the German PB forum.

Here is the official forum. Thus also for the error correction of the documentation for other languages.
Has always been like this

mk-soft wrote: Sat Sep 17, 2022 10:34 am Here is the official forum. Thus also for the error correction of the documentation for other languages.

Thus?
In the German forum, there are three threads especially for improving the German documentation, see <https://www.purebasic.fr/german/viewforum.php?f=20>.
It just dosn't make sense to discuss things specific to other languages on an English forum.
And Andre, who maintains the German documentation, is reading also on the German forum, of course.

Why wouldn't you want bugs posted here is beyond me...
Don't you want bugs to be widely known?
Are you actively looking for bugs in the german or russian forum? - no?
They kindly post here for the benefit of the PB-Team and the community as a whole.

Mijikai wrote: Sat Sep 17, 2022 11:25 am Why wouldn't you want bugs posted here is beyond me...
Don't you want bugs to be widely known?
Are you actively looking for bugs in the german or russian forum? - no?

I was not talking about bugs in general.
Is it too much to ask that you read exactly what I actually wrote?

Please people, calm down... it's weekend

It's of course the right way to post any bugs, even regarding the documentation, on the English forum.

And I can say you why: the German and French docs usually are 1:1 translations from the English docs. Mesa (for the French docs) and I try to avoid any translation errors. Almost all missing or 'better to be described' things affect the English docs too. So most of the time the English docs will be improved, and then the German and French docs too. And often there is needed some internal knowledge too, that's why the English forum (with participation of Fred) is the right place.

Specific to this topic: it will be checked (even for the other languages, especially the 'English source docs') and improved. So thanks for the report!

Suggestions how the docs can be improved (English and then German/French docs the same way):

1) NewMap - description:
Instead of the current description 'If a new key is used....'

When a map is accessed (read or write) with a non-existing key, a new item is added.

Maybe also an additional code example could show this behaviour. Anyone have a good one?

2) AddMapElement() - additional remark:

When a map is accessed (read or write) with a non-existing key, a new item is added.

Probably also Fred should have a look here, what he want to have included in the docs about this topic