* (bug 829) Fix URL-escaping on block success
[lhc/web/wiklou.git] / includes / DefaultSettings.php
index 1457612..56652ef 100644 (file)
 # This is not a valid entry point, perform no further processing unless MEDIAWIKI is defined
 if( defined( 'MEDIAWIKI' ) ) {
 
-/**
- * MediaWiki version number
- * @global string $wgVersion
- */
+/** MediaWiki version number */
 $wgVersion                     = '1.5pre-alpha';
 
-/** 
- * Name of the site.
- * It must be changed in LocalSettings.php
- * @global string $wgSitename
- */
+/** Name of the site. It must be changed in LocalSettings.php */
 $wgSitename         = 'MediaWiki';
 
-/**
- * Will be same as you set @see $wgSitename
- * @global mixed $wgMetaNamespace
- */
+/** Will be same as you set @see $wgSitename */
 $wgMetaNamespace    = FALSE;
 
-
-/** 
- * URL of the server
- * It will be automaticly build including https mode
- * @global string $wgServer
- */
+/** URL of the server. It will be automaticly build including https mode */
 $wgServer = '';
 
 if( isset( $_SERVER['SERVER_NAME'] ) ) {
@@ -64,7 +49,6 @@ unset($wgProto);
 /**
  * The path we should point to.
  * It might be a virtual path in case with use apache mod_rewrite for example
- * @global string $wgScriptPath
  */
 $wgScriptPath      = '/wiki';
 
@@ -118,37 +102,46 @@ $wgTmpDirectory     = "{$wgUploadDirectory}/tmp";
 $wgUploadBaseUrl    = "";
 /**#@-*/
 
-# If you operate multiple wikis, you can define a shared upload
-# path here. Uploads to this wiki will NOT be put there - they
-# will be put into $wgUploadDirectory.
-#
-# If $wgUseSharedUploads is set, the wiki will look in the
-# shared repository if no file of the given name is found in
-# the local repository (for [[Image:..]], [[Media:..]] links).
-# Thumbnails will also be looked for and generated in this
-# directory.
-#
+/**
+ * If you operate multiple wikis, you can define a shared upload path here.
+ * Uploads to this wiki will NOT be put there - they will be put into
+ * $wgUploadDirectory.
+ * If $wgUseSharedUploads is set, the wiki will look in the shared repository if
+ * no file of the given name is found in the local repository (for [[Image:..]],
+ * [[Media:..]] links). Thumbnails will also be looked for and generated in this
+ * directory.
+ */
 $wgUseSharedUploads = false;
-# Full path on the web server where shared uploads can be found
+/** Full path on the web server where shared uploads can be found */
 $wgSharedUploadPath = "http://commons.wikimedia.org/shared/images";
-# Path on the file system where shared uploads can be found
+/** Path on the file system where shared uploads can be found */
 $wgSharedUploadDirectory = "/var/www/wiki3/images";
-# Set this to false especially if you have a set of files that need to be
-# accessible by all wikis, and you do not want to use the hash (path/a/aa/)
-# directory layout.
+
+/**
+ * Set the following to false especially if you have a set of files that need to
+ * be accessible by all wikis, and you do not want to use the hash (path/a/aa/)
+ * directory layout.
+ */
 $wgHashedSharedUploadDirectory = true;
-# set true if the repository uses latin1 filenames
+
+/** set true if the repository uses latin1 filenames */
 $wgSharedLatin1=false;
-# Base URL for a repository wiki. Leave this blank if uploads are just
-# stored in a shared directory and not meant to be accessible through
-# a separate wiki. Otherwise the image description pages on the local
-# wiki will link to the image description page on this wiki.
-#
-# Please specify the namespace, as in the example below.
+
+/**
+ * Base URL for a repository wiki. Leave this blank if uploads are just stored
+ * in a shared directory and not meant to be accessible through a separate wiki.
+ * Otherwise the image description pages on the local wiki will link to the
+ * image description page on this wiki.
+ *
+ * Please specify the namespace, as in the example below.
+ */
 $wgRepositoryBaseUrl="http://commons.wikimedia.org/wiki/Image:";
 
+
+#
 # Email settings
 #
+
 /**
  * Site admin email address
  * Default to wikiadmin@SERVER_NAME
@@ -236,11 +229,12 @@ $wgDBschema           = 'mediawiki';
 
 
 
-# Shared database for multiple wikis.
-# Presently used for storing a user table for single sign-on
-# The server for this database must be the same as for the main
-# database.
-# EXPERIMENTAL
+/**
+ * Shared database for multiple wikis. Presently used for storing a user table
+ * for single sign-on. The server for this database must be the same as for the
+ * main database.
+ * EXPERIMENTAL
+ */
 $wgSharedDB = null;
 
 # Database load balancer
@@ -262,31 +256,44 @@ $wgSharedDB = null;
 # Leave at false to use the single-server variables above
 $wgDBservers           = false; 
 
+/** How long to wait for a slave to catch up to the master */ 
+$wgMasterWaitTimeout = 10;
+
 # Sysop SQL queries
 #   The sql user shouldn't have too many rights other the database, restrict
 #   it to SELECT only on 'cur' table for example
 #
-$wgAllowSysopQueries = false; # Dangerous if not configured properly.
-$wgDBsqluser           = 'sqluser';
-$wgDBsqlpassword       = 'sqlpass';
-$wgDBpassword       = 'userpass';
-$wgSqlLogFile           = "{$wgUploadDirectory}/sqllog_mFhyRe6";
-$wgDBerrorLog          = false; # File to log MySQL errors to
-
-# wgDBminWordLen :
-#  MySQL 3.x : used to discard words that MySQL will not return any results for
-#  shorter values configure mysql directly
-#  MySQL 4.x : ignore it and configure mySQL
-# See: http://dev.mysql.com/doc/mysql/en/Fulltext_Fine-tuning.html
+/** Dangerous if not configured properly. */
+$wgAllowSysopQueries = false;
+$wgDBsqluser = 'sqluser';
+$wgDBsqlpassword = 'sqlpass';
+$wgDBpassword = 'userpass';
+$wgSqlLogFile = "{$wgUploadDirectory}/sqllog_mFhyRe6";
+/** File to log MySQL errors to */
+$wgDBerrorLog          = false;
+
+/**
+ * wgDBminWordLen :
+ * MySQL 3.x : used to discard words that MySQL will not return any results for
+ * shorter values configure mysql directly.
+ * MySQL 4.x : ignore it and configure mySQL
+ * See: http://dev.mysql.com/doc/mysql/en/Fulltext_Fine-tuning.html
+ */
 $wgDBminWordLen     = 4;
-$wgDBtransactions      = false; # Set to true if using InnoDB tables
-$wgDBmysql4                    = false; # Set to true to use enhanced fulltext search
+/** Set to true if using InnoDB tables */
+$wgDBtransactions      = false;
+/** Set to true to use enhanced fulltext search */
+$wgDBmysql4                    = false;
 $wgSqlTimeout          = 30;
 
-$wgBufferSQLResults     = true; # use buffered queries by default
+/** use buffered queries by default */
+$wgBufferSQLResults     = true;
 
-# Other wikis on this site, can be administered from a single developer account
-# Array, interwiki prefix => database name
+/**
+ * Other wikis on this site, can be administered from a single developer
+ * account.
+ * Array, interwiki prefix => database name
+ */ 
 $wgLocalDatabases   = array();
 
 
@@ -313,26 +320,21 @@ $wgUseTurckShm      = false;
 
 # Language settings
 #
-/**
- * Site language code
- * Default to 'en'. Should be one of ./language/Language(.*).php
- * @global string $wgLanguageCode
- */
+/** Site language code, should be one of ./language/Language(.*).php */
 $wgLanguageCode     = 'en';
 
-/**
- * Filename of a language file generated by dumpMessages.php
- * @global string|false $wgLanguageFile (default:false)
- */
+/** Filename of a language file generated by dumpMessages.php */
 $wgLanguageFile     = false;
-/**
- * Treat language links as magic connectors, not inline links
- * @global bool $wgInterwikiMagic (default:true)
- */
+
+/** Treat language links as magic connectors, not inline links */
 $wgInterwikiMagic      = true;
-$wgInputEncoding       = 'ISO-8859-1'; # LanguageUtf8.php normally overrides this
-$wgOutputEncoding      = 'ISO-8859-1'; # unless you set the next option to true:
-$wgUseLatin1           = false; # Enable ISO-8859-1 compatibility mode
+
+/** LanguageUtf8.php normally overrides this */
+$wgInputEncoding       = 'ISO-8859-1';
+/** unless you set the next option to true: */
+$wgOutputEncoding      = 'ISO-8859-1'; 
+/** Enable ISO-8859-1 compatibility mode */
+$wgUseLatin1           = false;
 $wgEditEncoding                = '';
 
 # Set this to eg 'ISO-8859-1' to perform character set
@@ -348,12 +350,17 @@ $wgLegacyEncoding   = false;
 $wgMimeType                    = 'text/html';
 $wgDocType                     = '-//W3C//DTD XHTML 1.0 Transitional//EN';
 $wgDTD                         = 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd';
-$wgUseDynamicDates  = false; # Enable to allow rewriting dates in page text
-                                                        # DOES NOT FORMAT CORRECTLY FOR MOST LANGUAGES
-$wgAmericanDates    = false; # Enable for English module to print dates
-                                                        # as eg 'May 12' instead of '12 May'
-$wgTranslateNumerals = true; # For Hindi and Arabic use local numerals instead
-                             # of Western style (0-9) numerals in interface.
+
+/** Enable to allow rewriting dates in page text.
+ * DOES NOT FORMAT CORRECTLY FOR MOST LANGUAGES */
+$wgUseDynamicDates  = false; 
+/** Enable for English module to print dates as eg 'May 12' instead of '12 May' */
+$wgAmericanDates    = false; 
+/**
+ * For Hindi and Arabic use local numerals instead of Western style (0-9)
+ * numerals in interface.
+ */
+$wgTranslateNumerals = true;
 
 
 # Translation using MediaWiki: namespace
@@ -391,8 +398,9 @@ $wgSiteSupportPage  = ''; # A page where you users can receive donations
 $wgReadOnlyFile         = "{$wgUploadDirectory}/lock_yBgMBwiR";
 $wgUseData = false ;
 
-# The debug log file should be not be publicly accessible if it is
-# used, as it may contain private data.
+/**
+ * The debug log file should be not be publicly accessible if it is used, as it
+ * may contain private data. */
 $wgDebugLogFile         = '';
 
 /**#@+
@@ -406,8 +414,8 @@ $wgReadOnly             = false;
 $wgLogQueries           = false;
 $wgDebugDumpSql         = false;
 
-# Whether to disable automatic generation of "we're sorry,
-# but there has been a database error" pages.
+/** Whether to disable automatic generation of "we're sorry, but there has been
+ * a database error" pages. */
 $wgIgnoreSQLErrors      = false;
 
 # Should [[Category:Dog]] on a page associate it with the
@@ -416,8 +424,10 @@ $wgIgnoreSQLErrors      = false;
 # all articles in the category)
 $wgUseCategoryMagic            = true;
 
-# disable experimental dmoz-like category browsing. Output things like:
-# Encyclopedia > Music > Style of Music > Jazz
+/**
+ * disable experimental dmoz-like category browsing. Output things like:
+ * Encyclopedia > Music > Style of Music > Jazz
+ */
 $wgUseCategoryBrowser   = false;
 
 $wgEnablePersistentLC  = false;        # Obsolete, do not use
@@ -436,16 +446,18 @@ $wgEnableParserCache = true;
 
 /**#@-*/
 
-# wgHitcounterUpdateFreq sets how often page counters should be
-# updated, higher values are easier on the database. A value of 1
-# causes the counters to be updated on every hit, any higher value n
-# cause them to update *on average* every n hits. Should be set to
-# either 1 or something largish, eg 1000, for maximum efficiency.
-
+/**
+ * wgHitcounterUpdateFreq sets how often page counters should be updated, higher
+ * values are easier on the database. A value of 1 causes the counters to be
+ * updated on every hit, any higher value n cause them to update *on average*
+ * every n hits. Should be set to either 1 or something largish, eg 1000, for
+ * maximum efficiency.
+*/
 $wgHitcounterUpdateFreq = 1;
 
-# User rights
-#   It's not 100% safe, there could be security hole using that one. Use at your
+# User rights settings
+#
+#  It's not 100% safe, there could be security hole using that one. Use at your
 # own risks.
 
 $wgWhitelistEdit = false;   # true = user must login to edit.
@@ -461,86 +473,85 @@ $wgDefaultBlockExpiry     = '24 hours'; # default expiry time
 $wgAutoblockExpiry             = 86400; # Number of seconds before autoblock entries expire
 
 # Proxy scanner settings
-# If you enable this, every editor's IP address will be scanned for open
-# HTTP proxies.
-#
-# Don't enable this. Many sysops will report "hostile TCP port scans" to
-# your ISP and ask for your server to be shut down. 
 #
-# You have been warned.
-#
-$wgBlockOpenProxies = false; # Automatic open proxy test on edit
+
+/**
+ * If you enable this, every editor's IP address will be scanned for open HTTP
+ * proxies.
+ * 
+ * Don't enable this. Many sysops will report "hostile TCP port scans" to your
+ * ISP and ask for your server to be shut down.
+ * 
+ * You have been warned.
+ */
+$wgBlockOpenProxies = false;
+/** Port we want to scan for a proxy */
 $wgProxyPorts = array( 80, 81, 1080, 3128, 6588, 8000, 8080, 8888, 65506 );
+/** Script used to scan */
 $wgProxyScriptPath = "$IP/proxy_check.php";
+/** */
 $wgProxyMemcExpiry = 86400;
+/** */
 $wgProxyKey = 'W1svekXc5u6lZllTZOwnzEk1nbs';
-$wgProxyList = array();  # big list of banned IP addresses, in the keys not the values
+/** big list of banned IP addresses, in the keys not the values */
+$wgProxyList = array();
 
-# Number of accounts each IP address may create, 0 to disable.
-# Requires memcached
+/** Number of accounts each IP address may create, 0 to disable.
+ * Requires memcached */
 $wgAccountCreationThrottle = 0;
 
-
 # Client-side caching:
-$wgCachePages       = true; # Allow client-side caching of pages
 
-# Set this to current time to invalidate all prior cached pages.
-# Affects both client- and server-side caching.
+/** Allow client-side caching of pages */
+$wgCachePages       = true;
+
+/**
+ * Set this to current time to invalidate all prior cached pages. Affects both
+ * client- and server-side caching.
+ */
 $wgCacheEpoch = '20030516000000';
 
 
 # Server-side caching:
-#  This will cache static pages for non-logged-in users
-#  to reduce database traffic on public sites.
-#  Must set $wgShowIPinHeader = false
+
+/**
+ * This will cache static pages for non-logged-in users to reduce
+ * database traffic on public sites.
+ * Must set $wgShowIPinHeader = false
+ */  
 $wgUseFileCache = false;
+/** Directory where the cached page will be saved */
 $wgFileCacheDirectory = "{$wgUploadDirectory}/cache";
 
-# When using the file cache, we can store the cached HTML gzipped to save disk
-# space. Pages will then also be served compressed to clients that support it.
-# THIS IS NOT COMPATIBLE with ob_gzhandler which is now enabled if supported in
-# the default LocalSettings.php! If you enable this, remove that setting first.
-#
-# Requires zlib support enabled in PHP.
+/**
+ * When using the file cache, we can store the cached HTML gzipped to save disk
+ * space. Pages will then also be served compressed to clients that support it.
+ * THIS IS NOT COMPATIBLE with ob_gzhandler which is now enabled if supported in
+ * the default LocalSettings.php! If you enable this, remove that setting first.
+ * 
+ * Requires zlib support enabled in PHP.
+ */
 $wgUseGzip = false;
 
-/*     T. Gries Aug.-Nov.2004
-
-       THESE ARE MY SUGGESTED FIRST TEST global admin options FOR ENOTIF.
-       Attention: the defaults might differ from standard media wiki distributions.
+# Email notification settings
+#
 
-       However, I suggest to start with these which allow to evaluate almost all new features quickly.
-       user preferences default options SEE AS USUAL /languages/Language.php
-*/
+/** 
+ * Program to run when the email is actually sent out. You might want to make
+ * your server beep for example. Usermailer.php will make a system() call with
+ * exactly that string as parameter.
+ */
+# $wgEmailNotificationSystembeep = '/usr/bin/beep -f 4000 -l 20 &';
+$wgEmailNotificationSystembeep = '';
 
-########################### CAUTION ################# ATTENTION ###############################################
-#
-# T. Gries Aug.-Dec. 2004
-#
-# SECTION FOR DEVELOPERS and SERVER ADMINS
-#
-# HERE COME TWO OPTIONS, WHICH ALLOW ACOUSTIC SIGNALS on the server beeper WHEN AN EMAIL IS ACTUALLY SENT OUT.
-# YOU MIGHT WISH TO ENABLE THESE, BUT BE CAREFUL, AS A system() CALL IS PERFORMED using the shown parameters.
-# I FIND IT VERY USEFUL, but this is a very personal comment. T. Gries
-#
-# The system speaker beeps when the wiki actually sends out a notification mail (safe default = disabled).
-#
-# The following string is passed as parameter to a system() call in UserMailer.php
-# The system() calls call - in the shown example - the beep 1.2.2 program (LINUX) with frequency f [Hz] and length l [msec]
-#
-# Beep 1.2.2 can be found on http://freshmeat.net/projects/beep/ and I like it.
-#
-########################### SAFE #################### SAFE #####################################################
-$wgEmailNotificationSystembeep = ''; # empty string disables this feature; this appears to be safe
-######ENTER#AT#YOUR#OWN#RISK###CAUTION###### ATTENTION ###################################################
-#$wgEmailNotificationSystembeep        = '/usr/bin/beep -f 4000 -l 20 &';      # a system() call with exactly this string as parameter is executed when such a mail is sent
-########################### CAUTION ################# ATTENTION ###############################################
+/** For email notification on page changes */
+$wgPasswordSender = $wgEmergencyContact;
 
-# For email notification on page changes T.Gries/M.Arndt 01.11.2004
-$wgPasswordSender                              = $wgEmergencyContact;
-$wgEmailNotificationMailsSentFromPageEditor    = false; # false: Enotif mails appear to come from $wgEmergencyContact
-#                                                       # true: from PageEditor if s/he opted-in
+# true: from PageEditor if s/he opted-in
+# false: Enotif mails appear to come from $wgEmergencyContact
+$wgEmailNotificationMailsSentFromPageEditor    = false; 
 
+// TODO move UPO to preferences probably ?
 # If set to true, users get a corresponding option in their preferences and can choose to enable or disable at their discretion
 # If set to false, the corresponding input form on the user preference page is suppressed
 # It call this to be a "user-preferences-option (UPO)"
@@ -551,11 +562,14 @@ $wgEmailNotificationRevealPageEditorAddress       = false;        # UPO; reply-to address may
 $wgEmailNotificationForMinorEdits              = true; # UPO; false: "minor edits" on pages do not trigger notification mails.
 #                                                      # Attention: _every_ change on a user_talk page trigger a notification mail (if the user is not yet notified)
 
-# Show watching users in recent changes, watchlist and page history views
+
+/** Show watching users in recent changes, watchlist and page history views */
 $wgRCShowWatchingUsers                                 = false; # UPO
-# Show watching users in Page views
+/** Show watching users in Page views */
 $wgPageShowWatchingUsers                       = false;
-# Show "Updated (since my last visit)" marker in RC view, watchlist and history view for watched pages with new changes
+/**
+ * Show "Updated (since my last visit)" marker in RC view, watchlist and history
+ * view for watched pages with new changes */
 $wgShowUpdatedMarker                           = true; # UPO
 
 $wgCookieExpiration = 2592000;
@@ -563,84 +577,129 @@ $wgCookieExpiration = 2592000;
 # Squid-related settings
 #
 
-# Enable/disable Squid
- $wgUseSquid = false;
+/** Enable/disable Squid */
+$wgUseSquid = false;
  
-# If you run Squid3 with ESI support, enable this (default:false):
- $wgUseESI = false;
+/** If you run Squid3 with ESI support, enable this (default:false): */
+$wgUseESI = false;
  
-# Internal server name as known to Squid, if different
+/** Internal server name as known to Squid, if different */
 # $wgInternalServer = 'http://yourinternal.tld:8000';
- $wgInternalServer = $wgServer;
+$wgInternalServer = $wgServer;
  
-# Cache timeout for the squid, will be sent as s-maxage (without ESI) or 
-# Surrogate-Control (with ESI). Without ESI, you should strip out s-maxage in the Squid config.
-# 18000 seconds = 5 hours, more cache hits with 2678400 = 31 days
- $wgSquidMaxage = 18000;
+/**
+ * Cache timeout for the squid, will be sent as s-maxage (without ESI) or
+ * Surrogate-Control (with ESI). Without ESI, you should strip out s-maxage in
+ * the Squid config. 18000 seconds = 5 hours, more cache hits with 2678400 = 31
+ * days
+ */
+$wgSquidMaxage = 18000;
  
-# A list of proxy servers (ips if possible) to purge on changes
-# don't specify ports here (80 is default)
+/**
+ * A list of proxy servers (ips if possible) to purge on changes don't specify
+ * ports here (80 is default)
+ */
 # $wgSquidServers = array('127.0.0.1');
+$wgSquidServersNoPurge = array();
 
-# Maximum number of titles to purge in any one client operation
+/** Maximum number of titles to purge in any one client operation */
 $wgMaxSquidPurgeTitles = 400;
 
 
 # Cookie settings:
-#   Set to set an explicit domain on the login cookies
-#   eg, "justthis.domain.org" or ".any.subdomain.net"
+#
+/**
+ * Set to set an explicit domain on the login cookies eg, "justthis.domain. org"
+ * or ".any.subdomain.net"
+ */
 $wgCookieDomain = '';
 $wgCookiePath = '/';
 $wgDisableCookieCheck = false;
 
-# Whether to allow inline image pointing to other websites
+/**  Whether to allow inline image pointing to other websites */
 $wgAllowExternalImages = true;
 
-$wgMiserMode = false; # Disable database-intensive features
-$wgDisableQueryPages = false; # Disable all query pages if miser mode is on, not just some
-$wgUseWatchlistCache = false; # Generate a watchlist once every hour or so
-$wgWLCacheTimeout = 3600;     # The hour or so mentioned above
+/** Disable database-intensive features */
+$wgMiserMode = false;
+/** Disable all query pages if miser mode is on, not just some */
+$wgDisableQueryPages = false;
+/** Generate a watchlist once every hour or so */
+$wgUseWatchlistCache = false;
+/** The hour or so mentioned above */
+$wgWLCacheTimeout = 3600;
 
-# To use inline TeX, you need to compile 'texvc' (in the 'math' subdirectory
-# of the MediaWiki package and have latex, dvips, gs (ghostscript), and
-# convert (ImageMagick) installed and available in the PATH.
-# Please see math/README for more information.
+/**
+ * To use inline TeX, you need to compile 'texvc' (in the 'math' subdirectory of
+ * the MediaWiki package and have latex, dvips, gs (ghostscript), andconvert
+ * (ImageMagick) installed and available in the PATH.
+ * Please see math/README for more information.
+ */
 $wgUseTeX = false;
-$wgTexvc = './math/texvc'; # Location of the texvc binary
+/** Location of the texvc binary */
+$wgTexvc = './math/texvc';
 
+#
 # Profiling / debugging
-$wgProfiling = false; # Enable for more detailed by-function times in debug log
-$wgProfileLimit = 0.0; # Only record profiling info for pages that took longer than this
-$wgProfileOnly = false; # Don't put non-profiling info into log file
-$wgProfileToDatabase = false; # Log sums from profiling into "profiling" table in db.
-$wgProfileSampleRate = 1; # Only profile every n requests when profiling is turned on
-$wgDebugProfiling = false; # Detects non-matching wfProfileIn/wfProfileOut calls
-$wgDebugFunctionEntry = 0; # Output debug message on every wfProfileIn/wfProfileOut
-$wgDebugSquid = false; # Lots of debugging output from SquidUpdate.php
+#
+
+/** Enable for more detailed by-function times in debug log */
+$wgProfiling = false; 
+/** Only record profiling info for pages that took longer than this */
+$wgProfileLimit = 0.0;
+/** Don't put non-profiling info into log file */
+$wgProfileOnly = false; 
+/** Log sums from profiling into "profiling" table in db. */
+$wgProfileToDatabase = false;
+/** Only profile every n requests when profiling is turned on */
+$wgProfileSampleRate = 1;
+/** If true, print a raw call tree instead of per-function report */
+$wgProfileCallTree = false; 
+
+/** Detects non-matching wfProfileIn/wfProfileOut calls */
+$wgDebugProfiling = false;
+/** Output debug message on every wfProfileIn/wfProfileOut */
+$wgDebugFunctionEntry = 0;
+/** Lots of debugging output from SquidUpdate.php */
+$wgDebugSquid = false;
 
 $wgDisableCounters = false;
 $wgDisableTextSearch = false;
-$wgDisableSearchUpdate = false; # If you've disabled search semi-permanently, this also disables updates to the table. If you ever re-enable, be sure to rebuild the search table.
-$wgDisableUploads = true; # Uploads have to be specially set up to be secure
-$wgRemoteUploads = false; # Set to true to enable the upload _link_ while local uploads are disabled. Assumes that the special page link will be bounced to another server where uploads do work.
+/**
+ * If you've disabled search semi-permanently, this also disables updates to the
+ * table. If you ever re-enable, be sure to rebuild the search table.
+ */
+$wgDisableSearchUpdate = false;
+/** Uploads have to be specially set up to be secure */
+$wgDisableUploads = true;
+/**
+ * Set to true to enable the upload _link_ while local uploads are disabled.
+ * Assumes that the special page link will be bounced to another server where
+ * uploads do work.
+ */
+$wgRemoteUploads = false; 
 $wgDisableAnonTalk = false;
 
-# Path to the GNU diff3 utility. If the file doesn't exist,
-# edit conflicts will fall back to the old behaviour (no merging).
+/**
+ * Path to the GNU diff3 utility. If the file doesn't exist, edit conflicts will
+ * fall back to the old behaviour (no merging).
+ */
 $wgDiff3 = '/usr/bin/diff3';
 
-
-# We can also compress text in the old revisions table. If this is set on,
-# old revisions will be compressed on page save if zlib support is available.
-# Any compressed revisions will be decompressed on load regardless of this
-# setting *but will not be readable at all* if zlib support is not available.
+/** 
+ * We can also compress text in the old revisions table. If this is set on, old
+ * revisions will be compressed on page save if zlib support is available. Any
+ * compressed revisions will be decompressed on load regardless of this setting
+ * *but will not be readable at all* if zlib support is not available.
+ */
 $wgCompressRevisions = false;
 
-# This is the list of preferred extensions for uploading files. Uploading
-# files with extensions not in this list will trigger a warning.
+/**
+ * This is the list of preferred extensions for uploading files. Uploading files
+ * with extensions not in this list will trigger a warning.
+ */
 $wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg', 'ogg' );
 
-# Files with these extensions will never be allowed as uploads.
+/** Files with these extensions will never be allowed as uploads. */
 $wgFileBlacklist = array(
        # HTML may contain cookie-stealing JavaScript and web bugs
        'html', 'htm',
@@ -651,44 +710,50 @@ $wgFileBlacklist = array(
        # May contain harmful executables for Windows victims
        'exe', 'scr', 'dll', 'msi', 'vbs', 'bat', 'com', 'pif', 'cmd', 'vxd', 'cpl' );
 
-# This is a flag to determine whether or not to check file extensions on
-# upload.
+/** This is a flag to determine whether or not to check file extensions on upload. */
 $wgCheckFileExtensions = true;
 
-# If this is turned off, users may override the warning for files not
-# covered by $wgFileExtensions.
+/**
+ * If this is turned off, users may override the warning for files not covered
+ * by $wgFileExtensions.
+ */
 $wgStrictFileExtensions = true;
 
-# Warn if uploaded files are larger than this
+/** Warn if uploaded files are larger than this */
 $wgUploadSizeWarning = 150000;
 
-$wgPasswordSalt = true; # For compatibility with old installations set to false
+/** For compatibility with old installations set to false */
+$wgPasswordSalt = true; 
 
-# Which namespaces should support subpages?
-# See Language.php for a list of namespaces.
-#
+/** Which namespaces should support subpages?
+ * See Language.php for a list of namespaces.
+ */
 $wgNamespacesWithSubpages = array( -1 => 0, 0 => 0, 1 => 1,
   2 => 1, 3 => 1, 4 => 0, 5 => 1, 6 => 0, 7 => 1, 8 => 0, 9 => 1, 10 => 0, 11 => 1);
 
 $wgNamespacesToBeSearchedDefault = array( -1 => 0, 0 => 1, 1 => 0,
   2 => 0, 3 => 0, 4 => 0, 5 => 0, 6 => 0, 7 => 0, 8 => 0, 9 => 1, 10 => 0, 11 => 1 );
 
-# If set, a bold ugly notice will show up at the top of every page.
-$wgSiteNotice = "";
+/** If set, a bold ugly notice will show up at the top of every page. */
+$wgSiteNotice = '';
 
-## Set $wgUseImageResize to true if you want to enable dynamic
-## server side image resizing ("Thumbnails")
-# 
-$wgUseImageResize              = false;
 
-## Resizing can be done using PHP's internal image libraries
-## or using ImageMagick. The later supports more file formats
-## than PHP, which only supports PNG, GIF, JPG, XBM and WBMP.
-##
-## Set $wgUseImageMagick to true to use Image Magick instead
-## of the builtin functions
 #
+# Images settings
+#
+
+/** dynamic server side image resizing ("Thumbnails") */
+$wgUseImageResize              = false;
+
+/**
+ * Resizing can be done using PHP's internal image libraries or using
+ * ImageMagick. The later supports more file formats than PHP, which only
+ * supports PNG, GIF, JPG, XBM and WBMP.
+ * 
+ * Use Image Magick instead of PHP builtin functions.
+ */
 $wgUseImageMagick              = false;
+/** The convert command shipped with ImageMagick */
 $wgImageMagickConvertCommand    = '/usr/bin/convert';
 
 # Scalable Vector Graphics (SVG) may be uploaded as images.
@@ -702,175 +767,209 @@ $wgSVGConverters = array(
        'inkscape' => '$path/inkscape -z -w $width -f $input -e $output',
        'batik' => 'java -Djava.awt.headless=true -jar $path/batik-rasterizer.jar -w $width -d $output $input',
        );
-$wgSVGConverter = 'ImageMagick'; # Pick one of the above
-$wgSVGConverterPath = ''; # If not in the executable PATH, specify
+/** Pick one of the above */
+$wgSVGConverter = 'ImageMagick';
+/** If not in the executable PATH, specify */
+$wgSVGConverterPath = '';
 
+/** @todo FIXME what does it do here ?? [ashar] */
 if( !isset( $wgCommandLineMode ) ) {
        $wgCommandLineMode = false;
 }
 
-# Show seconds in Recent Changes
+
+#
+# Recent changes settings
+#
+
+/** Show seconds in Recent Changes */
 $wgRCSeconds = false;
 
-# Log IP addresses in the recentchanges table
+/** Log IP addresses in the recentchanges table */
 $wgPutIPinRC = false;
 
-# RDF metadata toggles
+/**
+ * Recentchanges items are periodically purged; entries older than this many
+ * seconds will go.
+ * For one week : 7 * 24 * 3600
+ */
+$wgRCMaxAge = 7 * 24 * 3600;
+
+
+#
+# Copyright and credits settings
+#
+
+/** RDF metadata toggles */
 $wgEnableDublinCoreRdf = false;
 $wgEnableCreativeCommonsRdf = false;
 
-# Override for copyright metadata.
-# TODO: these options need documentation
+/** Override for copyright metadata.
+ * TODO: these options need documentation
+ */
 $wgRightsPage = NULL;
 $wgRightsUrl = NULL;
 $wgRightsText = NULL;
 $wgRightsIcon = NULL;
 
-# Set this to some HTML to override the rights icon with an arbitrary logo
+/** Set this to some HTML to override the rights icon with an arbitrary logo */
 $wgCopyrightIcon = NULL;
 
-# Set this to true if you want detailed copyright information forms on Upload.
+/** Set this to true if you want detailed copyright information forms on Upload. */
 $wgUseCopyrightUpload = false;
 
-# Set this to false if you want to disable checking that detailed 
-# copyright information values are not empty.
+/** Set this to false if you want to disable checking that detailed copyright
+ * information values are not empty. */
 $wgCheckCopyrightUpload = true;
 
+/**
+ * Set this to the number of authors that you want to be credited below an
+ * article text. Set it to zero to hide the attribution block, and a negative
+ * number (like -1) to show all authors. Note that this will# require 2-3 extra
+ * database hits, which can have a not insignificant impact on performance for
+ * large wikis.
+ */
+$wgMaxCredits = 0;
+
+/** If there are more than $wgMaxCredits authors, show $wgMaxCredits of them.
+ * Otherwise, link to a separate credits page. */
+$wgShowCreditsIfMax = true;
+
+
 
-# Set this to false to avoid forcing the first letter of links
-# to capitals. WARNING: may break links! This makes links
-# COMPLETELY case-sensitive. Links appearing with a capital at
-# the beginning of a sentence will *not* go to the same place
-# as links in the middle of a sentence using a lowercase initial.
+/**
+ * Set this to false to avoid forcing the first letter of links to capitals.
+ * WARNING: may break links! This makes links COMPLETELY case-sensitive. Links
+ * appearing with a capital at the beginning of a sentence will *not* go to the
+ * same place as links in the middle of a sentence using a lowercase initial.
+ */
 $wgCapitalLinks = true;
 
-# List of interwiki prefixes for wikis we'll accept as sources
-# for Special:Import (for sysops). Since complete page history
-# can be imported, these should be 'trusted'.
+/**
+ * List of interwiki prefixes for wikis we'll accept as sources for
+ * Special:Import (for sysops). Since complete page history# can be imported,
+ * these should be 'trusted'.
+ */
 $wgImportSources = array();
 
-# Set this to the number of authors that you want to be credited below an
-# article text. Set it to zero to hide the attribution block, and a
-# negative number (like -1) to show all authors. Note that this will
-# require 2-3 extra database hits, which can have a not insignificant
-# impact on performance for large wikis.
-$wgMaxCredits = 0;
 
-# If there are more than $wgMaxCredits authors, show $wgMaxCredits of them.
-# Otherwise, link to a separate credits page.
-$wgShowCreditsIfMax = true;
 
-# Text matching this regular expression will be recognised as spam
-# See http://en.wikipedia.org/wiki/Regular_expression
+/** Text matching this regular expression will be recognised as spam
+ * See http://en.wikipedia.org/wiki/Regular_expression */
 $wgSpamRegex = false; 
-# Similarly if this function returns true
+/** Similarly if this function returns true */
 $wgFilterCallback = false;
 
-# Go button goes straight to the edit screen if the article doesn't exist
+/** Go button goes straight to the edit screen if the article doesn't exist. */
 $wgGoToEdit = false;
 
-# Allow limited user-specified HTML in wiki pages?
-# It will be run through a whitelist for security.
-# Set this to false if you want wiki pages to consist only of wiki
-# markup. Note that replacements do not yet exist for all HTML
-# constructs.
+/** Allow limited user-specified HTML in wiki pages?
+ * It  will be run through a whitelist for security. Set this to false if you
+ * want wiki pages to consist only of wiki markup. Note that replacements do not
+ * yet exist for all HTML constructs.*/
 $wgUserHtml = true;
 
-# Allow raw, unchecked HTML in <html>...</html> sections.
-# THIS IS VERY DANGEROUS on a publically editable site, so
-# you can't enable it unless you've restricted editing to
-# trusted users only with $wgWhitelistEdit.
+/** Allow raw, unchecked HTML in <html>...</html> sections.
+ * THIS IS VERY DANGEROUS on a publically editable site, so you can't enable it
+ * unless you've restricted editing to trusted users only with $wgWhitelistEdit.
+ */
 $wgRawHtml = false;
 
-# $wgUseTidy: use tidy to make sure HTML output is sane.
-# This should only be enabled if $wgUserHtml is true.
-# tidy is a free tool that fixes broken HTML. 
-# See http://www.w3.org/People/Raggett/tidy/
-# $wgTidyBin should be set to the path of the binary and 
-# $wgTidyConf to the path of the configuration file.
-# $wgTidyOpts can include any number of parameters.
+/**
+ * $wgUseTidy: use tidy to make sure HTML output is sane.
+ * This should only be enabled if $wgUserHtml is true.
+ * tidy is a free tool that fixes broken HTML.
+ * See http://www.w3.org/People/Raggett/tidy/
+ * $wgTidyBin should be set to the path of the binary and
+ * $wgTidyConf to the path of the configuration file.
+ * $wgTidyOpts can include any number of parameters.
+ */
 $wgUseTidy = false;
 $wgTidyBin = 'tidy';
 $wgTidyConf = $IP.'/extensions/tidy/tidy.conf'; 
 $wgTidyOpts = '';
 
-# See list of skins and their symbolic names in languagel/Language.php
+/** See list of skins and their symbolic names in languagel/Language.php */
 $wgDefaultSkin = 'monobook';
 
-# Settings added to this array will override the language globals for
-# the user preferences used by anonymous visitors and newly created
-# accounts. (See names and sample values in languages/Language.php)
-#
-# For instance, to disable section editing links:
-#   $wgDefaultUserOptions['editsection'] = 0;
-#
+/**
+ * Settings added to this array will override the language globals for the user
+ * preferences used by anonymous visitors and newly created accounts. (See names
+ * and sample values in languages/Language.php)
+ * For instance, to disable section editing links:
+ *  $wgDefaultUserOptions ['editsection'] = 0;
+ * 
+ */
 $wgDefaultUserOptions = array();
 
-# Whether or not to allow real name fields. Defaults to true.
-# If set to false, the corresponding input forms on the log-in page and on the user preference page is suppressed.
+/** Whether or not to allow and use real name fields. Defaults to true. */
 $wgAllowRealName = true;
 
-# Use XML parser?
+/** Use XML parser? */
 $wgUseXMLparser = false ;
 
-# Extensions
+/** Extensions */
 $wgSkinExtensionFunctions = array();
 $wgExtensionFunctions = array();
 
-# Allow user Javascript page?
+/** Allow user Javascript page? */
 $wgAllowUserJs = true;
 
-# Allow user Cascading Style Sheets (CSS)?
+/** Allow user Cascading Style Sheets (CSS)? */
 $wgAllowUserCss = true;
 
-# Use the site's Javascript page?
+/** Use the site's Javascript page? */
 $wgUseSiteJs = true;
 
-# Use the site's Cascading Style Sheets (CSS)?
+/** Use the site's Cascading Style Sheets (CSS)? */
 $wgUseSiteCss = true;
        
-# Filter for Special:Randompage. Part of a WHERE clause
+/** Filter for Special:Randompage. Part of a WHERE clause */
 $wgExtraRandompageSQL = false;
 
-# Allow the "info" action, very inefficient at the moment
+/** Allow the "info" action, very inefficient at the moment */
 $wgAllowPageInfo = false;
 
-# Maximum indent level of toc.
+/** Maximum indent level of toc. */
 $wgMaxTocLevel = 999;
 
-# Recognise longitude/latitude coordinates
+/** Recognise longitude/latitude coordinates */
 $wgUseGeoMode = false;
 
-# Validation for print or other production versions
+/** Validation for print or other production versions */
 $wgUseValidation = false;
 
-# Use external C++ diff engine (module wikidiff from the
-# extensions package)
+/** Use external C++ diff engine (module wikidiff from the extensions package) */
 $wgUseExternalDiffEngine = false;
 
-# Use RC Patrolling to check for vandalism
+/** Use RC Patrolling to check for vandalism */
 $wgUseRCPatrol = true;
 
-# Set maximum number of results to return in syndication feeds
-# (RSS, Atom) for eg Recentchanges, Newpages.
+/** Set maximum number of results to return in syndication feeds (RSS, Atom) for
+ * eg Recentchanges, Newpages. */
 $wgFeedLimit = 50;
 
-# _Minimum_ timeout for cached Recentchanges feed, in seconds.
-# A cached version will continue to be served out even if changes
-# are made, until this many seconds runs out since the last render.
+/** _Minimum_ timeout for cached Recentchanges feed, in seconds.
+ * A cached version will continue to be served out even if changes
+ * are made, until this many seconds runs out since the last render. */
 $wgFeedCacheTimeout = 60;
 
-# When generating Recentchanges RSS/Atom feed, diffs will not be
-# generated for pages larger than this size.
+/** When generating Recentchanges RSS/Atom feed, diffs will not be generated for
+ * pages larger than this size. */
 $wgFeedDiffCutoff = 32768;
 
 
-# Additional namespaces. If the namespaces defined in Language.php and Namespace.php are insufficient,
-# you can create new ones here, for example, to import Help files in other languages.
-# PLEASE NOTE: Once you delete a namespace, the pages in that namespace will no longer be accessible.
-# If you rename it, then you can access them through the new namespace name.
-#
-# Custom namespaces should start at 100 and stop at 255 (hard limit set by database)
+/**
+ * Additional namespaces. If the namespaces defined in Language.php and
+ * Namespace.php are insufficient,# you can create new ones here, for example,
+ * to import Help files in other languages.
+ * PLEASE  NOTE: Once you delete a namespace, the pages in that namespace will
+ * no longer be accessible. If you rename it, then you can access them through
+ * the new namespace name.
+ * 
+ * Custom namespaces should start at 100 and stop at 255 (hard limit set by
+ * database).
+ */
 #$wgExtraNamespaces =
 #      array(100 => "Hilfe",
 #            101 => "Hilfe_Diskussion",
@@ -879,17 +978,21 @@ $wgFeedDiffCutoff = 32768;
 #            );
 $wgExtraNamespaces = NULL;
 
-# Enable SOAP interface. Off by default
-# SOAP is a protocoll for remote procedure calls (RPC) using http as middleware.
-# This interface can be used by bots or special clients to receive articles from
-# a wiki.
-# Most bots use the normal HTTP interface and don't use SOAP.
-# If unsure, set to false.
+/**
+ * Enable SOAP interface. Off by default
+ * SOAP is a protocoll for remote procedure calls (RPC) using http as
+ * middleware. This interface can be used by bots or special clients to receive
+ * articles from a wiki.
+ * Most bots use the normal HTTP interface and don't use SOAP.
+ * If unsure, set to false.
+ */
 $wgEnableSOAP = false;
 
-# Limit images on image description pages to a user-selectable limit. In order to
-# reduce disk usage, limits can only be selected from a list. This is the list of
-# settings the user can choose from:
+/**
+ * Limit images on image description pages to a user-selectable limit. In order
+ * to reduce disk usage, limits can only be selected from a list. This is the
+ * list of settings the user can choose from:
+ */
 $wgImageLimits = array (
        array(320,240),
        array(640,480),
@@ -915,51 +1018,57 @@ $wgNavigationLinks = array (
        array( 'text'=>'sitesupport',   'href'=>'sitesupport-url' ),
 );
 
-# On category pages, show thumbnail gallery for images belonging to that category
-# instead of listing them as articles.
+/**
+ *  On  category pages, show thumbnail gallery for images belonging to that
+ * category instead of listing them as articles.
+ */
 $wgCategoryMagicGallery = true;
 
-# Browser Blacklist for unicode non compliant browsers
-# Contains a list of regexps : "/regexp/"  matching problematic browsers
+/**
+ * Browser Blacklist for unicode non compliant browsers
+ * Contains a list of regexps : "/regexp/"  matching problematic browsers
+ */
 $wgBrowserBlackList = array(
        "/Mozilla\/4\.78 \[en\] \(X11; U; Linux/"
        // FIXME: Add some accurate, true things here
        );
 
-# Fake out the timezone that the server thinks it's in. This will be used
-# for date display and not for what's stored in the DB.
-# Leave to null to retain your server's OS-based timezone value
-# This is the same as the timezone
+/**
+ * Fake out the timezone that the server thinks it's in. This will be used for
+ * date display and not for what's stored in the DB. Leave to null to retain
+ * your server's OS-based timezone value. This is the same as the timezone.
+ */
 # $wgLocaltimezone = 'GMT';
 # $wgLocaltimezone = 'PST8PDT';
 # $wgLocaltimezone = 'Europe/Sweden';
 # $wgLocaltimezone = 'CET';
 $wgLocaltimezone = null;
 
-# User level management
-# The number is the database id of a group you want users to be attached by
-# default. A better interface should be coded [av]
+/**
+ * User level management
+ * The number is the database id of a group you want users to be attached by
+ * default. A better interface should be coded [av]
+ */
 $wgAnonGroupId = 1;
 $wgLoggedInGroupId = 2;
 $wgSysopGroupId = 3;
 $wgBureaucratGroupId = 4;
 
-/*
-When translating messages with wfMsg(), it is not always clear what should
-be considered UI messages and what shoud be content messages. 
-
-For example, for regular wikipedia site like en, there should be only one 
-'mainpage', therefore when getting the link of 'mainpage', we should 
-treate it as content of the site and call wfMsgForContent(), while for 
-rendering the text of the link, we call wfMsg(). The code in default
-behaves this way. However, sites like common do offer different versions 
-of 'mainpage' and the like for different languages. This array provides a
-way to override the default behavior. For example, to allow language specific
-mainpage and community portal, set
-
-$wgForceUIMsgAsContentMsg = array( 'mainpage', 'portal-url' );
-
-*/
+/**
+ * When translating messages with wfMsg(), it is not always clear what should be
+ * considered UI messages and what shoud be content messages.
+ *
+ * For example, for regular wikipedia site like en, there should be only one
+ * 'mainpage', therefore when getting the link of 'mainpage', we should treate
+ * it as content of the site and call wfMsgForContent(), while for rendering the
+ * text of the link, we call wfMsg(). The code in default behaves this way.
+ * However, sites like common do offer different versions of 'mainpage' and the
+ * like for different languages. This array provides a way to override the
+ * default behavior. For example, to allow language specific mainpage and
+ * community portal, set
+ *
+ * $wgForceUIMsgAsContentMsg = array( 'mainpage', 'portal-url' );
+ */
 $wgForceUIMsgAsContentMsg = array();
 
 
@@ -976,8 +1085,7 @@ $wgAuth = null;
  *     $wgHooks['event_name'][] = array($function, $data);
  * or:
  *     $wgHooks['event_name'][] = array($object, 'method');
- */
-       
+ */    
 $wgHooks = array();
 
 /**
@@ -1007,7 +1115,15 @@ $wgDisableInternalSearch = false;
  */
 $wgSearchForwardUrl = null;
 
+/**
+ * If true, external URL links in wiki text will be given the
+ * rel="nofollow" attribute as a hint to search engines that
+ * they should not be followed for ranking purposes as they
+ * are user-supplied and thus subject to spamming.
+ */
+$wgNoFollowLinks = true;
+
 } else {
        die();
 }
-?>
+?>
\ No newline at end of file