On 31 May 2014, at 21:44, Adam Cox wrote:
>> + *
>> + * @bug WARNING: Currently (20 May 2014), this does not properly 
>> migrate attachments for resolutions that
>> + * choose revisions that are not the current winning revision. See 
>> CDTDatastore for details.
>
> Well, it gives a more verbose explanation with an example. What would 
> you
> like it to say?

A more specific link would be good (e.g., if it's in the class-level 
docs, an @see to there or if it's on a specific method, a link to that 
method).

Also, the way this is phrased, it's unclear whether you're referring to 
code or documentation -- I suggest something like "See the CDTDatastore 
class documentation for details" or "See the documentation for 
CDTDatastore#methodName for details" (or, however one links to 
methods!).