diff --git a/libjsonparser.changes b/libjsonparser.changes
index f63aa84..d940947 100644
--- a/libjsonparser.changes
+++ b/libjsonparser.changes
@@ -1,3 +1,9 @@
+-------------------------------------------------------------------
+Sun Aug 30 08:10:55 UTC 2020 - Jan Engelhardt <jengelh@inai.de>
+
+- Update descriptions and mention feature set and
+  noticable problems.
+
 -------------------------------------------------------------------
 Sat Aug 29 14:05:17 UTC 2020 - Matthias Mailänder <mailaender@opensuse.org>
 
diff --git a/libjsonparser.spec b/libjsonparser.spec
index c103461..74cdaa0 100644
--- a/libjsonparser.spec
+++ b/libjsonparser.spec
@@ -19,7 +19,7 @@
 Name:           libjsonparser
 Version:        1.1.0
 Release:        0
-Summary:        JSON parser written in portable ANSI C
+Summary:        JSON parser written in ANSI C
 License:        BSD-2-Clause
 Group:          Development/Libraries/C and C++
 URL:            https://github.com/udp/json-parser
@@ -31,24 +31,29 @@ BuildRequires:  gcc
 BuildRequires:  pkgconfig
 
 %description
-Very low footprint JSON parser written in portable ANSI C
-that never recurses or allocates more memory than it needs
-and comes with no further dependencies.
+JSON parser written in ANSI C that never recurses.
+In C++ mode, it offers a number of decorators like a default constructor,
+begin()/end(), and implicit conversions.
 
 %package -n libjsonparser%{sover}
-Summary:        Shared library for %{name}
+Summary:        JSON parser written in ANSI C
 Group:          System/Libraries
 
 %description -n libjsonparser%{sover}
-Low footprint JSON parser written in portable ANSI C.
-Has a simple API with operator sugar for C++
+JSON parser written in ANSI C that never recurses.
+In C++ mode, it offers a number of decorators like a default constructor,
+begin()/end(), and implicit conversions.
 
 %package devel
-Summary:        Development files for json-parser
+Summary:        Development files for libjsonparser
 Requires:       libjsonparser%{sover} = %{version}
 
 %description devel
-Files needed to develop applications with Very low footprint JSON parser
+Files needed to develop applications with libjsonparser.
+
+This openSUSE build does not support the source line/column number
+tracking, and setting -DJSON_TRACK_SOURCE in libjsonparser-using
+projects will cause a silent ABI break.
 
 %prep
 %autosetup -n json-parser-%{version}