From 8a8bc3dc1bc810cef952a12071b6ec7dd8ff9750 Mon Sep 17 00:00:00 2001
From: James Moger <james.moger@gitblit.com>
Date: Mon, 20 Oct 2014 09:33:07 -0400
Subject: [PATCH] Prepare v1.6.1 documentation updates

---
 src/main/java/com/gitblit/manager/IRuntimeManager.java |   61 ++++++++++++++++++++++++++++++
 1 files changed, 60 insertions(+), 1 deletions(-)

diff --git a/src/main/java/com/gitblit/manager/IRuntimeManager.java b/src/main/java/com/gitblit/manager/IRuntimeManager.java
index 178b93c..132534c 100644
--- a/src/main/java/com/gitblit/manager/IRuntimeManager.java
+++ b/src/main/java/com/gitblit/manager/IRuntimeManager.java
@@ -17,14 +17,16 @@
 
 import java.io.File;
 import java.util.Date;
+import java.util.Locale;
 import java.util.Map;
 import java.util.TimeZone;
 
 import com.gitblit.IStoredSettings;
 import com.gitblit.models.ServerSettings;
 import com.gitblit.models.ServerStatus;
+import com.gitblit.utils.XssFilter;
 
-public interface IRuntimeManager {
+public interface IRuntimeManager extends IManager {
 
 	void setBaseFolder(File folder);
 
@@ -34,21 +36,59 @@
 	 * Returns the preferred timezone for the Gitblit instance.
 	 *
 	 * @return a timezone
+ 	 * @since 1.4.0
 	 */
 	TimeZone getTimezone();
+
+	/**
+	 * Returns the fixed locale for clients, or null if clients may choose their locale
+	 *
+	 * @return a fixed locale or null if clients are allowed to specify locale preference
+ 	 * @since 1.5.1
+	 */
+	Locale getLocale();
 
 	/**
 	 * Determine if this Gitblit instance is actively serving git repositories
 	 * or if it is merely a repository viewer.
 	 *
 	 * @return true if Gitblit is serving repositories
+ 	 * @since 1.4.0
 	 */
 	boolean isServingRepositories();
+
+	/**
+	 * Determine if this Gitblit instance is actively serving git repositories
+	 * over HTTP.
+	 *
+	 * @return true if Gitblit is serving repositories over HTTP
+ 	 * @since 1.6.0
+	 */
+	boolean isServingHTTP();
+
+	/**
+	 * Determine if this Gitblit instance is actively serving git repositories
+	 * over the GIT Daemon protocol.
+	 *
+	 * @return true if Gitblit is serving repositories over the GIT Daemon protocol
+ 	 * @since 1.6.0
+	 */
+	boolean isServingGIT();
+
+	/**
+	 * Determine if this Gitblit instance is actively serving git repositories
+	 * over the SSH protocol.
+	 *
+	 * @return true if Gitblit is serving repositories over the SSH protocol
+ 	 * @since 1.6.0
+	 */
+	boolean isServingSSH();
 
 	/**
 	 * Determine if this Gitblit instance is running in debug mode
 	 *
 	 * @return true if Gitblit is running in debug mode
+ 	 * @since 1.4.0
 	 */
 	boolean isDebugMode();
 
@@ -56,15 +96,23 @@
 	 * Returns the boot date of the Gitblit server.
 	 *
 	 * @return the boot date of Gitblit
+ 	 * @since 1.4.0
 	 */
 	Date getBootDate();
 
+	/**
+	 * Returns the server status.
+	 *
+	 * @return the server status
+  	 * @since 1.4.0
+	 */
 	ServerStatus getStatus();
 
 	/**
 	 * Returns the descriptions/comments of the Gitblit config settings.
 	 *
 	 * @return SettingsModel
+ 	 * @since 1.4.0
 	 */
 	ServerSettings getSettingsModel();
 
@@ -72,6 +120,7 @@
 	 * Returns the file object for the specified configuration key.
 	 *
 	 * @return the file
+ 	 * @since 1.4.0
 	 */
 	File getFileOrFolder(String key, String defaultFileOrFolder);
 
@@ -83,6 +132,7 @@
 	 * access based on environment or some other indicator.
 	 *
 	 * @return the file
+ 	 * @since 1.4.0
 	 */
 	File getFileOrFolder(String fileOrFolder);
 
@@ -90,6 +140,7 @@
 	 * Returns the runtime settings.
 	 *
 	 * @return settings
+ 	 * @since 1.4.0
 	 */
 	IStoredSettings getSettings();
 
@@ -98,6 +149,14 @@
 	 *
 	 * @param settings
 	 * @return true if the update succeeded
+ 	 * @since 1.4.0
 	 */
 	boolean updateSettings(Map<String, String> updatedSettings);
+
+	/**
+	 * Returns the HTML sanitizer used to clean user content.
+	 *
+	 * @return the HTML sanitizer
+	 */
+	XssFilter getXssFilter();
 }
\ No newline at end of file

--
Gitblit v1.9.1