[doc] explain some port methods that were missing documentation