It is currently Mon Oct 15, 2018 10:57 pm

All times are UTC + 1 hour




Post new topic This topic is locked, you cannot edit posts or make further replies.  [ 224 posts ]  Go to page Previous  1 ... 10, 11, 12, 13, 14, 15  Next
Author Message
 Post subject: Re: PureBasic Docs - Errors & needed improvements to the man
PostPosted: Mon Sep 26, 2011 1:49 am 
Offline
PureBasic Bullfrog
PureBasic Bullfrog
User avatar

Joined: Wed Jul 06, 2005 5:42 am
Posts: 7980
Location: Fort Nelson, BC, Canada
Currently the new commands RandomizeArray() and RandomizeList() appear in the command index under "Sort" in the manual. This is good but I think they should also appear in the command index for their respective objects, "Array" and "Linked List" as they are commands that work exclusively with those objects. I looked for them there first and I imagine others might as well.

(very useful additions, btw)

_________________
Veni, vidi, vici.


Top
 Profile  
 
 Post subject: Re: PureBasic Docs - Errors & needed improvements to the man
PostPosted: Fri Sep 30, 2011 7:44 am 
Offline
Addict
Addict

Joined: Sun Sep 07, 2008 12:45 pm
Posts: 3971
Location: Germany
Hi,

during looking after windows bugs, I discovered that CreateCube() is not mentioned in the
help (4.60RC1 german helpfile).
And CreateMesh() has one parameter to much in the help.


Top
 Profile  
 
 Post subject: Re: PureBasic Docs - Errors & needed improvements to the man
PostPosted: Mon Oct 03, 2011 11:07 pm 
Offline
Addict
Addict
User avatar

Joined: Wed Aug 31, 2005 11:09 pm
Posts: 3662
Location: Italy
PB4.60 RC1

PokeS()

Text$ is missing from the parameters listed inside the table.

_________________
Philosophy is questions that may never be answered. Religion is answers that must never be questioned.

[ My little PureBasic review ]


Top
 Profile  
 
 Post subject: Re: PureBasic Docs - Errors & needed improvements to the man
PostPosted: Sun Oct 23, 2011 10:59 pm 
Offline
Addict
Addict
User avatar

Joined: Wed Aug 31, 2005 11:09 pm
Posts: 3662
Location: Italy
PB 4.60 RC2

ReplaceString

1) The help doesn't mention what the return value is.
You have to deduce looking and trying the examples it is a copy of the source string modified by the replace operation.

2) The examples in the help are using numeric constants instead of the symbolic constants #PB_String_*, so again one is guessing what is what, and you have to check the numerical value of the constants to know for sure.

viewtopic.php?f=4&t=47882

EDIT: in the 4.60 final too.

_________________
Philosophy is questions that may never be answered. Religion is answers that must never be questioned.

[ My little PureBasic review ]


Last edited by luis on Fri Nov 25, 2011 12:16 am, edited 1 time in total.

Top
 Profile  
 
 Post subject: Re: PureBasic Docs - Errors & needed improvements to the man
PostPosted: Wed Nov 02, 2011 1:22 am 
Offline
Enthusiast
Enthusiast
User avatar

Joined: Sun Dec 21, 2008 5:02 pm
Posts: 609
Location: Aarhus, Denmark
A mention of #PB_GadgetType_Canvas is missing (GadgetType, constants overview etc.).


Top
 Profile  
 
 Post subject: Re: PureBasic Docs - Errors & needed improvements to the man
PostPosted: Fri Nov 25, 2011 12:21 am 
Offline
Addict
Addict
User avatar

Joined: Wed Aug 31, 2005 11:09 pm
Posts: 3662
Location: Italy
PB 4.60 final

NextMapElement

ReturnValue is listed inside the table with a @ in front of it. It should be outside (like Example).

_________________
Philosophy is questions that may never be answered. Religion is answers that must never be questioned.

[ My little PureBasic review ]


Top
 Profile  
 
 Post subject: Re: PureBasic Docs - Errors & needed improvements to the man
PostPosted: Fri Dec 02, 2011 7:30 pm 
Offline
PureBasic Team
PureBasic Team
User avatar

Joined: Fri Apr 25, 2003 6:14 pm
Posts: 1572
Location: Germany (Saxony, Deutscheinsiedel)
Fixed for next version (topics from this side of the thread):
- NextMapElement -> Returnvalue
- GadgetType -> CanvasGadget
- ReplaceString -> Return value
- RemoveString -> using PB constant instead of value
- RandomizeArray/List --> several more links/mentions were added in the manual to find this new functions easier
:D

Things, which should already be fine with PB 4.60 final:
- CreateCube

Up to Fred, who must check if an error in the docs or a missing feature of the command:
- CreateMesh -> second parameter
- and of course the first topic in this thread with collected suggestions!
:twisted:

_________________
Bye,
...André
(PureBasicTeam::Docs & Support - PureArea.net | Order:: PureBasic | PureVisionXP)


Top
 Profile  
 
 Post subject: Re: PureBasic Docs - Errors & needed improvements to the man
PostPosted: Sun Dec 04, 2011 3:03 pm 
Offline
Addict
Addict
User avatar

Joined: Thu Apr 21, 2005 2:38 pm
Posts: 1559
Location: Germany
Andre,

unfortunately you seem to have forgotten to add a remark to each
Gadget description in the help for which the SetGadgetColor() and
SetGadgetItemColor() commands on the Mac don't work (in contrast
to the Windows and Linux version). Do you remember my fancy table
which lists all non-working color commands on the Mac? freak
decided that a remark should have been added to each Gadget
description which doesn't work with color commands on the Mac:
freak wrote:
Don't add that table. Add a note in the topic for each function instead.

There has already been again an unnecessary bug report of a new
user which could have been prevented by changing the documentation
as freak had proposed. It would be nice if you could add the necessary
notes in the help for PB 4.61... :wink:


Top
 Profile  
 
 Post subject: Re: PureBasic Docs - Errors & needed improvements to the man
PostPosted: Sun Dec 11, 2011 12:21 am 
Offline
Addict
Addict
User avatar

Joined: Wed Aug 31, 2005 11:09 pm
Posts: 3662
Location: Italy
PB 4.60

I think the manual should explain residents.

They are only mentioned in the compiler options, but there is no explanation on what they are, what you can put into a resident and what you can't, and what you can use them for.

_________________
Philosophy is questions that may never be answered. Religion is answers that must never be questioned.

[ My little PureBasic review ]


Top
 Profile  
 
 Post subject: ScaleMaterial is missing in the Docs
PostPosted: Fri Dec 16, 2011 8:36 pm 
Offline
Enthusiast
Enthusiast
User avatar

Joined: Sun Aug 03, 2003 12:06 am
Posts: 264
Location: Austria
Under Material
ScrollMaterial and RotateMaterial are listed and explained
ScaleMaterial is not in the docs. But it exists.

[Note by Andre on 11th Oct. 2012: fixed in PB5.00 b4]

_________________
--------------
Yes, its an Irish Wolfhound.
Height: 107 cm; Weight: 88 kg


Top
 Profile  
 
 Post subject: Re: PureBasic Docs - Errors & needed improvements to the man
PostPosted: Wed Dec 21, 2011 12:15 pm 
Offline
Always Here
Always Here

Joined: Mon Sep 22, 2003 6:45 pm
Posts: 7439
Location: Norway
In the IDE: F1 on ArraySize() leads to the page of Dim instead of ArraySize().


Top
 Profile  
 
 Post subject: Re: PureBasic Docs - Errors & needed improvements to the man
PostPosted: Fri Dec 30, 2011 3:50 pm 
Offline
Addict
Addict
User avatar

Joined: Wed Aug 31, 2005 11:09 pm
Posts: 3662
Location: Italy
Asc()

Please add a note in the manual explaining it works with unicode too (and replace chain with string).

see: viewtopic.php?p=370521#p370521

_________________
Philosophy is questions that may never be answered. Religion is answers that must never be questioned.

[ My little PureBasic review ]


Top
 Profile  
 
 Post subject: Re: PureBasic Docs - Errors & needed improvements to the man
PostPosted: Fri Jan 06, 2012 5:29 pm 
Offline
Addict
Addict
User avatar

Joined: Mon Jul 25, 2005 3:51 pm
Posts: 3496
Location: Utah, USA
PathRequester() specifies its syntax as:
Code:
Filename$ = PathRequester(Title$, InitialPath$)


It would make more sense if this was changed to:
Code:
Path$ = PathRequester(Title$, InitialPath$)


[Note by Andre on 11th Oct. 2012: done for PB5.00 final]

_________________
Image


Top
 Profile  
 
 Post subject: Re: PureBasic Docs - Errors & needed improvements to the man
PostPosted: Sun Jan 15, 2012 1:34 am 
Offline
Enthusiast
Enthusiast
User avatar

Joined: Sun Dec 21, 2008 5:02 pm
Posts: 609
Location: Aarhus, Denmark
Help: OffsetOf wrote:
... When used with an Interface, the function index is the memory offset, so it will be IndexOfTheFunction*4.

On 64-bit it is IndexOfTheFunction*8. This goes for the example, too. Pointers are 4 bytes on 32-bit and 8 bytes on 64-bit.

Code:
Structure Person
  Name.s
  ForName.s
  Age.w
EndStructure

Debug OffsetOf(Person\Age) ; will be 8 as a string is 4 byte in memory (16 on 64-bit)


Interface ITest
  Create()
  Destroy(Flags)
EndInterface

Debug OffsetOf(ITest\Destroy()) ; will be 4 (8 on 64-bit)


Top
 Profile  
 
 Post subject: Re: PureBasic Docs - Errors & needed improvements to the man
PostPosted: Sun Jan 15, 2012 3:45 am 
Offline
Enthusiast
Enthusiast
User avatar

Joined: Wed Oct 22, 2003 2:51 am
Posts: 743
Location: Canada
[quote=Help - CreateTexture()]It's strongly recommended to make the texture square and with power of 2 width/height: 64x64, 128x128, 256x256... Old GFX cards can have limitation, so if possible limit the texture size to 256x256. [/quote]

Sorry but this is false, the texture can be rectangular :

16X256 --> Valid size
64X128 --> Valid size
128X256 --> Valid size
256X16 --> Valid size
128X64 --> Valid size
256X128 --> Valid size

Best regards.
Guimauve


Top
 Profile  
 
Display posts from previous:  Sort by  
Post new topic This topic is locked, you cannot edit posts or make further replies.  [ 224 posts ]  Go to page Previous  1 ... 10, 11, 12, 13, 14, 15  Next

All times are UTC + 1 hour


Who is online

Users browsing this forum: No registered users and 1 guest


You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum

Search for:
Jump to:  
cron

 


Powered by phpBB © 2008 phpBB Group
subSilver+ theme by Canver Software, sponsor Sanal Modifiye