/*
 * Copyright 2016-2019 Talsma ICT
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *         http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

/**
 * Main package defining the core {@code context-propagation} concepts in this library
 *
 * <h2><a href="Context.html">Context</a></h2>
 * <p>
 * Defines a context as something with a value that can be closed.
 *
 * <h2><a href="ContextManager.html">ContextManager</a></h2>
 * <p>
 * Interface defining required operations to manage contexts:
 * creating new contexts and obtaining 'current' contexts.
 *
 * <h2><a href="ContextSnapshot.html">ContextSnapshot</a></h2>
 * <p>
 * A snapshot of one or more active contexts
 * that can be reactivated temporarily (until closed).
 *
 * <h2><a href="ContextManagers.html">ContextManagers</a></h2>
 * <p>
 * Contains a static method to create a new snapshot
 * from registered ContextManager implementations.
 *
 * @author Sjoerd Talsma
 */
package nl.talsmasoftware.context;
@@ -702,42 +702,54 @@
 %3Ch2%3E
-%3Ca href=%22C
+%7B@linkplain nl.talsmasoftware.c
 ontext.
-html%22%3E
 Context
-%3C/a%3E
+%7D
 %3C/h2
@@ -764,112 +764,576 @@
 %0A * 
-Defines a context as something with a value that can be closed.%0A *%0A * %3Ch2%3E%3Ca href=%22ContextManager.html%22%3E
+A %7B@linkplain nl.talsmasoftware.context.Context context%7D contains%0A * a %7B@linkplain nl.talsmasoftware.context.Context#getValue() value%7D.%3Cbr%3E%0A * There can be one active context per thread. A context remains active until it is closed or another context%0A * is activated in that thread.%0A *%0A * %3Cp%3E%0A * An %7B@linkplain nl.talsmasoftware.context.threadlocal.AbstractThreadLocalContext AbstractThreadLocalContext%7D%0A * base class is provided that supports nested contexts and provides predictable behaviour for out-of-order closing.%0A *%0A * %3Ch2%3E%7B@linkplain nl.talsmasoftware.context.
 Cont
@@ -1342,20 +1342,17 @@
 tManager
-%3C/a%3E
+%7D
 %3C/h2%3E%0A *
@@ -1363,64 +1363,159 @@
 %0A * 
-Interface defining required operations to manage
+Manages the active context.%0A * Can %7B@linkplain nl.talsmasoftware.context.ContextManager#initializeNewContext(java.lang.Object) initialize a new
  context
 s:%0A 
@@ -1514,67 +1514,126 @@
 text
-s:
+%7D
 %0A * 
-creating new contexts and obtaining 'current'
+and provides access to the %7B@linkplain nl.talsmasoftware.context.ContextManager#getActiveContext() active
  context
 s.%0A 
@@ -1628,17 +1628,17 @@
  context
-s
+%7D
 .%0A *%0A * 
@@ -1645,39 +1645,46 @@
 %3Ch2%3E
-%3Ca href=%22ContextSnapshot.html%22%3E
+%7B@linkplain nl.talsmasoftware.context.
 Cont
@@ -1694,20 +1694,17 @@
 Snapshot
-%3C/a%3E
+%7D
 %3C/h2%3E%0A *
@@ -1726,135 +1726,382 @@
 hot 
-of one or more active contexts%0A * that can be reactivated temporarily (until closed).%0A *%0A * %3Ch2%3E%3Ca href=%22ContextManagers.html%22%3E
+contains the current value from all known context managers.%3Cbr%3E%0A * These values can be reactivated in another thread.%3Cbr%3E%0A * Reactivated snapshots must be closed to avoid leaking context.%0A *%0A * %3Cp%3E%0A * All context aware utility classes in this library are tested to make sure they reactivate and close snapshots in a safe way.%0A *%0A * %3Ch2%3E%7B@linkplain nl.talsmasoftware.context.
 Cont
@@ -2115,12 +2115,9 @@
 gers
-%3C/a%3E
+%7D
 %3C/h2
@@ -2132,107 +2132,121 @@
 %0A * 
-Contains a static method to create a new snapshot%0A * from registered ContextManager implementations
+Utility class that detects available context managers and lets you take a snapshot of all active contexts at once
 .%0A *

Add more package javadoc