docs(ngForm): clarify the purpose of ngForm

tbosch · tbosch · commit 549166740b94 · 2014-04-02T17:23:13.000-07:00
Related to #6704 and #2513.
diff --git a/src/ng/directive/form.js b/src/ng/directive/form.js
@@ -215,6 +215,10 @@ function FormController(element, attrs, $scope, $animate) {
  * does not allow nesting of form elements. It is useful to nest forms, for example if the validity of a
  * sub-group of controls needs to be determined.
  *
+ * Note: the purpose of `ngForm` is to group controls,
+ * but not to be a replacement for the `<form>` tag with all of its capabilities
+ * (e.g. posting to the server, ...).
+ *
  * @param {string=} ngForm|name Name of the form. If specified, the form controller will be published into
  *                       related scope, under this name.
  *

Original file line number	Diff line number	Diff line change
`@@ -215,6 +215,10 @@ function FormController(element, attrs, $scope, $animate) {`
`215`	`215`	`* does not allow nesting of form elements. It is useful to nest forms, for example if the validity of a`
`216`	`216`	`* sub-group of controls needs to be determined.`
`217`	`217`	`*`
	`218`	+ * Note: the purpose of `ngForm` is to group controls,
	`219`	+ * but not to be a replacement for the `<form>` tag with all of its capabilities
	`220`	`+ * (e.g. posting to the server, ...).`
	`221`	`+ *`
`218`	`222`	`* @param {string=} ngForm\|name Name of the form. If specified, the form controller will be published into`
`219`	`223`	`* related scope, under this name.`
`220`	`224`	`*`