Fixing typos

Found via `codespell -q 3 --skip="./lang”`

admin/install.php

@@ -896,7 +896,7 @@ function print_test( $p_test_description, $p_result, $p_hard_fail = true, $p_mes
 						false,
 						count( $t_bool_columns ) . ' columns must be converted to BOOLEAN' );
 				} else {
-					# We did not get an array => error occured
+					# We did not get an array => error occurred
 					print_test( $t_msg, false, true, $t_bool_columns );
 				}
 

api/soap/mc_issue_api.php

@@ -384,7 +384,7 @@ function mci_issue_get_due_date( BugData $p_bug ) {
  * @param integer $p_issue_id       Issue id to apply custom field values to.
  * @param array   &$p_custom_fields The array of custom field values as described in the webservice complex types.
  * @param boolean $p_log_insert     Create history logs for new values.
- * @return booleamn|SoapFault|RestFault true for sucess, otherwise fault.
+ * @return boolean|SoapFault|RestFault true for success, otherwise fault.
  */
 function mci_issue_set_custom_fields( $p_issue_id, array &$p_custom_fields = null, $p_log_insert ) {
 	# set custom field values on the submitted issue

core/classes/BugFilterQuery.class.php

@@ -667,7 +667,7 @@ protected function build_prop_view_state() {
 	/**
 	 * Utility function to process the values for a filter property that is related
 	 * to a database id number, used to represent users.
-	 * Manages special case meta-value-none, wich is translated to id "0", to be able
+	 * Manages special case meta-value-none, which is translated to id "0", to be able
 	 * to match database values where "0" is the default for empty/none
 	 * Manages special case meta-value-myself, by replacing with the actual current user id.
 	 *
@@ -807,7 +807,7 @@ protected function build_prop_priority() {
 	/**
 	 * Utility function to process the values for a filter property that is related
 	 * to a database string field.
-	 * Manages special case meta-value-none, wich is translated to "", to be able
+	 * Manages special case meta-value-none, which is translated to "", to be able
 	 * to match database values where "" is the default for empty/null
 	 *
 	 * @param array $p_array	Input array with strings
@@ -854,7 +854,7 @@ protected function build_prop_version() {
 	/**
 	 * Utility function to process the values for a filter property that is related
 	 * to a database id number.
-	 * Manages special cases like meta-value-none, wich is translated to id "0", to be able
+	 * Manages special cases like meta-value-none, which is translated to id "0", to be able
 	 * to match database values where "0" is the default for empty/none
 	 * @param array $p_array	Input array with ids
 	 * @return array	Converted array
@@ -1098,7 +1098,7 @@ protected function build_prop_relationship() {
 		} else {
 			# relation is specified
 			if( META_FILTER_NONE == $c_rel_bug ) {
-				# rel REL, bug NONE, those bugs that dont have any REL relation (may have other types)
+				# rel REL, bug NONE, those bugs that don't have any REL relation (may have other types)
 				# map to a non-existant relation type -1 to include nulls
 				$t_where = 'COALESCE(' . $t_table_dst . '.relationship_type, -1) <> ' . $this->param( $t_comp_type )
 						. ' AND COALESCE(' . $t_table_src . '.relationship_type, -1) <> ' . $this->param( $c_rel_type );
@@ -1124,7 +1124,7 @@ protected function build_prop_relationship() {
 	}
 
 	/**
-	 * Utility function to return the projects, fro mthe current filter scope, that meets some
+	 * Utility function to return the projects, from the current filter scope, that meets some
 	 * access level threshold. The specified access can be either a int/array threshold, or
 	 * a configuration option to be evaluated at each project
 	 * (see documentation for access_project_array_filter() )
@@ -1184,7 +1184,7 @@ protected function build_prop_tags() {
 			$t_tag_projects_clause = '';
 		} else {
 			if( empty( $t_projects_can_view_tags ) ) {
-				# if cant view tags in any project, exit
+				# if can't view tags in any project, exit
 				log_event( LOG_FILTERING, 'tags query, no accesible projects ' );
 				return;
 			} else {
@@ -1302,7 +1302,7 @@ protected function helper_table_alias_for_cf( $p_cfdef ) {
 	}
 
 	/**
-	 * Build the query parts for the filter propertie srelated to custom fields
+	 * Build the query parts for the filter properties related to custom fields
 	 * @return void
 	 */
 	protected function build_prop_custom_fields() {
@@ -1478,7 +1478,7 @@ protected function helper_convert_legacy_clause( $p_string, array $p_params = nu
 	}
 
 	/**
-	 * Build the query parts for the filter propertie srelated to plugin filter fields
+	 * Build the query parts for the filter properties related to plugin filter fields
 	 * @return void
 	 */
 	protected function build_prop_plugin_filters() {
@@ -1504,7 +1504,7 @@ protected function build_prop_plugin_filters() {
 	}
 
 	/**
-	 * Return a column name for the specified proeprty to sort on.
+	 * Return a column name for the specified property to sort on.
 	 * Valid only for standard bug table fields
 	 * Manages joining with other tables to allow sorting by display names instead
 	 * of its numerical ids.
@@ -1539,7 +1539,7 @@ protected function helper_sort_column_alias( $p_prop ) {
 				# sorting by username: coalesce( username, $prefix_for_deleted || id )
 				# sorting by realname: coalesce( nullif(realname,''), username, $prefix_for_deleted || id )
 				$t_select = 'COALESCE(';
-				# Note: show_realname should olny be set at global or all_projects
+				# Note: show_realname should only be set at global or all_projects
 				# Note: sort_by_last_name is not supported here
 				if( ON == config_get( 'show_realname' ) ) {
 					$t_select .= 'NULLIF(' . $t_table_alias . '.realname, \'\'), ';

core/classes/DbQuery.class.php

@@ -39,7 +39,7 @@
  * Allows building a query and fetching data, providing compatible functionality
  * for all supported databases. Hides the underlaying details from the ADOdb layer.
  *
- * Suports inline parameters with ":label" syntax, and anonymous parameters
+ * Supports inline parameters with ":label" syntax, and anonymous parameters
  * through the param() method.
  * Supports binding arrays which will be later expanded to individual parameters.
  *
@@ -51,7 +51,7 @@
  *     - "${string}{int}" For special constructs, eg: $in0 for late binding IN caluses
  * 2) $expanded_query_string: stores the query string after expansion of special constructs
  *   into standard "${int}" parameters
- * 3) $db_query_string: stores que query string after all paramaters have been renamed,
+ * 3) $db_query_string: stores the query string after all parameters have been renamed,
  *   reordered and converted to the specific database parameter syntax expected by ADOdb.
  *   Binded values are stored in $db_param_array
  *
@@ -107,7 +107,7 @@ class DbQuery {
 
 	/**
 	 * Array of values for parameters included in the final query string for ADOdb,
-	 * indexed as neede for the ADOdb driver
+	 * indexed as needed for the ADOdb driver
 	 * @var array
 	 */
 	protected $db_param_array;
@@ -196,10 +196,10 @@ public function append_sql( $p_query_string ) {
 	}
 
 	/**
-	 * Creates a string containing a parameter that can be appended to que query string
+	 * Creates a string containing a parameter that can be appended to the query string
 	 * The provided value is binded to the parameter and stored for use at execution time
 	 * The parameters created by this method are anonymous parameters, so they can't be
-	 * accesed later to have values modified or rebinded.
+	 * accessed later to have values modified or rebinded.
 	 * The format of the token created is: "$n", where "n" is an incremental integer
 	 * @param mixed $p_value	Value to bind for this parameter
 	 * @return string			Token string
@@ -493,7 +493,7 @@ protected function process_expand_params() {
 	}
 
 	/**
-	 * Process query string to expand late binding contructs for IN clauses
+	 * Process query string to expand late binding constructs for IN clauses
 	 * @return void
 	 */
 	protected function process_expand_params_in() {
@@ -571,7 +571,7 @@ protected function process_sql_syntax_oracle() {
 
 		$t_query = $this->db_query_string;
 
-		# split the string by the relevant delimiters. The delimiters will be part of the splitted array
+		# split the string by the relevant delimiters. The delimiters will be part of the split array
 		$t_parts = preg_split("/(')|( AS )|(CAST\s*\()/mi", $t_query, -1, PREG_SPLIT_NO_EMPTY | PREG_SPLIT_DELIM_CAPTURE);
 		$t_is_literal = false;
 		$t_cast = 0;
@@ -890,14 +890,14 @@ public function sql_ilike( $p_alias, $p_value, $p_escape = null ) {
 	 * - alias: is the name of the column as a valid identifier in the final sql query
 	 * - value: is the string used as pattern for the like expression.
 	 * - escape: optionally, a character used as escape character in the pattern string
-	 * Optionally, the expresion can be forced to be case insensitive, otherwise the default
+	 * Optionally, the expression can be forced to be case insensitive, otherwise the default
 	 * behaviour from the database is used.
 	 *
 	 * The returned string would replace the sql part for: "alias LIKE 'xxx'"
 	 *
 	 * For portability reasons, the supported wildcards are '%' and '_'. Other special tokens
 	 * are automatically escaped:
-	 * - [] syntax in mssql are treated as literal charachters.
+	 * - [] syntax in mssql are treated as literal characters.
 	 * - \ as default escape char in mysql is treated as a literal character.
 	 * Note that the pattern string uses c-style escaping, so a "\" character must be written as "\\"
 	 *

core/commands/Command.php

@@ -113,7 +113,7 @@ public function query( $p_name, $p_default = null ) {
 	/**
 	 * Execute the command.  This may throw a CommandException is execution is interrupted.
 	 * The command is expected to trigger events that are handled by plugins as part of
-	 * exection.
+	 * execution.
 	 *
 	 * @return array Execution result
 	 */

core/config_api.php

@@ -702,7 +702,7 @@ function config_cache_all() {
 
 	$t_config_rows = array();
 
-	# With oracle databse, ADOdb maps column type "L" to clob.
+	# With oracle database, ADOdb maps column type "L" to clob.
 	# Because reading clobs is significantly slower, cast them to varchar for faster query execution
 	# Standard max size for varchar is 4000 bytes, so a safe limit is used as 1000 charancters
 	# for multibyte strings (up to 4 bytes per char)

core/constant_inc.php

@@ -718,7 +718,7 @@
 define( 'MANAGE_CONFIG_ACTION_CLONE', 'clone' );
 define( 'MANAGE_CONFIG_ACTION_EDIT', 'edit' );
 
-# Databse functional type identifiers.
+# Database functional type identifiers.
 define( 'DB_TYPE_UNDEFINED', 0 );
 define( 'DB_TYPE_MYSQL', 1 );
 define( 'DB_TYPE_PGSQL', 2 );

core/custom_field_api.php

@@ -824,7 +824,7 @@ function custom_field_get_linked_ids( $p_project_id = ALL_PROJECTS ) {
 			unset( $t_uncached_projects[$t_project_id] );
 		}
 
-		# save empty array for those projects that dont appear in the results
+		# save empty array for those projects that don't appear in the results
 		if( !empty( $t_uncached_projects ) ) {
 			foreach( $t_uncached_projects as $t_pr_id ) {
 				$g_cache_cf_linked[$t_pr_id] = array();

core/database_api.php

@@ -211,7 +211,7 @@ function db_check_database_support( $p_db_type ) {
 }
 
 /**
- * Maps a db driver type to the functional databse type
+ * Maps a db driver type to the functional database type
  * @param string	$p_driver_type Database driver name
  * @return int		Database type
  */
@@ -982,7 +982,7 @@ function db_oracle_adapt_query_syntax( $p_query, array &$p_arr_parms = null ) {
 	#   To do so, we will assume that the "AS" following a "CAST", is safe to be kept.
 	#   Using a counter for "CAST" appearances to allow nesting: CAST(CAST(x AS y) AS z)
 
-	# split the string by the relevant delimiters. The delimiters will be part of the splitted array
+	# split the string by the relevant delimiters. The delimiters will be part of the split array
 	$t_parts = preg_split("/(')|( AS )|(CAST\s*\()/mi", $p_query, -1, PREG_SPLIT_NO_EMPTY | PREG_SPLIT_DELIM_CAPTURE);
 	$t_is_literal = false;
 	$t_cast = 0;

core/email_api.php

@@ -145,7 +145,7 @@ function email_is_valid( $p_email ) {
 		if( !empty( $t_limit_email_domains ) ) {
 			foreach( $t_limit_email_domains as $t_email_domain ) {
 				if( 0 == strcasecmp( $t_email_domain, $t_domain ) ) {
-					return true; # no need to check mx record details (below) if we've explicity allowed the domain
+					return true; # no need to check mx record details (below) if we've explicitly allowed the domain
 				}
 			}
 			log_event( LOG_EMAIL, "failed - not in limited domains list '$t_limit_email_domains'" );

core/error_api.php

@@ -237,7 +237,7 @@ function error_handler( $p_type, $p_error, $p_file, $p_line ) {
 			if( isset( $t_stack[2] ) ) {
 				$t_caller = $t_stack[2];
 			} else {
-				# If called from main page body, there is no stack block for the funcion, use the page block instead
+				# If called from main page body, there is no stack block for the function, use the page block instead
 				$t_caller = $t_stack[1];
 			}
 

core/exceptions/LegacyApiFaultException.php

@@ -19,7 +19,7 @@
 /**
  * An exception that is triggered from a RestFault or SoapFault which is the legacy
  * way to trigger API errors.  This exception class should be removed once all APIs
- * dependend on exceptions rather than return codes being faults.
+ * dependent on exceptions rather than return codes being faults.
  *
  * Don't inherit from MantisException since we don't follow the conventions of having
  * code correspond to Mantis error code, but code here is the http error code.

core/file_api.php

@@ -103,7 +103,7 @@ function file_get_display_name( $p_filename ) {
 }
 
 /**
- * Fills the cache with the attachement count from a list of bugs
+ * Fills the cache with the attachment count from a list of bugs
  * If the bug doesn't have attachments, cache its value as 0.
  * @global array $g_cache_file_count
  * @param array $p_bug_ids Array of bug ids

core/filter_api.php

@@ -1004,7 +1004,7 @@ function filter_deserialize( $p_serialized_filter ) {
 	# in this case, the filter version field inside the array is to be used
 	# and if not present, set the current filter version
 
-	# check fitler version mark
+	# check filter version mark
 	$t_setting_arr = explode( '#', $p_serialized_filter, 2 );
 	$t_version_string = $t_setting_arr[0];
 	if( in_array( $t_version_string, array( 'v1', 'v2', 'v3', 'v4' ) ) ) {
@@ -2774,7 +2774,7 @@ function filter_db_update_filter( $p_filter_id, $p_filter_string, $p_project_id
 
 /**
  * Add a filter to the database.
- * This fucntion does not perform any validation on access or inserted data
+ * This function does not perform any validation on access or inserted data
  *
  * @param string $p_filter_string  Filter string in filter-serialized format
  * @param integer $p_user_id      User id owner of the filter
@@ -3945,7 +3945,7 @@ function filter_is_temporary( array $p_filter ) {
  * temporary filter by its session key.
  * The parameter can be ither an existing key, so its used directly,
  * or a filter array, which can contain a property with the key
- * If a filter is provided that does not contain the key proeprty, an empty
+ * If a filter is provided that does not contain the key property, an empty
  * string is returned.
  * @param array|string $p_key_or_filter	Either a string key, or a filter array
  * @return string|null	Formatted parameter string, or null

core/filter_form_api.php

@@ -2360,15 +2360,15 @@ function print_multivalue_field( $p_field_name, $p_field_value ) {
  * This method only prints the cells, not the table definition, or any other form element
  * outside of that.
  * A filter array is provided, to populate the fields.
- * The form will use javascript to show dinamic completion of fields (unless the
+ * The form will use javascript to show dynamic completion of fields (unless the
  * parameter $p_static is provided).
  * A page name can be provided to be used as a fallback script when javascript is
- * not available on the cliuent, and the form was rendered with dynamic fields.
+ * not available on the client, and the form was rendered with dynamic fields.
  * By default, the fallback is the current page.
  *
  * @param array $p_filter	Filter array to show.
  * @param boolean $p_for_screen	Type of output
- * @param boolean $p_static	Wheter to print a static form (no dynamic fields)
+ * @param boolean $p_static	Whether to print a static form (no dynamic fields)
  * @param string $p_static_fallback_page	Page name to use as javascript fallback
  * @return void
  */
@@ -2378,7 +2378,7 @@ function filter_form_draw_inputs( $p_filter, $p_for_screen = true, $p_static = f
 	$t_view_type = $t_filter['_view_type'];
 	$t_source_query_id = isset( $t_filter['_source_query_id'] ) ? (int)$t_filter['_source_query_id'] : -1;
 
-	# If it's a stored filter, linked to a secific project, use that project_id to render available fields
+	# If it's a stored filter, linked to a specific project, use that project_id to render available fields
 	if( $t_source_query_id > 0 ) {
 		$t_project_id = (int)filter_get_field( $t_source_query_id, 'project_id' );
 		if( ALL_PROJECTS == $t_project_id ) {

core/html_api.php

@@ -1438,7 +1438,7 @@ public function render() {
 
 		# Arrange the items in rows accounting for their actual cell space
 		foreach( $this->items as $t_item ) {
-			# Get the actual table colums needed to render the item
+			# Get the actual table columns needed to render the item
 			$t_item_cols = ( $this->item_orientation == self::ORIENTATION_VERTICAL ) ? $t_item->colspan : $t_item->colspan + 1;
 			# Search for a row with enough space to fit the item
 			$t_found = false;

core/print_api.php

@@ -183,7 +183,7 @@ function print_successful_redirect( $p_redirect_to ) {
  * Print avatar image for the given user ID
  *
  * @param integer $p_user_id 		A user identifier.
- * @param string $p_class_prefix	CSS classs prefix.
+ * @param string $p_class_prefix	CSS class prefix.
  * @param integer $p_size    		Image pixel size.
  * @return void
  */

core/user_api.php

@@ -1081,7 +1081,7 @@ function user_get_access_level( $p_user_id, $p_project_id = ALL_PROJECTS ) {
 $g_user_accessible_projects_cache = null;
 
 /**
- * retun an array of project IDs to which the user has access
+ * return an array of project IDs to which the user has access
  *
  * @param integer $p_user_id       A valid user identifier.
  * @param boolean $p_show_disabled Whether to include disabled projects in the result array.
@@ -1217,7 +1217,7 @@ function user_get_accessible_subprojects( $p_user_id, $p_project_id, $p_show_dis
 }
 
 /**
- * retun an array of sub-project IDs of all sub-projects project to which the user has access
+ * return an array of sub-project IDs of all sub-projects project to which the user has access
  * @param integer $p_user_id    A valid user identifier.
  * @param integer $p_project_id A valid project identifier.
  * @return array

docbook/Admin_Guide/en-US/Workflow.xml

@@ -137,7 +137,7 @@
 	    <para>Note that the scope of the applied change is
 	    dependent on the selected project.  If "All Projects" is selected,
 	    then the configuration is to be used as the default for all
-			projects, unless overidden by a specific project.  To configure for
+			projects, unless overridden by a specific project.  To configure for
 			a specific project, switch to it via the combobox at the
 			top right corner of the screen.
 		</para>

docbook/Admin_Guide/en-US/config/date.xml

@@ -53,7 +53,7 @@
 					different from the one used for the other date settings
 					described above; see
 					<ulink url="http://momentjs.com/docs/#/displaying/format/">
-						Moment.js documention
+						Moment.js documentation
 					</ulink>
 					for details.
 				</para></note>

docbook/Admin_Guide/en-US/config/email.xml

@@ -247,7 +247,7 @@ $g_notify_flags['new'] = array(
 			<term>$g_email_ensure_unique</term>
 			<listitem>
 				<para>
-					When enabled, the uniqueness of email addresses will be inforced for new
+					When enabled, the uniqueness of email addresses will be enforced for new
 					users as well as updates to existing ones.  Note that there can be duplicate
 					emails before this option was turned ON.  Default is ON.
 				</para>