refine some wording
authorDenis Ovsienko <infrastation@yandex.ru>
Fri, 6 Dec 2013 12:21:30 +0000 (16:21 +0400)
committerDenis Ovsienko <infrastation@yandex.ru>
Fri, 6 Dec 2013 13:13:02 +0000 (17:13 +0400)
Fix spelling, punctiation and put a number of which/that cases right:
http://web.ku.edu/~edit/which.html

17 files changed:
wwwroot/css/pi.css
wwwroot/inc/ajax-interface.php
wwwroot/inc/auth.php
wwwroot/inc/code.php
wwwroot/inc/config.php
wwwroot/inc/database.php
wwwroot/inc/deviceconfig.php
wwwroot/inc/functions.php
wwwroot/inc/install.php
wwwroot/inc/interface-lib.php
wwwroot/inc/interface.php
wwwroot/inc/ophandlers.php
wwwroot/inc/popup.php
wwwroot/inc/slbv2.php
wwwroot/inc/solutions.php
wwwroot/inc/triggers.php
wwwroot/inc/upgrade.php

index e83a1b4a106f6c4d4dd3195b89946eef4728652d..89a2ded4a90fce9bde793dec23924134b1f01dd7 100644 (file)
@@ -617,7 +617,7 @@ div.vlan {
        border: solid 4px lime !important;
 }
 
-/*this style is used for <a>s which does not contain href (ancors), to make them look like plain text*/
+/*this style is used for <a>s that do not contain href (anchors) to make them look like plain text*/
 .nolink {
        text-decoration: none;
        color: black;
@@ -628,7 +628,7 @@ div.vlan {
        text-decoration: none;
 }
 
-/*this class controls popup switch info. It should be on the element which contains portname in plain text*/
+/*This class controls popup switch info. It should be on the element that contains portname in plain text.*/
 .interactive-portname {
        cursor: default;
 }
index 7a904e13eb50d029a214744a2862d6383b9905f9..45f55fa5859f27e935c278db49c42384eb4653b7 100644 (file)
@@ -6,7 +6,7 @@
 
 /*
  *
- *  This file contains HTML-generating funcitons which are needed in ajax handler
+ *  This file contains HTML-generating functions required by AJAX handlers.
  *
  *
 */
index 210f7978a8a42bea3659f68b9d0c8d2a01c02d5d..d1d32ea37433cdfdce677273f26fb621a3f6060b 100644 (file)
@@ -331,7 +331,7 @@ function authenticated_via_ldap ($username, $password, &$ldap_displayname)
        if ($LDAP_options['cache_expiry'] == 0) // immediate expiry set means disabled cache
                return authenticated_via_ldap_nocache ($username, $password, $ldap_displayname);
        // authenticated_via_ldap_cache()'s way of locking can sometimes result in
-       // a PDO error condition, which convertPDOException() was not able to dispatch.
+       // a PDO error condition that convertPDOException() was not able to dispatch.
        // To avoid reaching printPDOException() (which prints backtrace with password
        // argument in cleartext), any remaining PDO condition is converted locally.
        try
index fec9780b7542227ab1fca7a969981155156370f8..2f1bba4669240aa0ce9847d7b211e89df2d94faf 100644 (file)
@@ -260,7 +260,7 @@ function getLexemsFromRawText ($text)
 // After parsing the input successfully a list of SYNT_GRANT and SYNT_DEFINITION
 // trees is returned.
 //
-// P.S. The above is true for input, which is a complete and correct RackCode text.
+// P.S. The above is true for input that is a complete and correct RackCode text.
 // Other inputs may produce different combinations of lex/synt structures. Calling
 // function must check the parse tree itself.
 function getParseTreeFromLexems ($lexems)
@@ -452,7 +452,7 @@ function getParseTreeFromLexems ($lexems)
                        // UNARY_EXPRESSION ::= true | false | TAG | AUTOTAG | PREDICATE
                        if
                        (
-                               $stacktop['type'] == 'LEX_TAG' or // first look for tokens, which are most
+                               $stacktop['type'] == 'LEX_TAG' or // first look for tokens that are most
                                $stacktop['type'] == 'LEX_AUTOTAG' or // likely to appear in the text
                                $stacktop['type'] == 'LEX_PREDICATE' or // supplied by user
                                $stacktop['type'] == 'LEX_TRUE' or
@@ -828,7 +828,7 @@ function locateSyntaxError ($stack)
 {
        // The first SYNT_CODETEXT node, if is present, holds stuff already
        // successfully processed. Its line counter shows, where the last reduction
-       // took place (it _might_ be the same line, which causes the syntax error).
+       // took place (it _might_ be the same line that causes the syntax error).
        // The next node (it's very likely to exist) should have its line counter
        // pointing to the place, where the first (of 1 or more) error is located.
        if (isset ($stack[0]['type']) and $stack[0]['type'] == 'SYNT_CODETEXT')
@@ -996,7 +996,7 @@ function findTagWarnings ($expr)
        }
 }
 
-// Check context modifiers, warn about those, which try referencing non-existent tags.
+// Check context modifiers, warn about those that try referencing non-existent tags.
 function findCtxModWarnings ($modlist)
 {
        $ret = array();
index 941510649f5ff893c508acca12136ddd7ce39727..94fae4a3ddbf0dc341cffe526ddc7923d7590f64 100644 (file)
@@ -6,8 +6,8 @@ Developer's Guide. Otherwise working copies updated from SVN (for example,
 committers' copies) can run into issues:
 1. The source is rendered unfunctional after "svn update", asking users to
    finish the "upgrade".
-2. Once the batch for the "upgrade" is executed, the queries, which get added
-   to the batch later, are likely to receive no real execution.
+2. Once the batch for the "upgrade" is executed, the queries that get added
+   to the batch later are likely to receive no real execution.
 3. In case the executed part of such partial batch is found incorrect later,
    but before the release, fixing the wrong queries will be harder, hence they
    have already been executed.
index 2e2dbc76162a3187a90a17a39c95c4ff420f7b2b..7ee547cb0521fc20d21141b253f0c21b17765092 100644 (file)
@@ -321,7 +321,7 @@ function getRacks ($row_id)
        return reindexById ($result->fetchAll (PDO::FETCH_ASSOC));
 }
 
-# Return rack and row details for those objects on the list, which have
+# Return rack and row details for those objects on the list that have
 # at least one rackspace atom allocated to them.
 function getMountInfo ($object_ids)
 {
@@ -1446,7 +1446,7 @@ function resetRackSortOrder ($row_id)
 }
 
 // This function accepts rack data returned by amplifyCell(), validates and applies changes
-// supplied in $_REQUEST and returns resulting array. Only those changes are examined, which
+// supplied in $_REQUEST and returns resulting array. Only those changes are examined that
 // correspond to current rack ID.
 // 1st arg is rackdata, 2nd arg is unchecked state, 3rd arg is checked state.
 // If 4th arg is present, object_id fields will be updated accordingly to the new state.
@@ -1518,7 +1518,7 @@ function processGridForm (&$rackData, $unchecked_state, $checked_state, $object_
        return FALSE;
 }
 
-// This function builds a list of rack-unit-atom records, which are assigned to
+// This function builds a list of rack-unit-atom records assigned to
 // the requested object.
 function getMoleculeForObject ($object_id)
 {
@@ -3041,8 +3041,8 @@ function getObjectAttrsSearchResults ($what)
        return $ret;
 }
 
-// Search stickers and return a list of pairs "object_id-attribute_id",
-// which matched. A partilar object_id could be returned more than once, if it has
+// Search stickers and return a list of pairs "object_id-attribute_id"
+// that matched. A partilar object_id could be returned more than once, if it has
 // multiple matching stickers. Search is only performed on "string" or "dict" attributes.
 function getStickerSearchResults ($tablename, $what)
 {
@@ -3452,7 +3452,7 @@ function getRackspaceStats ()
 
 /*
 
-The following allows figuring out records in TagStorage, which refer to non-existing entities:
+The following allows figuring out records in TagStorage that refer to non-existing entities:
 
 mysql> select entity_id from TagStorage left join Files on entity_id = id where entity_realm = 'file' and id is null;
 mysql> select entity_id from TagStorage left join IPv4Network on entity_id = id where entity_realm = 'ipv4net' and id is null;
@@ -3461,7 +3461,7 @@ mysql> select entity_id from TagStorage left join IPv4VS on entity_id = id where
 mysql> select entity_id from TagStorage left join IPv4RSPool on entity_id = id where entity_realm = 'ipv4rspool' and id is null;
 mysql> select entity_id from TagStorage left join UserAccount on entity_id = user_id where entity_realm = 'user' and user_id is null;
 
-Accordingly, these are the records, which refer to non-existent tags:
+Accordingly, these are the records that refer to non-existent tags:
 
 mysql> select tag_id from TagStorage left join TagTree on tag_id = id where id is null;
 
@@ -4012,7 +4012,7 @@ function generateEntityAutoTags ($cell)
                        break;
                case 'user':
                        # {$username_XXX} autotag is generated always, but {$userid_XXX}
-                       # appears only for accounts, which exist in local database.
+                       # appears only for accounts that exist in local database.
                        $ret[] = array ('tag' => '$username_' . $cell['user_name']);
                        if (isset ($cell['user_id']))
                                $ret[] = array ('tag' => '$userid_' . $cell['user_id']);
@@ -4122,7 +4122,7 @@ function addTagForEntity ($realm, $entity_id, $tag_id)
 }
 
 // Add records into TagStorage, if this makes sense (IOW, they don't appear
-// on the implicit list already). Then remove any other records, which
+// on the implicit list already). Then remove any other records that
 // appear on the "implicit" side of the chain. This will make sure,
 // that both the tag base is still minimal and all requested tags appear on
 // the resulting tag chain.
@@ -4130,7 +4130,7 @@ function addTagForEntity ($realm, $entity_id, $tag_id)
 function rebuildTagChainForEntity ($realm, $entity_id, $extrachain = array(), $replace = FALSE)
 {
        // Put the current explicit sub-chain into a buffer and merge all tags from
-       // the extra chain, which aren't there yet.
+       // the extra chain that aren't there yet.
        $oldchain = array();
        $newchain = array();
        foreach (loadEntityTags ($realm, $entity_id) as $oldtag)
@@ -4405,7 +4405,7 @@ function getNATv4ForObject ($object_id)
        return $ret;
 }
 
-// Return a list of files, which are not linked to the specified record. This list
+// Return a list of files that are not linked to the specified record. This list
 // will be used by printSelect().
 function getAllUnlinkedFiles ($entity_type = NULL, $entity_id = 0)
 {
@@ -4982,7 +4982,7 @@ function getVLANInfo ($vlan_ck)
        return $ret;
 }
 
-// return list of network IDs, which are not bound to the given VLAN domain
+// return list of network IDs that are not bound to the given VLAN domain
 function getVLANIPv4Options ($except_vdid)
 {
        $prepared = usePreparedSelectBlade
@@ -4995,7 +4995,7 @@ function getVLANIPv4Options ($except_vdid)
        return reduceSubarraysToColumn ($prepared->fetchAll (PDO::FETCH_ASSOC), 'id');
 }
 
-// return list of network IDs, which are not bound to the given VLAN domain
+// return list of network IDs that are not bound to the given VLAN domain
 function getVLANIPv6Options ($except_vdid)
 {
        $prepared = usePreparedSelectBlade
@@ -5068,7 +5068,7 @@ function commitReduceVLANIPv6 ($vlan_ck, $ipv6net_id)
        );
 }
 
-// Return a list of switches, which have specific VLAN configured on
+// Return a list of switches that have specific VLAN configured on
 // any port (each switch with the list of such ports).
 function getVLANConfiguredPorts ($vlan_ck)
 {
@@ -5365,7 +5365,7 @@ function touchVLANSwitch ($switch_id)
        );
 }
 
-# Return list of rows for objects, which have the date stored in the given
+# Return list of rows for objects that have the date stored in the given
 # attribute belonging to the given range (relative to today's date).
 function scanAttrRelativeDays ($attr_id, $not_before_days, $not_after_days)
 {
index 277f937a3f01a7b7a6ccc30e3308caa8d05da80d..088db57eb7b863819c86e31d1f96b3c9603c6aa1 100644 (file)
@@ -835,7 +835,7 @@ function vrp55Read8021QConfig ($input)
                        $ret['current']['link-type'] = $matches[1];
                        break;
                // Native VLAN is configured differently for each link-type case, but
-               // VRP is known to filter off clauses, which don't make sense for
+               // VRP is known to filter off clauses that don't make sense for
                // current link-type. This way any interface section should contain
                // only one kind of "set native" clause (but if this constraint breaks,
                // we get a problem).
index 5a7563715a0966d0813f4f58f1df597f5615d098..834d617ba687cb425910056c8448961cba484daf 100644 (file)
@@ -416,7 +416,7 @@ function getBypassValue()
        return genericAssertion ($page[$pageno]['bypass'], $page[$pageno]['bypass_type']);
 }
 
-// fills $args array with the bypass values of specified $pageno which are provided in $_REQUEST
+// fills $args array with the bypass values of specified $pageno that are provided in $_REQUEST
 function fillBypassValues ($pageno, &$args)
 {
        global $page, $sic;
@@ -462,7 +462,7 @@ function setDisplayedName (&$cell)
        }
 }
 
-// This function finds height of solid rectangle of atoms, which are all
+// This function finds height of solid rectangle of atoms that are all
 // assigned to the same object. Rectangle base is defined by specified
 // template.
 function rectHeight ($rackData, $startRow, $template_idx)
@@ -1262,8 +1262,8 @@ function treeItemCmp ($a, $b)
 
 // Build a tree from the item list and return it. Input and output data is
 // indexed by item id (nested items in output are recursively stored in 'kids'
-// key, which is in turn indexed by id. Functions, which are ready to handle
-// tree collapsion/expansion themselves, may request non-zero threshold value
+// key, which is in turn indexed by id. Functions that are ready to handle
+// tree collapsion/expansion themselves may request non-zero threshold value
 // for smaller resulting tree.
 function treeFromList (&$orig_nodelist, $threshold = 0, $return_main_payload = TRUE)
 {
@@ -1324,7 +1324,7 @@ function treeFromList (&$orig_nodelist, $threshold = 0, $return_main_payload = T
 }
 
 // Build a tree from the tag list and return everything _except_ the tree.
-// IOW, return taginfo items, which have parent_id set and pointing outside
+// IOW, return taginfo items that have parent_id set and pointing outside
 // of the "normal" tree, which originates from the root.
 function getOrphanedTags ()
 {
@@ -1442,7 +1442,7 @@ function getTagSubtree ($tagid)
        return $subtree;
 }
 
-// returns an array of tag ids which have $tagid as its parent (all levels)
+// returns an array of tag ids that have $tagid as its parent (all levels)
 function getTagDescendents ($tagid)
 {
        $ret = array();
@@ -1649,8 +1649,8 @@ function getObjectiveTagTree ($tree, $realm, $preselect)
        return $ret;
 }
 
-// Preprocess tag tree to get only tags which can effectively reduce given filter result,
-// than passes shrinked tag tree to getObjectiveTagTree and return its result.
+// Preprocess tag tree to get only tags that can effectively reduce given filter result,
+// then pass shrinked tag tree to getObjectiveTagTree and return its result.
 // This makes sense only if andor mode is 'and', otherwise function does not modify tree.
 // 'Given filter' is a pair of $entity_list(filter result) and $preselect(filter data).
 // 'Effectively' means reduce to non-empty result.
@@ -1791,7 +1791,7 @@ function getCellFilter ()
                showWarning ('Invalid and/or switch value in submitted form');
                return NULL;
        }
-       // Both tags and predicates, which don't exist, should be
+       // Both tags and predicates that don't exist, should be
        // handled somehow. Discard them silently for now.
        global $taglist, $pTable;
        foreach (array ('cft', 'cfp', 'nft', 'nfp') as $param)
@@ -2628,7 +2628,7 @@ function prepareIPTree ($netlist, $expanded_id = 0)
        return $tree;
 }
 
-# Traverse IPv4/IPv6 tree and return a list of all networks, which
+# Traverse IPv4/IPv6 tree and return a list of all networks that
 # exist in DB and don't have any sub-networks.
 function getTerminalNetworks ($tree)
 {
@@ -2644,7 +2644,7 @@ function getTerminalNetworks ($tree)
 
 // Check all items of the tree recursively, until the requested target id is
 // found. Mark all items leading to this item as "expanded", collapsing all
-// the rest, which exceed the given threshold (if the threshold is given).
+// the rest that exceed the given threshold (if the threshold is given).
 function iptree_markup_collapsion (&$tree, $threshold = 1024, $target = 0)
 {
        $self = __FUNCTION__;
@@ -2988,7 +2988,7 @@ function considerGivenConstraint ($cell, $filter)
                return judgeContext ($expr);
 }
 
-// Return list of records in the given realm, which conform to
+// Return list of records in the given realm that conform to
 // the given RackCode expression. If the realm is unknown or text
 // doesn't validate as a RackCode expression, return NULL.
 // Otherwise (successful scan) return a list of all matched
@@ -3138,7 +3138,7 @@ function getPortListPrefs()
 
 // Return data for printNiftySelect() with port type options. All OIF options
 // for the default IIF will be shown, but only the default OIFs will be present
-// for each other IIFs. IIFs, for which there is no default OIF, will not
+// for each other IIFs. IIFs for that there is no default OIF will not
 // be listed.
 // This SELECT will be used for the "add new port" form.
 function getNewPortTypeOptions()
@@ -3283,7 +3283,7 @@ function iosParseVLANString ($string)
        return $ret;
 }
 
-// Scan given array and return the key, which addresses the first item
+// Scan given array and return the key that addresses the first item
 // with requested column set to given value (or NULL if there is none such).
 // Note that 0 and NULL mean completely different things and thus
 // require strict checking (=== and !===).
@@ -3302,7 +3302,7 @@ function array_values_same ($a1, $a2)
        return !count (array_diff ($a1, $a2)) and !count (array_diff ($a2, $a1));
 }
 
-# Reindex provided array of arrays by a column value, which is present in
+# Reindex provided array of arrays by a column value that is present in
 # each sub-array and is assumed to be unique. Most often, make "id" column in
 # a list of cells into the key space.
 function reindexById ($input, $column_name = 'id')
@@ -3442,7 +3442,7 @@ function generate8021QDeployOps ($vswitch, $device_vlanlist, $before, $changes)
        $domain_vlanlist = getDomainVLANList ($vswitch['domain_id']);
        $employed_vlans = getEmployedVlans ($vswitch['object_id'], $domain_vlanlist);
 
-       // only ignore VLANs, which exist and are explicitly shown as "alien"
+       // only ignore VLANs that exist and are explicitly shown as "alien"
        $old_managed_vlans = array();
        foreach ($device_vlanlist as $vlan_id)
                if
@@ -3482,10 +3482,10 @@ function generate8021QDeployOps ($vswitch, $device_vlanlist, $before, $changes)
        $ports_to_do = $ports_to_do_queue1 + $ports_to_do_queue2;
        // New VLAN table is a union of:
        // 1. all compulsory VLANs
-       // 2. all "current" non-alien allowed VLANs of those ports, which are left
+       // 2. all "current" non-alien allowed VLANs of those ports that are left
        //    intact (regardless if a VLAN exists in VLAN domain, but looking,
        //    if it is present in device's own VLAN table)
-       // 3. all "new" allowed VLANs of those ports, which we do "push" now
+       // 3. all "new" allowed VLANs of those ports that we do "push" now
        // Like for old_managed_vlans, a VLANs is never listed, only if it
        // exists and belongs to "alien" type.
        $new_managed_vlans = array();
@@ -3493,7 +3493,7 @@ function generate8021QDeployOps ($vswitch, $device_vlanlist, $before, $changes)
        // in order to delete it from device as soon as vlan will be removed from the last port
        // This array tracks port count:
        //  * keys are vlan_id's;
-       //  * values are the number of changed ports which were using this vlan in old configuration
+       //  * values are the number of changed ports that were using this vlan in old configuration
        $used_vlans = array();
        // 1
        foreach ($domain_vlanlist as $vlan_id => $vlan)
@@ -3670,7 +3670,7 @@ function generate8021QDeployOps ($vswitch, $device_vlanlist, $before, $changes)
                switch ($port['old_mode'] . '->' . $port['new_mode'])
                {
                case 'trunk->trunk':
-                       // For each allowed VLAN, which is present on the "new" list and missing from
+                       // For each allowed VLAN that is present on the "new" list and missing from
                        // the "old" one, queue a command to assign current port to that VLAN.
                        if (count ($tmp = array_diff ($port['new_allowed'], $port['old_allowed'])))
                                $crq[] = array
@@ -4018,7 +4018,7 @@ function get8021QSyncOptions
                // (__R): port missing from DB
                if (!array_key_exists ($pn, $C))
                {
-                       // Allow importing any configuration, which passes basic
+                       // Allow importing any configuration that passes basic
                        // validation. If port mode doesn't match its VST role,
                        // this will be handled later WRT each port.
                        $ret[$pn] = array
@@ -4307,7 +4307,7 @@ function initiateUplinksReverb ($object_id, $uplink_ports)
        return $done;
 }
 
-// returns a first port from $ports which is connected and it's name equals to $name
+// returns the first port from $ports that is connected and its name equals to $name
 function findConnectedPort ($ports, $name)
 {
        foreach ($ports as $portinfo)
@@ -4631,8 +4631,8 @@ function compareDecomposedPortNames ($porta, $portb)
 // * fa1, gi0/1~48, te1/49~50 (type matters, then index)
 // * gi5/1~3, te5/4~5 (here index matters more, than type)
 // This implementation makes port type (prefix) matter for all
-// interfaces, which have less, than 2 indices, but for other ports
-// their indices matter more, than type (unless there is a clash
+// interfaces that have less than 2 indices, but for other ports
+// their indices matter more than type (unless there is a clash
 // of indices).
 // When $name_in_value is TRUE, port name determines as $plist[$key]['name']
 // Otherwise portname is the key of $plist
@@ -4683,7 +4683,7 @@ function usort_portlist(&$array)
 
 // This is a dual-purpose formating function:
 // 1. Replace empty strings with nbsp.
-// 2. Cut strings, which are too long, append "cut here" indicator and provide a mouse hint.
+// 2. Cut strings that are too long: append "cut here" indicator and provide a mouse hint.
 function niftyString ($string, $maxlen = 30, $usetags = TRUE)
 {
        $cutind = '&hellip;'; // length is 1
@@ -4808,7 +4808,7 @@ function searchEntitiesByText ($terms)
                        $summary['vlan'] = getVLANSearchResult ($terms);
                }
        }
-       # Filter search results in a way in some realms to omit records, which the
+       # Filter search results in a way in some realms to omit records that the
        # user would not be able to browse anyway.
        foreach (array ('object', 'ipv4net', 'ipv6net', 'ipv4rspool', 'ipv4vs', 'ipvs', 'file', 'rack', 'row', 'location') as $realm)
                if (isset ($summary[$realm]))
@@ -5246,11 +5246,11 @@ function getPortinfoByName (&$object, $portname)
 }
 
 # For the given object ID return a getSelect-suitable list of object types
-# compatible with the object's attributes, which have an assigned value in
+# compatible with the object's attributes that have an assigned value in
 # AttributeValue (no assigned values mean full compatibility). Being compatible
 # with an attribute means having a record in AttributeMap (with the same chapter
 # ID, if the attribute is dictionary-based). This knowledge is required to allow
-# the user changing object type ID in a way, which leaves data in AttributeValue
+# the user changing object type ID in a way that leaves data in AttributeValue
 # meeting constraints in AttributeMap upon the change.
 function getObjectTypeChangeOptions ($object_id)
 {
index 5e6aaba7c854a0e095441b58d1ad831a0e37bdff..b2fc87230408cb2a88edeb850ed08fef0ce9481c 100644 (file)
@@ -483,7 +483,7 @@ function get_pseudo_file ($name)
                $query[] = "CREATE TABLE `AttributeValue` (
   `object_id` int(10) unsigned NOT NULL,
   -- Default value intentionally breaks the constraint, this blocks
-  -- any insertion, which doesn't have 'object_tid' on the column list.
+  -- any insertion that doesn't have 'object_tid' on the column list.
   `object_tid` int(10) unsigned NOT NULL default '0',
   `attr_id` int(10) unsigned NOT NULL,
   `string_value` char(255) default NULL,
@@ -1663,8 +1663,8 @@ WHERE O.objtype_id = 1562";
 ('IPV4LB_LISTSRC','false','string','yes','no','no','List source: IPv4 load balancers'),
 ('IPV4OBJ_LISTSRC','not ({\$typeid_3} or {\$typeid_9} or {\$typeid_10} or {\$typeid_11})','string','yes','no','no','List source: IPv4-enabled objects'),
 ('IPV4NAT_LISTSRC','{\$typeid_4} or {\$typeid_7} or {\$typeid_8} or {\$typeid_798}','string','yes','no','no','List source: IPv4 NAT performers'),
-('ASSETWARN_LISTSRC','{\$typeid_4} or {\$typeid_7} or {\$typeid_8}','string','yes','no','no','List source: object, for which asset tag should be set'),
-('NAMEWARN_LISTSRC','{\$typeid_4} or {\$typeid_7} or {\$typeid_8}','string','yes','no','no','List source: object, for which common name should be set'),
+('ASSETWARN_LISTSRC','{\$typeid_4} or {\$typeid_7} or {\$typeid_8}','string','yes','no','no','List source: objects for that asset tag should be set'),
+('NAMEWARN_LISTSRC','{\$typeid_4} or {\$typeid_7} or {\$typeid_8}','string','yes','no','no','List source: objects for that common name should be set'),
 ('RACKS_PER_ROW','12','uint','yes','no','yes','Racks per row'),
 ('FILTER_PREDICATE_SIEVE','','string','yes','no','yes','Predicate sieve regex(7)'),
 ('FILTER_DEFAULT_ANDOR','and','string','no','no','yes','Default list filter boolean operation (or/and)'),
index eb11f441fac35465f87e2048c4495cd911f5890b..1644fc9a52229577cbae7211611b0075e31a967f 100644 (file)
@@ -467,7 +467,7 @@ function transformRequestData()
        // Escape any globals before we ever try to use them, but keep a copy of originals.
        $sic = array();
        // walk through merged GET and POST instead of REQUEST array because it
-       // can contain cookies with data which could not be decoded from UTF-8
+       // can contain cookies with data that could not be decoded from UTF-8
        foreach (($_POST + $_GET) as $key => $value)
        {
                if (is_array ($value))
index 812f761999c956793c56b629864b3b433cf505f8..c2ec9be72890df78a824ff63a6892a6aaa7fcb22 100644 (file)
@@ -1206,7 +1206,7 @@ function renderObjectPortRow ($port, $is_highlighted)
        if ($is_highlighted)
                echo ' class=highlight';
        $a_class = isEthernetPort ($port) ? 'port-menu' : '';
-       echo "><td class='tdleft' NOWRAP><a name='port-${port['id']}' class='ancor interactive-portname nolink $a_class'>${port['name']}</a></td>";
+       echo "><td class='tdleft' NOWRAP><a name='port-${port['id']}' class='anchor interactive-portname nolink $a_class'>${port['name']}</a></td>";
        echo "<td class=tdleft>${port['label']}</td>";
        echo "<td class=tdleft>" . formatPortIIFOIF ($port) . "</td><td class=tdleft><tt>${port['l2address']}</tt></td>";
        if ($port['remote_object_id'])
@@ -1985,7 +1985,7 @@ function renderRackSpaceForObject ($object_id)
                        }
 
        // Get a list of all of this object's parents,
-       // then trim the list to only include parents which are racks
+       // then trim the list to only include parents that are racks
        $parentRacks = array();
        foreach (getEntityRelatives('parents', 'object', $object_id, 'rack') as $parentData)
                $parentRacks[] = $parentData['entity_id'];
@@ -2623,7 +2623,7 @@ function renderEmptyIPv6 ($ip_bin, $hl_ip)
        if ($ip_bin === $hl_ip)
                $class .= ' highlight';
        $fmt = ip6_format ($ip_bin);
-       echo "<tr class='$class'><td><a class='ancor' name='ip-$fmt' href='" . makeHref (array ('page' => 'ipaddress', 'ip' => $fmt)) . "'>" . $fmt;
+       echo "<tr class='$class'><td><a class='anchor' name='ip-$fmt' href='" . makeHref (array ('page' => 'ipaddress', 'ip' => $fmt)) . "'>" . $fmt;
        $editable = permitted ('ipaddress', 'properties', 'editAddress')
                ? 'editable'
                : '';
@@ -2652,7 +2652,7 @@ function renderSeparator ($first, $last, $hl_ip)
                echo "<tr><td colspan=4 class=tdleft></td></tr>\n";
 }
 
-// calculates page number which contains given $ip (used by renderIPv6NetworkAddresses)
+// calculates page number that contains given $ip (used by renderIPv6NetworkAddresses)
 function getPageNumOfIPv6 ($list, $ip_bin, $maxperpage)
 {
        if (intval ($maxperpage) <= 0 || count ($list) <= $maxperpage)
@@ -2721,7 +2721,7 @@ function renderIPv4NetworkAddresses ($range)
                        $addr = $range['addrlist'][$ip_bin];
                else
                {
-                       echo "<tr class='tdleft $tr_class'><td class=tdleft><a class='ancor' name='ip-$dottedquad' href='" . makeHref(array('page'=>'ipaddress', 'ip' => $dottedquad)) . "'>$dottedquad</a></td>";
+                       echo "<tr class='tdleft $tr_class'><td class=tdleft><a class='anchor' name='ip-$dottedquad' href='" . makeHref(array('page'=>'ipaddress', 'ip' => $dottedquad)) . "'>$dottedquad</a></td>";
                        $editable = permitted ('ipaddress', 'properties', 'editAddress')
                                ? 'editable'
                                : '';
@@ -2739,7 +2739,7 @@ function renderIPv4NetworkAddresses ($range)
                }
                $tr_class .= ' ' . $addr['class'];
                echo "<tr class='tdleft $tr_class'>";
-               echo "<td><a class='ancor $history_class' $title name='ip-$dottedquad' href='".makeHref(array('page'=>'ipaddress', 'ip'=>$addr['ip']))."'>${addr['ip']}</a></td>";
+               echo "<td><a class='anchor $history_class' $title name='ip-$dottedquad' href='".makeHref(array('page'=>'ipaddress', 'ip'=>$addr['ip']))."'>${addr['ip']}</a></td>";
                $editable =
                        (empty ($addr['allocs']) || !empty ($addr['name']) || !empty ($addr['comment']))
                        && permitted ('ipaddress', 'properties', 'editAddress')
@@ -2859,7 +2859,7 @@ function renderIPv6NetworkAddresses ($netinfo)
 
                $tr_class = $addr['class'] . ' tdleft' . ($hl_ip === $ip_bin ? ' highlight' : '');
                echo "<tr class='$tr_class'>";
-               echo "<td><a class='ancor $history_class' $title name='ip-${addr['ip']}' href='" . makeHref (array ('page' => 'ipaddress', 'ip' => $addr['ip'])) . "'>${addr['ip']}</a></td>";
+               echo "<td><a class='anchor $history_class' $title name='ip-${addr['ip']}' href='" . makeHref (array ('page' => 'ipaddress', 'ip' => $addr['ip'])) . "'>${addr['ip']}</a></td>";
                $editable =
                        (empty ($addr['allocs']) || !empty ($addr['name'])
                        && permitted ('ipaddress', 'properties', 'editAddress')
@@ -5165,7 +5165,7 @@ function renderCellFilterPortlet ($preselect, $realm, $cell_list = array(), $byp
                global $pTable;
                $myPredicates = array();
                $psieve = getConfigVar ('FILTER_PREDICATE_SIEVE');
-               // Repack matching predicates in a way, which tagOnChain() understands.
+               // Repack matching predicates in a way that tagOnChain() understands.
                foreach (array_keys ($pTable) as $pname)
                        if (preg_match ("/${psieve}/", $pname))
                                $myPredicates[] = array ('id' => $pname, 'tag' => $pname);
@@ -6062,18 +6062,18 @@ function showPathAndSearch ($pageno, $tabno)
                if (! isset ($title['params']['tab']))
                        $title['params']['tab'] = 'default';
                $is_first = TRUE;
-               $ancor_tail = '';
+               $anchor_tail = '';
                foreach ($title['params'] as $param_name => $param_value)
                {
                        if ($param_name == '#')
                        {
-                               $ancor_tail = '#' . $param_value;
+                               $anchor_tail = '#' . $param_value;
                                continue;
                        }
                        $item .= ($is_first ? '' : '&') . "${param_name}=${param_value}";
                        $is_first = FALSE;
                }
-               $item .= $ancor_tail;
+               $item .= $anchor_tail;
                $item .= "'>" . $title['name'] . "</a>";
                $items[] = $item;
 
@@ -6477,7 +6477,7 @@ function render8021QOrderForm ($some_id)
                if ($pageno != 'object')
                {
                        echo '<td>';
-                       // hide any object, which is already in the table
+                       // hide any object that is already in the table
                        $options = array();
                        foreach (getNarrowObjectList ('VLANSWITCH_LISTSRC') as $object_id => $object_dname)
                                if (!in_array ($object_id, $all_vswitches))
@@ -6936,14 +6936,14 @@ function renderObject8021QPorts ($object_id)
                        foreach ($sockets[$port_name][0] as $tmp)
                                $socket_columns .= '<td>' . $tmp . '</td>';
                }
-               $ancor = '';
+               $anchor = '';
                $tdclass = '';
                if (isset ($hl_port_name) and $hl_port_name == $port_name)
                {
                        $tdclass .= 'class="border_highlight"';
-                       $ancor = "name='port-$hl_port_id'";
+                       $anchor = "name='port-$hl_port_id'";
                }
-               echo "<tr class='${trclass}' valign=top><td${td_extra} ${tdclass} NOWRAP><a class='interactive-portname port-menu nolink' $ancor>${port_name}</a></td>" . $socket_columns;
+               echo "<tr class='${trclass}' valign=top><td${td_extra} ${tdclass} NOWRAP><a class='interactive-portname port-menu nolink' $anchor>${port_name}</a></td>" . $socket_columns;
                echo "<td${td_extra}>${text_left}</td><td class=tdright nowrap${td_extra}>${text_right}</td></tr>";
                if (!array_key_exists ($port_name, $sockets))
                        continue;
@@ -7050,7 +7050,7 @@ function getAccessPortControlCode ($req_port_name, $vdom, $port_name, $port, &$n
        $ret = "<input type=hidden name=pn_${nports} value=${port_name}>";
        $ret .= "<input type=hidden name=pm_${nports} value=access>";
        $options = array();
-       // Offer only options, which are listed in domain and fit into VST.
+       // Offer only options that are listed in domain and fit into VST.
        // Never offer immune VLANs regardless of VST filter for this port.
        // Also exclude current VLAN from the options, unless current port
        // mode is "trunk" (in this case it should be possible to set VST-
@@ -7181,8 +7181,8 @@ function renderTrunkPortControls ($vswitch, $vdom, $port_name, $vlanport)
                        // they are shown among radio options, but disabled, so that the user cannot
                        // break traffic of these VLANs. In addition to that, when port's native VLAN
                        // is set to one of these alien VLANs, the whole group of radio buttons is
-                       // disabled. These measures make it harder for the system to break a VLAN,
-                       // which is explicitly protected from it.
+                       // disabled. These measures make it harder for the system to break a VLAN
+                       // that is explicitly protected from it.
                        if
                        (
                                $native_options[$vlanport['native']]['vlan_type'] == 'alien' or
@@ -7368,7 +7368,7 @@ function renderVLANIPLinks ($some_id)
                                'domain_id' => $vlan['domain_id'],
                                'vlan_id' => $vlan['vlan_id'],
                        );
-               // Any VLAN can link to any network, which isn't yet linked to current domain.
+               // Any VLAN can link to any network that isn't yet linked to current domain.
                // get free IP nets
                $netlist_func  = $ip_ver == 'ipv6' ? 'getVLANIPv6Options' : 'getVLANIPv4Options';
                foreach ($netlist_func ($vlan['domain_id']) as $net_id)
@@ -7700,14 +7700,14 @@ END
                        break;
                }
 
-               $ancor = '';
+               $anchor = '';
                $td_class = '';
                if (isset ($hl_port_name) and $hl_port_name == $port_name)
                {
-                       $ancor = "name='port-$hl_port_id'";
+                       $anchor = "name='port-$hl_port_id'";
                        $td_class = ' border_highlight';
                }
-               echo "<tr class='${trclass}'><td class='tdleft${td_class}' NOWRAP><a class='interactive-portname port-menu nolink' $ancor>${port_name}</a></td>";
+               echo "<tr class='${trclass}'><td class='tdleft${td_class}' NOWRAP><a class='interactive-portname port-menu nolink' $anchor>${port_name}</a></td>";
                if (!count ($radio_attrs))
                {
                        echo "<td class='tdleft${left_extra}'>${left_text}</td>";
@@ -8021,7 +8021,7 @@ function renderDiscoveredNeighbors ($object_id)
                                amplifyCell($dp_remote_object);
                                $dp_neighbor['port'] = shortenIfName ($dp_neighbor['port'], NULL, $dp_remote_object['id']);
 
-                               // get port list which names match CDP portname
+                               // get list of ports that have name matching CDP portname
                                $remote_ports = array(); // list of remote (by DP info) ports
                                foreach ($dp_remote_object['ports'] as $port)
                                        if ($port['name'] == $dp_neighbor['port'])
@@ -8272,13 +8272,13 @@ function formatAttributeValue ($record)
        return $result;
 }
 
-function addAutoScrollScript ($ancor_name)
+function addAutoScrollScript ($anchor_name)
 {
        addJS (<<<END
 $(document).ready(function() {
-       var ancor = document.getElementsByName('$ancor_name')[0];
-       if (ancor)
-               ancor.scrollIntoView(false);
+       var anchor = document.getElementsByName('$anchor_name')[0];
+       if (anchor)
+               anchor.scrollIntoView(false);
 });
 END
        , TRUE);
@@ -9196,7 +9196,7 @@ function renderDataIntegrityReport ()
                finishPortLet ();
        }
 
-       // check 4: relationships which violate ObjectParentCompat Rules
+       // check 4: relationships that violate ObjectParentCompat Rules
        $invalids = array ();
        $result = usePreparedSelectBlade
        (
@@ -9234,7 +9234,7 @@ function renderDataIntegrityReport ()
                finishPortLet ();
        }
 
-       // check 5: Links which violate PortCompat Rules
+       // check 5: Links that violate PortCompat Rules
        $invalids = array ();
        $result = usePreparedSelectBlade
        (
index 2d1e5ace92efddaffc3da3fd36a52d35435794d8..26d0c1eb590f70f044338c6e10909d9eda50dba7 100644 (file)
@@ -6,8 +6,8 @@
 
 /*
 
-"Ophandler" in RackTables stands for "operation handler", or a function,
-which handles execution of "operation" (in the meaning explained in
+"Ophandler" in RackTables stands for "operation handler", or a function
+that handles execution of "operation" (in the meaning explained in
 navigation.php). Most of the ophandlers are meant to perform one specific
 action, for example, to set a name of an object. Each such action often
 requires a set of parameters (e. g. ID of the object and the new name),
@@ -20,7 +20,7 @@ assorted classes. Namely, an "InvalidRequestArgException" class means, that
 at least one of the parameters provided by the user is not acceptable. This
 is a "soft" error, which gets displayed in the standard message area of
 otherwise usual interface. A different case is "InvalidArgException", which
-means, that one of the internal functions detected its argument(s) invalid
+means that one of the internal functions detected its argument(s) invalid
 or corrupted, and that argument(s) did not come from user's input (and thus
 cannot be fixed without fixing a bug in the code). Such "hard" errors don't
 get special early handling and end up in the default catching block. The
@@ -401,7 +401,7 @@ $opspec_list['chapter-edit-del'] = array
        (
                // Technically dict_key is enough to delete, but including chapter_id into
                // WHERE clause makes sure, that the action actually happends for the same
-               // chapter, which authorization was granted for.
+               // chapter that authorization was granted for.
                array ('url_argname' => 'chapter_no', 'table_colname' => 'chapter_id', 'assertion' => 'uint'),
                array ('url_argname' => 'dict_key', 'assertion' => 'uint'),
                array ('fix_argname' => 'dict_sticky', 'fix_argvalue' => 'no'), # protect system rows
@@ -1086,7 +1086,7 @@ function updateObjectAllocation ()
        $object_id = getBypassValue();
        $changecnt = 0;
        // Get a list of all of this object's parents,
-       // then trim the list to only include parents which are racks
+       // then trim the list to only include parents that are racks
        $parentRacks = array();
        foreach (getEntityRelatives('parents', 'object', $object_id, 'rack') as $parentData)
                $parentRacks[] = $parentData['entity_id'];
@@ -2902,7 +2902,7 @@ function resolve8021QConflicts ()
                                if ($port['decision'] == 'left')
                                        // confirm deletion of local copy
                                        $ndone += del8021QPort ($vswitch['object_id'], $port_name);
-                               // otherwise ignore a decision, which doesn't address a conflict
+                               // otherwise ignore a decision that doesn't address a conflict
                }
        }
        catch (InvalidRequestArgException $e)
@@ -2993,7 +2993,7 @@ function updVSTRule()
        }
        catch (Exception $e)
        {
-               // Every case, which is soft-processed in process.php, will have the working copy available for a retry.
+               // Every case that is soft-processed in process.php, will have the working copy available for a retry.
                if ($e instanceof InvalidRequestArgException or $e instanceof RTDatabaseError)
                {
                        @session_start();
@@ -3274,7 +3274,7 @@ function deleteVlan()
        assertStringArg ('vlan_ck');
        $confports = getVLANConfiguredPorts ($_REQUEST['vlan_ck']);
        if (! empty ($confports))
-               throw new RackTablesError ("You can not delete vlan which has assosiated ports");
+               throw new RackTablesError ("You can not delete VLAN that has assosiated ports");
        list ($vdom_id, $vlan_id) = decodeVLANCK ($_REQUEST['vlan_ck']);
        usePreparedDeleteBlade ('VLANDescription', array ('domain_id' => $vdom_id, 'vlan_id' => $vlan_id));
        showSuccess ("VLAN $vlan_id has been deleted");
@@ -3312,7 +3312,7 @@ function doVSMigrate()
        usePreparedDeleteBlade ('VSEnabledIPs', array ('vs_id' => $vs_id));
        usePreparedDeleteBlade ('VSEnabledPorts', array ('vs_id' => $vs_id));
 
-       // remove all VIPs and ports which are in $plan,and create new ones
+       // remove all VIPs and ports that are in $plan and create new ones
        foreach ($plan['vips'] as $vip)
        {
                usePreparedDeleteBlade ('VSIPs', array ('vs_id' => $vs_id, 'vip' => $vip['vip']));
index baf17465d86c498734259d5dcf3b316609e093d1..03b522132437176e17c71efaea383fc77ec4d9a6 100644 (file)
@@ -4,7 +4,7 @@
 # framework. See accompanying file "COPYING" for the full copyright and
 # licensing information.
 
-// Return a list of rack IDs, which are P or less positions
+// Return a list of rack IDs that are P or less positions
 // far from the given rack in its row.
 function getProximateRacks ($rack_id, $proximity = 0)
 {
@@ -175,7 +175,7 @@ INNER JOIN (
        return $ret;
 }
 
-// Return a list of all objects which are possible parents
+// Return a list of all objects that are possible parents
 //    Special case for VMs and VM Virtual Switches
 //        - only select Servers with the Hypervisor attribute set to Yes
 function findObjectParentCandidates ($object_id)
index b68fc17b1a81fa7dd10299eb96b7ba09c2faa6a1..c71e1caf023d04dc6379b906cd1e6b3503e6bd58 100644 (file)
@@ -370,7 +370,7 @@ function isVIPEnabled ($vip, $vip_list)
        return FALSE;
 }
 
-// returns list of ipv4vs ids which have one of the IPs or fwmarks of group $group_id
+// returns list of ipv4vs ids that have one of the IPs or fwmarks of group $group_id
 function getVSIDsByGroup ($group_id)
 {
        $ret = array();
@@ -637,7 +637,7 @@ function commitDeleteVSG ($id)
        usePreparedDeleteBlade ('VS', array ('id' => $id));
 }
 
-// returns an array of object_ids which have links to a given VS
+// returns an array of object_ids that have links to a given VS
 // may be used as 'refcnt'
 function getVSLinkedObjects ($vs_id)
 {
index 050db8b235109424a90636ab1646ecbf36752171..822bd55788aabe90408ac7104a383a50fe7e0237 100644 (file)
@@ -6,7 +6,7 @@
 
 /*
 
-The purpose of this file is to contain functions, which generate a complete
+The purpose of this file is to contain functions that generate a complete
 HTTP response body and are either "dead ends" or depend on just a small
 amount of other code (which should eventually be placed in a sort of
 "first order" library file).
index 06f48d108022ce437eb045c2fe423123d15dfbef..f414f4c5016a129158b591381315e880fe8b395f 100644 (file)
@@ -174,7 +174,7 @@ function trigger_ports ()
        return 'std';
 }
 
-// Offer the generic VLAN setup tab for every object, which already
+// Offer the generic VLAN setup tab for every object that already
 // has a VLAN domain associated or at least can have one (in the latter
 // case additionally heat the tab, if no domain is set.
 function trigger_object_8021qorder ()
index 93dc8faaf4a1fd8ee369d061996ce56e9061bce7..ab7aa41058bb2d31b1f6032728fe411f77b67045 100644 (file)
@@ -1376,6 +1376,8 @@ CREATE TABLE `VSEnabledPorts` (
                        $query[] = "ALTER TABLE `EntityLink` DROP KEY `EntityLink-compound`, ADD KEY `EntityLink-compound` (`child_entity_type`,`child_entity_id`,`parent_entity_type`)";
                        $query[] = "INSERT INTO `EntityLink` (`parent_entity_type`, `parent_entity_id`, `child_entity_type`, `child_entity_id`) SELECT `entity_type`, `entity_id`, 'file', `file_id` FROM `FileLink`";
                        $query[] = "DROP TABLE `FileLink`";
+                       $query[] = "UPDATE Config SET description = 'List source: objects for that asset tag should be set' WHERE varname = 'ASSETWARN_LISTSRC'";
+                       $query[] = "UPDATE Config SET description = 'List source: objects for that common name should be set' WHERE varname = 'NAMEWARN_LISTSRC'";
                        $query[] = "UPDATE Config SET varvalue = '0.20.7' WHERE varname = 'DB_VERSION'";
                        break;
                case 'dictionary':