Hans-Peter Diettrich wrote:
Mark Morgan Lloyd schrieb:
Actually I meant
a=1;
(* First line of a long block *)
(* of comments arranged Sloane-style. *)
How would you then separate comments pertaining to the following item?
By the fact that there's a declaration between them.
Mark Morgan Lloyd schrieb:
Actually I meant
a=1;
(* First line of a long block *)
(* of comments arranged Sloane-style. *)
How would you then separate comments pertaining to the following item?
By the fact that there's a declaration between them.
Not when the second one is a
Doug Chamberlin wrote:
I'm in the same boat (35+ years). Comments are always immediately after
instead of before. Among other things this helps ensure the comment is
not lost when the code is moved since it is located *within* the
unit/procedure/function. I sure hope any further automated
Mattias Gaertner wrote:
I wonder if I could ask a question that follows on from Bernd's
sentiment. He points out that the IDE will pick up a comment /before/ a
declaration, but for getting on for 30 years I've been putting comments
immediately /after/ and that includes the positioning of a
On Sun, 25 Jul 2010 07:31:13 +
Mark Morgan Lloyd markmll.laza...@telemetry.co.uk wrote:
Doug Chamberlin wrote:
I'm in the same boat (35+ years). Comments are always immediately after
instead of before. Among other things this helps ensure the comment is
not lost when the code is
On Sun, 25 Jul 2010 07:36:43 +
Mark Morgan Lloyd markmll.laza...@telemetry.co.uk wrote:
Mattias Gaertner wrote:
I wonder if I could ask a question that follows on from Bernd's
sentiment. He points out that the IDE will pick up a comment /before/ a
declaration, but for getting on
Mattias Gaertner wrote:
If every line of a comment block is terminated does
the IDE pick up all of them and does each one need at the start?
You mean:
a=1;
// Comment for a
// another comment for a
Actually I meant
a=1;
(* First line of a long block *)
(* of comments arranged
Mark Morgan Lloyd schrieb:
Actually I meant
a=1;
(* First line of a long block *)
(* of comments arranged Sloane-style. *)
How would you then separate comments pertaining to the following item?
DoDi
--
___
Lazarus mailing list
Bernd wrote:
Much stuff that appeared on a single line, with occasional missing
spaces. If it's difficult to write it should be difficult to read. Here
endeth the rant :-)
I wonder if I could ask a question that follows on from Bernd's
sentiment. He points out that the IDE will pick up a
On 24/07/2010 17:34, Mark Morgan Lloyd wrote:
Bernd wrote:
Much stuff that appeared on a single line, with occasional missing
spaces. If it's difficult to write it should be difficult to read.
Here endeth the rant :-)
I wonder if I could ask a question that follows on from Bernd's
On Sat, 24 Jul 2010 16:34:12 +
Mark Morgan Lloyd markmll.laza...@telemetry.co.uk wrote:
Bernd wrote:
Much stuff that appeared on a single line, with occasional missing
spaces. If it's difficult to write it should be difficult to read. Here
endeth the rant :-)
I wonder if I could
On 7/24/2010 12:34 PM, Mark Morgan Lloyd wrote:
I wonder if I could ask a question that follows on from Bernd's
sentiment. He points out that the IDE will pick up a comment /before/
a declaration, but for getting on for 30 years I've been putting
comments immediately /after/ and that includes
IMHO, Lazarus should hold a list of all public declarations done in
the RTL and the LCL and when pressing F1 with the cursor on some name,
it should show the appropriate help, even if is not found in any unit
mentioned in the uses clause - such as it works today. (providing a
selection list
On 2010-07-23 14:08, Michael Schnell wrote:
IMHO, Lazarus should hold a list of all public declarations done in
the RTL and the LCL and when pressing F1 with the cursor on some name,
it should show the appropriate help, even if is not found in any unit
mentioned in the uses clause - such
Zitat von Michael Schnell mschn...@lumino.de:
IMHO, Lazarus should hold a list of all public declarations done in
the RTL and the LCL and when pressing F1 with the cursor on some
name, it should show the appropriate help, even if is not found in
any unit mentioned in the uses clause -
2010/7/23 Mattias Gaertner nc-gaert...@netcologne.de:
The fpdoc files for the LCL are in docs/xml/lcl.
Ok, I found them, they are there indeed, I wrongly concluded that they
are not there because it didn't find documentation for classes that it
should have found (seems to be a bug resulting from
On 23/07/2010 13:34, Bernd wrote:
Its not only the fpdoc thing or how to generate documentation, this is
only of secondary interest to me now.
At the moment I am just trying to understand the code of the source
editor, the autocompletion and the hints but I cannot find anything
that will help
On 07/23/2010 01:14 PM, Mattias Gärtner wrote:
Zitat von Michael Schnell mschn...@lumino.de:
IMHO, Lazarus should hold a list of all public declarations done in
the RTL and the LCL and when pressing F1 with the cursor on some
name, it should show the appropriate help, even if is not found
On Fri, 23 Jul 2010 15:27:50 +0200
Michael Schnell mschn...@lumino.de wrote:
On 07/23/2010 01:14 PM, Mattias Gärtner wrote:
Zitat von Michael Schnell mschn...@lumino.de:
IMHO, Lazarus should hold a list of all public declarations done in
the RTL and the LCL and when pressing F1 with
On 07/23/2010 04:01 PM, Mattias Gaertner wrote:
There is already a tool to see all public declaration: View
CodeBrowser. It does not only list all public declarations of RTL and
LCL, but all FPC packages, your project and all used packages.
Depending on your platform there are about 200
2010/7/23 Martin laza...@mfriebe.de:
On a first glance, if the source is to complicated to explain tiself, the
you need comments.
But actually, then you need to clean up your source, so it becames readable
again.
Of course readable, is defined on the readers ability, and that varies =
It
On 7/23/2010 13:53, Bernd wrote:
Comments are for *other* people who might later read your code and
don't yet know how it works.
+1
plus they are also very helpful to you when you come back some time later and
don't remember what's going on or why ;)
comments are *always* helpful! There
2010/7/23 Mattias Gaertner nc-gaert...@netcologne.de:
You can see the html output of fpdoc when pressing F1 on an identifier.
It will pop up an error message that there is no help available
although I have created fpdoc help entries and the fpdoc editor shows
the entry when i am on this
2010/7/23 Bernd prof7...@googlemail.com:
You can install lhelp for an offline help viewer.
Trying this now.
This will give me a nice chm viewer if i additionally download the chm
files for LCL, FCL and RTL (the scripts in docs/html fail with some
file not found messages) but it still won't
There is something that could boost productivity and learning curve of
new developers by a factor of three at least and all needed
infrastructure (at least the hardest parts) for this feature seem to
be implemented and working already, it is just not (yet) used to its
full potential.
I have one
On Thu, 22 Jul 2010 16:38:03 +0200
Bernd prof7...@googlemail.com wrote:
[...]
It will show the text of the above comment when hovering the mouse
over any occurrence of this method call. This is a GREAT feature.
:)
It also shows the text of the fpdoc nodes.
Now here comes my complaint: 99%
On Thu, 22 Jul 2010 16:38:03 +0200, Bernd prof7...@googlemail.com wrote:
It will show the text of the above comment when hovering the mouse
over any occurrence of this method call. This is a GREAT feature.
It also shows fpdoc entries. That is even more useful ;-)
Now here comes my
2010/7/22 Andreas Schneider ak...@gmx.de:
Many classes and methods are already documented in fpdoc.
Ok, now I'm looking for these files but it seems It is not so easy to
find them anywhere on the ftp server or the website or sf.net. I am
using one of the recent snapshots and It would be nice
28 matches
Mail list logo