[Lazarus] LCL package reorganization mess

2011-07-23 Thread Hans-Peter Diettrich
The recent change in the package names has invalidated all #LCL links in the documentation :-( IMO the package names should be exchanged, so that LCL contains the high-level components (equivalent to the Delphi VCL). The other package can be renamed into e.g. Widgetsets, to make clear what it

Re: [Lazarus] Codetools and comments

2011-07-23 Thread Hans-Peter Diettrich
Mattias Gaertner schrieb: Hans-Peter Diettrich drdiettri...@aol.com hat am 18. Juli 2011 um 15:20 geschrieben: Is it normal that the codetools try to insert e.g. end; into comments, while editing the comment? No. Please create a bug report with an example. I couldn't reproduce this one

[Lazarus] Laz Barcodes

2011-07-23 Thread José Mejuto
Hello Lazarus-List, I had added a new set of components to Lazarus CCR http://lazarus-ccr.svn.sourceforge.net/viewvc/lazarus-ccr/components/lazbarcodes/ to generate, currently, 2D barcodes: * QR * MicroQR * Aztec * Aztec Rune * DataMatrix The backend has been ported from Zint

[Lazarus] Documentation style

2011-07-23 Thread Hans-Peter Diettrich
During the development of the doc tracker I stumbled over several issues: The English wording often violates my feeling for the language. Can some native English speakers proofread the documentation, and correct stylistic flaws? I don't want to discourage non-native speakers to contribute to

Re: [Lazarus] Does Lazarus v0.9.31 compile with the latest FPC snapshot?

2011-07-23 Thread Graeme Geldenhuys
You'll need lazarus svn 30332. FPC has added tkHelper in TTypeKind enumeration (typeinfo.pp). Is there documentation on tkHelper? What exactly does it describe? Just curious. Regards, - Graeme - -- Regards, - Graeme - ___ fpGUI - a

[Lazarus] RE : Does Lazarus v0.9.31 compile with the latest FPCsnapshot?

2011-07-23 Thread Ludo Brands
Probably helper types: http://wiki.lazarus.freepascal.org/Helper_types Ludo -Message d'origine- De : Graeme Geldenhuys [mailto:graemeg.li...@gmail.com] Envoyé : samedi 23 juillet 2011 13:28 À : Lazarus mailing list Objet : Re: [Lazarus] Does Lazarus v0.9.31 compile with the

Re: [Lazarus] Documentation style

2011-07-23 Thread Mattias Gaertner
On Sat, 23 Jul 2011 13:20:42 +0100 Hans-Peter Diettrich drdiettri...@aol.com wrote: [...] Style related are field names like childs, which IMO should read Children Yes. [...] Often I come across circles, referring to circular unit references. IMO the correct term instead would be loops,

Re: [Lazarus] Documentation style

2011-07-23 Thread Jürgen Hestermann
Many descriptions only describe the obvious, like method names expressed in more words. Such descriptions are quite useless, and should be replaced by more informative ones. I'd suggest to remove all these descriptions (replace by a todo-marker?), until somebody can describe the elements

Re: [Lazarus] Documentation style

2011-07-23 Thread Howard Page-Clark
On 23/7/11 1:20, Hans-Peter Diettrich wrote: During the development of the doc tracker I stumbled over several issues: The English wording often violates my feeling for the language. Can some native English speakers proofread the documentation, and correct stylistic flaws? snip I also can

Re: [Lazarus] Documentation style

2011-07-23 Thread Mattias Gaertner
On Sat, 23 Jul 2011 15:29:45 +0200 Jürgen Hestermann juergen.hesterm...@gmx.de wrote: Many descriptions only describe the obvious, like method names expressed in more words. Such descriptions are quite useless, and should be replaced by more informative ones. I'd suggest to remove all

Re: [Lazarus] Documentation style

2011-07-23 Thread Mattias Gaertner
On Sat, 23 Jul 2011 14:59:20 +0100 Howard Page-Clark h...@talktalk.net wrote: On 23/7/11 1:20, Hans-Peter Diettrich wrote: During the development of the doc tracker I stumbled over several issues: The English wording often violates my feeling for the language. Can some native English

Re: [Lazarus] Documentation style

2011-07-23 Thread Jürgen Hestermann
Mattias Gaertner schrieb: Then no extra documentation is needed.[...] How to distinguish an item that needs documentation and an item that does not need documentation? Well, if the current documentation just repeats the name (with fillwords) then it is useless IMO and should be deleted. But

Re: [Lazarus] RE : Does Lazarus v0.9.31 compile with the latest FPCsnapshot?

2011-07-23 Thread Sven Barth
On 23.07.2011 13:44, Ludo Brands wrote: Probably helper types: http://wiki.lazarus.freepascal.org/Helper_types Yes, you are right. To explain this a bit: In Delphi helper classes (and records) are basically classes that magically derive from a TClassHelperBase (or so) class which in turn

Re: [Lazarus] Documentation style

2011-07-23 Thread Martin
On 23/07/2011 16:06, Jürgen Hestermann wrote: Mattias Gaertner schrieb: Then no extra documentation is needed.[...] How to distinguish an item that needs documentation and an item that does not need documentation? Well, if the current documentation just repeats the name (with fillwords)

Re: [Lazarus] Documentation style

2011-07-23 Thread Hans-Peter Diettrich
Mattias Gaertner schrieb: Often I come across circles, referring to circular unit references. IMO the correct term instead would be loops, in e.g. avoid loops. AFAIK the correct term in graph theory is cycle. Sounds good. Many descriptions only describe the obvious, like method names

Re: [Lazarus] Documentation style

2011-07-23 Thread Hans-Peter Diettrich
Mattias Gaertner schrieb: What if the method just does what the name says? Then no extra documentation is needed.[...] How to distinguish an item that needs documentation and an item that does not need documentation? Give an example? DoDi --

Re: [Lazarus] Documentation style

2011-07-23 Thread Hans-Peter Diettrich
Howard Page-Clark schrieb: I also can assign doc files to those people, which are willing to proofread the documentation, so that we can avoid duplicate work. I'm a native English speaker, and I'm willing to proofread documentation, and make suggestions for improvements. However, I suspect

Re: [Lazarus] Documentation style

2011-07-23 Thread Mattias Gaertner
On Sat, 23 Jul 2011 16:59:14 +0100 Hans-Peter Diettrich drdiettri...@aol.com wrote: [...] As already mentioned in another mail, all links to #LCL are broken now. I changed the #LCL to #LCLBase in the lcl xml files. Argh :-( ? Mattias --

Re: [Lazarus] Documentation style

2011-07-23 Thread Hans-Peter Diettrich
Mattias Gaertner schrieb: On Sat, 23 Jul 2011 16:59:14 +0100 Hans-Peter Diettrich drdiettri...@aol.com wrote: [...] As already mentioned in another mail, all links to #LCL are broken now. I changed the #LCL to #LCLBase in the lcl xml files. Argh :-( ? Why do you break existing