From cfc7e7a2e74339eae4d091f049ce5a336198bd60 Mon Sep 17 00:00:00 2001
From: tjcrowder <tj@crowdersoftware.com>
Date: Thu, 10 Sep 2009 17:45:11 +0100
Subject: [PATCH] doc: Convert all subheadings to H5s throughout.

---
 src/ajax.js                    |  6 ++---
 src/ajax/periodical_updater.js |  4 +--
 src/ajax/request.js            |  4 +--
 src/ajax/responders.js         |  2 +-
 src/ajax/updater.js            | 10 ++++----
 src/dom/dom.js                 |  2 +-
 src/dom/event.js               | 24 +++++++++---------
 src/dom/form.js                |  6 ++---
 src/lang/array.js              | 24 +++++++++---------
 src/lang/class.js              |  2 +-
 src/lang/date.js               |  2 +-
 src/lang/enumerable.js         | 46 +++++++++++++++++-----------------
 src/lang/function.js           | 14 +++++------
 src/lang/hash.js               | 24 +++++++++---------
 src/lang/number.js             |  6 ++---
 src/lang/object.js             |  2 +-
 src/lang/string.js             | 10 ++++----
 src/lang/template.js           |  8 +++---
 18 files changed, 98 insertions(+), 98 deletions(-)

diff --git a/src/ajax.js b/src/ajax.js
index 3102025..88a1f52 100644
--- a/src/ajax.js
+++ b/src/ajax.js
@@ -8,7 +8,7 @@
  *
  *  Actual requests are made by creating instances of [[Ajax.Request]].
  *
- *  <h4>Request headers</h4>
+ *  <h5>Request headers</h5>
  *
  *  The following headers are sent with all Ajax requests (and can be
  *  overridden with the `requestHeaders` option described below):
@@ -21,7 +21,7 @@
  *  * `Content-type` is automatically determined based on the `contentType`
  *    and `encoding` options.
  *
- *  <h4>Ajax options</h4>
+ *  <h5>Ajax options</h5>
  *
  *  All Ajax classes share a common set of _options_ and _callbacks_.
  *  Callbacks are called at various points in the life-cycle of a request, and
@@ -64,7 +64,7 @@
  *    `true` otherwise): Sanitizes the contents of
  *    [[Ajax.Response#responseText]] before evaluating it.
  *
- *  <h4>Common callbacks</h4>
+ *  <h5>Common callbacks</h5>
  *
  *  When used on individual instances, all callbacks (except `onException`) are
  *  invoked with two parameters: the `XMLHttpRequest` object and the result of
diff --git a/src/ajax/periodical_updater.js b/src/ajax/periodical_updater.js
index 3214273..d5fa4ef 100644
--- a/src/ajax/periodical_updater.js
+++ b/src/ajax/periodical_updater.js
@@ -16,7 +16,7 @@
  *  keeping track of the response text so it can (optionally) react to
  *  receiving the exact same response consecutively.
  *
- *  <h4>Additional options</h4>
+ *  <h5>Additional options</h5>
  *
  *  `Ajax.PeriodicalUpdater` features all the common options and callbacks
  *  described in the [[Ajax section]] &mdash; _plus_ those added by `Ajax.Updater`.
@@ -34,7 +34,7 @@
  *    is the same; when the result is different once again, `frequency` will
  *    revert to its original value.
  *
- *  <h4>Disabling and re-enabling a <code>PeriodicalUpdater</code></h4>
+ *  <h5>Disabling and re-enabling a <code>PeriodicalUpdater</code></h5>
  *
  *  You can hit the brakes on a running `PeriodicalUpdater` by calling
  *  [[Ajax.PeriodicalUpdater#stop]]. If you wish to re-enable it later, call
diff --git a/src/ajax/request.js b/src/ajax/request.js
index b79df17..352cc48 100644
--- a/src/ajax/request.js
+++ b/src/ajax/request.js
@@ -5,7 +5,7 @@
  *
  *  `Ajax.Request` is a general-purpose class for making HTTP requests.
  *
- *  <h4>Automatic JavaScript response evaluation</h4>
+ *  <h5>Automatic JavaScript response evaluation</h5>
  *
  *  If an Ajax request follows the _same-origin policy_ **and** its response
  *  has a JavaScript-related `Content-type`, the content of the `responseText`
@@ -28,7 +28,7 @@
  *
  *  The MIME-type string is examined in a case-insensitive manner.
  *
- *  <h4>Methods you may find useful</h4>
+ *  <h5>Methods you may find useful</h5>
  *
  *  Instances of the `Request` object provide several methods that can come in
  *  handy in your callback functions, especially once the request is complete.
diff --git a/src/ajax/responders.js b/src/ajax/responders.js
index 8fe5c26..c9ed244 100644
--- a/src/ajax/responders.js
+++ b/src/ajax/responders.js
@@ -34,7 +34,7 @@
  *        }
  *      });
  *
- *  <h4>Responder callbacks</h4>
+ *  <h5>Responder callbacks</h5>
  *
  *  The callbacks for responders are similar to the callbacks described in
  *  the [[Ajax section]], but take a different signature. They're invoked with
diff --git a/src/ajax/updater.js b/src/ajax/updater.js
index 6979dfa..7cb23da 100644
--- a/src/ajax/updater.js
+++ b/src/ajax/updater.js
@@ -7,7 +7,7 @@
  *  `Ajax.Updater` is a subclass of [[Ajax.Request]] built for a common
  *  use-case.
  *
- *  <h4>Example</h4>
+ *  <h5>Example</h5>
  *
  *      new Ajax.Updater('items', '/items', {
  *        parameters: { text: $F('text') }
@@ -17,13 +17,13 @@
  *  parameters); it will then replace the contents of the element with the ID
  *  of `items` with whatever response it receives.
  *
- *  <h4>Callbacks</h4>
+ *  <h5>Callbacks</h5>
  *
  *  `Ajax.Updater` supports all the callbacks listed in the [[Ajax section]].
  *  Note that the `onComplete` callback will be invoked **after** the element
  *  is updated.
  *
- *  <h4>Additional options</h4>
+ *  <h5>Additional options</h5>
  *
  *  `Ajax.Updater` has some options of its own apart from the common options
  *  described in the [[Ajax section]]:
@@ -37,7 +37,7 @@
  *    `top`, `bottom`, `before`, or `after` &mdash; and _inserts_ the contents of the
  *    response in the manner described by [[Element#insert]].
  *
- *  <h4>More About `evalScripts`</h4>
+ *  <h5>More About `evalScripts`</h5>
  *
  *  If you use `evalScripts: true`, any _inline_ `<script>` block will be evaluated.
  *  This **does not** mean it will be evaluated in the global scope; it won't, and that
@@ -45,7 +45,7 @@
  *  that only inline `<script>` blocks are supported; external scripts are ignored.
  *  See [[String#evalScripts]] for the details.
  *
- *  <h4>Single container, or success/failure split?</h4>
+ *  <h5>Single container, or success/failure split?</h5>
  *
  *  The examples above all assume you're going to update the same container
  *  whether your request succeeds or fails. Instead, you may want to update
diff --git a/src/dom/dom.js b/src/dom/dom.js
index 5713f03..3fae168 100644
--- a/src/dom/dom.js
+++ b/src/dom/dom.js
@@ -320,7 +320,7 @@ Element.Methods = {
    *  - `top` (as `element`'s first child)
    *  - `bottom` (as `element`'s last child)
    *
-   *  <h4>Examples</h4>
+   *  <h5>Examples</h5>
    *
    *  Insert the given HTML at the bottom of the element (using the default):
    *
diff --git a/src/dom/event.js b/src/dom/event.js
index af7f01d..7980c52 100644
--- a/src/dom/event.js
+++ b/src/dom/event.js
@@ -5,7 +5,7 @@
    *
    *  The namespace for Prototype's event system.
    *
-   *  <h4>Events: a fine mess</h4>
+   *  <h5>Events: a fine mess</h5>
    *
    *  Event management is one of the really sore spots of cross-browser
    *  scripting.
@@ -17,7 +17,7 @@
    *  Safari). Also, MSIE has a tendency to leak memory when it comes to
    *  discarding event handlers.
    *
-   *  <h4>Prototype to the rescue</h4>
+   *  <h5>Prototype to the rescue</h5>
    *
    *  Of course, Prototype smooths it over so well you'll forget these
    *  troubles even exist. Enter the `Event` namespace. It is replete with
@@ -418,7 +418,7 @@
    *
    *  The examples in this documentation use the [[Element#observe]] form.
    *
-   *  <h4>The Handler</h4>
+   *  <h5>The Handler</h5>
    *
    *  Signature:
    *
@@ -435,13 +435,13 @@
    *  Note that we used `this` to refer to the element, and that we received the `event` object
    *  as a parameter (even on MSIE).
    *
-   *  <h4>It's All About Timing</h4>
+   *  <h5>It's All About Timing</h5>
    *
    *  One of the most common errors trying to observe events is trying to do it before the element
    *  exists in the DOM. Don't try to observe elements until after the
    *  [[document.observe dom:loaded]] event or `window` `load` event has been fired.
    *
-   *  <h4>Preventing the Default Event Action and Bubbling</h4>
+   *  <h5>Preventing the Default Event Action and Bubbling</h5>
    *
    *  If we want to stop the event (e.g., prevent its default action and stop it bubbling), we can
    *  do so with the extended event object's [[Event#stop]] method:
@@ -450,7 +450,7 @@
    *        event.stop();
    *      });
    *
-   *  <h4>Finding the Element Where the Event Occurred</h4>
+   *  <h5>Finding the Element Where the Event Occurred</h5>
    *
    *  Since most events bubble from descendant elements up through the hierarchy until they're
    *  handled, we can observe an event on a container rather than individual elements within the
@@ -481,12 +481,12 @@
    *  record was clicked. [[Event#findElement]] finds the row that was clicked, and `this` refers
    *  to the table we were observing.
    *
-   *  <h4>Stopping Observing the Event</h4>
+   *  <h5>Stopping Observing the Event</h5>
    *
    *  If we don't need to observe the event anymore, we can stop observing it with
    *  [[Event.stopObserving]] (aka [[Element#stopObserving]]).
    *
-   *  <h4>Using an Instance Method as a Handler</h4>
+   *  <h5>Using an Instance Method as a Handler</h5>
    *
    *  If we want to use an instance method as a handler, we will probably want to use
    *  [[Function#bind]] to set the handler's context; otherwise, the context will be lost and
@@ -511,13 +511,13 @@
    *  details. There's also [[Function#bindAsEventListener]], which is handy for certain very
    *  specific situations. (Normally, `bind` is all you need.)
    *
-   *  <h4>Side Notes</h4>
+   *  <h5>Side Notes</h5>
    *
    *  Although Prototype smooths out most of the differences between browsers, the fundamental
    *  behavior of a browser implementation isn't changed. For example, the timing of the `change`
    *  or `blur` events varies a bit from browser to browser.
    *
-   *  <h4>Changes in 1.6.x</h4>
+   *  <h5>Changes in 1.6.x</h5>
    *
    *  Prior to Prototype 1.6, `observe` supported a fourth argument (`useCapture`), a boolean that
    *  indicated whether to use the browser's capturing phase or its bubbling phase. Since MSIE does
@@ -572,7 +572,7 @@
    *  for that `eventName`. If `eventName` is also omitted, unregisters _all_
    *  event handlers on `element`. (In each case, only affects handlers registered via Prototype.)
    *
-   *  <h4>Examples</h4>
+   *  <h5>Examples</h5>
    *
    *  Assuming:
    *
@@ -591,7 +591,7 @@
    *
    *      $('foo').stopObserving();
    *
-   *  <h4>A Common Error</h4>
+   *  <h5>A Common Error</h5>
    *
    *  When using instance methods as observers, it's common to use [[Function#bind]] on them, e.g.:
    *
diff --git a/src/dom/form.js b/src/dom/form.js
index 37f4b13..e23d2bc 100644
--- a/src/dom/form.js
+++ b/src/dom/form.js
@@ -39,7 +39,7 @@ var Form = {
    *  the value for that key in the object will be an array of the field values
    *  in the order they appeared on the array of elements.
    *
-   *  <h4>The Options</h4>
+   *  <h5>The Options</h5>
    *
    *  The options allow you to control two things: What kind of return
    *  value you get (an object or a string), and whether and which `submit`
@@ -64,7 +64,7 @@ var Form = {
    *  _(Deprecated)_ If you pass in a [[Boolean]] instead of an object for `options`, it
    *  is used as the `hash` option and all other options are defaulted.
    *
-   *  <h4>A <em>hash</em>, not a Hash</h4>
+   *  <h5>A <em>hash</em>, not a Hash</h5>
    *
    *  If you opt to receive an object, it is a plain JavaScript object with keys
    *  and values, __not__ a [[Hash]]. All JavaScript objects are hashes in the lower-case
@@ -490,7 +490,7 @@ Form.Element.Serializers = {
  *  [[Form.Observer]], which serializes a form and triggers when the result has changed; and
  *  [[Form.Element.Observer]], which triggers when the value of a given form field changes.
  *
- *  <h4>Creating Your Own TimedObserver Implementations</h4>
+ *  <h5>Creating Your Own TimedObserver Implementations</h5>
  *
  *  It's easy to create your own `TimedObserver` implementations: Simply subclass `TimedObserver`
  *  and provide the `getValue()` method. For example, this is the complete source code for
diff --git a/src/lang/array.js b/src/lang/array.js
index 9a2f672..389a122 100644
--- a/src/lang/array.js
+++ b/src/lang/array.js
@@ -52,7 +52,7 @@ Array.from = $A;
  *  their `[]` indexing operator. They become very powerful objects that
  *  greatly simplify the code for 99% of the common use cases involving them.
  *
- *  <h4>Why you should stop using for...in to iterate</h4>
+ *  <h5>Why you should stop using for...in to iterate</h5>
  *
  *  Many JavaScript authors have been misled into using the `for...in` JavaScript
  *  construct to loop over array elements. This kind of code just won't work
@@ -77,7 +77,7 @@ Array.from = $A;
  *  those coming from the [[Enumerable]] module, and those Prototype puts in the
  *  Array namespace (listed further below).
  *
- *  <h4>What you should use instead</h4>
+ *  <h5>What you should use instead</h5>
  *
  *  You can revert to vanilla loops:
  *
@@ -99,7 +99,7 @@ Array.from = $A;
  *  module. So manual loops should be fairly rare.
  *
  *
- *  <h4>A note on performance</h4>
+ *  <h5>A note on performance</h5>
  *
  *  Should you have a very large array, using iterators with lexical closures
  *  (anonymous functions that you pass to the iterators and that get invoked at
@@ -134,7 +134,7 @@ Array.from = $A;
    *
    *  Clears the array (makes it empty) and returns the array reference.
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      var guys = ['Sam', 'Justin', 'Andrew', 'Dan'];
    *      guys.clear();
@@ -170,7 +170,7 @@ Array.from = $A;
    *
    *  Returns a **copy** of the array without any `null` or `undefined` values.
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      var orig = [undefined, 'A', undefined, 'B', null, 'C'];
    *      var copy = orig.compact();
@@ -193,7 +193,7 @@ Array.from = $A;
    *  useful when handling the results of a recursive collection algorithm,
    *  for instance.
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      var a = ['frank', ['bob', 'lisa'], ['jill', ['tom', 'sally']]];
    *      var b = a.flatten();
@@ -216,7 +216,7 @@ Array.from = $A;
    *  Produces a new version of the array that does not contain any of the
    *  specified values, leaving the original array unchanged.
    *
-   *  ### Examples
+   *  <h5>Examples</h5>
    *
    *      [3, 5, 6].without(3)
    *      // -> [5, 6]
@@ -238,7 +238,7 @@ Array.from = $A;
    *
    *  Reverses the array's contents, optionally cloning it first.
    *
-   *  ### Examples
+   *  <h5>Examples</h5>
    *
    *      // Making a copy
    *      var nums = [3, 5, 6, 1, 20];
@@ -266,7 +266,7 @@ Array.from = $A;
    *  On large arrays when `sorted` is `false`, this method has a potentially
    *  large performance cost.
    *
-   *  ### Examples
+   *  <h5>Examples</h5>
    *
    *      [1, 3, 2, 1].uniq();
    *      // -> [1, 2, 3]
@@ -325,7 +325,7 @@ Array.from = $A;
    *
    *  Returns the debug-oriented string representation of an array.
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      ['Apples', {good: 'yes', bad: 'no'}, 3, 34].inspect()
    *      // -> "['Apples', [object Object], 3, 34]"
@@ -339,7 +339,7 @@ Array.from = $A;
    *
    *  Returns a JSON string representation of the array.
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      ['a', {b: null}].toJSON();
    *      //-> '["a", {"b": null}]'
@@ -363,7 +363,7 @@ Array.from = $A;
    *  or `-1` if `item` doesn't exist in the array. `Array#indexOf` compares
    *  items using *strict equality* (`===`).
    *
-   *  ### Examples
+   *  <h5>Examples</h5>
    *
    *      [3, 5, 6, 1, 20].indexOf(1)
    *      // -> 3
diff --git a/src/lang/class.js b/src/lang/class.js
index bbf6eac..68b1fe6 100644
--- a/src/lang/class.js
+++ b/src/lang/class.js
@@ -86,7 +86,7 @@ var Class = (function() {
    *  of the class and of all its subclasses, even those that have already been
    *  instantiated.
    *
-   *  <h4>Examples</h4>
+   *  <h5>Examples</h5>
    *
    *      var Animal = Class.create({
    *        initialize: function(name, sound) {
diff --git a/src/lang/date.js b/src/lang/date.js
index e67338b..1e2494a 100644
--- a/src/lang/date.js
+++ b/src/lang/date.js
@@ -10,7 +10,7 @@
  *  Produces a string representation of the date in ISO 8601 format.
  *  The time zone is always UTC, as denoted by the suffix "Z".
  *
- *  ### Example
+ *  <h5>Example</h5>
  *
  *      var d = new Date(1969, 11, 31, 19);
  *      d.getTimezoneOffset();
diff --git a/src/lang/enumerable.js b/src/lang/enumerable.js
index 300ae5b..598505b 100644
--- a/src/lang/enumerable.js
+++ b/src/lang/enumerable.js
@@ -12,7 +12,7 @@
  *  are [[Array]] and [[Hash]], but you'll find it in less obvious spots as
  *  well, such as in [[ObjectRange]] and various DOM- or Ajax-related objects.
  *
- *  <h4>The <code>context</code> parameter</h4>
+ *  <h5>The <code>context</code> parameter</h5>
  *
  *  Every method of `Enumerable` that takes an iterator also takes the "context
  *  object" as the next (optional) parameter. The context object is what the
@@ -31,7 +31,7 @@
  *  If there is no `context` argument, the iterator function will execute in
  *  the scope from which the `Enumerable` method itself was called.
  *
- *  <h4>Mixing <code>Enumerable</code> into your own objects</h4>
+ *  <h5>Mixing <code>Enumerable</code> into your own objects</h5>
  *
  *  So, let's say you've created your very own collection-like object (say,
  *  some sort of Set, or perhaps something that dynamically fetches data
@@ -93,12 +93,12 @@ var Enumerable = (function() {
    *
    *  Calls `iterator` for each item in the collection.
    *
-   *  ### Examples
+   *  <h5>Examples</h5>
    *
    *      ['one', 'two', 'three'].each(alert);
    *      // Alerts "one", then alerts "two", then alerts "three"
    *
-   *  ### Built-In Variants
+   *  <h5>Built-In Variants</h5>
    *
    *  Most of the common use cases for `each` are already available pre-coded
    *  as other methods on `Enumerable`. Whether you want to find the first
@@ -131,7 +131,7 @@ var Enumerable = (function() {
    *  fewer than `number` items; it won't "pad" the last group with empty
    *  values. For that behavior, use [[Enumerable#inGroupsOf]].
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      var students = [
    *        { name: 'Sunny', age: 20 },
@@ -168,7 +168,7 @@ var Enumerable = (function() {
    *  is boolean-equivalent to `false`, such as `undefined`, `0`, or indeed
    *  `false`);
    *
-   *  ### Examples
+   *  <h5>Examples</h5>
    *
    *      [].all();
    *      // -> true (empty arrays have no elements that could be falsy)
@@ -203,7 +203,7 @@ var Enumerable = (function() {
    *  Determines whether at least one element is truthy (boolean-equivalent to
    *  `true`), either directly or through computation by the provided iterator.
    *
-   *  ### Examples
+   *  <h5>Examples</h5>
    *
    *      [].any();
    *      // -> false (empty arrays have no elements that could be truthy)
@@ -235,7 +235,7 @@ var Enumerable = (function() {
    *  `iterator` is provided, the elements are simply copied to the
    *  returned array.
    *
-   *  ### Examples
+   *  <h5>Examples</h5>
    *
    *      ['Hitch', "Hiker's", 'Guide', 'to', 'the', 'Galaxy'].collect(function(s) {
    *        return s.charAt(0).toUpperCase();
@@ -266,7 +266,7 @@ var Enumerable = (function() {
    *  Returns the first element for which the iterator returns a truthy value.
    *  Aliased by the [[Enumerable#find]] method.
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      [1, 7, -2, -4, 5].detect(function(n) { return n < 0; });
    *      // -> -2
@@ -291,7 +291,7 @@ var Enumerable = (function() {
    *  Returns all the elements for which the iterator returned a truthy value.
    *  For the opposite operation, see [[Enumerable#reject]].
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      [1, 'two', 3, 'four', 5].findAll(Object.isString);
    *      // -> ['two', 'four']
@@ -326,7 +326,7 @@ var Enumerable = (function() {
    *  or a falsy value not to. Note that the `RegExp` `match` function will
    *  convert elements to Strings to perform matching.
    *
-   *  ### Examples
+   *  <h5>Examples</h5>
    *
    *      // Get all strings containing a repeated letter
    *      ['hello', 'world', 'this', 'is', 'cool'].grep(/(.)\1/);
@@ -358,7 +358,7 @@ var Enumerable = (function() {
    *  based on the `==` comparison operator (equality with implicit type
    *  conversion).
    *
-   *  ### Examples
+   *  <h5>Examples</h5>
    *
    *      $R(1, 15).include(10);
    *      // -> true
@@ -392,7 +392,7 @@ var Enumerable = (function() {
    *  Like [[Enumerable#eachSlice]], but pads out the last chunk with the
    *  specified value if necessary and doesn't support the `iterator` function.
    *
-   *  ### Examples
+   *  <h5>Examples</h5>
    *
    *      var students = [
    *        { name: 'Sunny',  age: 20 },
@@ -434,7 +434,7 @@ var Enumerable = (function() {
    *  argument, the element as its second argument, and the element's index as
    *  its third. It returns the new value for the accumulator.
    *
-   *  ### Examples
+   *  <h5>Examples</h5>
    *
    *      $R(1,10).inject(0, function(acc, n) { return acc + n; });
    *      // -> 55 (sum of 1 to 10)
@@ -462,7 +462,7 @@ var Enumerable = (function() {
    *  Invokes the same method, with the same arguments, for all items in a
    *  collection. Returns an array of the results of the method calls.
    *
-   *  ### Examples
+   *  <h5>Examples</h5>
    *
    *      ['hello', 'world'].invoke('toUpperCase');
    *      // -> ['HELLO', 'WORLD']
@@ -499,7 +499,7 @@ var Enumerable = (function() {
    *  evaluated, and its index in the enumeration; it should return the value
    *  `max` should consider (and potentially return).
    *
-   *  ### Examples
+   *  <h5>Examples</h5>
    *
    *      ['c', 'b', 'a'].max();
    *      // -> 'c'
@@ -539,7 +539,7 @@ var Enumerable = (function() {
    *  evaluated, and its index in the enumeration; it should return the value
    *  `min` should consider (and potentially return).
    *
-   *  ### Examples
+   *  <h5>Examples</h5>
    *
    *      ['c', 'b', 'a'].min();
    *      // -> 'a'
@@ -578,7 +578,7 @@ var Enumerable = (function() {
    *  then using [[Enumerable#reject]] because the enumeration is only processed
    *  once.
    *
-   *  ### Examples
+   *  <h5>Examples</h5>
    *
    *      ['hello', null, 42, false, true, , 17].partition();
    *      // -> [['hello', 42, true, 17], [null, false, undefined]]
@@ -606,7 +606,7 @@ var Enumerable = (function() {
    *  and [[Enumerable#each]]: fetching the same property for all of the
    *  elements. Returns an array of the property values.
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      ['hello', 'world', 'this', 'is', 'nice'].pluck('length');
    *      // -> [5, 5, 4, 2, 4]
@@ -628,7 +628,7 @@ var Enumerable = (function() {
    *  Returns all the elements for which the iterator returns a falsy value.
    *  For the opposite operation, see [[Enumerable#findAll]].
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      [1, "two", 3, "four", 5].reject(Object.isString);
    *      // -> [1, 3, 5]
@@ -657,7 +657,7 @@ var Enumerable = (function() {
    *  `sortBy` does not guarantee a *stable* sort; adjacent equivalent elements
    *  may be swapped.
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      ['hello', 'world', 'this', 'is', 'nice'].sortBy(function(s) {
    *        return s.length;
@@ -681,7 +681,7 @@ var Enumerable = (function() {
    *
    *  Returns an Array containing the elements of the enumeration.
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      $R(1, 5).toArray();
    *      // -> [1, 2, 3, 4, 5]
@@ -708,7 +708,7 @@ var Enumerable = (function() {
    *  If supplied, `iterator` is called with each tuple as its only argument
    *  and should return the value to use in place of that tuple.
    *
-   *  ### Examples
+   *  <h5>Examples</h5>
    *
    *      var firstNames = ['Jane', 'Nitin', 'Guy'];
    *      var lastNames  = ['Doe',  'Patel', 'Forcier'];
diff --git a/src/lang/function.js b/src/lang/function.js
index 3044451..0d56113 100644
--- a/src/lang/function.js
+++ b/src/lang/function.js
@@ -24,7 +24,7 @@ Object.extend(Function.prototype, (function() {
    *  the values as an array of strings (or an empty array if the function is
    *  defined without parameters).
    *
-   *  ### Examples
+   *  <h5>Examples</h5>
    *
    *      function fn(foo, bar) {
    *        return foo + bar;
@@ -52,7 +52,7 @@ Object.extend(Function.prototype, (function() {
    *  function is called, it will call the original ensuring that `this` is set
    *  to `context`. Also optionally curries arguments for the function.
    *
-   *  ### Examples
+   *  <h5>Examples</h5>
    *
    *  A typical use of `Function#bind` is to ensure that a callback (event
    *  handler, etc.) that is an object method gets called with the correct
@@ -136,7 +136,7 @@ Object.extend(Function.prototype, (function() {
    *    This mostly happens if the number of arguments will vary, and so you
    *    want to know the event object is the first argument.
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      var ContentUpdater = Class.create({
    *        initialize: function(initialData) {
@@ -226,7 +226,7 @@ Object.extend(Function.prototype, (function() {
    *  To schedule a function to run as soon as the interpreter is idle, use
    *  [[Function#defer]].
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      function showMsg(msg) {
    *        alert(msg);
@@ -255,7 +255,7 @@ Object.extend(Function.prototype, (function() {
    *  ID that can be used to clear the timeout with `window.clearTimeout` before
    *  it runs.
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      function showMsg(msg) {
    *        alert(msg);
@@ -293,7 +293,7 @@ Object.extend(Function.prototype, (function() {
    *  indirection in-between that sets up the proper context \[`this` value\] for
    *  it.)
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      // Wrap String#capitalize so it accepts an additional argument
    *      String.prototype.capitalize = String.prototype.capitalize.wrap(
@@ -333,7 +333,7 @@ Object.extend(Function.prototype, (function() {
    *  want to transform a function that takes an object to a method of that
    *  object or its prototype, shortening its signature by one argument.
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      // A function that sets a name on a target object
    *      function setName(target, name) {
diff --git a/src/lang/hash.js b/src/lang/hash.js
index 801ad90..3ff86c0 100644
--- a/src/lang/hash.js
+++ b/src/lang/hash.js
@@ -22,7 +22,7 @@ function $H(object) {
  *  methods that let you enumerate keys and values, iterate over key/value
  *  pairs, merge two hashes together, and much more.
  *
- *  <h4>Creating a hash</h4>
+ *  <h5>Creating a hash</h5>
  *
  *  You can create a Hash either via `new Hash()` or the convenience alias
  *  `$H()`; there is **no** difference between them. In either case, you may
@@ -67,7 +67,7 @@ var Hash = Class.create(Enumerable, (function() {
    *  implementations exhibit *ordered* behavior, this is not standardized and
    *  may not always be the case, and so cannot be relied upon.
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      var h = $H({version: 1.6, author: 'The Core Team'});
    *
@@ -96,7 +96,7 @@ var Hash = Class.create(Enumerable, (function() {
    *
    *  Stores `value` in the hash using the key `key` and returns `value`.
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      var h = $H();
    *      h.keys();
@@ -117,7 +117,7 @@ var Hash = Class.create(Enumerable, (function() {
    *
    *  Returns the stored value for the given `key`.
    *
-   *  ### Examples
+   *  <h5>Examples</h5>
    *
    *      var h = new Hash({a: 'apple', b: 'banana', c: 'coconut'});
    *      h.get('a');
@@ -135,7 +135,7 @@ var Hash = Class.create(Enumerable, (function() {
    *  Deletes the stored pair for the given `key` from the hash and returns its
    *  value.
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      var h = new Hash({a: 'apple', b: 'banana', c: 'coconut'});
    *      h.keys();
@@ -157,7 +157,7 @@ var Hash = Class.create(Enumerable, (function() {
    *  Returns a cloned, vanilla object whose properties (and property values)
    *  match the keys (and values) from the hash.
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      var h = new Hash({ a: 'apple', b: 'banana', c: 'coconut' });
    *      var obj = h.toObject();
@@ -175,7 +175,7 @@ var Hash = Class.create(Enumerable, (function() {
    *
    *  The order of the keys is not guaranteed.
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      var h = $H({one: "uno", two: "due", three: "tre"});
    *      h.keys();
@@ -192,7 +192,7 @@ var Hash = Class.create(Enumerable, (function() {
    *
    *  The order of the values is not guaranteed.
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      var h = $H({one: "uno", two: "due", three: "tre"});
    *      h.values();
@@ -225,7 +225,7 @@ var Hash = Class.create(Enumerable, (function() {
    *
    *  To modify the original hash in place, use [[Hash#update]].
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      var h = $H({one: "uno", two: "due"});
    *      var h2 = h.merge({three: "tre"});
@@ -249,7 +249,7 @@ var Hash = Class.create(Enumerable, (function() {
    *  `update` modifies the hash. To get a new hash instead, use
    *  [[Hash#merge]].
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      var h = $H({one: "uno", two: "due"});
    *      h.update({three: "tre"});
@@ -289,7 +289,7 @@ var Hash = Class.create(Enumerable, (function() {
    *  The order of pairs in the string is not guaranteed, other than the order
    *  of array values described above.
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      $H({action: 'ship',
    *          order_id: 123,
@@ -337,7 +337,7 @@ var Hash = Class.create(Enumerable, (function() {
    *
    *  Returns a JSON string containing the keys and values in this hash.
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      var h = $H({'a': 'apple', 'b': 23, 'c': false});
    *      h.toJSON();
diff --git a/src/lang/number.js b/src/lang/number.js
index 643d1e9..459d9dc 100644
--- a/src/lang/number.js
+++ b/src/lang/number.js
@@ -20,7 +20,7 @@ Object.extend(Number.prototype, (function() {
    *  (which is therefore assumed to be in the \[0..255\] range, inclusive).
    *  Useful for composing CSS color strings.
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      10.toColorPart()
    *      // -> "0a"
@@ -49,7 +49,7 @@ Object.extend(Number.prototype, (function() {
    *  the first parameter. The number will be 0 on first call, 1 on second
    *  call, etc. `times` returns the number instance it was called on.
    *
-   *  ### Example
+   *  <h5>Example</h5>
    *
    *      (3).times(alert);
    *      // -> Alerts "0", then "1", then "2"; returns 3
@@ -81,7 +81,7 @@ Object.extend(Number.prototype, (function() {
    *  that the string's length is at least equal to `length`. Takes an optional
    *  `radix` argument which specifies the base to use for conversion.
    *
-   *  ### Examples
+   *  <h5>Examples</h5>
    *
    *      (13).toPaddedString(4);
    *      // -> "0013"
diff --git a/src/lang/object.js b/src/lang/object.js
index 6676045..10c3023 100644
--- a/src/lang/object.js
+++ b/src/lang/object.js
@@ -173,7 +173,7 @@
    *  Do note that this is a _shallow_ copy, not a _deep_ copy. Nested objects
    *  will retain their references.
    *
-   *  ### Examples
+   *  <h5>Examples</h5>
    *
    *      var original = {name: 'primaryColors', values: ['red', 'green', 'blue']};
    *      var copy = Object.clone(original);
diff --git a/src/lang/string.js b/src/lang/string.js
index 09fd464..e141180 100644
--- a/src/lang/string.js
+++ b/src/lang/string.js
@@ -127,7 +127,7 @@ Object.extend(String.prototype, (function() {
    *  `span`, and `abbr`. It _will not_ strip namespace-prefixed tags such
    *  as `h:table` or `xsl:template`.
    *
-   *  <h4>Caveat User</h4>
+   *  <h5>Caveat User</h5>
    *
    *  Note that the processing `stripTags` does is good enough for most purposes, but
    *  you cannot rely on it for security purposes. If you're processing end-user-supplied
@@ -145,12 +145,12 @@ Object.extend(String.prototype, (function() {
    *
    *  Strips a string of things that look like an HTML script blocks.
    *
-   *  <h4>Example</h4>
+   *  <h5>Example</h5>
    *
    *      "<p>This is a test.<script>alert("Look, a test!");</script>End of test</p>".stripScripts();
    *      // => "<p>This is a test.End of test</p>"
    *
-   *  <h4>Caveat User</h4>
+   *  <h5>Caveat User</h5>
    *
    *  Note that the processing `stripScripts` does is good enough for most purposes,
    *  but you cannot rely on it for security purposes. If you're processing end-user-supplied
@@ -183,7 +183,7 @@ Object.extend(String.prototype, (function() {
    *  they were empty (the result for that position in the array will be `undefined`);
    *  external files are _not_ loaded and processed by `evalScripts`.
    *
-   *  <h4>About `evalScripts`, `var`s, and defining functions</h4>
+   *  <h5>About `evalScripts`, `var`s, and defining functions</h5>
    *
    *  `evalScripts` evaluates script blocks, but this **does not** mean they are
    *  evaluated in the global scope. They aren't, they're evaluated in the scope of
@@ -302,7 +302,7 @@ Object.extend(String.prototype, (function() {
    *  Converts a string separated by dashes into a camelCase equivalent.
    *  For instance, 'foo-bar' would be converted to 'fooBar'.
    *
-   *  <h4>Examples</h4>
+   *  <h5>Examples</h5>
    *
    *      'background-color'.camelize();
    *      // -> 'backgroundColor'
diff --git a/src/lang/template.js b/src/lang/template.js
index 435a3e7..cb9020d 100644
--- a/src/lang/template.js
+++ b/src/lang/template.js
@@ -14,7 +14,7 @@
  *  expression. The `Template` class provides a much nicer and clearer way of
  *  achieving this formatting.
  *
- *  <h4>Straightforward templates</h4>
+ *  <h5>Straightforward templates</h5>
  *
  *  The `Template` class uses a basic formatting syntax, similar to what is
  *  used in Ruby. The templates are created from strings that have embedded
@@ -36,7 +36,7 @@
  *      myTemplate.evaluate(show);
  *      // -> "The TV show The Simpsons was created by Matt Groening."
  *
- *  <h4>Templates are meant to be reused</h4>
+ *  <h5>Templates are meant to be reused</h5>
  *
  *  As the example illustrates, `Template` objects are not tied to specific
  *  data. The data is bound to the template only during the evaluation of the
@@ -60,7 +60,7 @@
  *      // -> Multiply by 0.9478 to convert from kilojoules to BTUs.
  *      // -> Multiply by 1024 to convert from megabytes to gigabytes.
  *
- *  <h4>Escape sequence</h4>
+ *  <h5>Escape sequence</h5>
  *
  *  There's always the chance that one day you'll need to have a literal in your
  *  template that looks like a symbol, but is not supposed to be replaced. For
@@ -75,7 +75,7 @@
  *      t.evaluate(data);
  *      // -> in Ruby we also use the #{variable} syntax for templates.
  *
- *  <h4>Custom syntaxes</h4>
+ *  <h5>Custom syntaxes</h5>
  *
  *  The default syntax of the template strings will probably be enough for most
  *  scenarios. In the rare occasion where the default Ruby-like syntax is