Sign in Join

Live chat for Free Pascal, Lazarus, Delphi and every Pascal programmer.

Mailing lists / fpc-devel / 2006-12

Question about writing documentation

6 messages · 4 people · –

Reply by email Subscribe to this list Your subscription

Read-only archive. Use j and k to move between messages.

Joost van der Sluis

Hi all,

Two things:

One: TDataset.Recordcount on Delphi (TclientDataset?) returns 0 if it's called on an inactive TDataset. But an exception seems to be more appropiate to me. But some dataset-descendents raise an exception, some return 0.
Now what should I do in sqldb and the TMemDataset?

Two: I want to document the choice I made in point one, and I think that the writing documentation at the same time is a good idea. But now I have this question: TDataset.Recordcount always return -1. Even if the TDataset is closed.
Any comment on the exception in, for example, TMemDataset.Recordcount, should I place that in the TMemDataset.Recordcount-help? Or can I put into the TDataset.Recordcount a remark, that most TDataset.Descendents return 0 or raise an exception?
Normally you would write that down in the documentation of the descendent, but I want to make a statement to TDataset-descendent- developers, that if they make their own descendent, it should return 0 or an exception. where's the place to do that?

I hope my point is clear.

Regards,
Joost.

Met vriendelijke groeten, Joost van der Sluis CNOC Informatiesystemen en Netwerken http://www.cnoc.nl

Reply by email

George Birbilis
to Joost van der Sluis

Why not say return <1 or <=0 for all?

----------------
George Birbilis ()
Computer & Informatics Engineer
Microsoft MVP J# for 2004-2006
Borland "Spirit of Delphi"
3D, QuickTime, QTVR, Java, Delphi,
ActiveX, .NET components, Robotics
http://www.kagi.com/birbilis
http://birbilis.spaces.live.com

Show quoted text 50 lines
-----Original Message----- From: On Behalf Of Joost van der Sluis Sent: Friday, December 22, 2006 12:52 AM To: FPC developers' list Subject: [fpc-devel] Question about writing documentation Hi all, Two things: One: TDataset.Recordcount on Delphi (TclientDataset?) returns 0 if it's called on an inactive TDataset. But an exception seems to be more appropiate to me. But some dataset-descendents raise an exception, some return 0. Now what should I do in sqldb and the TMemDataset? Two: I want to document the choice I made in point one, and I think that the writing documentation at the same time is a good idea. But now I have this question: TDataset.Recordcount always return -1. Even if the TDataset is closed. Any comment on the exception in, for example, TMemDataset.Recordcount, should I place that in the TMemDataset.Recordcount-help? Or can I put into the TDataset.Recordcount a remark, that most TDataset.Descendents return 0 or raise an exception? Normally you would write that down in the documentation of the descendent, but I want to make a statement to TDataset-descendent- developers, that if they make their own descendent, it should return 0 or an exception. where's the place to do that? I hope my point is clear. Regards, Joost. -- Met vriendelijke groeten, Joost van der Sluis CNOC Informatiesystemen en Netwerken http://www.cnoc.nl _______________________________________________ fpc-devel maillist - http://lists.freepascal.org/mailman/listinfo/fpc-devel

_____

avast! Antivirus <http://www.avast.com> : Outbound message clean.

Virus Database (VPS): 0659-1, 16/12/2006
Tested on: 22/12/2006 9:44:37 p?
avast! - copyright (c) 1988-2006 ALWIL Software.

Reply by email

George Birbilis

The FPC dev env when run in windowed mode at Windows XP 32-bit shows no cursor (no blinking, nothing). At full screen shows a blinking cursor, but it's very tiring cause it blinks too fast

----------------
George Birbilis ()
Computer & Informatics Engineer
Microsoft MVP J# for 2004-2006
Borland "Spirit of Delphi"
3D, QuickTime, QTVR, Java, Delphi,
ActiveX, .NET components, Robotics
http://www.kagi.com/birbilis
http://birbilis.spaces.live.com

_____

avast! Antivirus <http://www.avast.com> : Outbound message clean.

Virus Database (VPS): 0659-1, 16/12/2006
Tested on: 22/12/2006 9:53:59 p?
avast! - copyright (c) 1988-2006 ALWIL Software.

Reply by email

Bram Kuijvenhoven
to George Birbilis
George Birbilis wrote
The FPC dev env when run in windowed mode at Windows XP 32-bit shows no cursor (no blinking, nothing). At full screen shows a blinking cursor, but it's very tiring cause it blinks too fast

Please use a bugreport to report such issues, but start a new thread if you also wish to discuss it on the mailing list.

Kind regards,

Bram

Reply by email

George Birbilis
to Bram Kuijvenhoven

Sorry, forgot to change the subject
Can others see these two issues too?

Show quoted text 7 lines
> The FPC dev env when run in windowed mode at Windows XP 32-bit shows > no cursor (no blinking, nothing). At full screen shows a blinking > cursor, but it's very tiring cause it blinks too fast Please use a bugreport to report such issues, but start a new thread if you also wish to discuss it on the mailing list.

_____

avast! Antivirus <http://www.avast.com> : Outbound message clean.

Virus Database (VPS): 0659-1, 16/12/2006
Tested on: 22/12/2006 9:17:16 ??
avast! - copyright (c) 1988-2006 ALWIL Software.

Reply by email

Marc Weustink
to George Birbilis
George Birbilis wrote
Sorry, forgot to change the subject

BTW, changing the subject doesn't start a new thread (for threaded mailreaders).
Don't use reply to start a thread, use new (new creates a new thread, reply stays in the thread)

Can others see these two issues too?

I leave this to others.

Marc

Show quoted text 26 lines
>> The FPC dev env when run in windowed mode at Windows XP > 32-bit shows >> no cursor (no blinking, nothing). At full screen shows a blinking >> cursor, but it's very tiring cause it blinks too fast > Please use a bugreport to report such issues, but start a new > thread if you also wish to discuss it on the mailing list. _____ avast! Antivirus <http://www.avast.com> : Outbound message clean. Virus Database (VPS): 0659-1, 16/12/2006 Tested on: 22/12/2006 9:17:16 ?? avast! - copyright (c) 1988-2006 ALWIL Software. _______________________________________________ fpc-devel maillist - http://lists.freepascal.org/mailman/listinfo/fpc-devel

Reply by email