@@ -274,10 +274,10 @@ of the config that are repeated in different places.
274
274
Normalization
275
275
-------------
276
276
277
- When the config files are processed they are first normalized, they are then
278
- merged and then the tree is used to validate the resulting array. The normalization
279
- is to remove some of the differences that result from different configuration formats,
280
- mainly the differences between Yaml and XML.
277
+ When the config files are processed they are first normalized, then merged
278
+ and finally the tree is used to validate the resulting array. The normalization
279
+ process is used to remove some of the differences that result from different
280
+ configuration formats, mainly the differences between Yaml and XML.
281
281
282
282
The separator used in keys is typically ``_ `` in Yaml and ``- `` in XML. For
283
283
example, ``auto_connect `` in Yaml and ``auto-connect ``. The normalization would
@@ -323,8 +323,8 @@ a second argument::
323
323
->end()
324
324
;
325
325
326
- As well as fixing this it ensures that single xml elements are still turned into an array.
327
- So you may have:
326
+ As well as fixing this, `` fixXmlConfig `` ensures that single xml elements
327
+ are still turned into an array. So you may have:
328
328
329
329
.. code-block :: xml
330
330
@@ -341,7 +341,7 @@ By default ``connection`` would be an array in the first case and a string
341
341
in the second making it difficult to validate. You can ensure it is always
342
342
an array with with ``fixXmlConfig ``.
343
343
344
- You can further control the normalization process if you need to. For example
344
+ You can further control the normalization process if you need to. For example,
345
345
you may want to allow a string to be set and used as a particular key or several
346
346
keys to be set explicitly. So that, if everything apart from id is optional in this
347
347
config:
0 commit comments