Incorporate snippets code improvements from Pavel Rappo

Improve drainPermits javadoc

fix code sample indentation

another attempt to improve clarity

whitespace

standardize import statement order

Documentation improvements

normalize whitespace after <p>

delete trailing empty lines of javadoc

fix imports

clean up imports

whitespace

6941130: Semaphore should throw if number of permits overflows or underflows

6574123: Help implementers of fair synchronizers

happens-before

Edit pass for happens-before descriptions

Add serial ids

Documentation improvements

Wording fixes and improvements

Wording improvements and fixes

Document toString

Cosmetics

replace isFirst param with isFirst method

Code walkthrough misc

Use ACS in FutureTask; doc improvements

Avoid cache threashing

Simplify AQS hook methods

Headers reference Creative Commons

Fix documentation

cache finals across volatiles; avoid readResolve; doc improvments; timed invokeAll interleaves

Typo fix

Merged FairSemaphore into Semaphore

Redeclare some Conditions as ReentrantLock.ConditionObjects

Spellcheck

In response to Eamonn's comment that "best effort lower bound" is not
defined for waiting times, all such references have been deleted. The
preceding text makes it clear that the time must elapse before the
method will return, and trying to say anything about the maximum waiting
time is pointless. We can still say something to this effect in the package
docs if we want.

Scrunched catch, finally, else clauses.

Misc performance tunings

Added missing javadoc tags; minor reformatting

re-check-in initial implementations