From 805d52f82be857793ab00a42ee2131ca33d05aad Mon Sep 17 00:00:00 2001
From: =?utf8?q?David=20=E2=80=98Bombe=E2=80=99=20Roden?=
 <bombe@freenetproject.org>
Date: Mon, 23 Jun 2008 01:00:18 +0200
Subject: [PATCH] add javadoc

---
 src/de/todesbaum/jsite/i18n/I18nContainer.java | 36 ++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/src/de/todesbaum/jsite/i18n/I18nContainer.java b/src/de/todesbaum/jsite/i18n/I18nContainer.java
index d3cd314..483c6e2 100644
--- a/src/de/todesbaum/jsite/i18n/I18nContainer.java
+++ b/src/de/todesbaum/jsite/i18n/I18nContainer.java
@@ -24,26 +24,62 @@ import java.util.Iterator;
 import java.util.List;
 
 /**
+ * Container that collects {@link Runnable}s that change the texts of GUI
+ * components when the current locale has changed.
+ * 
  * @author David ‘Bombe’ Roden &lt;bombe@freenetproject.org&gt;
  */
 public class I18nContainer implements Iterable<Runnable> {
 
+	/** The container singleton. */
 	private static final I18nContainer singleton = new I18nContainer();
+
+	/** The list of runnables that change texts. */
 	private final List<Runnable> i18nRunnables = Collections.synchronizedList(new ArrayList<Runnable>());
+
+	/**
+	 * The list of runnables that change texts and run after
+	 * {@link #i18nRunnables}.
+	 */
 	private final List<Runnable> i18nPostRunnables = Collections.synchronizedList(new ArrayList<Runnable>());
 
+	/**
+	 * Returns the singleton instance.
+	 * 
+	 * @return The singleton instance
+	 */
 	public static I18nContainer getInstance() {
 		return singleton;
 	}
 
+	/**
+	 * Registers an i18n runnable that is run when the current locale has
+	 * changed.
+	 * 
+	 * @param i18nRunnable
+	 *            The runnable to register
+	 */
 	public void registerRunnable(Runnable i18nRunnable) {
 		i18nRunnables.add(i18nRunnable);
 	}
 
+	/**
+	 * Registers a {@link Runnable} that changes texts when the current locale
+	 * has changed and runs after {@link #i18nRunnables} have run.
+	 * 
+	 * @param i18nPostRunnable
+	 *            The runnable to register
+	 */
 	public void registerPostRunnable(Runnable i18nPostRunnable) {
 		i18nPostRunnables.add(i18nPostRunnable);
 	}
 
+	/**
+	 * {@inheritDoc}
+	 * <p>
+	 * Returns a combined list of {@link #i18nRunnables} and
+	 * {@link #i18nPostRunnables}, in that order.
+	 */
 	public Iterator<Runnable> iterator() {
 		List<Runnable> allRunnables = new ArrayList<Runnable>();
 		allRunnables.addAll(i18nRunnables);
-- 
2.7.4