From dbd703a9fb864b787bc90c45fd4eb5ded7422f24 Mon Sep 17 00:00:00 2001
From: Misko Hevery
Date: Thu, 1 Aug 2013 15:53:59 -0700
Subject: docs(compile/selmulti): description for compile/selmulti error

Closes #3459
---
 docs/content/error/compile/selmulti.ngdoc | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

(limited to 'docs/content/error')

diff --git a/docs/content/error/compile/selmulti.ngdoc b/docs/content/error/compile/selmulti.ngdoc
index d737ca35..8154cc67 100644
--- a/docs/content/error/compile/selmulti.ngdoc
+++ b/docs/content/error/compile/selmulti.ngdoc
@@ -2,3 +2,19 @@
 @name $compile:selmulti
 @fullName Binding to Multiple Attribute
 @description
+
+Binding to the `multiple` attribute of `select` element is not supported since switching between multiple and single mode changes the {@link api/ng.directive:ngModel `ngModel`} object type from instance to array of instances which breaks the model semantics.
+
+If you need to use different types of `select` elements in your template based on some variable, please use {@link api/ng.directive:ngIf ngIf} or {@link api/ng.directive:ngSwitch ngSwitch} directives to select one of them to be used at runtime.
+
+
+Example with invalid usage:
+```
+<select ng-model="some.model" multiple="{{mode}}"></select>
+```
+
+Example that uses ngIf to pick one of the `select` elements based on a variable:
+```
+<select ng-if="mode == 'multiple'" ng-model="some.model" multiple></select>
+<select ng-if="mode != 'multiple'" ng-model="some.model"></select>
+```
-- 
cgit v1.2.3