German help for NewMap (PB 6.0)

Found an issue in the documentation ? Please report it here !

Moderator: Documentation Editors

infratec
Always Here
Always Here
Posts: 6817
Joined: Sun Sep 07, 2008 12:45 pm
Location: Germany

German help for NewMap (PB 6.0)

Post by infratec »

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:

Code: Select all

Debug TestMap("test")
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.
Last edited by infratec on Sat Sep 17, 2022 10:51 am, edited 1 time in total.
Little John
Addict
Addict
Posts: 4519
Joined: Thu Jun 07, 2007 3:25 pm
Location: Berlin, Germany

Re: German help for NewMap (PB 6.0)

Post by Little John »

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.
User avatar
mk-soft
Always Here
Always Here
Posts: 5333
Joined: Fri May 12, 2006 6:51 pm
Location: Germany

Re: German help for NewMap (PB 6.0)

Post by mk-soft »

Here is the official forum. Thus also for the error correction of the documentation for other languages.
Has always been like this
My Projects ThreadToGUI / OOP-BaseClass / EventDesigner V3
PB v3.30 / v5.75 - OS Mac Mini OSX 10.xx - VM Window Pro / Linux Ubuntu
Downloads on my Webspace / OneDrive
Little John
Addict
Addict
Posts: 4519
Joined: Thu Jun 07, 2007 3:25 pm
Location: Berlin, Germany

Re: German help for NewMap (PB 6.0)

Post by Little John »

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.
User avatar
Mijikai
Addict
Addict
Posts: 1360
Joined: Sun Sep 11, 2016 2:17 pm

Re: German help for NewMap (PB 6.0)

Post by Mijikai »

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.
Little John
Addict
Addict
Posts: 4519
Joined: Thu Jun 07, 2007 3:25 pm
Location: Berlin, Germany

Re: German help for NewMap (PB 6.0)

Post by Little John »

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?
User avatar
Andre
PureBasic Team
PureBasic Team
Posts: 2056
Joined: Fri Apr 25, 2003 6:14 pm
Location: Germany (Saxony, Deutscheinsiedel)
Contact:

Re: German help for NewMap (PB 6.0)

Post by Andre »

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! :D
Bye,
...André
(PureBasicTeam::Docs & Support - PureArea.net | Order:: PureBasic | PureVisionXP)
User avatar
Andre
PureBasic Team
PureBasic Team
Posts: 2056
Joined: Fri Apr 25, 2003 6:14 pm
Location: Germany (Saxony, Deutscheinsiedel)
Contact:

Re: German help for NewMap (PB 6.0)

Post by Andre »

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 8)
Bye,
...André
(PureBasicTeam::Docs & Support - PureArea.net | Order:: PureBasic | PureVisionXP)
Post Reply