Re: [fpc-devel] fpdoc inherited entries

2008-02-18 Thread Michael Van Canneyt
On Sun, 17 Feb 2008, Mattias Gaertner wrote: In the LCL there is documentation for TControl.Caption which is useful for all descendant classes like TButton.Caption too. It would be nice if fpdoc shows the content of TControl.Caption if TButton.Caption does not have a value or at least

Re: [fpc-devel] fpdoc inherited entries

2008-02-18 Thread Marco van de Voort
In the LCL there is documentation for TControl.Caption which is useful for all descendant classes like TButton.Caption too. It would be nice if fpdoc shows the content of TControl.Caption if TButton.Caption does not have a value or at least show a link to the inherited entries. Comments?

Re: [fpc-devel] fpdoc inherited entries

2008-02-18 Thread Mattias Gärtner
Zitat von Michael Van Canneyt [EMAIL PROTECTED]: On Sun, 17 Feb 2008, Mattias Gaertner wrote: In the LCL there is documentation for TControl.Caption which is useful for all descendant classes like TButton.Caption too. It would be nice if fpdoc shows the content of TControl.Caption if

Re: [fpc-devel] fpdoc inherited entries

2008-02-18 Thread Michael Van Canneyt
On Mon, 18 Feb 2008, Mattias Gärtner wrote: Zitat von Michael Van Canneyt [EMAIL PROTECTED]: On Sun, 17 Feb 2008, Mattias Gaertner wrote: In the LCL there is documentation for TControl.Caption which is useful for all descendant classes like TButton.Caption too. It would be

Re: [fpc-devel] fpdoc inherited entries

2008-02-18 Thread Mattias Gärtner
Zitat von Michael Van Canneyt [EMAIL PROTECTED]: On Mon, 18 Feb 2008, Mattias Gärtner wrote: Zitat von Michael Van Canneyt [EMAIL PROTECTED]: On Sun, 17 Feb 2008, Mattias Gaertner wrote: In the LCL there is documentation for TControl.Caption which is useful for

Re: [fpc-devel] fpdoc inherited entries

2008-02-18 Thread Michael Van Canneyt
On Mon, 18 Feb 2008, Mattias Gärtner wrote: Zitat von Michael Van Canneyt [EMAIL PROTECTED]: On Mon, 18 Feb 2008, Mattias Gärtner wrote: Zitat von Michael Van Canneyt [EMAIL PROTECTED]: On Sun, 17 Feb 2008, Mattias Gaertner wrote: In the LCL there is

Re: [fpc-devel] fpdoc inherited entries

2008-02-18 Thread Michael Van Canneyt
On Mon, 18 Feb 2008, Felipe Monteiro de Carvalho wrote: On Feb 18, 2008 12:51 PM, Michael Van Canneyt [EMAIL PROTECTED] wrote: Then you need to decide what to do: - Create a page for TChild.Property and simply refer to TParent.property (a braindead solution imho) Why is creating a

Re: [fpc-devel] fpdoc inherited entries

2008-02-18 Thread Felipe Monteiro de Carvalho
On Feb 18, 2008 12:51 PM, Michael Van Canneyt [EMAIL PROTECTED] wrote: Then you need to decide what to do: - Create a page for TChild.Property and simply refer to TParent.property (a braindead solution imho) Why is creating a link from TChild.Property to TParent.Property a bad thing? AFAIK,

Re: [fpc-devel] fpdoc inherited entries

2008-02-18 Thread Felipe Monteiro de Carvalho
On Feb 18, 2008 2:17 PM, Michael Van Canneyt [EMAIL PROTECTED] wrote: Because you don't need the TChild.Property page at all. There should not be a link to TChild.Property anywhere. All links should always be to TParent.property. Ah ... ok, I misunderstood you. We have the same oppinion =)

Re: [fpc-devel] fpdoc inherited entries

2008-02-18 Thread Mattias Gärtner
Zitat von Michael Van Canneyt [EMAIL PROTECTED]: [...] The problem is that you may or may not have the definition (and corresponding page) in memory. If the parent def (and doc) is not in memory, you don't know whether a page is available or not. How do the links to the ancestor

Re: [fpc-devel] fpdoc inherited entries

2008-02-18 Thread Michael Van Canneyt
On Mon, 18 Feb 2008, Mattias Gärtner wrote: It should only refer, iff the TChild.Property is not documented (= has no short description) and iff there is a documented TParent.Property, where TParent does not need to be the direct ancestor. For example TButton.Caption should not

[fpc-devel] fpdoc inherited entries

2008-02-17 Thread Mattias Gaertner
In the LCL there is documentation for TControl.Caption which is useful for all descendant classes like TButton.Caption too. It would be nice if fpdoc shows the content of TControl.Caption if TButton.Caption does not have a value or at least show a link to the inherited entries. Comments?