From patchwork Sun Mar 1 16:29:40 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Hartmut Goebel X-Patchwork-Id: 20480 Return-Path: X-Original-To: patchwork@mira.cbaines.net Delivered-To: patchwork@mira.cbaines.net Received: by mira.cbaines.net (Postfix, from userid 113) id E55D927BBEA; Sun, 1 Mar 2020 16:30:18 +0000 (GMT) X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on mira.cbaines.net X-Spam-Level: X-Spam-Status: No, score=-2.9 required=5.0 tests=BAYES_00,MAILING_LIST_MULTI, URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.2 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mira.cbaines.net (Postfix) with ESMTP id 3F21B27BBE4 for ; Sun, 1 Mar 2020 16:30:18 +0000 (GMT) Received: from localhost ([::1]:49700 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j8RTo-0001Os-EK for patchwork@mira.cbaines.net; Sun, 01 Mar 2020 11:30:12 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:52427) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j8RTg-0001OW-KH for guix-patches@gnu.org; Sun, 01 Mar 2020 11:30:06 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1j8RTe-0005XV-It for guix-patches@gnu.org; Sun, 01 Mar 2020 11:30:04 -0500 Received: from debbugs.gnu.org ([209.51.188.43]:59146) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1j8RTe-0005XM-Fk for guix-patches@gnu.org; Sun, 01 Mar 2020 11:30:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1j8RTe-0007Cj-C5 for guix-patches@gnu.org; Sun, 01 Mar 2020 11:30:02 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#39856] [PATCH] gnu: Reword and extend descriptions for some KDE packages. Resent-From: Hartmut Goebel Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Sun, 01 Mar 2020 16:30:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 39856 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 39856@debbugs.gnu.org X-Debbugs-Original-To: guix-patches@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.158308019527651 (code B ref -1); Sun, 01 Mar 2020 16:30:02 +0000 Received: (at submit) by debbugs.gnu.org; 1 Mar 2020 16:29:55 +0000 Received: from localhost ([127.0.0.1]:36886 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1j8RTW-0007Bu-O0 for submit@debbugs.gnu.org; Sun, 01 Mar 2020 11:29:55 -0500 Received: from lists.gnu.org ([209.51.188.17]:45428) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1j8RTU-0007Bj-3l for submit@debbugs.gnu.org; Sun, 01 Mar 2020 11:29:53 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:52390) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j8RTR-0001Ks-SB for guix-patches@gnu.org; Sun, 01 Mar 2020 11:29:51 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1j8RTP-0005Oy-Ob for guix-patches@gnu.org; Sun, 01 Mar 2020 11:29:49 -0500 Received: from mail-out.m-online.net ([2001:a60:0:28:0:1:25:1]:55817) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1j8RTP-0005O1-FW for guix-patches@gnu.org; Sun, 01 Mar 2020 11:29:47 -0500 Received: from frontend01.mail.m-online.net (unknown [192.168.8.182]) by mail-out.m-online.net (Postfix) with ESMTP id 48Vpdj4BS7z1rGSM for ; Sun, 1 Mar 2020 17:29:45 +0100 (CET) Received: from localhost (dynscan1.mnet-online.de [192.168.6.70]) by mail.m-online.net (Postfix) with ESMTP id 48Vpdj3MmQz1qqyf for ; Sun, 1 Mar 2020 17:29:45 +0100 (CET) X-Virus-Scanned: amavisd-new at mnet-online.de Received: from mail.mnet-online.de ([192.168.8.182]) by localhost (dynscan1.mail.m-online.net [192.168.6.70]) (amavisd-new, port 10024) with ESMTP id hSx4PXn6ixWO for ; Sun, 1 Mar 2020 17:29:43 +0100 (CET) Received: from hermia.goebel-consult.de (ppp-188-174-55-76.dynamic.mnet-online.de [188.174.55.76]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.mnet-online.de (Postfix) with ESMTPS for ; Sun, 1 Mar 2020 17:29:43 +0100 (CET) Received: from thisbe.fritz.box (unknown [192.168.110.24]) by hermia.goebel-consult.de (Postfix) with ESMTP id 1136D6015D for ; Sun, 1 Mar 2020 17:31:56 +0100 (CET) From: Hartmut Goebel Date: Sun, 1 Mar 2020 17:29:40 +0100 Message-Id: <3b318dab904a53b3945346fb79a2a52188fb32ec.1583080156.git.h.goebel@crazy-compilers.com> X-Mailer: git-send-email 2.21.1 MIME-Version: 1.0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org Sender: "Guix-patches" X-getmail-retrieved-from-mailbox: Patches * gnu/packages/kde-multimedia.scm (libkcompatdisc)[description]: Extend. * gnu/packages/kde-pim.scm (akonadi-search, kalarmcal, kdemailimporter, kdepim-apps-libs, kidentitymanagement, kldap, kmailtransport, kmbox, kmime, kontactinterface, kpimtextedit)[description]: Reword and extend. (ktnef, kpimcommon, libkdepim)[synopsis, description]: Reword and extend. (kmailtransport)[synopsis]: Fix space. * gnu/packages/kde-systemtools.scm (khelpcenter)[description]: Extend. --- gnu/packages/kde-multimedia.scm | 4 ++- gnu/packages/kde-pim.scm | 53 +++++++++++++++++++++----------- gnu/packages/kde-systemtools.scm | 10 +++++- 3 files changed, 47 insertions(+), 20 deletions(-) diff --git a/gnu/packages/kde-multimedia.scm b/gnu/packages/kde-multimedia.scm index e87df550a9..4c1d5e7244 100644 --- a/gnu/packages/kde-multimedia.scm +++ b/gnu/packages/kde-multimedia.scm @@ -688,6 +688,8 @@ Its features include: ("solid" ,solid))) (home-page "https://cgit.kde.org/libkcompactdisc.git/") (synopsis "KDE library for playing & ripping CDs") - (description "KDE library for playing & ripping CDs.") + (description "The KDE Compact Disc library provides an API for +applications using the KDE Platform to interface with the CD drives for audio +CDs.") (license ;; GPL for programs, LGPL for libraries (list license:gpl2+ license:lgpl2.0+)))) diff --git a/gnu/packages/kde-pim.scm b/gnu/packages/kde-pim.scm index 9d48475a17..feee086cc5 100644 --- a/gnu/packages/kde-pim.scm +++ b/gnu/packages/kde-pim.scm @@ -329,8 +329,8 @@ wrapping notes into KMime::Message objects.") `(#:tests? #f)) ;; TODO: needs dbus (home-page "https://api.kde.org/stable/kdepimlibs-apidocs/akonadi/html/") (synopsis "Akonadi search library") - (description "Xapian-based indexing and query infrastructure for -Akonadi.") + (description "This package provides a library used to search in the +Akonadi PIM data server. It uses Xapian for indexing and querying.") (license ;; GPL for programs, LGPL for libraries (list license:gpl2+ license:lgpl2.0+)))) @@ -371,7 +371,8 @@ Akonadi.") `(#:tests? #f)) ;; TODO: TZ setup (home-page "https://api.kde.org/stable/kdepimlibs-apidocs/") (synopsis "Library for handling kalarm calendar data") - (description "This library provides an API for KAlarm alarms.") + (description "This library provides access to and handling of kalarm +calendar data.") (license license:lgpl2.0+))) (define-public kcalutils @@ -454,7 +455,8 @@ functions for accessing calendar data using the kcalcore API.") ("qtbase" ,qtbase))) (home-page "https://cgit.kde.org/kdepim-apps-libs.git") (synopsis "KDE PIM mail related libraries and data files") - (description "KDE PIM mail related libraries and data files.") + (description "This packages provides mail related libraries and data files +for KDE PIM.") (license ;; GPL for programs, LGPL for libraries (list license:gpl2+ license:lgpl2.0+)))) @@ -541,7 +543,7 @@ cryptography to the contents of the clipboard.") #t))))) (home-page "https://kontact.kde.org/") (synopsis "Library for shared identities between mail applications") - (description "Library for shared identities between mail applications.") + (description "This library provides an API for managing user identities.") (license ;; GPL for programs, LGPL for libraries, FDL for documentation (list license:gpl2+ license:lgpl2.0+ license:fdl1.2+)))) @@ -601,7 +603,9 @@ easier to do so.") ("openldap" ,openldap))) (home-page "https://api.kde.org/stable/kdepimlibs-apidocs/") (synopsis "Library for accessing LDAP") - (description "This library provides an API for LDAP.") + (description " This is a library for accessing LDAP with a convenient Qt +style C++ API. LDAP (Lightweight Directory Access Protocol) is an application +protocol for querying and modifying directory services running over TCP/IP. ") (license license:lgpl2.0+))) (define-public kleopatra @@ -694,7 +698,8 @@ and retrieving certificates from LDAP servers.") ("qtbase" ,qtbase))) (home-page "https://cgit.kde.org/mailimporter.git") (synopsis "KDE mail importer library") - (description "KDE mail importer library.") + (description "This package provides libraries for importing mails other +e-mail client programs into KMail and KDE PIM.") (license ;; GPL for programs, LGPL for libraries (list license:gpl2+ license:lgpl2.0+)))) @@ -736,7 +741,7 @@ and retrieving certificates from LDAP servers.") `(#:tests? #f)) ;; TODO - 3/3 tests fail, require drkonqi (home-page "https://api.kde.org/stable/kdepimlibs-apidocs/") (synopsis "Mail transport service library") - (description " This library provides an API and support code for managing + (description "This library provides an API and support code for managing mail transport.") (license license:lgpl2.0+))) @@ -760,7 +765,8 @@ mail transport.") ("qtbase" ,qtbase))) (home-page "https://api.kde.org/stable/kdepimlibs-apidocs/") (synopsis "Library for handling mbox mailboxes") - (description "A library for accessing mail storages in MBox format.") + (description "This is a library for handling mailboxes in mbox format, +using a Qt/KMime C++ API.") (license license:lgpl2.0+ ))) (define-public kmime @@ -794,7 +800,11 @@ mail transport.") #t))))) (home-page "https://api.kde.org/stable/kdepimlibs-apidocs/") (synopsis "Library for handling MIME data") - (description "A library for MIME handling.") + (description "This library provides an API for handling MIME +data. MIME (Multipurpose Internet Mail Extensions) is an Internet Standard +that extends the format of e-mail to support text in character sets other than +US-ASCII, non-text attachments, multi-part message bodies, and header +information in non-ASCII character sets.") (license license:lgpl2.0+))) (define-public kontactinterface @@ -821,7 +831,8 @@ mail transport.") ("qtbase" ,qtbase))) (home-page "https://api.kde.org/stable/kdepimlibs-apidocs/") (synopsis "Kontact interface library") - (description "Kontact Interface library.") + (description " This library provides the glue necessary for +application \"Parts\" to be embedded as a Kontact component (or plugin).") (license license:lgpl2.0+))) (define-public kpimcommon @@ -881,8 +892,8 @@ mail transport.") (arguments `(#:tests? #f)) ;; TODO tests hang (home-page "https://cgit.kde.org/pimcommon.git") - (synopsis "Common library for KDE PIM") - (description "Common library for KDE PIM.") + (synopsis "Common libraries for KDE PIM") + (description "This package provides common libraries for KDE PIM.") (license ;; GPL for programs, LGPL for libraries (list license:gpl2+ license:lgpl2.0+)))) @@ -922,7 +933,9 @@ mail transport.") `(#:tests? #f)) ;; TODO - test suite hangs (home-page "https://api.kde.org/stable/kdepimlibs-apidocs/") (synopsis "Library providing a textedit with PIM-specific features") - (description "A library for PIM-specific text editing utilities.") + (description "This package provides a textedit with PIM-specific features. +It also provides so-called rich text builders which can convert the formatted +text in the text edit to all kinds of markup, like HTML or BBCODE.") (license ;; GPL for programs, LGPL for libraries, FDL for documentation (list license:gpl2+ license:lgpl2.0+ license:fdl1.2+)))) @@ -990,8 +1003,12 @@ standard protocols for e-mail transmission.") ("ki18n" ,ki18n) ("qtbase" ,qtbase))) (home-page "https://api.kde.org/stable/kdepimlibs-apidocs/ktnef/html/") - (synopsis "Viewer for mail attachments using TNEF format") - (description "Viewer for mail attachments using TNEF format") + (synopsis "Library for handling mail attachments using TNEF format") + (description "Ktnef is a library for handling data in the TNEF +format (Transport Neutral Encapsulation Format, a proprietary format of e-mail +attachment used by Microsoft Outlook and Microsoft Exchange Server). The API +permits access to the actual attachments, the message properties (TNEF/MAPI), +and allows one to view/extract message formatted text in Rich Text Format.") (license license:lgpl2.0+))) (define-public libkdepim @@ -1037,8 +1054,8 @@ standard protocols for e-mail transmission.") ("kwidgetsaddons" ,kwidgetsaddons) ("qtbase" ,qtbase))) (home-page "https://cgit.kde.org/libkdepim.git") - (synopsis "Libraries for common kdepim apps") - (description "Libraries for common kdepim apps.") + (synopsis "Libraries for common KDE PIM apps") + (description "This package provided libraries for common KDE PIM apps.") (license ;; GPL for programs, LGPL for libraries (list license:gpl2+ license:lgpl2.0+)))) diff --git a/gnu/packages/kde-systemtools.scm b/gnu/packages/kde-systemtools.scm index 682a5f583c..5054b8adf8 100644 --- a/gnu/packages/kde-systemtools.scm +++ b/gnu/packages/kde-systemtools.scm @@ -161,7 +161,15 @@ Dolphin with the version control systems: Bzr, Git, Mercurial, Subversion.") `(#:tests? #f)) ;; 1/1 test fails (home-page "https://kde.org/applications/system/org.kde.Help") (synopsis "KDE documentation viewer") - (description "KDE documentation viewer") + (description "KHelpCenter uses meta data files which describe the +documentation available in the system. Each document is represented by a meta +data file and shown as an entry in the KHelpCenter navigation tree view. The +meta data contains information about title and short description of the +document, the location of the document and some more information like how to +search the document and translations of title and description. Document +hierarchy is represented as hierarchy of the meta data files. Directories are +also described by a meta data file which contains the same information as a +document meta data file.") (license license:gpl2+))) (define-public konsole