added descriptions, also clarifying naming of methods
added descriptions, also clarifying naming of methods

realm/realm-core,realm/realm-core,realm/realm-core,realm/realm-core,realm/realm-core,realm/realm-core,realm/realm-core