openapi3: fix deprecation comments (#1034)

Author: alexandear

.github/docs/openapi3.txt

@@ -128,13 +128,16 @@ func DefineNumberFormatValidator(name string, validator NumberFormatValidator)
     number format.
 
 func DefineStringFormat(name string, pattern string)
-    DefineStringFormat defines a regexp pattern for a given string
-    format Deprecated: Use openapi3.DefineStringFormatValidator(name,
+    DefineStringFormat defines a regexp pattern for a given string format
+
+    Deprecated: Use openapi3.DefineStringFormatValidator(name,
     NewRegexpFormatValidator(pattern)) instead.
 
 func DefineStringFormatCallback(name string, callback func(string) error)
-    DefineStringFormatCallback defines a callback function for a given
-    string format Deprecated: Use openapi3.DefineStringFormatValidator(name,
+    DefineStringFormatCallback defines a callback function for a given string
+    format
+
+    Deprecated: Use openapi3.DefineStringFormatValidator(name,
     NewCallbackValidator(fn)) instead.
 
 func DefineStringFormatValidator(name string, validator StringFormatValidator)

openapi3/schema_formats.go

@@ -131,12 +131,14 @@ func DefineIntegerFormatValidator(name string, validator IntegerFormatValidator)
 }
 
 // DefineStringFormat defines a regexp pattern for a given string format
+//
 // Deprecated: Use openapi3.DefineStringFormatValidator(name, NewRegexpFormatValidator(pattern)) instead.
 func DefineStringFormat(name string, pattern string) {
 	DefineStringFormatValidator(name, NewRegexpFormatValidator(pattern))
 }
 
 // DefineStringFormatCallback defines a callback function for a given string format
+//
 // Deprecated: Use openapi3.DefineStringFormatValidator(name, NewCallbackValidator(fn)) instead.
 func DefineStringFormatCallback(name string, callback func(string) error) {
 	DefineStringFormatValidator(name, NewCallbackValidator(callback))