adding carets using keyboard: repeated action invocation on key hold
updating javadoc (following CR-IC-5846)