PureBasic Docs - Errors & needed improvements to the man

Little John · **Posted:** Tue Oct 06, 2009 5:15 pm

Chr()

In the help of PB 4.40 Beta 3 it reads like this:

Quote:

Text$ = Chr(ASCII-Value)
Returns the character associated with the given ASCII value.

Not a single word about Unicode there ...
But Chr() can also return Unicode characters (in unicode mode, if the source file is in UTF8 format). That's much appreciated and pretty cool, but before we can use it, we'll have to know about it. :-)

So mention it in the docs, please.

Regards, Little John

Little John · **Posted:** Thu Oct 08, 2009 4:53 am

NewMap

Although the help for NewMap() exists, the word "NewMap" does not appear in the help index. Also in the command index of Map(), the word "NewMap" is missing.

Another mistake:
In the beginning of the second paragraph of the English help for NewMap it reads

Quote:

When using a new key for an affection, a new element is automatically added to the map.

"affection" doesn't make sense in this context. In the German help, it correctly reads "Zuweisung" here. This is "assignment" in English.

Regards, Little John

Arctic Fox · **Posted:** Tue Oct 13, 2009 7:20 pm

The link to TextureOutput() in StartDrawing() should be removed.

Andre · **Posted:** Tue Oct 13, 2009 7:26 pm

@Little John:

The spelling error in english 'NewMap' help was fixed, as well a false link to the 'LinkedList' library in the introduction of the 'Map' library. There is also a link to the 'NewMap' keyword already there.... and it's not listed in the command-list of this library just because it's a keyword and not a command of this library.

The other issues I've set on the 'ToDo' list - see first post...

Andre · **Posted:** Tue Oct 13, 2009 8:05 pm

Arctic Fox wrote:

The link to TextureOutput() in StartDrawing() should be removed.

Done.

Little John · **Posted:** Tue Oct 13, 2009 8:28 pm

Thank you, Andre!

Regards, Little John

Seymour Clufley · **Posted:** Sun Oct 18, 2009 2:41 am

I'm using beta5 and the CHM has no documentation of the new 2D Drawing commands, drawing modes, etc.

blueb · **Posted:** Tue Oct 20, 2009 2:46 pm

It would be helpful if the manual explained the For:Next command a little better..

e.g. Stepping and negative stepping for example.

Code:

k = 10
For k = 10 To 1 Step -1
    Debug k
Next

--blueb

Andre · **Posted:** Tue Oct 20, 2009 8:23 pm

blueb wrote:

It would be helpful if the manual explained the For:Next command a little better..

e.g. Stepping and negative stepping for example.

Code:

k = 10
For k = 10 To 1 Step -1
    Debug k
Next

Done

Seymour Clufley wrote:

I'm using beta5 and the CHM has no documentation of the new 2D Drawing commands, drawing modes, etc.

Set on ToDo list for Fred/freak.

Little John · **Posted:** Sat Oct 24, 2009 11:26 am

FillArea()

Currently the Reference Manual writes:

Quote:

If the 'BorderColor' parameter is set to -1, then the area defined by the color found at the (x,y) coordinates will be filled.

IMHO this hardly describes the effect of -1 in this context.

I think it should read something like this:

Quote:

If the 'BorderColor' parameter is set to -1, then any color that is different from the color at point (x,y) will be treated as 'BorderColor'.

Regards, Little John

infratec · **Posted:** Mon Oct 26, 2009 10:16 am

Hi,

DatabaseUpdate() needs an update!

At the weekend I was fighting for ours with SQLite and the example in the (german) help.

Code:

  ; Zuerst stellen wir eine Verbindung zu der 'employee' (Angestellten) Tabelle her
  ;
  If DatabaseQuery(#Datenbank, "SELECT * FROM employee") ; Ermittelt alle Einträge in der 'employee' Tabelle
  
    While NextDatabaseRow(#Datenbank)   ; alle Einträge durchlaufen
      
      ; Aktualisieren des 'checked' Felds für jeden Eintrag, vorausgesetzt
      ; das 'id' Feld ist das erste in der 'employee' Tabelle
      ;
      DatabaseUpdate(#Datenbank, "UPDATE employee SET checked=1 WHERE id="+GetDatabaseString(#Datenbank, 0)) 
    Wend

    FinishDatabaseQuery(#Datenbank)
  EndIf

This example tells you, that it is possible to update each entry in the database inside the loop.
But it is not working.

There is already a posting about that, but nothing is changed.
viewtopic.php?f=13&t=32876&p=248148&hilit=sqlite+update#p248148

So please change the helpfile, or if it is a bug with SQLite, write it inside this help.

Best regards,

Bernd

THCM · **Posted:** Thu Oct 29, 2009 9:53 am

Hi, it would be helpful to have a better explanation of the different screen output subsystems and which commands are supported by each subsystem. Also a compiler warning would be nice, if you try to use an unsupported command.

Little John · **Posted:** Thu Oct 29, 2009 10:31 pm

As I posted in the "Coding questions" section a few days ago, some example code in the current help regarding 2D drawing ( see e.g. Circle() ) does not work at all on Ubuntu.

Srod has confirmed my point of view and nobody objected, so I really think the example code is wrong, at least as far as Linux is concerned.
On Windows, the example code in the help does work, but srod wrote that in his opinion the modification that I posted (suggested by #Null on the German forum) is the safer one to use on all platforms.

Since it's important to have working example code, please change it for the 4.40 final release.

TIA, Little John

Seymour Clufley · **Posted:** Tue Nov 03, 2009 4:44 am

Little John wrote:

If the 'BorderColor' parameter is set to -1, then any color that is different from the color at point (x,y) will be treated as 'BorderColor'.

I strongly agree with this suggestion.

nco2k · **Joined:** Mon Sep 15, 2003 5:55 am **Posts:** 1341

would be nice if you could re-arrange the value types table and keep .c at one place.

currently:

Quote:

Byte
Ascii
Character
Word
Unicode
Character
Long
Integer
Integer
Float
Quad
Double
String
Fixed String

better:

Quote:

Byte
Ascii
Word
Unicode
Character
Character
Long
Quad
Integer
Integer
Float
Double
String
Fixed String

btw, why isnt there a default (.i like) type for floats? .f on 32bit and .d on 64bit. isnt .d 'faster' on 64bit?

c ya,
nco2k

PureBasic Forum

PureBasic Docs - Errors & needed improvements to the man

Who is online