Update api docs and add test for exception case.

Author: markstory

Cake/ORM/Associations.php

@@ -91,8 +91,7 @@ public function drop($alias) {
  * @param array $associations The list of associations to save parents from.
  *   associations not in this list will not be saved.
  * @param array $options The options for the save operation.
- * @return Entity modified entity
- * @throws new \InvalidArgumentExceptio when an unknown alias is used.
+ * @return Entity Modified entity
  */
 	public function saveParents(Table $table, Entity $entity, $associations, $options = []) {
 		if (empty($associations)) {
@@ -113,7 +112,7 @@ public function saveParents(Table $table, Entity $entity, $associations, $option
  * @param array $associations The list of associations to save children from.
  *   associations not in this list will not be saved.
  * @param array $options The options for the save operation.
- * @return boolean success
+ * @return Entity Modified entity
  */
 	public function saveChildren(Table $table, Entity $entity, $associations, $options) {
 		if (empty($associations)) {
@@ -131,7 +130,8 @@ public function saveChildren(Table $table, Entity $entity, $associations, $optio
  * @param array $options Original options
  * @param boolean $owningSide Compared with association classes'
  *   isOwningSide method.
- * @return void
+ * @return Entity modified entity.
+ * @throws new \InvalidArgumentException When an unknown alias is used.
  */
 	protected function _saveAssociations($table, $entity, $associations, $options, $owningSide) {
 		foreach ($associations as $alias => $nested) {

Cake/Test/TestCase/ORM/AssociationsTest.php

@@ -214,4 +214,28 @@ public function testSaveChildrenFiltered() {
 		);
 		$this->assertSame($entity, $result);
 	}
+
+/**
+ * Test exceptional case.
+ *
+ * @expectedException \InvalidArgumentException
+ * @expectedExceptionMessage Cannot save Profiles, it is not associated to Users
+ */
+	public function testErrorOnUnknownAlias() {
+		$table = $this->getMock(
+			'Cake\ORM\Table',
+			['save'],
+			[['alias' => 'Users']]);
+
+		$entity = new Entity();
+		$entity->set('profile', ['key' => 'value']);
+
+		$this->associations->saveChildren(
+			$table,
+			$entity,
+			['Profiles'],
+			['atomic' => true]
+		);
+	}
+
 }