DOC: doc fixups
closes #5110.

@cpcloud 

Seems like the is an issue with the example in the documentation.  Can you reproduce the rng_hourly_eastern.values below?  Clearly it's wrong, but I cannot reproduce locally.

```
In [177]: rng_hourly = DatetimeIndex(['11/06/2011 00:00', '11/06/2011 01:00',
   .....:                             '11/06/2011 01:00', '11/06/2011 02:00',
   .....:                             '11/06/2011 03:00'])
   .....: 

In [179]: rng_hourly_eastern = rng_hourly.tz_localize('US/Eastern', infer_dst=True)

In [180]: rng_hourly_eastern.values

array([1970-01-16 164:00:00, 1970-01-16 165:00:00, 1970-01-16 166:00:00,
       1970-01-16 167:00:00, 1970-01-16 168:00:00], dtype=datetime64[ns])
```
