adds documentation for a parameter of pending()