From ef12444a6c15cb2e30cdbb8420e3605144fa62b3 Mon Sep 17 00:00:00 2001
From: Mike Gerwitz <mike@mikegerwitz.com>
Date: Thu, 10 Nov 2011 23:02:26 -0500
Subject: [PATCH] [#5] Added additional inheritance information

---
 doc/classes.texi | 58 +++++++++++++++++++++++++++++++++++++++---------
 1 file changed, 48 insertions(+), 10 deletions(-)

diff --git a/doc/classes.texi b/doc/classes.texi
index e97a48e..94b75d8 100644
--- a/doc/classes.texi
+++ b/doc/classes.texi
@@ -502,17 +502,55 @@ condition that both @var{dfn\_n\^C'} and @var{dfn\_n\^C} are defined
 values.
 
 @var{C'} will @dfn{inherit} all public and protected members of supertype
-@var{C}. As such, it could be said that @var{dfn\^C'} = @var{dfn\^C} +
-@var{dfn}. For any condition @var{o} of any member @var{name}, member
-@var{dfn\_name\^C'} will be said to @dfn{override} member @var{dfn\_name\^C},
-provided that overriding member @var{name} passes all validation rules
-associated with the operation.
+@var{C} such that @var{dfn\_n\^C'} = @var{dfn\_n\^C} for each @var{dfn\^C}. For
+any positive condition @var{o\_n}, member @var{dfn\_n\^C'} will be said to
+@dfn{override} member @var{dfn\_n\^C}, provided that overriding member @var{n}
+passes all validation rules associated with the operation. A @code{protected}
+member may be @dfn{escalated} to @code{public}, but the reverse is untrue.
+@code{private} members are invisible to subtypes.
 
-For a condition @var{o\_name} where member @var{name} is defined as a method, it
-is required that @var{dfn\_name\^C} be declared with the @code{virtual} keyword
-and that @var{dfn\_name\^C'} be declared with the @code{override} keyword.
-Non-virtual methods cannot be overridden (same as the "final" keyword in
-languages like Java).
+For any positive condition @var{o\_n} where member @var{n} is defined as a
+@emph{method}:
+
+@itemize
+@item
+One of the following conditions must always be true:
+  @itemize
+  @item
+  @var{dfn\_n\^C} is declared with the @code{virtual} keyword and
+  @var{dfn\_n\^C'} is declared with the @code{override} keyword.
+  @itemize
+    @item
+    Note that @var{dfn\_n\^C'} will not become @code{virtual} by default (unlike
+    languages such as C++); they must be explicitly declared as such.
+  @end itemize
+  @item
+  @var{dfn\_n\^C} is declared with the @code{abstract} keyword and
+  @var{dfn\_n\^C'} omits the @code{override} keywords.
+  @end itemize
+@item
+The argument count of method @var{dfn\_n\^C'} must be >= the argument count of
+method @var{dfn\_n\^C} to permit polymorphism.
+@item
+A reference to super method @var{dfn\_n\^C} will be preserved and assigned to
+@samp{this.__super} within context of method @var{dfn\_n\^C'}.
+@item
+A method is said to be @dfn{concrete} when it provides a definition and
+@dfn{abstract} when it provides only a declaration.
+@itemize
+  @item
+  Any method @var{n} such that @var{dfn\_n\^C} is declared @code{abstract} may
+  be overridden by a concrete or abstract method @var{dfn\_n\^C'}.
+  @item
+  A method @var{n} may @emph{not} be declared @code{abstract} if @var{dfn\_n\^C}
+  is concrete.
+@end itemize
+@item
+Member @var{dfn\_n\^C} must be a method.
+@end itemize
+
+Members that have been declared @code{static} cannot be overridden
+(@pxref{Static Members}).
 
 @subsection Discussion
 Inheritance can be a touchy subject among many Object-Oriented developers due to