PureBasic Docs - Errors & needed improvements to the man

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

Moderator: Documentation Editors

Marlin
Enthusiast
Enthusiast
Posts: 406
Joined: Sun Sep 17, 2006 1:24 pm
Location: Germany

Re: PureBasic Docs - Errors & needed improvements to the man

Post by Marlin »

I believe, I got what you meant now, but I still find this
help wrote:(The drag source is responsible for removing the original data)
confusing.

Who would ever asume, that the code in the target app would or should
bypass the code in the source application and do something in the other app :?:

If source and target are the same application, there is nothing, that would prevent
the target to be able to do the cleanup (a tiny bit earlier) than the source (after DragXXX) could do.
The programmer can decide this as he pleases.
freak
PureBasic Team
PureBasic Team
Posts: 5929
Joined: Fri Apr 25, 2003 5:21 pm
Location: Germany

Re: PureBasic Docs - Errors & needed improvements to the man

Post by freak »

Marlin wrote:I believe, I got what you meant now, but I still find this
help wrote:(The drag source is responsible for removing the original data)
confusing.

Who would ever asume, that the code in the target app would or should
bypass the code in the source application and do something in the other app :?:
This is how a "move" works:
- source initiates the drag & drop
- when successful, target copies the data from source
- when successful, source deletes the data

I don't see what is so confusing about this. If you ignore the case of files, this is the only way this could work, as the target program cannot delete data in the source program.
Marlin wrote:If source and target are the same application, there is nothing, that would prevent
the target to be able to do the cleanup (a tiny bit earlier) than the source (after DragXXX) could do.
The programmer can decide this as he pleases.
But this is generally not the case. If you drag text for example, you can never assume that the user only drops it within your own program. If you want that, you have to use DragPrivate() which is meant for this. All other formats work between programs by default.
quidquid Latine dictum sit altum videtur
User avatar
luis
Addict
Addict
Posts: 3876
Joined: Wed Aug 31, 2005 11:09 pm
Location: Italy

Re: PureBasic Docs - Errors & needed improvements to the man

Post by luis »

Marco2007 wrote: but much more important: I´m soooo happy you have never been a teacher of mine at school :mrgreen:
I never understood people saying those things.

"he's so good I don't want to have him to teach something to me, give me someone only a little better than me, so I wouldn't risk to learn too much and maybe I will able to make some errors without getting caught"

MAH!
"Have you tried turning it off and on again ?"
A little PureBasic review
User avatar
Kaeru Gaman
Addict
Addict
Posts: 4826
Joined: Sun Mar 19, 2006 1:57 pm
Location: Germany

Re: PureBasic Docs - Errors & needed improvements to the man

Post by Kaeru Gaman »

@luis: +1

mediocrity is king these days - poor mankind.
oh... and have a nice day.
Marlin
Enthusiast
Enthusiast
Posts: 406
Joined: Sun Sep 17, 2006 1:24 pm
Location: Germany

Re: PureBasic Docs - Errors & needed improvements to the man

Post by Marlin »

freak wrote:This is how a "move" works:
- source initiates the drag & drop
- when successful, target copies the data from source
- when successful, source deletes the data
This is a nice clear understandable explanation.

I think it would not be bad to have something like that in the helpfile too.
freak wrote:I don't see what is so confusing about this. If you ignore the case of files, this is the only way this could work, as the target program cannot delete data in the source program.
Files are a rather common thing to be dragged.
Those are not usually part of an applications private data.
Yet, I consider them "original data".
So I was a little shocked to read about a drag source (not my app),
that would possibly take on, to remove(/delete) files (without my explicit consent).

Yes, just as you said: the target program cannot delete data in the source program.

I considered the thought, that it could or should be otherwise, allmost unthinkable,
therefore I did not see, why this should be mentioned in the helpfile,
unless it was refering to something rather unusuall (rather than unavoidable).
Marlin wrote:Who would ever asume, that the code in the target app would or should
bypass the code in the source application and do something in the other app :?:
Matt
Enthusiast
Enthusiast
Posts: 447
Joined: Sat May 21, 2005 1:08 am
Location: USA

Re: PureBasic Docs - Errors & needed improvements to the man

Post by Matt »

Could the missing .pb files linked as examples in the help files be added please?
User avatar
luis
Addict
Addict
Posts: 3876
Joined: Wed Aug 31, 2005 11:09 pm
Location: Italy

Re: PureBasic Docs - Errors & needed improvements to the man

Post by luis »

in 4.40 B7

in the PureBasic - Map (overview) the link to the sample program Map.pb doesn't work, at least on my system...

the link is expanded to :

Code: Select all

res://D:\WINDOWS\system32\shdoclc.dll/dnserror.htm#mk:@MSITStore:D:\Programmi\PureBasic\BETA\PureBasic.chm::/Examples/Map.pb.html
while for example the (working) linked list sample program is:

Code: Select all

mk:@MSITStore:D:\Programmi\PureBasic\BETA\PureBasic.chm::/Examples/LinkedList.pb.html


ALSO: maybe it's because it's still beta, but Fred in the announcement talked about a "full english doc" so I'm reporting anyway: the history is not updated.
"Have you tried turning it off and on again ?"
A little PureBasic review
Matt
Enthusiast
Enthusiast
Posts: 447
Joined: Sat May 21, 2005 1:08 am
Location: USA

Re: PureBasic Docs - Errors & needed improvements to the man

Post by Matt »

That's what I just stated luis :lol:
User avatar
luis
Addict
Addict
Posts: 3876
Joined: Wed Aug 31, 2005 11:09 pm
Location: Italy

Re: PureBasic Docs - Errors & needed improvements to the man

Post by luis »

But my post is longer and with some tags with strange text inside.
Could be useful ? Maybe.
"Have you tried turning it off and on again ?"
A little PureBasic review
Little John
Addict
Addict
Posts: 4519
Joined: Thu Jun 07, 2007 3:25 pm
Location: Berlin, Germany

Re: PureBasic Docs - Errors & needed improvements to the man

Post by Little John »

luis wrote:
Marco2007 wrote: but much more important: I´m soooo happy you have never been a teacher of mine at school :mrgreen:
I never understood people saying those things.

"he's so good I don't want to have him to teach something to me, give me someone only a little better than me, so I wouldn't risk to learn too much and maybe I will able to make some errors without getting caught"

MAH!
Well, I have taught private lessons for more than 35 years, mainly about mathematics (only school math up to A-level) -- I'm not a mathematician, there's just some math in my blood for unknown reasons. So I never examined anyone, but helped pupils to pass examinations at school.
Some points always have been important to me: a) People should know the reason why they are learning this and that, b) when learning, people should have good feelings (e.g. it's possible to have a little fun in each lesson), c) When interesting stuff is presented in a relaxed atmosphere, almost all pupils do want to learn. Humans are curious by nature, teachers can utilize this fact. :-)

So if I were a teacher at school, yes I think my examinations would be rather demanding. But beforehand, I'd teach the pupils more than they had to know in order to pass the examinations. :-)

Regards, Little John
User avatar
oryaaaaa
Enthusiast
Enthusiast
Posts: 791
Joined: Mon Jan 12, 2004 11:40 pm
Location: Okazaki, JAPAN

Re: PureBasic Docs - Errors & needed improvements to the man

Post by oryaaaaa »

Please add to man

test.a, file.a 0..255
User avatar
Arctic Fox
Enthusiast
Enthusiast
Posts: 609
Joined: Sun Dec 21, 2008 5:02 pm
Location: Aarhus, Denmark

Re: PureBasic Docs - Errors & needed improvements to the man

Post by Arctic Fox »

Isn't this missing in the manual for ArraySize()?
http://www.purebasic.fr/english/viewtop ... 75#p303466
User avatar
Andre
PureBasic Team
PureBasic Team
Posts: 2056
Joined: Fri Apr 25, 2003 6:14 pm
Location: Germany (Saxony, Deutscheinsiedel)
Contact:

Re: PureBasic Docs - Errors & needed improvements to the man

Post by Andre »

Arctic Fox wrote:Isn't this missing in the manual for ArraySize()?
http://www.purebasic.fr/english/viewtop ... 75#p303466
Done :)
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: PureBasic Docs - Errors & needed improvements to the man

Post by Andre »

luis wrote:in 4.40 B7

in the PureBasic - Map (overview) the link to the sample program Map.pb doesn't work, at least on my system...
The related example file Map.pb is still missing in the docs.
So I set it on the 'ToDo' list in first post...
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: PureBasic Docs - Errors & needed improvements to the man

Post by Andre »

Demivec wrote:Update entry 'Data' to correct examples and text describing the storing of memory addresses so that they use the Integer (.i) type instead of Long (.l). This will keep things accurate for both 32-bit and 64-bit environments.
Updated the 'Data' description to reflect the new variable types and prefered '.i' type.
Bye,
...André
(PureBasicTeam::Docs & Support - PureArea.net | Order:: PureBasic | PureVisionXP)
Locked