doc: adjust to_timestamp()/to_date() wording

Discussion: https://postgr.es/m/20190706202425[email protected]

Author: Justin Pryzby

Backpatch-through: 12

diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index eeb3c46316a461be83e8c80dc1d71362c145c925..185a184daae67c7b29c980657058eaae72b5620f 100644 (file)
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -6420,20 +6420,20 @@ SELECT regexp_match('abc01234xyz', '(?:(.*?)(\d+)(.*)){1,1}');
       
       
        If FX is specified, a separator in the template string
-       matches exactly one character in input string.  Notice we don't insist the
-       input string character be the same as the template string separator.
+       matches exactly one character in the input string.  But note that the
+       input string character is not required to be the same as the separator from the template string.
        For example, to_timestamp('2000/JUN', 'FXYYYY MON')
        works, but to_timestamp('2000/JUN', 'FXYYYY  MON')
-       returns an error because the second template string space is consumed
-       by the letter J in the input string.
+       returns an error because the second space in the template string consumes
+       the letter J from the input string.
       
      
 
      
       
        A TZH template pattern can match a signed number.
-       Without the FX option, it can lead to ambiguity in
-       interpretation of the minus sign, which can also be interpreted as a separator.
+       Without the FX option, minus signs may be ambiguous,
+       and could be interpreted as a separator.
        This ambiguity is resolved as follows:  If the number of separators before
        TZH in the template string is less than the number of
        separators before the minus sign in the input string, the minus sign