Closely related to @deprecated tag are also Delphi "hint directives" : deprecated, platform, library. pasdoc correctly parses and understands them.

Example (equivalent to example above but this time using deprecated hint directive):

{ This procedure is only for backward-compatibility, it may be
  removed in future versions of this unit. You should use
  @link(ConvertString) in new code. }
procedure OldConvertString(var MyString: ShortString); deprecated;

Using deprecated hint directive has the same meaning (for pasdoc) as using @deprecated tag in symbol’s description (i.e. in both cases pasdoc will print this red warning "Warning: this symbol is deprecated."). Where possible, you should probably use the deprecated hint directive, so that both compiler and pasdoc know abuot the deprecation. Both FPC and Delphi support it.

@deprecated tag may be useful because (at least old versions of) Delphi doesn’t allow hint directives for properties and non-structural types (although Kylix 3 help says that hint directives for any types are allowed). But pasdoc’s @deprecated tag may be freely specified for any item in your unit, including properties and any types.

pasdoc generates appropriate "red warnings" for all hint directives in the final documentation. See test unit ok_hint_directives.pas.