Merge: Fix warnings in the JSON, SAX and SAXophoNit libraries and in the `neo_doxygen...

Fix all the warnings in the following directories:

* `/lib/json`
* `/lib/sax`
* `/lib/saxophonit`
* `/contrib/neo_doxygen`

Signed-off-by: Jean-Christophe Beaupré <jcbrinfo@users.noreply.github.com>

Pull-Request: #946
Reviewed-by: Jean Privat <jean@pryen.org>

diff --combined lib/json/dynamic.nit
index 2f73fea,578afb1..1ee3ce7
--- 1/lib/json/dynamic.nit
--- 2/lib/json/dynamic.nit
+++ b/lib/json/dynamic.nit
@@@ -14,16 -14,24 +14,24 @@@
  # See the License for the specific language governing permissions and
  # limitations under the License.
  
- # Dynamic interface to read Json strings.
+ # Dynamic interface to read JSON strings.
  #
  # `String::to_json_value` returns a `JsonValue` which can be queried
- # to get the underlying Json data. It can also be used as any Json types.
+ # to get the underlying JSON data.
  module dynamic
  
  import error
  private import static
  
+ # Wraps a JSON value.
+ #
+ # Offer methods to query the type, to dynamicaly cast the underlying value and
+ # to query elements (in case of a JSON object or a JSON array).
+ #
+ # Use `String::to_json_value` to get a `JsonValue` from a string.
  class JsonValue
+ 
+       # The wrapped JSON value.
        var value: nullable Object
  
        # Is this value null?
@@@ -74,8 -82,8 +82,8 @@@
        #
        # require: `self.is_numeric`
        #
 -      #     assert "1.234".to_json_value.to_numeric = 1.234
 -      #     assert "1234".to_json_value.to_numeric = 1234
 +      #     assert "1.234".to_json_value.to_numeric == 1.234
 +      #     assert "1234".to_json_value.to_numeric == 1234
        fun to_numeric: Numeric
        do
                if is_int then return to_i