Zitat von Tom Verhoeff <T.Verhoeff@tue.nl>:

> I would like to throw up a suggestion for extending the editor's hinting
> functionality.
>
> We use Lazarus in a first-year introductory programming course.
> One of the rules in our coding standard is that every variable
> declaration needs to be accompanied by an explanatory comment.
>
> It would be nice if the editor could show the comment associated with the
> variable's declaration when you enter/point at an occurrence of that
> variable.
>
> This resembles the functionality where you get the routine prototype
> when entering/pointing at a routine invocation.
>
> Of course, this could apply to other names as well (constants, types,
> routines).  In fact, for routines, the prototype only shows you the
> _syntactic_ specifics of that routine.  _Semantic_ specifics are typically
> addressed in a comment.
>
> It might be necessary to use a special marker (cf. Javadoc) to
> help the editor recognize such comments-to-be-used-for-hinting.
>
> This functionality would further increase the value of adding comments
> to definitions and declarations.

Implemented in svn 16843.
For example:
var
  i: integer; // comment starting in same line
  c: char;
    {< long comment starting in next line}

Comments in front are not yet implemented.


> By the way, I hired a student (Thorstin Crijns) to do some work on
> improving Lazarus for educational use.  This should benefit all Lazarus
> users, both aspiring beginners and experienced users.

Great.


> You'll be hearing more from Thorstin in the future.
>
> I have asked him to start with the built-in help facility and
> documentation.  Other items on the list are the built-in debugger support,
> and template support.  Editor features could be another thing, but he
> will need more help there.

:)

Mattias



