unofficial mirror of guix-patches@gnu.org 
 help / color / mirror / code / Atom feed
* [bug#74329] [PATCH 0/2] Extensively lint descriptions and synopses.
@ 2024-11-12 20:36 Gabriel Wicki
       [not found] ` <handler.74329.B.173144383113227.ack@debbugs.gnu.org>
  0 siblings, 1 reply; 3+ messages in thread
From: Gabriel Wicki @ 2024-11-12 20:36 UTC (permalink / raw)
  To: 74329; +Cc: vagrant

Aloha

I've linted quite a bunch of descriptions and synopses after Vagrant asked
whether someone was up to that task[1] (:

So this is it.  Going through all the warnings I found quite a bunch of false
positives, or at least cases where the linting rules do not reflect the
status-quo.  I'll prepare a separate patch set for my suggestions in that
regard.

Thanks for merging and have a nice day,

gabber


[1] https://logs.guix.gnu.org/guix/2024-11-04.log#194454


Gabriel Wicki (1):
  gnu: Lint descriptions.

 gnu/packages/astronomy.scm        |   4 +-
 gnu/packages/audio.scm            |   8 +-
 gnu/packages/autotools.scm        |   6 +-
 gnu/packages/axoloti.scm          |  12 +--
 gnu/packages/bioconductor.scm     |  25 ++++---
 gnu/packages/bioinformatics.scm   |   4 +-
 gnu/packages/calendar.scm         |   2 +-
 gnu/packages/check.scm            |  10 +--
 gnu/packages/chez.scm             |  16 ++--
 gnu/packages/code.scm             |   2 +-
 gnu/packages/compression.scm      |   4 +-
 gnu/packages/connman.scm          |   2 +-
 gnu/packages/cran.scm             |  56 +++++++-------
 gnu/packages/crates-graphics.scm  |  15 ++--
 gnu/packages/crates-io.scm        |  16 ++--
 gnu/packages/crates-web.scm       |   2 +-
 gnu/packages/crypto.scm           |   9 +--
 gnu/packages/databases.scm        |   2 +-
 gnu/packages/display-managers.scm |   2 +-
 gnu/packages/docker.scm           |   2 +-
 gnu/packages/elm.scm              |   2 +-
 gnu/packages/emacs-xyz.scm        | 118 ++++++++++++++---------------
 gnu/packages/emulators.scm        |   2 +-
 gnu/packages/fonts.scm            |   4 +-
 gnu/packages/fpga.scm             |   4 +-
 gnu/packages/freedesktop.scm      |   2 +-
 gnu/packages/game-development.scm |   4 +-
 gnu/packages/games.scm            |   6 +-
 gnu/packages/geo.scm              |   2 +-
 gnu/packages/gnunet.scm           |  10 +--
 gnu/packages/golang-check.scm     |   2 +-
 gnu/packages/golang-web.scm       |   2 +-
 gnu/packages/golang-xyz.scm       |  10 +--
 gnu/packages/golang.scm           |   7 +-
 gnu/packages/guile.scm            |   4 +-
 gnu/packages/haskell-check.scm    |  34 ++++-----
 gnu/packages/haskell-web.scm      |   2 +-
 gnu/packages/haskell-xyz.scm      |  80 +++++++++++---------
 gnu/packages/ibus.scm             |   2 +-
 gnu/packages/image.scm            |   9 ++-
 gnu/packages/ipfs.scm             |   4 +-
 gnu/packages/java-xml.scm         |   6 +-
 gnu/packages/java.scm             |  41 +++++-----
 gnu/packages/kodi.scm             |   7 +-
 gnu/packages/linux.scm            |  23 +++---
 gnu/packages/lisp-xyz.scm         |  16 ++--
 gnu/packages/machine-learning.scm |  24 +++---
 gnu/packages/messaging.scm        |   2 +-
 gnu/packages/minetest.scm         |   2 +-
 gnu/packages/monitoring.scm       |   2 +-
 gnu/packages/music.scm            |  11 ++-
 gnu/packages/node-xyz.scm         |   4 +-
 gnu/packages/ocaml.scm            |   6 +-
 gnu/packages/opencl.scm           |   2 +-
 gnu/packages/perl-check.scm       |   6 +-
 gnu/packages/perl.scm             |  14 ++--
 gnu/packages/python-xyz.scm       |  12 +--
 gnu/packages/qt.scm               |   5 +-
 gnu/packages/radio.scm            |   4 +-
 gnu/packages/rocm.scm             |   6 +-
 gnu/packages/rust-apps.scm        |   2 +-
 gnu/packages/scanner.scm          |  16 ++--
 gnu/packages/search.scm           |   2 +-
 gnu/packages/security-token.scm   |   6 +-
 gnu/packages/shells.scm           |   2 +-
 gnu/packages/shellutils.scm       |   8 +-
 gnu/packages/ssh.scm              |   2 +-
 gnu/packages/statistics.scm       |  14 ++--
 gnu/packages/tcl.scm              |   6 +-
 gnu/packages/tex.scm              | 120 +++++++++++++++---------------
 gnu/packages/text-editors.scm     |   6 +-
 gnu/packages/textutils.scm        |   5 +-
 gnu/packages/tor.scm              |   2 +-
 gnu/packages/xdisorg.scm          |   8 +-
 gnu/packages/xfce.scm             |   4 +-
 gnu/packages/xml.scm              |   7 +-
 gnu/packages/xorg.scm             |   2 +-
 77 files changed, 462 insertions(+), 452 deletions(-)


base-commit: 33665c52c4670bc3b4d337c89ac9cc6c4c69b26f
prerequisite-patch-id: 301c84e45a417b3160d86c9701a87eed73104779
-- 
2.46.0





^ permalink raw reply	[flat|nested] 3+ messages in thread

* [bug#74329] [PATCH 1/2] gnu: Lint synopses.
       [not found] ` <handler.74329.B.173144383113227.ack@debbugs.gnu.org>
@ 2024-11-12 20:41   ` Gabriel Wicki
  2024-11-12 20:42   ` [bug#74329] [PATCH 2/2] gnu: Lint descriptions Gabriel Wicki
  1 sibling, 0 replies; 3+ messages in thread
From: Gabriel Wicki @ 2024-11-12 20:41 UTC (permalink / raw)
  To: 74329

From 33801b76330c4e83e06baafd0bc6fda452e7f09c Mon Sep 17 00:00:00 2001
Message-ID: <33801b76330c4e83e06baafd0bc6fda452e7f09c.1731443063.git.gabriel@erlikon.ch>
In-Reply-To: <cover.1731443063.git.gabriel@erlikon.ch>
References: <cover.1731443063.git.gabriel@erlikon.ch>
From: Gabriel Wicki <gabriel@erlikon.ch>
Date: Tue, 5 Nov 2024 23:23:50 +0100
Subject: [PATCH 1/2] gnu: Lint synopses.

Correct a bunch of synopses.

Change-Id: I69fb52cc783994673e2eaf92b936edc19ba92cfe
---
 gnu/packages/astronomy.scm          |  2 +-
 gnu/packages/base.scm               |  2 +-
 gnu/packages/bioconductor.scm       |  2 +-
 gnu/packages/bioinformatics.scm     |  4 +-
 gnu/packages/browser-extensions.scm |  4 +-
 gnu/packages/c.scm                  |  2 +-
 gnu/packages/cran.scm               |  2 +-
 gnu/packages/crates-crypto.scm      |  2 +-
 gnu/packages/crates-graphics.scm    |  2 +-
 gnu/packages/crates-io.scm          | 70 ++++++++++++++---------------
 gnu/packages/crates-web.scm         | 12 ++---
 gnu/packages/docbook.scm            |  2 +-
 gnu/packages/emacs-xyz.scm          | 28 ++++++------
 gnu/packages/emacs.scm              |  2 +-
 gnu/packages/finance.scm            |  2 +-
 gnu/packages/firmware.scm           |  2 +-
 gnu/packages/games.scm              |  4 +-
 gnu/packages/gawk.scm               |  2 +-
 gnu/packages/gnome.scm              |  3 +-
 gnu/packages/golang-check.scm       |  2 +-
 gnu/packages/golang-crypto.scm      |  5 +--
 gnu/packages/golang-web.scm         |  3 +-
 gnu/packages/golang-xyz.scm         |  2 +-
 gnu/packages/golang.scm             |  2 +-
 gnu/packages/gstreamer.scm          |  2 +-
 gnu/packages/haskell-apps.scm       |  2 +-
 gnu/packages/haskell-crypto.scm     |  2 +-
 gnu/packages/haskell-xyz.scm        | 39 ++++++++--------
 gnu/packages/heads.scm              |  2 +-
 gnu/packages/ipfs.scm               |  3 +-
 gnu/packages/irc.scm                |  2 +-
 gnu/packages/julia-jll.scm          | 16 +++----
 gnu/packages/kde-pim.scm            |  2 +-
 gnu/packages/kde-plasma.scm         |  2 +-
 gnu/packages/lesstif.scm            |  2 +-
 gnu/packages/linux.scm              |  4 +-
 gnu/packages/lisp-xyz.scm           |  6 +--
 gnu/packages/mail.scm               |  2 +-
 gnu/packages/messaging.scm          |  2 +-
 gnu/packages/ocaml.scm              |  2 +-
 gnu/packages/pascal.scm             |  2 +-
 gnu/packages/pdf.scm                |  2 +-
 gnu/packages/pure.scm               |  2 +-
 gnu/packages/python-compression.scm |  2 +-
 gnu/packages/python-science.scm     |  2 +-
 gnu/packages/python-web.scm         |  3 +-
 gnu/packages/python-xyz.scm         | 10 ++---
 gnu/packages/qt.scm                 |  2 +-
 gnu/packages/rpc.scm                |  2 +-
 gnu/packages/simulation.scm         |  2 +-
 gnu/packages/smalltalk.scm          |  2 +-
 gnu/packages/sugar.scm              |  2 +-
 gnu/packages/terminals.scm          |  2 +-
 gnu/packages/tex.scm                | 59 ++++++++++++------------
 gnu/packages/virtualization.scm     |  2 +-
 gnu/packages/vpn.scm                |  2 +-
 gnu/packages/web.scm                |  2 +-
 57 files changed, 175 insertions(+), 178 deletions(-)

diff --git a/gnu/packages/astronomy.scm b/gnu/packages/astronomy.scm
index 7d6fbd6aac..c022f2c7de 100644
--- a/gnu/packages/astronomy.scm
+++ b/gnu/packages/astronomy.scm
@@ -348,7 +348,7 @@ (define-public calcmysky-qt5
     (inputs
      (modify-inputs (package-inputs calcmysky)
        (replace "qtbase" qtbase-5)))
-    (synopsis "Qt5 build for the CalcMySky library.")))
+    (synopsis "Qt5 build for the CalcMySky library")))
 
 (define-public casacore
   (package
diff --git a/gnu/packages/base.scm b/gnu/packages/base.scm
index 4e8121ae2c..7af02319ce 100644
--- a/gnu/packages/base.scm
+++ b/gnu/packages/base.scm
@@ -108,7 +108,7 @@ (define-public hello
                (base32
                 "086vqwk2wl8zfs47sq2xpjc9k066ilmb8z6dn0q6ymwjzlm196cd"))))
     (build-system gnu-build-system)
-    (synopsis "Hello, GNU world: An example GNU package")
+    (synopsis "Example GNU package")
     (description
      "GNU Hello prints the message \"Hello, world!\" and then exits.  It
 serves as an example of standard GNU coding practices.  As such, it supports
diff --git a/gnu/packages/bioconductor.scm b/gnu/packages/bioconductor.scm
index f567e22a48..59a291300d 100644
--- a/gnu/packages/bioconductor.scm
+++ b/gnu/packages/bioconductor.scm
@@ -273,7 +273,7 @@ (define-public r-mpo-db
            (sha256
             (base32 "12rf5dpnjrpw55bgnbn68dni2g0p87nvs9c7mamqk0ayafs61zl0"))))))
     (home-page "https://github.com/YuLab-SMU/MPO.db")
-    (synopsis "set of annotation maps describing the Mouse Phenotype Ontology")
+    (synopsis "Set of annotation maps describing the Mouse Phenotype Ontology")
     (description
      "This is the human disease ontology R package HDO.db, which provides the
 semantic relationship between human diseases.  Relying on the DOSE and
diff --git a/gnu/packages/bioinformatics.scm b/gnu/packages/bioinformatics.scm
index 748b1901b6..a88b1e2077 100644
--- a/gnu/packages/bioinformatics.scm
+++ b/gnu/packages/bioinformatics.scm
@@ -16059,7 +16059,7 @@ (define-public python-mgatk
     (native-inputs
      (list python-pytest))
     (home-page "https://github.com/caleblareau/mgatk")
-    (synopsis "Mitochondrial genome analysis toolkit.")
+    (synopsis "Mitochondrial genome analysis toolkit")
     (description "This package is a Python-based command line interface for
 processing .bam files with mitochondrial reads and generating high-quality
 heteroplasmy estimation from sequencing data.  The mgatk package places a
@@ -19876,7 +19876,7 @@ (define-public vembrane
     (native-inputs
      (list poetry python-pytest))
     (home-page "https://github.com/vembrane/vembrane")
-    (synopsis "Filter VCF/BCF files with Python expressions.")
+    (synopsis "Filter VCF/BCF files with Python expressions")
     (description "Vembrane simultaneously filters variants based on
 any INFO or FORMAT field, CHROM, POS, ID, REF, ALT, QUAL, FILTER, and the
 annotation field ANN.  When filtering based on ANN, annotation entries are
diff --git a/gnu/packages/browser-extensions.scm b/gnu/packages/browser-extensions.scm
index 50b7674215..47505eb3c8 100644
--- a/gnu/packages/browser-extensions.scm
+++ b/gnu/packages/browser-extensions.scm
@@ -214,7 +214,7 @@ (define passff
            (lambda _
              (substitute* "src/manifest.json"
                (("_VERSIONHOLDER_") ,version)))))))
-    (synopsis "zx2c4 pass management extension for Mozilla Firefox")
+    (synopsis "Pass management extension for Mozilla Firefox")
     (description "This extension will allow you to access your zx2c4 pass
 repository directly from your web browser.  You can choose to automatically
 fill and submit login forms if a matching password entry is found.")
@@ -270,7 +270,7 @@ (define noscript
     (arguments
      `(#:install-plan '(("." ,(assq-ref properties 'addon-id)))))
     (home-page "https://noscript.net")
-    (synopsis "Software providing extra protection for various browsers.")
+    (synopsis "Software providing extra protection for various browsers")
     (description "The NoScript Security Suite is a software providing extra
 protection for web browsers.")
     (license license:gpl3+)))
diff --git a/gnu/packages/c.scm b/gnu/packages/c.scm
index 13fdb99424..07df24d4e1 100644
--- a/gnu/packages/c.scm
+++ b/gnu/packages/c.scm
@@ -1376,7 +1376,7 @@ (define-public orangeduck-mpc
                                  " "))))
                           (delete 'configure))))
       (home-page "https://github.com/orangeduck/mpc")
-      (synopsis "Parser Combinator library for C ")
+      (synopsis "Parser Combinator library for C")
       (description "@code{mpc} is a lightweight Parser Combinator library for C.
 @code{mpc} can help with tasks such as:
 @itemize
diff --git a/gnu/packages/cran.scm b/gnu/packages/cran.scm
index 0593288818..c93df13675 100644
--- a/gnu/packages/cran.scm
+++ b/gnu/packages/cran.scm
@@ -6359,7 +6359,7 @@ (define-public r-d3r
             (base32
              "1m4i3kqzkz7w06sp9zqcy9f88xpdhi7cqih3phdrf4yjmfk1pfjg"))))))
     (home-page "https://github.com/timelyportfolio/d3r")
-    (synopsis "d3.js utilities for R")
+    (synopsis "Data visualization utilities for R")
     (description
      "This package provides a suite of functions to help ease the use of the
 d3.js visualization library in R.  These helpers include
diff --git a/gnu/packages/crates-crypto.scm b/gnu/packages/crates-crypto.scm
index 422edfbc1d..e5d5a17002 100644
--- a/gnu/packages/crates-crypto.scm
+++ b/gnu/packages/crates-crypto.scm
@@ -1924,7 +1924,7 @@ (define-public rust-curve25519-dalek-derive-0.1
                        ("rust-quote" ,rust-quote-1)
                        ("rust-syn" ,rust-syn-2))))
     (home-page "https://doc.dalek.rs/curve25519_dalek")
-    (synopsis "curve25519-dalek Derives")
+    (synopsis "Derives of curve25519-dalek")
     (description "This package provides curve25519-dalek Derives.")
     (license (list license:expat license:asl2.0))))
 
diff --git a/gnu/packages/crates-graphics.scm b/gnu/packages/crates-graphics.scm
index 0c1b944736..42ba239bf5 100644
--- a/gnu/packages/crates-graphics.scm
+++ b/gnu/packages/crates-graphics.scm
@@ -5746,7 +5746,7 @@ (define-public rust-x11-clipboard-0.8
                (system (string-append xvfb " " display " &"))))))))
     (native-inputs (list xorg-server-for-tests))
     (home-page "https://github.com/quininer/x11-clipboard")
-    (synopsis "x11 clipboard support for Rust")
+    (synopsis "X11 clipboard support for Rust")
     (description "This package provides x11 clipboard support for Rust.")
     (license license:expat)))
 
diff --git a/gnu/packages/crates-io.scm b/gnu/packages/crates-io.scm
index c08ccd29fd..654667359d 100644
--- a/gnu/packages/crates-io.scm
+++ b/gnu/packages/crates-io.scm
@@ -297,7 +297,7 @@ (define-public rust-abi-stable-derive-0.11
        #:cargo-development-inputs
        (("rust-as-derive-utils" ,rust-as-derive-utils-0.11))))
     (home-page "https://github.com/rodrimati1992/abi_stable_crates/")
-    (synopsis "Implementation detail of abi_stable.")
+    (synopsis "Implementation detail of abi_stable")
     (description "This package contains an implementation detail of abi_stable.")
     (license (list license:expat license:asl2.0))))
 
@@ -1975,7 +1975,7 @@ (define-public rust-anstyle-lossy-1
     (arguments
      `(#:cargo-inputs (("rust-anstyle" ,rust-anstyle-1))))
     (home-page "https://github.com/rust-cli/anstyle")
-    (synopsis "conversion between ANSI color codes")
+    (synopsis "Conversion between ANSI color codes")
     (description "Lossy conversion between ANSI Color Codes.")
     (license (list license:expat license:asl2.0))))
 
@@ -2080,7 +2080,7 @@ (define-public rust-anstyle-stream-0.2
         ("rust-proptest" ,rust-proptest-1)
         ("rust-strip-ansi-escapes" ,rust-strip-ansi-escapes-0.1))))
     (home-page "https://github.com/rust-cli/anstyle")
-    (synopsis "Library for writing colored text to a terminal.")
+    (synopsis "Library for writing colored text to a terminal")
     (description "This package provides a simple cross platform library for
 writing colored text to a terminal.")
     (license (list license:expat license:asl2.0))))
@@ -4614,7 +4614,7 @@ (define-public rust-assert2-0.3
                        ("rust-is-terminal" ,rust-is-terminal-0.4)
                        ("rust-yansi" ,rust-yansi-0.5))))
     (home-page "https://github.com/de-vri-es/assert2-rs")
-    (synopsis "assert!(...) and check!(...) macros inspired by Catch2")
+    (synopsis "Macros inspired by Catch2")
     (description "This package provides assert!(...) and check!(...) macros
 inspired by Catch2.")
     (license license:bsd-2)))
@@ -6599,7 +6599,7 @@ (define-public rust-backtrace-ext-0.2
        #:cargo-development-inputs (("rust-miette" ,rust-miette-5)
                                    ("rust-thiserror" ,rust-thiserror-1))))
     (home-page "https://github.com/gankra/backtrace-ext")
-    (synopsis "conveniences on top of the backtrace crate")
+    (synopsis "Conveniences on top of the backtrace crate")
     (description
      "This package provides minor conveniences on top of the backtrace crate.")
     (license (list license:expat license:asl2.0))))
@@ -11149,7 +11149,7 @@ (define-public rust-carapace-spec-clap-0.1
         ("rust-serde-yaml" ,rust-serde-yaml-0.9))
        #:cargo-development-inputs (("rust-snapbox" ,rust-snapbox-0.4))))
     (home-page "https://github.com/rsteube/carapace-spec-clap")
-    (synopsis "spec generation for clap-rs/clap")
+    (synopsis "Spec generation for clap-rs/clap")
     (description "This package provides spec generation for clap-rs/clap.")
     (license license:expat)))
 
@@ -12631,7 +12631,7 @@ (define-public rust-circular-0.3
         (base32 "1slb0zd1xj0fjd0ql86zs57l1xbn5ywsyj1d8397bcvc1yg27z5h"))))
     (build-system cargo-build-system)
     (home-page "https://github.com/sozu-proxy/circular")
-    (synopsis "stream abstraction for nom")
+    (synopsis "Stream abstraction for nom")
     (description
      "This package provides a stream abstraction designed for use with nom.")
     (license license:expat)))
@@ -15635,7 +15635,7 @@ (define-public rust-const-sha1-0.2
     (build-system cargo-build-system)
     (arguments `(#:skip-build? #t))
     (home-page "https://github.com/rylev/const-sha1")
-    (synopsis "sha1 implementation for use in const contexts")
+    (synopsis "SHA1 implementation for use in const contexts")
     (description
      "This package provides a sha1 implementation for use in const contexts.")
     (license (list license:asl2.0 license:expat))))
@@ -16651,7 +16651,7 @@ (define-public rust-cpuid-bool-0.2
      ;; error: This crate works only on x86 and x86-64 targets.
      (list #:skip-build? (not (target-x86?))))
     (home-page "https://github.com/RustCrypto/utils/tree/master/cpufeatures")
-    (synopsis "replaced by the `cpufeatures` crate")
+    (synopsis "Replaced by the `cpufeatures` crate")
     (description "This package has been replaced by the `cpufeatures` crate.")
     (license (list license:expat license:asl2.0))))
 
@@ -18486,7 +18486,7 @@ (define-public rust-ctor-0.2
        #:cargo-development-inputs
        (("rust-libc-print" ,rust-libc-print-0.1))))
     (home-page "https://github.com/mmastrac/rust-ctor")
-    (synopsis "__attribute__((constructor)) for Rust")
+    (synopsis "Rust's __attribute__((constructor))")
     (description
      "This package provides an @code{__attribute__((constructor))} for Rust.")
     (license (list license:asl2.0 license:expat))))
@@ -23901,7 +23901,7 @@ (define-public rust-enum-iterator-1
      `(#:cargo-inputs (("rust-enum-iterator-derive" ,rust-enum-iterator-derive-1))))
     (home-page "https://github.com/stephaneyfx/enum-iterator")
     (synopsis
-     "Tools to iterate over all values of a type (e.g. all variants of an
+     "Iterate over all values of a type (e.g. all variants of an
 enumeration)")
     (description
      "This package provides tools to iterate over all values of a
@@ -32945,7 +32945,7 @@ (define-public rust-hyprland-0.3
         ("rust-strum" ,rust-strum-0.25)
         ("rust-tokio" ,rust-tokio-1))))
     (home-page "https://github.com/hyprland-community/hyprland-rs")
-    (synopsis "An unofficial rust wrapper for Hyprland's IPC")
+    (synopsis "Unofficial rust wrapper for Hyprland's IPC")
     (description
      "This package provides a unoffical rust wrapper for hyprland's IPC.")
     (license license:gpl3+)))
@@ -35273,8 +35273,8 @@ (define-public rust-is-debug-1
     (build-system cargo-build-system)
     (arguments `(#:skip-build? #t))
     (home-page "https://github.com/baoyachi/rust_is_debug")
-    (synopsis "get build model is debug")
     (description "get build model is debug")
+    (synopsis "Get build model is debug")
     (license (list license:expat license:asl2.0))))
 
 (define-public rust-is-docker-0.2
@@ -36790,7 +36790,7 @@ (define-public rust-kqueue-1
        #:cargo-development-inputs
        (("rust-tempfile" ,rust-tempfile-3))))
     (home-page "https://gitlab.com/worr/rust-kqueue")
-    (synopsis "kqueue interface for BSDs")
+    (synopsis "BSDs kqueue interface")
     (description "This package provides a kqueue interface for BSDs.")
     (license license:expat)))
 
@@ -53560,7 +53560,7 @@ (define-public rust-pico-args-0.5
         (base32 "05d30pvxd6zlnkg2i3ilr5a70v3f3z2in18m67z25vinmykngqav"))))
     (build-system cargo-build-system)
     (home-page "https://github.com/RazrFalcon/pico-args")
-    (synopsis "CLI arguments parser.")
+    (synopsis "CLI arguments parser")
     (description "This package provides an ultra simple CLI arguments parser.")
     (license license:expat)))
 
@@ -54318,7 +54318,7 @@ (define-public rust-pnet-base-0.34
                        ("rust-serde" ,rust-serde-1))
        #:cargo-development-inputs (("rust-serde-test" ,rust-serde-test-1))))
     (home-page "https://github.com/libpnet/libpnet")
-    (synopsis "Fundamental base types and code used by pnet.")
+    (synopsis "Fundamental base types and code used by pnet")
     (description
      "This crate implements fundamental base types and code used by pnet.")
     (license (list license:expat license:asl2.0))))
@@ -55511,7 +55511,7 @@ (define-public rust-postcard-1
                        ("rust-postcard-derive" ,rust-postcard-derive-0.1)
                        ("rust-serde" ,rust-serde-1))))
     (home-page "https://github.com/jamesmunns/postcard")
-    (synopsis "A no_std + serde compatible message library for Rust")
+    (synopsis "Rust message library compatible with no_std and serde")
     (description
      "This package provides a no_std + serde compatible message library for Rust.")
     (license (list license:expat license:asl2.0))))
@@ -57175,7 +57175,7 @@ (define-public rust-profiling-procmacros-1
      `(#:cargo-inputs (("rust-quote" ,rust-quote-1)
                        ("rust-syn" ,rust-syn-2))))
     (home-page "https://github.com/aclysma/profiling")
-    (synopsis "Abstraction over other profiler crates.")
+    (synopsis "Abstraction over other profiler crates")
     (description
      "This crate provides a very thin abstraction over other profiler crates.")
     (license (list license:expat license:asl2.0))))
@@ -59317,7 +59317,7 @@ (define-public rust-pyproject-toml-0.8
                        ("rust-serde" ,rust-serde-1)
                        ("rust-toml" ,rust-toml-0.8))))
     (home-page "https://github.com/PyO3/pyproject-toml-rs.git")
-    (synopsis "pyproject.toml parser in Rust")
+    (synopsis "Rust parser for pyproject.toml")
     (description "This package provides a pyproject.toml parser in Rust.")
     (license license:expat)))
 
@@ -60391,7 +60391,7 @@ (define-public rust-railroad-0.2
        (("rust-lazy-static" ,rust-lazy-static-1)
         ("rust-railroad-verification" ,rust-railroad-verification-0.1))))
     (home-page "https://github.com/lukaslueg/railroad")
-    (synopsis "library to create syntax-diagrams as Scalable Vector Graphics")
+    (synopsis "Library to create syntax-diagrams as Scalable Vector Graphics")
     (description
      "This package provides a library to create syntax-diagrams as Scalable
 Vector Graphics.")
@@ -64178,7 +64178,7 @@ (define-public rust-rstest-macros-0.18
         ("rust-rstest-reuse" ,rust-rstest-reuse-0.6)
         ("rust-rstest-test" ,rust-rstest-test-0.11))))
     (home-page "https://github.com/la10736/rstest")
-    (synopsis "Procedural macros for @code{rstest}.")
+    (synopsis "Procedural macros for @code{rstest}")
     (description
      "This package provides the procedural macro crate for @code{rstest}.")
     (license (list license:expat license:asl2.0))))
@@ -65948,7 +65948,7 @@ (define-public rust-rustdoc-json-0.8
                                    ("rust-tempfile" ,rust-tempfile-3))))
     (home-page
      "https://github.com/Enselic/cargo-public-api/tree/main/rustdoc-json")
-    (synopsis "Utilities for working with rustdoc JSON.")
+    (synopsis "Utilities for working with rustdoc JSON")
     (description "Utilities for working with rustdoc JSON.")
     (license license:expat)))
 
@@ -68979,7 +68979,7 @@ (define-public rust-serde-big-array-0.5
        #:cargo-development-inputs (("rust-serde-derive" ,rust-serde-derive-1)
                                    ("rust-serde-json" ,rust-serde-json-1))))
     (home-page "https://github.com/est31/serde-big-array")
-    (synopsis "Big array helper for serde.")
+    (synopsis "Big array helper for serde")
     (description "Big array helper for serde.")
     (license (list license:expat license:asl2.0))))
 
@@ -75264,7 +75264,7 @@ (define-public rust-structmeta-0.2
                        ("rust-syn" ,rust-syn-2))
        #:cargo-development-inputs (("rust-syn" ,rust-syn-2))))
     (home-page "https://github.com/frozenlib/structmeta")
-    (synopsis "Parse Rust's attribute arguments by defining a struct.")
+    (synopsis "Parse Rust's attribute arguments by defining a struct")
     (description "This package lets you parse Rust's attribute arguments by
 defining a struct.")
     (license (list license:expat license:asl2.0))))
@@ -75868,7 +75868,7 @@ (define-public rust-subplotlib-derive-0.7
         ("rust-quote" ,rust-quote-1)
         ("rust-syn" ,rust-syn-2))))
     (home-page "https://subplot.tech/")
-    (synopsis "macros for constructing subplotlib based test suites")
+    (synopsis "Macros for constructing subplotlib based test suites")
     (description
      "This package provides macros for constructing subplotlib based test
 suites, typically generated by @code{subplot codegen}.")
@@ -76276,7 +76276,7 @@ (define-public rust-sval-ref-2
      `(#:cargo-inputs (("rust-sval" ,rust-sval-2))
        #:cargo-development-inputs (("rust-sval-test" ,rust-sval-test-2))))
     (home-page "https://github.com/sval-rs/sval")
-    (synopsis "A variant of sval::Value for types with internal references")
+    (synopsis "Variant of sval::Value for types with internal references")
     (description
      "This package provides a variant of sval::Value for types with internal
 references")
@@ -80448,7 +80448,7 @@ (define-public rust-thiserror-1
         ("rust-rustversion" ,rust-rustversion-1)
         ("rust-trybuild" ,rust-trybuild-1))))
     (home-page "https://github.com/dtolnay/thiserror")
-    (synopsis "derive(Error)")
+    (synopsis "Provides @code{derive(Error)}")
     (description "This package provides @code{derive(Error)} in Rust.")
     (license (list license:expat license:asl2.0))))
 
@@ -80472,7 +80472,7 @@ (define-public rust-thiserror-core-1
                                    ("rust-rustversion" ,rust-rustversion-1)
                                    ("rust-trybuild" ,rust-trybuild-1))))
     (home-page "https://github.com/FlorianUekermann/thiserror")
-    (synopsis "derive(Error)")
+    (synopsis "Provides @code{derive(Error)}")
     (description "This package provides @code{derive(Error)} in Rust.")
     (license (list license:expat license:asl2.0))))
 
@@ -80535,7 +80535,7 @@ (define-public rust-thousands-0.2
     (arguments
      `(#:skip-build? #t))
     (home-page "https://github.com/tov/thousands-rs")
-    (synopsis "Adds digit separators to numerals, configurably.")
+    (synopsis "Adds digit separators to numerals, configurably")
     (description "This package provides thousand separators for numerals.")
     (license (list license:expat license:asl2.0))))
 
@@ -83326,7 +83326,7 @@ (define-public rust-tokio-uring-0.4
                                    ("rust-tokio" ,rust-tokio-1)
                                    ("rust-tokio-test" ,rust-tokio-test-0.4))))
     (home-page "https://tokio.rs")
-    (synopsis "io-uring support for the Tokio asynchronous runtime")
+    (synopsis "Tokio asynchronous runtime io-uring support")
     (description
      "This package provides io-uring support for the Tokio asynchronous runtime.")
     (license license:expat)))
@@ -85781,7 +85781,7 @@ (define-public rust-ubyte-0.10
        #:cargo-development-inputs (("rust-serde-json" ,rust-serde-json-1)
                                    ("rust-serde-test" ,rust-serde-test-1))))
     (home-page "https://github.com/SergioBenitez/ubyte")
-    (synopsis "no_std library for byte units")
+    (synopsis "Byte units no_std library")
     (description
      "This package provides a simple, complete, const-everything, saturating,
 human-friendly, no_std library for byte units.")
@@ -85875,7 +85875,7 @@ (define-public rust-udev-0.7
                        ("rust-mio" ,rust-mio-0.8)
                        ("rust-pkg-config" ,rust-pkg-config-0.3))))
     (home-page "https://github.com/Smithay/udev-rs")
-    (synopsis "libudev bindings for Rust")
+    (synopsis "Rust libudev bindings")
     (description "This package provides libudev bindings for Rust.")
     (license license:expat)))
 
@@ -85939,7 +85939,7 @@ (define-public rust-ufmt-macros-0.3
                        ("rust-quote" ,rust-quote-1)
                        ("rust-syn" ,rust-syn-1))))
     (home-page "https://github.com/japaric/ufmt")
-    (synopsis "μfmt macros")
+    (synopsis "Rust μfmt macros")
     (description "This package provides μfmt macros.")
     (license (list license:expat license:asl2.0))))
 
@@ -85977,7 +85977,7 @@ (define-public rust-ufmt-write-0.1
          "0sdx0r6ah9xr3nydrqxj01v25sb956c0jk5rqf6f5i9fnkb2wyp8"))))
     (build-system cargo-build-system)
     (home-page "https://github.com/japaric/ufmt")
-    (synopsis "μfmt's uWrite trait")
+    (synopsis "Rust μfmt's uWrite trait")
     (description "This package provides @code{μfmt}'s @code{uWrite} trait.")
     (license (list license:expat license:asl2.0))))
 
@@ -87231,7 +87231,7 @@ (define-public rust-urlencoding-2
         (base32 "1nj99jp37k47n0hvaz5fvz7z6jd0sb4ppvfy3nphr1zbnyixpy6s"))))
     (build-system cargo-build-system)
     (home-page "https://lib.rs/urlencoding")
-    (synopsis "A Rust library for doing URL percentage encoding.")
+    (synopsis "Rust library for doing URL percentage encoding")
     (description
      "This package provides a Rust library for doing URL percentage encoding.")
     (license license:expat)))
diff --git a/gnu/packages/crates-web.scm b/gnu/packages/crates-web.scm
index ee32c99374..6b1e6928e1 100644
--- a/gnu/packages/crates-web.scm
+++ b/gnu/packages/crates-web.scm
@@ -3724,7 +3724,7 @@ (define-public rust-hyper-native-tls-0.3
         ("rust-hyper" ,rust-hyper-0.10)
         ("rust-native-tls" ,rust-native-tls-0.2))))
     (home-page "https://github.com/sfackler/hyper-native-tls")
-    (synopsis "native-tls support for Hyper 0.10")
+    (synopsis "Hyper 0.10 native-tls support")
     (description "This package provides native-tls support for Hyper 0.10.")
     (license (list license:expat license:asl2.0))))
 
@@ -5579,7 +5579,7 @@ (define-public rust-tonic-0.10
         ("rust-tokio" ,rust-tokio-1)
         ("rust-tower" ,rust-tower-0.4))))
     (home-page "https://github.com/hyperium/tonic")
-    (synopsis "gRPC over HTTP/2 implementation for Rust")
+    (synopsis "Rust implementation of gRPC over HTTP/2")
     (description
      "This package provides a @code{gRPC} over HTTP/2 implementation focused
 on high performance, interoperability, and flexibility.")
@@ -6227,7 +6227,7 @@ (define-public rust-trust-dns-native-tls-0.20
         ("rust-tokio-native-tls" ,rust-tokio-native-tls-0.3)
         ("rust-trust-dns-proto" ,rust-trust-dns-proto-0.20))))
     (home-page "https://www.trust-dns.org/index.html")
-    (synopsis "native-tls extension for the Trust-DNS client")
+    (synopsis "Trust-DNS client native-tls extension")
     (description "Trust-DNS is a safe and secure DNS library.  This is an
 extension for the Trust-DNS client to use native-tls for TLS.")
     (license (list license:expat license:asl2.0))))
@@ -6331,7 +6331,7 @@ (define-public rust-trust-dns-openssl-0.20
         ("rust-tokio-openssl" ,rust-tokio-openssl-0.6)
         ("rust-trust-dns-proto" ,rust-trust-dns-proto-0.20))))
     (home-page "https://www.trust-dns.org/index.html")
-    (synopsis "tokio-openssl extension for the Trust-DNS client")
+    (synopsis "Trust-DNS client tokio-openssl extension")
     (description "Trust-DNS is a safe and secure DNS library.  This is an
 extension for the Trust-DNS client to use tokio-openssl for TLS.")
     (license (list license:expat license:asl2.0))))
@@ -6956,7 +6956,7 @@ (define-public rust-trust-dns-rustls-0.20
         ("rust-trust-dns-proto" ,rust-trust-dns-proto-0.20)
         ("rust-webpki" ,rust-webpki-0.21))))
     (home-page "https://www.trust-dns.org/index.html")
-    (synopsis "rustls extension for the Trust-DNS client")
+    (synopsis "Trust-DNS client rustls extension")
     (description
      "Trust-DNS is a safe and secure DNS library.  This is an extension for
 the Trust-DNS client to use rustls for TLS.")
@@ -7807,7 +7807,7 @@ (define-public rust-wiremock-0.5
     (native-inputs (list pkg-config))
     (inputs (list curl openssl zlib))
     (home-page "https://github.com/LukeMathWalker/wiremock-rs")
-    (synopsis "HTTP mocking to test Rust applications.")
+    (synopsis "HTTP mocking to test Rust applications")
     (description "This package provides HTTP mocking to test Rust
 applications.")
     (license (list license:expat license:asl2.0))))
diff --git a/gnu/packages/docbook.scm b/gnu/packages/docbook.scm
index 02cea45e97..990e0a38fd 100644
--- a/gnu/packages/docbook.scm
+++ b/gnu/packages/docbook.scm
@@ -334,7 +334,7 @@ (define-public docbook-mathml-1.0
      (list docbook-xml-4.1.2))
     (home-page
      "https://www.oasis-open.org/docbook/xml/mathml/1.0/index.1.shtml")
-    (synopsis "MathML support for DocBook XML V4.1.2.")
+    (synopsis "MathML support for DocBook XML V4.1.2")
     (description "The DocBook MathML Module is an extension to DocBook XML
 V4.1.2 that adds support for MathML in equation markup.")
     (license (license:non-copyleft "" "See file headers."))))
diff --git a/gnu/packages/emacs-xyz.scm b/gnu/packages/emacs-xyz.scm
index 59c804066a..620363fd31 100644
--- a/gnu/packages/emacs-xyz.scm
+++ b/gnu/packages/emacs-xyz.scm
@@ -312,7 +312,7 @@ (define-public emacs-0x0
       (build-system emacs-build-system)
       (home-page "https://git.sr.ht/~willvaughn/emacs-0x0")
       (synopsis
-       "Integration with @url{https://0x0.st, 0x0.st} and self-hosted services
+       "Integration with @url{https://0x0.st} and self-hosted services
 from Emacs")
       (description
        "Emacs 0x0 is a pastebin integration tool.  It can upload the current
@@ -2424,7 +2424,7 @@ (define-public emacs-speed-type
                  (string-append all " (skip-unless nil)"))))))))
     (propagated-inputs (list emacs-compat))
     (home-page "https://github.com/dakra/speed-type")
-    (synopsis "Practice touch/speed typing in GNU Emacs.")
+    (synopsis "Practice touch/speed typing in GNU Emacs")
     (description
      "Speed Type allows you to practice your touch typing skills.  You can
 test yourself by typing snippets from online books or use any piece of text or
@@ -4279,7 +4279,7 @@ (define-public emacs-bbdb-vcard
       (propagated-inputs (list emacs-bbdb))
       (home-page "https://github.com/tohojo/bbdb-vcard")
       (synopsis
-       "vCard Import and Export for The Insidious Big Brother Database (BBDB)")
+       "The Insidious Big Brother Database (BBDB) vCard Import and Export")
       (description
        "@code{bbdb-vcard.el} imports and exports vCards (version 3.0) as
 defined in RFC 2425 and RFC 2426 to/from The Insidious Big Brother Database
@@ -4926,7 +4926,7 @@ (define-public emacs-mediawiki-el
                (base32
                 "1d05jw2sa19rgzskvavh21bfmbh07yza1drfbgypsvay3nkjfd2z"))))
     (build-system emacs-build-system)
-    (synopsis "emacs mediawiki editor")
+    (synopsis "Mediawiki editor for Emacs")
     (description "This package provides a way to edit mediawiki sites from
 within emacs.")
     (home-page "https://github.com/hexmode/mediawiki-el")
@@ -5338,7 +5338,7 @@ (define-public emacs-capf-autosuggest
                (base32
                 "18cwiv227m8y1xqvsnjrzgd6f6kvvih742h8y38pphljssl109fk"))))
     (build-system emacs-build-system)
-    (synopsis "eshell completion suggestions for Emacs")
+    (synopsis "@code{eshell} completion suggestions for Emacs")
     (description "This package provides comint autosuggestions for Emacs
 eshell.")
     (home-page "https://repo.or.cz/emacs-capf-autosuggest")
@@ -8403,8 +8403,8 @@ (define-public emacs-org-rich-yank
         (base32 "0cajgkfcwqgqdqyqf01hxji28n27jmj9nf0w3rbyw6l5dffgch0n"))))
     (build-system emacs-build-system)
     (home-page "https://github.com/unhammer/org-rich-yank")
-    (synopsis "Automatically surround source code pasted into Org with
-@code{#+BEGIN_SRC} blocks")
+    (synopsis "Surround source code pasted into Org with @code{#+BEGIN_SRC}
+blocks")
     (description
      "This package provides a utility function for Org buffers that makes a
 @code{_SRC} block with the appropriate language annotation for code that has
@@ -14569,7 +14569,7 @@ (define-public emacs-anakondo
           (base32 "1fzsqd150gpmrj8kz3zy9cd78x9vank7ra720mljhyf04z0h1mj6"))))
       (build-system emacs-build-system)
       (home-page "https://github.com/didibus/anakondo")
-      (synopsis "clj-kondo based Clojure[Script] editing facilities")
+      (synopsis "Clojure[Script] editing facilities based on clj-kondo")
       (description
        "This package makes use of clj-kondo's analysis data to provide code
 editing facilities related to Clojure, ClojureScript and cljc source.")
@@ -18717,7 +18717,7 @@ (define-public emacs-gnosis
     (build-system emacs-build-system)
     (propagated-inputs (list emacs-compat emacs-emacsql))
     (home-page "https://thanosapollo.org/projects/gnosis")
-    (synopsis "Spaced repetition system for GNU Emacs.")
+    (synopsis "Spaced repetition system for GNU Emacs")
     (description
      "Gnosis is a spaced repetition system for note-taking and self-testing
 where notes are formatted as Question/Answer/Explanation. Notes are reviewed
@@ -21756,7 +21756,7 @@ (define-public emacs-free-keys
         (base32 "0xgifa7s9n882f9ymyyz9gc11xfbj3vfpnxiq1fqfm5hmwx9pwbc"))))
     (build-system emacs-build-system)
     (home-page "https://github.com/Fuco1/free-keys")
-    (synopsis "Show free keybindings for modkeys or prefixes in Emacs.")
+    (synopsis "Show free keybindings for modkeys or prefixes in Emacs")
     (description
      "Free-keys shows available key bindings in the current Emacs buffer.")
     (license license:gpl3+)))
@@ -24102,7 +24102,7 @@ (define-public emacs-pgmacs
     (build-system emacs-build-system)
     (propagated-inputs
      (list emacs-pg))
-    (synopsis "emacs PostgreSQL client")
+    (synopsis "PostgreSQL client in Emacs")
     (description "This package provides a PostgreSQL client in emacs.")
     (home-page "https://github.com/emarsden/pgmacs")
     (license license:gpl3+)))
@@ -33047,7 +33047,7 @@ (define-public emacs-jsdoc
              emacs-s
              tree-sitter-javascript))
       (home-page "https://github.com/isamert/jsdoc.el")
-      (synopsis "Inserts JSDoc function comments/typedefs easily.")
+      (synopsis "Inserts JSDoc function comments/typedefs easily")
       (description "This package provides an easy way to insert JSDoc function
 comments and typedefs using Emacs' builtin tree-sitter.")
       (license license:gpl3+))))
@@ -35370,7 +35370,7 @@ (define-public emacs-ox-reveal
       (propagated-inputs
        (list emacs-org))
       (home-page "https://github.com/hexmode/ox-reveal")
-      (synopsis "reveal.js Presentation Back-End for Org export engine")
+      (synopsis "Org export engine reveal.js Presentation Back-End")
       (description
        "Org Reveal exports your Org documents to @code{reveal.js} presentations.
 With org-reveal, you can create beautiful presentations with 3D effects from
@@ -37241,7 +37241,7 @@ (define-public emacs-discomfort
       (build-system emacs-build-system)
       (propagated-inputs (list emacs-debase))
       (home-page "https://codeberg.org/emacs-weirdware/discomfort")
-      (synopsis "User interface to mount & unmount disks in Emacs.")
+      (synopsis "User interface to mount and unmount disks in Emacs")
       (description "Discomfort is an interface to mount and unmount disks in Emacs, using UDisks2.")
       (license (list license:gpl3+)))))
 
diff --git a/gnu/packages/emacs.scm b/gnu/packages/emacs.scm
index 16ee12ac65..84bbf9df8a 100644
--- a/gnu/packages/emacs.scm
+++ b/gnu/packages/emacs.scm
@@ -546,7 +546,7 @@ (define-public emacs-no-x-toolkit
   (package/inherit emacs-no-x
     (name "emacs-no-x-toolkit")
     (synopsis "The extensible, customizable, self-documenting text
-editor (without an X toolkit)" )
+editor (without X toolkit)" )
     ;; Using emacs' inputs as base, since it has all the graphical stuff
     (inputs (modify-inputs (package-inputs emacs)
               (delete "gtk+")
diff --git a/gnu/packages/finance.scm b/gnu/packages/finance.scm
index d4594a1083..07f4b996ca 100644
--- a/gnu/packages/finance.scm
+++ b/gnu/packages/finance.scm
@@ -1956,7 +1956,7 @@ (define-public flowee
     (native-inputs
      (list pkg-config qttools-5 util-linux))       ; provides the hexdump command for tests
     (home-page "https://flowee.org")
-    (synopsis "Flowee infrastructure tools and services")
+    (synopsis "Infrastructure tools and services")
     (description
      "Flowee packages all tier-1 applications and services from the Flowee group.
 This includes components like The Hub and Indexer which and various others
diff --git a/gnu/packages/firmware.scm b/gnu/packages/firmware.scm
index fe6c1822fa..5374ac5a04 100644
--- a/gnu/packages/firmware.scm
+++ b/gnu/packages/firmware.scm
@@ -655,7 +655,7 @@ (define-public seabios
               (install-file "out/bios.bin"
                             (string-append #$output "/share/firmware")))))))
     (home-page "https://www.seabios.org/SeaBIOS")
-    (synopsis "x86 BIOS implementation")
+    (synopsis "BIOS implementation")
     (description "SeaBIOS is an implementation of a 16bit x86 BIOS.  SeaBIOS
 can run in an emulator or it can run natively on X86 hardware with the use of
 coreboot.")
diff --git a/gnu/packages/games.scm b/gnu/packages/games.scm
index bb97332b6d..c40a574c3b 100644
--- a/gnu/packages/games.scm
+++ b/gnu/packages/games.scm
@@ -5371,7 +5371,7 @@ (define-public pinball
               (symlink "README.md" "README")
               (invoke "autoreconf" "-vif"))))))
     (home-page "https://pinball.sourceforge.net")
-    (synopsis "Pinball simulator")
+    (synopsis "Pinball machine simulator")
     (description "The Emilia Pinball Project is a pinball simulator.  There
 are only two levels to play with, but they are very addictive.")
     (license license:gpl2)))
@@ -10873,7 +10873,7 @@ (define-public morris
 		 gnu-gettext libtool glib gtk+-2 boost))
     (arguments `(#:tests? #f))
     (home-page "http://nine-mens-morris.net/downloads.html")
-    (synopsis "Morris is an implementation of the board game Nine Men's Morris")
+    (synopsis "Implementation of the board game Nine Men's Morris")
     (description "Morris is an implementation of the board game Nine Men's Morris.
 It supports not only the standard game, but also several rule-variants and different
 board layouts. You can play against the computer, or simply use the program to
diff --git a/gnu/packages/gawk.scm b/gnu/packages/gawk.scm
index 6a77a692f5..730af0761c 100644
--- a/gnu/packages/gawk.scm
+++ b/gnu/packages/gawk.scm
@@ -261,4 +261,4 @@ (define-public cppawk-egawk
      (modify-inputs (package-inputs cppawk)
        (delete "gawk-mpfr")
        (prepend egawk-next)))
-    (synopsis "cppawk that calls Enhanced GNU Awk by default")))
+    (synopsis "Wrapper script that adds C preprocessing to Enhanced GNU Awk")))
diff --git a/gnu/packages/gnome.scm b/gnu/packages/gnome.scm
index dac01aa14a..9c30ae9fb6 100644
--- a/gnu/packages/gnome.scm
+++ b/gnu/packages/gnome.scm
@@ -1381,8 +1381,7 @@ (define-public gssdp
     (propagated-inputs
      ;; The .pc file "Requires" libsoup.
      (list libsoup))
-    (synopsis "GObject-based API over @acronym{SSDP, Simple Service Discovery
-Protocol} for GNOME")
+    (synopsis "GNOME GObject-based API over @acronym{SSDP, Simple Service Discovery Protocol}")
     (description "This package provides a library to handle resource discovery
 and announcement over @acronym{SSDP, Simple Service Discovery Protocol} and
 a debugging tool, @command{gssdp-device-sniffer}.")
diff --git a/gnu/packages/golang-check.scm b/gnu/packages/golang-check.scm
index 53bcc303bf..3ebb8f20a5 100644
--- a/gnu/packages/golang-check.scm
+++ b/gnu/packages/golang-check.scm
@@ -330,7 +330,7 @@ (define-public go-github-com-go-quicktest-qt
     (propagated-inputs
      (list go-github-com-google-go-cmp go-github-com-kr-pretty))
     (home-page "https://github.com/go-quicktest/qt")
-    (synopsis "qt: quicker Go tests")
+    (synopsis "Qt: quicker Go tests")
     (description
      "Package qt implements assertions and other helpers wrapped around the
 standard library's testing types.")
diff --git a/gnu/packages/golang-crypto.scm b/gnu/packages/golang-crypto.scm
index 2ba3a530ad..b14fa74e10 100644
--- a/gnu/packages/golang-crypto.scm
+++ b/gnu/packages/golang-crypto.scm
@@ -1527,8 +1527,7 @@ (define-public go-github-com-refraction-networking-utls
            go-golang-org-x-net
            go-golang-org-x-sys))
     (home-page "https://github.com/refraction-networking/utls")
-    (synopsis "Fork of the Go standard TLS library, providing low-level access
-to the ClientHello for mimicry purposes")
+    (synopsis "Fork of the Go standard TLS library")
     (description "uTLS is a fork of “crypto/tls”, which provides ClientHello
 fingerprinting resistance, low-level access to handshake, fake session tickets
 and some other features.  Handshake is still performed by “crypto/tls”, this
@@ -1691,7 +1690,7 @@ (define-public go-gitlab-com-yawning-edwards25519-extra
       (propagated-inputs (list go-golang-org-x-crypto
                                go-filippo-io-edwards25519))
       (home-page "https://gitlab.com/yawning/edwards25519-extra")
-      (synopsis "edwards25519-extra")
+      (synopsis "Extensions to Go standard library' Ed25519 and curve25519 implementation")
       (description "This package provides extensions to the Go standard
 library's Ed25519 and curve25519 implementations, primarily extracted from
 @@url{https://github.com/oasisprotocol/curve25519-voi,curve25519-voi}.  This
diff --git a/gnu/packages/golang-web.scm b/gnu/packages/golang-web.scm
index dcbc37cea3..931d926e57 100644
--- a/gnu/packages/golang-web.scm
+++ b/gnu/packages/golang-web.scm
@@ -524,8 +524,7 @@ (define-public go-github-com-aws-smithy-go
     (propagated-inputs
      (list go-github-com-jmespath-go-jmespath go-github-com-google-go-cmp))
     (home-page "https://github.com/aws/smithy-go")
-    (synopsis "@url{https://smithy.io/2.0/index.html,Smithy} code generators
-for Go")
+    (synopsis "Smithy code generators for Go")
     (description
      "Package smithy provides the core components for a Smithy SDK.")
     (license license:asl2.0)))
diff --git a/gnu/packages/golang-xyz.scm b/gnu/packages/golang-xyz.scm
index 0d6debcac4..f8584359c4 100644
--- a/gnu/packages/golang-xyz.scm
+++ b/gnu/packages/golang-xyz.scm
@@ -7660,7 +7660,7 @@ (define-public go-msgio
       #:install-source? #f
       #:import-path "github.com/libp2p/go-msgio/msgio"
       #:unpack-path "github.com/libp2p/go-msgio"))
-    (synopsis "CLI tool to wrap messages with msgio header.")))
+    (synopsis "CLI tool to wrap messages with msgio header")))
 
 (define-public go-numcpus
   (package
diff --git a/gnu/packages/golang.scm b/gnu/packages/golang.scm
index 00dde61f2c..7dbafd9bcb 100644
--- a/gnu/packages/golang.scm
+++ b/gnu/packages/golang.scm
@@ -2057,7 +2057,7 @@ (define-public go-github-com-flopp-go-findfont
     (arguments
      '(#:import-path "github.com/flopp/go-findfont"))
     (home-page "https://github.com/flopp/go-findfont")
-    (synopsis "go-findfont")
+    (synopsis "Go font finder library")
     (description
      "This package provides a platform-agnostic Go library to locate
 TrueType font files in your system's user and system font directories.")
diff --git a/gnu/packages/gstreamer.scm b/gnu/packages/gstreamer.scm
index 13c8734e68..c4fb8b9b4d 100644
--- a/gnu/packages/gstreamer.scm
+++ b/gnu/packages/gstreamer.scm
@@ -1185,7 +1185,7 @@ (define-public gst-plugins-espeak
       (native-inputs
        (list autoconf automake libtool pkg-config))
       (home-page "http://wiki.sugarlabs.org/go/Activity_Team/gst-plugins-espeak")
-      (synopsis "Use espeak ")
+      (synopsis "Use espeak")
       (description "This is a Gstreamer @code{src} plugin to use the espeak
 speech synthesizer as a sound source.")
       (license license:lgpl2.0+))))
diff --git a/gnu/packages/haskell-apps.scm b/gnu/packages/haskell-apps.scm
index 843681f311..3138e651e4 100644
--- a/gnu/packages/haskell-apps.scm
+++ b/gnu/packages/haskell-apps.scm
@@ -918,7 +918,7 @@ (define-public scroll
            ghc-random
            ghc-vector))
     (home-page "https://joeyh.name/code/scroll/")
-    (synopsis "scroll(6), a roguelike game")
+    (synopsis "Roguelike game")
     (description
      "You're a bookworm that's stuck on a scroll.  You have to dodge between
 words and use spells to make your way down the page as the scroll is read.  Go
diff --git a/gnu/packages/haskell-crypto.scm b/gnu/packages/haskell-crypto.scm
index 7ea9cf1e12..25867b3895 100644
--- a/gnu/packages/haskell-crypto.scm
+++ b/gnu/packages/haskell-crypto.scm
@@ -312,7 +312,7 @@ (define-public ghc-curve25519
    (list ghc-crypto-api))
   (properties '((upstream-name . "curve25519")))
   (home-page "https://github.com/acw/curve25519")
-  (synopsis "Fast implementations of the curve25519 elliptic curve primitives.")
+  (synopsis "Fast implementations of the curve25519 elliptic curve primitives")
   (description
    "This module provides Haskell bindings and extensions to the curve25519-donna
 codebase.  It's a pretty straightforward implementation of the basic
diff --git a/gnu/packages/haskell-xyz.scm b/gnu/packages/haskell-xyz.scm
index 9c3b990275..c91639cc93 100644
--- a/gnu/packages/haskell-xyz.scm
+++ b/gnu/packages/haskell-xyz.scm
@@ -779,7 +779,7 @@ (define-public ghc-base-compat-batteries
     (inputs (list ghc-base-compat))
     (native-inputs (list ghc-hspec ghc-quickcheck hspec-discover))
     (home-page "https://hackage.haskell.org/package/base-compat-batteries")
-    (synopsis "base-compat with extra batteries")
+    (synopsis "Extra batteries included base-compat")
     (description
      "This library provides functions available in later
 versions of @code{base} to a wider range of compilers, without requiring
@@ -6559,7 +6559,7 @@ (define-public ghc-generic-lens-core
      `(#:cabal-revision ("1"
                          "1dbjhd6k7ypqa9f4h9v2xndgb4mjhfli3n1vjm8r8ga0kfndbqfn")))
     (home-page "https://github.com/kcsongor/generic-lens")
-    (synopsis "Generically derive traversals, lenses and prisms.")
+    (synopsis "Generically derive traversals, lenses and prisms")
     (description
      "This library uses GHC.Generics to derive efficient optics (traversals,
 lenses and prisms) for algebraic data types in a type-directed way, with a
@@ -6583,7 +6583,7 @@ (define-public ghc-generic-lens
     (inputs (list ghc-generic-lens-core ghc-profunctors))
     (native-inputs (list ghc-lens ghc-inspection-testing ghc-hunit ghc-doctest))
     (home-page "https://github.com/kcsongor/generic-lens")
-    (synopsis "Generically derive traversals, lenses and prisms.")
+    (synopsis "Generically derive traversals, lenses and prisms")
     (description
      "This library uses @code{GHC.Generics} to derive efficient
 optics (traversals, lenses and prisms) for algebraic data types in a
@@ -11426,7 +11426,7 @@ (define-public ghc-skylighting
                   ghc-pretty-show
                   ghc-blaze-html))
     (home-page "https://github.com/jgm/skylighting")
-    (synopsis "syntax highlighting library")
+    (synopsis "Syntax highlighting library")
     (description
      "Skylighting is a syntax highlighting library with support for over one hundred
 languages.  It derives its tokenizers from XML syntax definitions used by KDE's
@@ -15980,7 +15980,7 @@ (define-public ghc-git-lfs
     (inputs (list ghc-http-client ghc-http-types ghc-aeson ghc-network-uri
                   ghc-case-insensitive))
     (home-page "https://hackage.haskell.org/package/git-lfs")
-    (synopsis "git-lfs protocol")
+    (synopsis "Git Large File Storage protocol")
     (description "An implementation of the git-lfs protocol.")
     (license license:agpl3)))
 
@@ -16038,7 +16038,7 @@ (define-public ghc-barbies
                          ghc-tasty-hunit
                          ghc-tasty-quickcheck))
     (home-page "https://github.com/jcpetruzza/barbies#readme")
-    (synopsis "Classes for working with types that can change clothes.")
+    (synopsis "Classes for working with types that can change clothes")
     (description
      "Types that are parametric on a functor are like Barbies that have an outfit for
 each role.  This package provides the basic abstractions to work with them
@@ -16126,7 +16126,7 @@ (define-public ghc-witherable
      `(#:cabal-revision ("3"
                          "1f2bvl41by904lnr0dk6qgasqwadq2w48l7fj51bp2h8bqbkdjyc")))
     (home-page "https://github.com/fumieval/witherable")
-    (synopsis "filterable traversable")
+    (synopsis "Filterable traversable")
     (description
      "This package provides a stronger variant of `traverse` which can remove elements
 and generalised mapMaybe, catMaybes, filter")
@@ -16209,7 +16209,7 @@ (define-public ghc-pcg-random
      `(#:cabal-revision ("1"
                          "1f8h0lv34cmqaxccg2yf6q4s8r5g2s8q8s9kql212iggd2l3vv77")))
     (home-page "https://github.com/cchalmers/pcg-random")
-    (synopsis "Haskell bindings to the PCG random number generator.")
+    (synopsis "Haskell bindings to the PCG random number generator")
     (description
      "PCG is a family of simple fast space-efficient statistically good algorithms for
 random number generation.  Unlike many general-purpose RNGs, they are also hard
@@ -16300,9 +16300,8 @@ (define-public ghc-ordered-containers
     (build-system haskell-build-system)
     (properties '((upstream-name . "ordered-containers")))
     (home-page "https://hackage.haskell.org/package/ordered-containers")
-    (synopsis
-     "Set- and Map-like types that remember the order elements were inserted")
     (description "")
+    (synopsis "Haskell types")
     (license license:bsd-3)))
 
 (define-public ghc-cabal-syntax
@@ -16318,7 +16317,7 @@ (define-public ghc-cabal-syntax
     (build-system haskell-build-system)
     (properties '((upstream-name . "Cabal-syntax")))
     (home-page "https://www.haskell.org/cabal/")
-    (synopsis "A library for working with .cabal files")
+    (synopsis "Library for working with .cabal files")
     (description
      "This library provides tools for reading and manipulating the .cabal file format.
 .  Version 3.6 (unlike the following versions) is a dummy package that prevents
@@ -16346,7 +16345,7 @@ (define-public ghc-tasty-hslua
     (properties '((upstream-name . "tasty-hslua")))
     (inputs (list ghc-hslua-core ghc-tasty ghc-tasty-hunit))
     (home-page "https://hslua.org/")
-    (synopsis "Tasty helpers to test HsLua.")
+    (synopsis "Tasty helpers to test HsLua")
     (description
      "Various tasty helpers and utilities to test HsLua oparations.  Built on top of
 tasty-hunit.")
@@ -16373,7 +16372,7 @@ (define-public ghc-hslua-marshalling
                          ghc-tasty-hunit
                          ghc-tasty-quickcheck))
     (home-page "https://hslua.org/")
-    (synopsis "Marshalling of values between Haskell and Lua.")
+    (synopsis "Marshalling of values between Haskell and Lua")
     (description
      "This package provides functions to marshal values from Haskell to Lua, and /vice
 versa/. .  This package is part of HsLua, a Haskell framework built around the
@@ -16394,7 +16393,7 @@ (define-public ghc-lua-arbitrary
     (properties '((upstream-name . "lua-arbitrary")))
     (inputs (list ghc-lua ghc-quickcheck))
     (home-page "https://hslua.org/")
-    (synopsis "Arbitrary instances for Lua types.")
+    (synopsis "Arbitrary instances for Lua types")
     (description
      "This package provides instances for QuickCheck's \\\"Arbitrary\\\" typeclass.")
     (license license:expat)))
@@ -16472,7 +16471,7 @@ (define-public ghc-hslua-aeson
     (native-inputs (list ghc-quickcheck ghc-quickcheck-instances ghc-tasty
                          ghc-tasty-quickcheck))
     (home-page "https://hslua.org/")
-    (synopsis "Allow aeson data types to be used with Lua.")
+    (synopsis "Allow aeson data types to be used with Lua")
     (description
      "This package provides instances to push and receive any datatype encodable as
 JSON to and from the Lua stack.")
@@ -16496,7 +16495,7 @@ (define-public ghc-gridtables
      `(#:cabal-revision ("1"
                          "0m2651z81n8s6hb8id7y6k2kprsgwnj7pcd6p8lmdpkzzz3wwd0c")))
     (home-page "https://github.com/tarleb/gridtables")
-    (synopsis "Parser for reStructuredText-style grid tables.")
+    (synopsis "Parser for reStructuredText-style grid tables")
     (description
      "This package provides a parser for plain-text representations of tables.  This
 package supports table headers, cells spanning multiple columns or rows, as well
@@ -16674,7 +16673,7 @@ (define-public ghc-servant
                   ghc-vault))
     (native-inputs (list ghc-hspec ghc-quickcheck-instances hspec-discover))
     (home-page "http://docs.servant.dev/")
-    (synopsis "A family of combinators for defining webservices APIs")
+    (synopsis "Family of combinators for defining webservices APIs")
     (description
      "This package provides a family of combinators for defining webservices APIs and
 serving them .  You can learn about the basics in the
@@ -16726,7 +16725,7 @@ (define-public ghc-servant-server
                          hspec-discover))
     (home-page "http://docs.servant.dev/")
     (synopsis
-     "A family of combinators for defining webservices APIs and serving them")
+     "Family of combinators for defining webservices APIs and serving them")
     (description
      "This package provides a family of combinators for defining webservices APIs and
 serving them .  You can learn about the basics in the
@@ -16850,7 +16849,7 @@ (define-public ghc-hslua-packaging
                   ghc-hslua-objectorientation))
     (native-inputs (list ghc-tasty-hslua ghc-tasty ghc-tasty-hunit))
     (home-page "https://hslua.org/")
-    (synopsis "Utilities to build Lua modules.")
+    (synopsis "Utilities to build Lua modules")
     (description
      "Utilities to package up Haskell functions and values into a Lua module. .  This
 package is part of HsLua, a Haskell framework built around the embeddable
@@ -16872,7 +16871,7 @@ (define-public ghc-hslua-module-version
     (inputs (list ghc-hslua-core ghc-hslua-marshalling ghc-hslua-packaging))
     (native-inputs (list ghc-tasty ghc-tasty-hunit ghc-tasty-lua))
     (home-page "https://hslua.org/")
-    (synopsis "Lua module to work with version specifiers.")
+    (synopsis "Lua module to work with version specifiers")
     (description "Wrapper for the Data.Version.Version Haskell type.")
     (license license:expat)))
 
diff --git a/gnu/packages/heads.scm b/gnu/packages/heads.scm
index 268d4d0198..4cc8a3d600 100644
--- a/gnu/packages/heads.scm
+++ b/gnu/packages/heads.scm
@@ -160,7 +160,7 @@ (define-public musl-cross
             (base32 "18r2a00k82hz0mqdvgm7crzc7305l36109c0j9yjmkxj2alcjw0k"))))))
     (supported-systems (delete "i586-gnu" %supported-systems))
     (home-page "https://github.com/osresearch/heads")
-    (synopsis "Musl-cross gcc 5 toolchain")
+    (synopsis "Cross gcc 5 toolchain")
     (description "Musl-cross toolchain: binutils, gcc 5 and musl.")
     (license license:isc))))
 
diff --git a/gnu/packages/ipfs.scm b/gnu/packages/ipfs.scm
index 988a565e03..a1c6834390 100644
--- a/gnu/packages/ipfs.scm
+++ b/gnu/packages/ipfs.scm
@@ -522,7 +522,8 @@ (define-public go-github-com-ipfs-go-ipld-cbor
            go-github-com-polydawn-refmt
            go-github-com-whyrusleeping-cbor-gen))
     (home-page "https://github.com/ipfs/go-ipld-cbor")
-    (synopsis "A cbor implementation of the @code{go-ipld-format}")
+    (synopsis "@acronym{Concise Binary Object Representation, CBOR}
+implementation of @code{go-ipld-format}")
     (description
      "An implementation of a @url{https://cbor.io/, CBOR} encoded merkledag object.")
     (license license:expat)))
diff --git a/gnu/packages/irc.scm b/gnu/packages/irc.scm
index 51bd43869e..211cee1b5b 100644
--- a/gnu/packages/irc.scm
+++ b/gnu/packages/irc.scm
@@ -795,7 +795,7 @@ (define-public epic5
     (native-inputs
      (list pkg-config))
     (home-page "http://epicsol.org")
-    (synopsis "Epic5 IRC Client")
+    (synopsis "IRC Client")
     (description
      "EPIC is a IRC client that has been under active development for
 over 20 years.  It is stable and mature, and offers an excellent ircII
diff --git a/gnu/packages/julia-jll.scm b/gnu/packages/julia-jll.scm
index 50bbd40a84..215e3127a1 100644
--- a/gnu/packages/julia-jll.scm
+++ b/gnu/packages/julia-jll.scm
@@ -351,7 +351,7 @@ (define-public julia-ffmpeg-jll
            julia-x265-jll
            julia-zlib-jll))
     (home-page "https://github.com/JuliaBinaryWrappers/FFMPEG_jll.jl")
-    (synopsis "ffmpeg library wrappers")
+    (synopsis "Library wrappers for ffmpeg")
     (description "This package provides a wrapper for ffmpeg.")
     (license license:expat)))
 
@@ -989,7 +989,7 @@ (define-public julia-libgcrypt-jll
     (propagated-inputs
      (list julia-jllwrappers julia-libgpg-error-jll))
     (home-page "https://github.com/JuliaBinaryWrappers/Libgcrypt_jll.jl")
-    (synopsis "libgcrypt library wrappers")
+    (synopsis "Library wrappers for libgcrypt")
     (description "This package provides a wrapper for the libgcrypt library.")
     (license license:expat)))
 
@@ -1063,7 +1063,7 @@ (define-public julia-libgpg-error-jll
     (propagated-inputs
      (list julia-jllwrappers))
     (home-page "https://github.com/JuliaBinaryWrappers/Libgpg_error_jll.jl")
-    (synopsis "libgpg-error library wrappers")
+    (synopsis "Library wrappers for libgpg-error")
     (description "This package provides a wrapper for the libgpg-error library.")
     (license license:expat)))
 
@@ -1837,7 +1837,7 @@ (define-public julia-x264-jll
     (propagated-inputs
      (list julia-jllwrappers))
     (home-page "https://github.com/JuliaBinaryWrappers/x264_jll.jl")
-    (synopsis "x264 library wrappers")
+    (synopsis "Library wrappers for x264")
     (description "This package provides a wrapper for the x264 video library.")
     (license license:expat)))
 
@@ -1873,7 +1873,7 @@ (define-public julia-x265-jll
     (propagated-inputs
      (list julia-jllwrappers))
     (home-page "https://github.com/JuliaBinaryWrappers/x265_jll.jl")
-    (synopsis "x265 library wrappers")
+    (synopsis "Library wrappers for x265")
     (description "This package provides a wrapper for the x265 video library.")
     (license license:expat)))
 
@@ -2422,7 +2422,7 @@ (define-public julia-xorg-libxrender-jll
     (propagated-inputs
      (list julia-jllwrappers julia-xorg-libx11-jll))
     (home-page "https://github.com/JuliaBinaryWrappers/Xorg_libXrender_jll.jl")
-    (synopsis "libXrender library wrappers")
+    (synopsis "Library wrappers libXrender")
     (description "This package provides a wrapper for the libXrender library.")
     (license license:expat)))
 
@@ -2638,7 +2638,7 @@ (define-public julia-xorg-xkbcomp-jll
     (propagated-inputs
      (list julia-jllwrappers julia-xorg-libxkbfile-jll))
     (home-page "https://github.com/JuliaBinaryWrappers/Xorg_xkbcomp_jll.jl")
-    (synopsis "xkbcomp library wrappers")
+    (synopsis "Library wrappers for xkbcomp")
     (description "This package provides a wrapper for the xkbcomp library.")
     (license license:expat)))
 
@@ -2710,7 +2710,7 @@ (define-public julia-xorg-xtrans-jll
     (propagated-inputs
      (list julia-jllwrappers))
     (home-page "https://github.com/JuliaBinaryWrappers/Xorg_xtrans_jll.jl")
-    (synopsis "xtrans library wrappers")
+    (synopsis "Library wrappers for xtrans")
     (description "This package provides a wrapper for the xtrans library.")
     (license license:expat)))
 
diff --git a/gnu/packages/kde-pim.scm b/gnu/packages/kde-pim.scm
index f34fe09057..5d546b7d4c 100644
--- a/gnu/packages/kde-pim.scm
+++ b/gnu/packages/kde-pim.scm
@@ -435,7 +435,7 @@ (define-public itinerary
                   sonnet
                   zlib))
     (home-page "https://invent.kde.org/pim/itinerary")
-    (synopsis "Itinerary and boarding pass management")
+    (synopsis "Boarding pass and itinerary management")
     (description
      "This package provides a tool for managing itinerary and boarding pass
 information.")
diff --git a/gnu/packages/kde-plasma.scm b/gnu/packages/kde-plasma.scm
index d36cfde21b..96026aeef7 100644
--- a/gnu/packages/kde-plasma.scm
+++ b/gnu/packages/kde-plasma.scm
@@ -1831,7 +1831,7 @@ (define-public mpvqt
     (arguments
      (list #:qtbase qtbase))
     (home-page "https://invent.kde.org/libraries/mpvqt")
-    (synopsis "A libmpv wrapper for QtQuick2 and QML")
+    (synopsis "libmpv wrapper for QtQuick2 and QML")
     (description "This package provides a libmpv wrapper for QtQuick2 and QML.")
     (license license:lgpl2.1+)))
 
diff --git a/gnu/packages/lesstif.scm b/gnu/packages/lesstif.scm
index bcda6b9867..b1b7fbbe82 100644
--- a/gnu/packages/lesstif.scm
+++ b/gnu/packages/lesstif.scm
@@ -79,7 +79,7 @@ (define-public motif
       (native-inputs
        (list autoconf automake byacc flex libtool pkg-config))
       (home-page "https://motif.ics.com/motif")
-      (synopsis "Motif toolkit for the X window system")
+      (synopsis "Toolkit for the X window system")
       (description "Motif is a standard graphical user interface, (as defined
 by the IEEE 1295 specification), used on more than 200 hardware and software
 platforms.  It provides application developers, end users, and system vendors
diff --git a/gnu/packages/linux.scm b/gnu/packages/linux.scm
index 1fa916f6b6..b4d72a8db5 100644
--- a/gnu/packages/linux.scm
+++ b/gnu/packages/linux.scm
@@ -7561,7 +7561,7 @@ (define-public ecryptfs-utils
            util-linux
            which))
     (home-page "https://ecryptfs.org/")
-    (synopsis "eCryptfs cryptographic file system utilities")
+    (synopsis "Cryptographic file system utilities")
     (description
      "eCryptfs is a POSIX-compliant stacked cryptographic file system for Linux.
 Each file's cryptographic meta-data is stored inside the file itself, along
@@ -9887,7 +9887,7 @@ (define-public falcosecurity-libs
            re2
            tbb))
     (home-page "https://github.com/falcosecurity/libs/")
-    (synopsis "libscap and lisbinsp Falco security libraries")
+    (synopsis "Falco security libraries")
     (description "The Falco security libraries include @code{libsinsp} and
 @code{libscap}.  @code{libscap} manages the data capture process, while
 @code{libsinsp} is a system inspection library that enriches events from
diff --git a/gnu/packages/lisp-xyz.scm b/gnu/packages/lisp-xyz.scm
index bacd1b54b7..decbe2590b 100644
--- a/gnu/packages/lisp-xyz.scm
+++ b/gnu/packages/lisp-xyz.scm
@@ -6731,7 +6731,7 @@ (define-public sbcl-cl-iconv
       (native-inputs (list sbcl-ptester))
       (inputs (list libiconv sbcl-cffi))
       (home-page "https://github.com/quek/cl-iconv")
-      (synopsis "iconv library for Common Lisp")
+      (synopsis "@command{iconv} library for Common Lisp")
       (description
        "This package provides CFFI bindings to convert between different
 character encodings using iconv.")
@@ -22311,7 +22311,7 @@ (define-public sbcl-nclasses
     (native-inputs
      (list sbcl-lisp-unit2))
     (home-page "https://github.com/atlas-engineer/nclasses")
-    (synopsis "Simplify class, condition, and generic function definitions.")
+    (synopsis "Simplify class, condition, and generic function definitions")
     (description
      "NClasses provides helper macros to help write classes, conditions,
 generic functions, and CLOS code in general with less boilerplate.
@@ -27638,7 +27638,7 @@ (define-public sbcl-slite
              sbcl-parachute
              sbcl-lisp-unit2))
       (home-page "https://github.com/tdrhq/slite")
-      (synopsis "Common Lisp system for Slite ")
+      (synopsis "Common Lisp system for Slite")
       (description
        "This package provides the Common Lisp part of the emacs-slite test runner.")
       (license license:asl2.0))))
diff --git a/gnu/packages/mail.scm b/gnu/packages/mail.scm
index ead8740627..8695756de9 100644
--- a/gnu/packages/mail.scm
+++ b/gnu/packages/mail.scm
@@ -4128,7 +4128,7 @@ (define-public pan
      (list gettext-minimal itstool pkg-config))
     (build-system gnu-build-system)
     (home-page "http://pan.rebelbase.com/")
-    (synopsis "Pan newsreader")
+    (synopsis "Usenet newsreader")
     (description "@code{pan} is a Usenet newsreader that's good at both text
 and binaries. It supports offline reading, scoring and killfiles, yEnc, NZB,
 PGP handling, multiple servers, and secure connections.")
diff --git a/gnu/packages/messaging.scm b/gnu/packages/messaging.scm
index c482cd469e..8cbe98d613 100644
--- a/gnu/packages/messaging.scm
+++ b/gnu/packages/messaging.scm
@@ -212,7 +212,7 @@ (define-public biboumi
                  (list util-linux "lib") ;; libuuid
                  pkg-config))
    (home-page "https://biboumi.louiz.org")
-   (synopsis "Biboumi is a XMPP gateway that connects to IRC")
+   (synopsis "XMPP gateway that connects to IRC")
    (description "Biboumi is a Free, Libre and Open Source XMPP gateway that connects to IRC
 servers and translates between the two protocols. Its goal is to let XMPP
 users take part in IRC discussions, using their favourite XMPP client.")
diff --git a/gnu/packages/ocaml.scm b/gnu/packages/ocaml.scm
index 9d29105cdb..89dc5a98c8 100644
--- a/gnu/packages/ocaml.scm
+++ b/gnu/packages/ocaml.scm
@@ -2848,7 +2848,7 @@ (define-public ocaml-ppx-import
                              ocaml-ppx-sexp-conv))
     (native-inputs (list ocaml-ounit ocaml-sexplib0))
     (properties `((upstream-name . "ppx_import")))
-    (synopsis "Extension for importing declarations from interface files.")
+    (synopsis "Extension for importing declarations from interface files")
     (description
      "Ppx-import is a syntax extension for importing declarations from
 interface files.")
diff --git a/gnu/packages/pascal.scm b/gnu/packages/pascal.scm
index 9d012fa28c..58b627c414 100644
--- a/gnu/packages/pascal.scm
+++ b/gnu/packages/pascal.scm
@@ -312,7 +312,7 @@ (define-public p2c
             (lambda _ (chdir "src"))))))
     (native-inputs
      (list perl unzip which))
-    (synopsis "p2c converts Pascal programs to C programs")
+    (synopsis "Convert Pascal programs to C programs")
     (description "This package provides @command{p2c}, a program to convert
 Pascal source code to C source code, and @command{p2cc}, a compiler for
 Pascal programs.")
diff --git a/gnu/packages/pdf.scm b/gnu/packages/pdf.scm
index 72aae8b002..d5884517b6 100644
--- a/gnu/packages/pdf.scm
+++ b/gnu/packages/pdf.scm
@@ -1000,7 +1000,7 @@ (define-public unpaper
      (list discount ffmpeg))
     (build-system meson-build-system)
     (home-page "https://www.flameeyes.com/projects/unpaper")
-    (synopsis "post-processing tool for scanned pages")
+    (synopsis "Post-processing tool for scanned pages")
     (description "@command{unpaper} is a post-processing tool for
 scanned sheets of paper, especially for book pages that have been
 scanned from previously created photocopies.
diff --git a/gnu/packages/pure.scm b/gnu/packages/pure.scm
index cb4cdd4d88..b23a70bcf4 100644
--- a/gnu/packages/pure.scm
+++ b/gnu/packages/pure.scm
@@ -58,7 +58,7 @@ (define-public pure
     (inputs
      (list gmp llvm-3.5 mpfr))
     (home-page "https://agraef.github.io/pure-lang/")
-    (synopsis "Pure programming Language")
+    (synopsis "Programming Language")
     (description "@code{pure} is a programming language based on term
 rewriting.  It offers equational definitions with pattern matching,
 full symbolic rewriting capabilities, dynamic typing, eager and lazy
diff --git a/gnu/packages/python-compression.scm b/gnu/packages/python-compression.scm
index cfabc618d2..5a6383facc 100644
--- a/gnu/packages/python-compression.scm
+++ b/gnu/packages/python-compression.scm
@@ -334,7 +334,7 @@ (define-public python-inflate64
            python-pytest
            python-setuptools-scm))
     (home-page "https://pypi.org/project/inflate64/")
-    (synopsis "deflate64 compression/decompression library")
+    (synopsis "Compression/decompression library")
     (description "The @code{inflate64} package provides @code{Deflater} and
 @code{Inflater} classes to compress and decompress with the Enhanced Deflate
 compression algorithm.")
diff --git a/gnu/packages/python-science.scm b/gnu/packages/python-science.scm
index f38992a1c2..af425ec38f 100644
--- a/gnu/packages/python-science.scm
+++ b/gnu/packages/python-science.scm
@@ -1810,7 +1810,7 @@ (define-public python-xarray-dataclasses
                              python-xarray))
     (native-inputs (list python-pytest python-poetry-core))
     (home-page "https://github.com/astropenguin/xarray-dataclasses/")
-    (synopsis "xarray data creation made easy by dataclass")
+    (synopsis "Data creation made easy by dataclass")
     (description "@code{xarray-dataclasses} is a Python package that makes it
 easy to create @code{xarray}'s @code{DataArray} and @code{Datase} objects that
 are \"typed\" (i.e. fixed dimensions, data type, coordinates, attributes, and
diff --git a/gnu/packages/python-web.scm b/gnu/packages/python-web.scm
index d892e03c9d..d35fd3729b 100644
--- a/gnu/packages/python-web.scm
+++ b/gnu/packages/python-web.scm
@@ -9503,8 +9503,7 @@ (define-public python-waybackpack
     (native-inputs (list python-pytest))
     (home-page "https://github.com/jsvine/waybackpack")
     (synopsis
-     "Command-line tool that lets you download the entire Wayback Machine
-archive for a given URL.")
+     "Download the entire Wayback Machine archive for a given URL")
     (description
      "This package provides a library and a command-line tool that lets
 you download the entire Wayback Machine archive for a given URL.")
diff --git a/gnu/packages/python-xyz.scm b/gnu/packages/python-xyz.scm
index 2a929466d8..f9fe28dfb4 100644
--- a/gnu/packages/python-xyz.scm
+++ b/gnu/packages/python-xyz.scm
@@ -5350,7 +5350,7 @@ (define-public python-mir-eval
                              python-six))
     (native-inputs (list python-matplotlib))
     (home-page "https://github.com/craffel/mir_eval")
-    (synopsis "Common metrics for common audio/music processing tasks.")
+    (synopsis "Common metrics for common audio/music processing tasks")
     (description "This is a Python library for computing common heuristic
 accuracy scores for various music/audio information retrieval/signal
 processing tasks.")
@@ -7124,7 +7124,7 @@ (define-public python-restructuredtext-lint
     (native-inputs
      (list python-nose))
     (home-page "https://github.com/twolfson/restructuredtext-lint")
-    (synopsis "reStructuredText linter")
+    (synopsis "Linter")
     (description "This package provides a linter for the reStructuredText
 format.")
     (license license:unlicense)))
@@ -10461,7 +10461,7 @@ (define-public python-pixelmatch
     (build-system python-build-system)
     (native-inputs (list python-pillow))
     (home-page "https://github.com/whtsky/pixelmatch-py")
-    (synopsis "A pixel-level image comparison library")
+    (synopsis "Pixel-level image comparison library")
     (description "This package provides a pixel-level image comparison library
 for Python, originally created to compare screenshots in tests.  Its features
 include accurate anti-aliased pixels detection and perceptual color difference
@@ -15660,7 +15660,7 @@ (define-public python-google-pasta
     (build-system pyproject-build-system)
     (propagated-inputs (list python-six))
     (home-page "https://github.com/google/pasta")
-    (synopsis "pasta is an AST-based Python refactoring library")
+    (synopsis "AST-based Python refactoring library")
     (description "This package provides \"pasta\", an AST-based Python
 refactoring library.")
     (license license:asl2.0)))
@@ -38066,7 +38066,7 @@ (define-public python-xmp-toolkit
     (propagated-inputs (list python-pytz))
     (native-inputs (list python-pytest))
     (home-page "https://github.com/python-xmp-toolkit/python-xmp-toolkit")
-    (synopsis "Python XMP Toolkit for working with metadata.")
+    (synopsis "Python XMP Toolkit for working with metadata")
     (description "Python XMP Toolkit is a library for working with XMP
 metadata, as well as reading/writing XMP metadata stored in many different
 file formats.
diff --git a/gnu/packages/qt.scm b/gnu/packages/qt.scm
index 687c20cd90..1ac8dfc529 100644
--- a/gnu/packages/qt.scm
+++ b/gnu/packages/qt.scm
@@ -1435,7 +1435,7 @@ (define-public qxlsx-qt5
     (name "qxlsx-qt5")
     (inputs
      (list qtbase-5))
-    (synopsis "Qt5 build for the qxlsx library.")))
+    (synopsis "Qt5 build for the qxlsx library")))
 
 (define-public qtxmlpatterns
   (package (inherit qtsvg-5)
diff --git a/gnu/packages/rpc.scm b/gnu/packages/rpc.scm
index b70214fa79..075a740a88 100644
--- a/gnu/packages/rpc.scm
+++ b/gnu/packages/rpc.scm
@@ -192,7 +192,7 @@ (define-public python-grpc-stubs
     (build-system python-build-system)
     (propagated-inputs (list python-grpcio python-typing-extensions))
     (home-page "https://github.com/shabbyrobe/grpc-stubs")
-    (synopsis "gRPC typing stubs for Python")
+    (synopsis "Typing stubs for Python")
     (description "This is a PEP-561-compliant stub-only package which provides
 type information of gRPC.")
     (license license:expat)))
diff --git a/gnu/packages/simulation.scm b/gnu/packages/simulation.scm
index 824318bf51..f3f6ee40fc 100644
--- a/gnu/packages/simulation.scm
+++ b/gnu/packages/simulation.scm
@@ -1332,7 +1332,7 @@ (define-public python-commonroad-io
                              python-tqdm))
     (native-inputs (list python-lxml python-pytest))
     (home-page "https://commonroad.in.tum.de/")
-    (synopsis "Read, write, and visualize CommonRoad scenarios.")
+    (synopsis "Read, write, and visualize CommonRoad scenarios")
     (description "This package provides methods to read, write, and visualize
 CommonRoad scenarios and planning problems.  It can be used as a framework for
 implementing motion planning algorithms to solve CommonRoad Benchmarks
diff --git a/gnu/packages/smalltalk.scm b/gnu/packages/smalltalk.scm
index 88a1bbc2c2..5c5b93236a 100644
--- a/gnu/packages/smalltalk.scm
+++ b/gnu/packages/smalltalk.scm
@@ -115,7 +115,7 @@ (define-public smalltalk
                  (("@LIBC_SO_DIR@")  (string-append libc "/lib"))))
              #t)))))
     (home-page "https://smalltalk.gnu.org/")
-    (synopsis "Smalltalk environment")
+    (synopsis "Programming language environment")
     (description
      "GNU Smalltalk is a free implementation of the Smalltalk language.  It
 implements the ANSI standard for the language and also includes extra classes
diff --git a/gnu/packages/sugar.scm b/gnu/packages/sugar.scm
index 77008bc078..51f80a58d3 100644
--- a/gnu/packages/sugar.scm
+++ b/gnu/packages/sugar.scm
@@ -184,7 +184,7 @@ (define-public sugar
            pkg-config
            python-empy))
     (home-page "https://www.sugarlabs.org/")
-    (synopsis "Sugar GTK shell")
+    (synopsis "GTK shell")
     (description "Sugar is the desktop environment component of a worldwide
 effort to provide every child with an equal opportunity for a quality
 education.  Available in more than twenty-five languages, Sugar Activities are
diff --git a/gnu/packages/terminals.scm b/gnu/packages/terminals.scm
index fbfc4439db..8b98cbdbd6 100644
--- a/gnu/packages/terminals.scm
+++ b/gnu/packages/terminals.scm
@@ -1772,7 +1772,7 @@ (define-public roxterm
            pkg-config))
     (inputs
      (list dbus dbus-glib gtk+ pcre vte))
-    (synopsis "ROXTerm terminal emulator")
+    (synopsis "Terminal emulator")
     (description "This package provides a terminal emulator with hyperlink
 support.  It's based on VTE and aimed at power users.")
     (home-page "https://realh.github.io/roxterm/en/index.html")
diff --git a/gnu/packages/tex.scm b/gnu/packages/tex.scm
index 358dd50368..969b6b4352 100644
--- a/gnu/packages/tex.scm
+++ b/gnu/packages/tex.scm
@@ -2704,7 +2704,7 @@ (define-public texlive-algorithms
     (outputs '("out" "doc"))
     (build-system texlive-build-system)
     (home-page "https://ctan.org/pkg/algorithms")
-    (synopsis "A suite of tools for typesetting algorithms in pseudo-code")
+    (synopsis "Suite of tools for typesetting algorithms in pseudo-code")
     (description
      "The package consists of two environments: @code{algorithm} and
 @code{algorithmic}.  The @code{algorithm} package defines a floating
@@ -5941,7 +5941,7 @@ (define-public texlive-bestpapers
     (outputs '("out" "doc"))
     (build-system texlive-build-system)
     (home-page "https://ctan.org/pkg/bestpapers")
-    (synopsis "A BibTeX package to produce lists of authors' best papers")
+    (synopsis "BibTeX package to produce lists of authors' best papers")
     (description
      "Many people preparing their resumes find the requirement ``please list
 five (or six, or ten) papers authored by you''.  The same requirement is often
@@ -13081,7 +13081,7 @@ (define-public texlive-cryptocode
     (build-system texlive-build-system)
     (home-page "https://ctan.org/pkg/cryptocode")
     (synopsis
-     "Pseudocode, protocols, game-based proofs and black-box reductions in cryptography")
+     "Pseudocode, protocols, game-based proofs, black-box reductions in cryptography")
     (description
      "The @code{cryptocode} package provides a set of macros to ease the
 typesetting of pseudocode, algorithms and protocols.  In addition it comes
@@ -16918,7 +16918,7 @@ (define-public texlive-filecontentsdef
     (outputs '("out" "doc"))
     (build-system texlive-build-system)
     (home-page "https://ctan.org/pkg/filecontentsdef")
-    (synopsis "filecontents, macro, and verbatim")
+    (synopsis "@code{filecontents}, @code{macro}, and @code{verbatim}")
     (description
      "The package provides two environments called @code{filecontentsdef} and
 @code{filecontentshere}.  They are derived from the LaTeX @code{filecontents}
@@ -18001,7 +18001,7 @@ (define-public texlive-garamond-math
     (outputs '("out" "doc"))
     (build-system texlive-build-system)
     (home-page "https://ctan.org/pkg/garamond-math")
-    (synopsis "An OTF math font matching EB Garamond")
+    (synopsis "OTF math font matching EB Garamond")
     (description
      "Garamond-Math is an OpenType math font matching EB Garamond (Octavio
 Pardo) and EB Garamond (Georg Mayr-Duffner).  Many mathematical symbols are
@@ -21673,8 +21673,8 @@ (define-public texlive-ijsra
     (build-system texlive-build-system)
     (home-page "https://ctan.org/pkg/ijsra")
     (synopsis
-     "LaTeX document class for the International Journal of Student Research
-in Archaeology")
+     "International Journal of Student Research in Archaeology's LaTeX
+document class")
     (description
      "This is a document class called ijsra which is used for the
 International Journal of Student Research in Archaeology.")
@@ -35689,7 +35689,7 @@ (define-public texlive-sudokubundle
     (outputs '("out" "doc"))
     (build-system texlive-build-system)
     (home-page "https://ctan.org/pkg/sudokubundle")
-    (synopsis "A set of sudoku-related packages")
+    (synopsis "Set of sudoku-related packages")
     (description
      "The bundle provides three packages: @code{printsudoku}, which provides
 a command @code{\\sudoku} whose argument is the name of a file containing
@@ -41189,7 +41189,7 @@ (define-public texlive-checklistings
     (arguments (list #:link-scripts #~(list "checklistings.sh")))
     (home-page "https://ctan.org/pkg/checklistings")
     (synopsis
-     "Pass verbatim contents through a compiler and reincorporate the resulting output")
+     "Pass verbatim content through a compiler and reincorporate the resulting output")
     (description
      "This package augments the @code{fancyvrb} and @code{listings} packages
 to allow the source code they contain to be checked by an external tool (like
@@ -45137,7 +45137,7 @@ (define-public texlive-platex
            texlive-unicode-data
            texlive-uptex))
     (home-page "https://ctan.org/pkg/platex")
-    (synopsis "pLaTeX2e and miscellaneous macros for pTeX")
+    (synopsis "Miscellaneous macros for pTeX and pLaTeX2e")
     (description
      "The bundle provides pLaTeX2e and miscellaneous macros for pTeX and
 e-pTeX.")
@@ -45161,7 +45161,7 @@ (define-public texlive-platex-tools
     (outputs '("out" "doc"))
     (build-system texlive-build-system)
     (home-page "https://ctan.org/pkg/platex-tools")
-    (synopsis "pLaTeX standard tools bundle")
+    (synopsis "Standard tools bundle")
     (description
      "This bundle is an extended version of the @code{latex-tools} bundle
 developed by the LaTeX team, mainly intended to support pLaTeX2e and
@@ -49731,7 +49731,7 @@ (define-public texlive-mptopdf
     (inputs (list perl))
     (propagated-inputs (list texlive-pdftex texlive-plain))
     (home-page "https://ctan.org/pkg/mptopdf")
-    (synopsis "mpost to PDF, native MetaPost graphics inclusion")
+    (synopsis "Native MetaPost graphics inclusion - mpost to PDF")
     (description
      "The @code{mptopdf} script does standalone conversion from mpost to PDF,
 using the @file{supp-*} and @file{syst-*} files.  They also allow native
@@ -57999,8 +57999,7 @@ (define-public texlive-ieejtran
     (build-system texlive-build-system)
     (home-page "https://ctan.org/pkg/ieejtran")
     (synopsis
-     "Unofficial bibliography style file for the Institute of Electrical
-Engineers of Japan")
+     "Institute of Electrical Engineers of Japan's unofficial bibliography style")
     (description
      "This package provides an unofficial BibTeX style for authors of the
 Institute of Electrical Engineers of Japan (IEEJ) transactions journals and
@@ -64896,7 +64895,8 @@ (define-public texlive-na-position
     (build-system texlive-build-system)
     (home-page "https://ctan.org/pkg/na-position")
     (synopsis
-     "Tables of relative positions of curves, asymptotes, tangents in Arabic documents")
+     "Tables of relative positions of curves, asymptotes, tangents in Arabic
+documents")
     (description
      "This package facilitates, in most cases, the creation of tables of
 relative positions of a curve and its asymptote, or a curve and a tangent in
@@ -68458,7 +68458,7 @@ (define-public texlive-footnotehyper
     (outputs '("out" "doc"))
     (build-system texlive-build-system)
     (home-page "https://ctan.org/pkg/footnotehyper")
-    (synopsis "hyperref aware @file{footnote.sty}")
+    (synopsis "@code{hyperref} aware @file{footnote.sty}")
     (description
      "The @code{footnote} package by Mark Wooding dates back to 1997 and has
 not been made @code{hyperref} compatible.  The aim of the present package is
@@ -72174,7 +72174,7 @@ (define-public texlive-ncctools
     (outputs '("out" "doc"))
     (build-system texlive-build-system)
     (home-page "https://ctan.org/pkg/ncctools")
-    (synopsis "A collection of general packages for LaTeX")
+    (synopsis "Collection of general packages for LaTeX")
     (description
      "The NCCtools bundle contains many packages for general use under LaTeX;
 many are also used by NCC LaTeX.  The bundle includes tools for:
@@ -77592,7 +77592,8 @@ (define-public texlive-scikgtex
     (build-system texlive-build-system)
     (home-page "https://ctan.org/pkg/scikgtex")
     (synopsis
-     "Mark research contributions in scientific documents and embed them in PDF metadata")
+     "Mark research contributions in scientific documents and embed them in
+PDF metadata")
     (description
      "Scientific Knowledge Graph TeX (SciKgTeX) is a LuaLaTeX package which
 makes it possible to annotate specific research contributions in scientific
@@ -92975,7 +92976,7 @@ (define-public texlive-beamertheme-focus
     (outputs '("out" "doc"))
     (build-system texlive-build-system)
     (home-page "https://ctan.org/pkg/beamertheme-focus")
-    (synopsis "A minimalist presentation theme for LaTeX Beamer")
+    (synopsis "Minimalist presentation theme for LaTeX Beamer")
     (description
      "This package provides a presentation theme for LaTeX Beamer that aims at
 a clean and minimalist design, so to minimize distractions and put the focus
@@ -95070,7 +95071,7 @@ (define-public texlive-cellprops
     (outputs '("out" "doc"))
     (build-system texlive-build-system)
     (home-page "https://ctan.org/pkg/cellprops")
-    (synopsis "Accept CSS-like selectors in @code{tabular}, @code{array}, ...")
+    (synopsis "Accept CSS-like selectors in @code{tabular}, @code{array}, etc")
     (description
      "This package reworks the internals of @code{tabular}, @code{array},
 and similar constructs, and adds a @code{\\cellprops} command accepting
@@ -101360,13 +101361,13 @@ (define-public texlive-eq-pin2corr
     (build-system texlive-build-system)
     (home-page "https://ctan.org/pkg/eq-pin2corr")
     (synopsis
-     "Add PIN security to the ``Correct'' button of a quiz created by
+     "Add PIN security to the @emph{Correct} button of a quiz created by
 @code{exerquiz}")
     (description
      "This package is an add-on to the @code{quiz} environment of the
 @code{exerquiz} package.  It adds PIN security to a quiz created by the
 @code{quiz} environment.  To correct a quiz, the document consumer must press
-the ``Correct'' button of the quiz and successfully enter the correct PIN
+the @emph{Correct} button of the quiz and successfully enter the correct PIN
 number.  The PIN security is designed for the instructor to mark and record
 the student's effort on that quiz.")
     (license license:lppl1.2+)))
@@ -102179,7 +102180,7 @@ (define-public texlive-exercisepoints
     (outputs '("out" "doc"))
     (build-system texlive-build-system)
     (home-page "https://ctan.org/pkg/exercisepoints")
-    (synopsis "A LaTeX package to count exercises and points")
+    (synopsis "LaTeX package to count exercises and points")
     (description
      "The package can be used to facilitate exercise counting and exercise point
 counting in a LaTeX document.  It counts the number of exercises and it sums
@@ -108698,7 +108699,7 @@ (define-public texlive-latexgit
     (outputs '("out" "doc"))
     (build-system texlive-build-system)
     (home-page "https://ctan.org/pkg/latexgit")
-    (synopsis "A LaTeX git wrapper")
+    (synopsis "LaTeX git wrapper")
     (description
      "This package provides several macros to fetch git information and typeset it.
 The macros defined by LaTeXgit can be helpful to documentation authors and
@@ -109646,8 +109647,8 @@ (define-public texlive-longfbox
     (build-system texlive-build-system)
     (home-page "https://ctan.org/pkg/longfbox")
     (synopsis
-     "Draw framed boxes with standard CSS attributes that can break over multiple
-pages")
+     "Draw framed boxes with standard CSS attributes able to span over
+multiple pages")
     (description
      "The @code{longfbox} package provides framed boxes that can be customized
 using standard CSS attributes.  It was written to support precise rendering of
@@ -121056,7 +121057,7 @@ (define-public texlive-suppose
     (outputs '("out" "doc"))
     (build-system texlive-build-system)
     (home-page "https://ctan.org/pkg/suppose")
-    (synopsis "Abbreviate the word ``Suppose''")
+    (synopsis "Abbreviate the word @emph{Suppose}")
     (description
      "This package provides commands for abbreviating the word ``Suppose'' in six
 fonts and with other variations.  The author recommends only using these
@@ -125518,7 +125519,7 @@ (define-public texlive-xsim
     (outputs '("out" "doc"))
     (build-system texlive-build-system)
     (home-page "https://ctan.org/pkg/xsim")
-    (synopsis "eXercise Sheets IMproved")
+    (synopsis "@acronym{XSIM, eXercise Sheets IMproved}")
     (description
      "This package helps in creating exercises and the corresponding solutions.  It
 is the official successor of the @code{exsheets} package and fixes/improves
@@ -125719,7 +125720,7 @@ (define-public texlive-ycbook
     (outputs '("out" "doc"))
     (build-system texlive-build-system)
     (home-page "https://ctan.org/pkg/ycbook")
-    (synopsis "A versatile book class")
+    (synopsis "Versatile book class")
     (description
      "This class is intended to be an interpretation of the @code{mwbk} class which
 is a part of the @code{mwcls} package.  The @code{mwcls} classes are simple,
diff --git a/gnu/packages/virtualization.scm b/gnu/packages/virtualization.scm
index be1a72d4a9..104dcbd7d6 100644
--- a/gnu/packages/virtualization.scm
+++ b/gnu/packages/virtualization.scm
@@ -2762,7 +2762,7 @@ (define-public xen
        (cross-libc "i686-linux-gnu") ; header files
        `(,(cross-libc "i686-linux-gnu") "static")))
     (home-page "https://xenproject.org/")
-    (synopsis "Xen Virtual Machine Monitor")
+    (synopsis "Hypervisor")
     (description "This package provides the Xen Virtual Machine Monitor
 which is a hypervisor.")
     ;; TODO: Some files are licensed differently.  List those.
diff --git a/gnu/packages/vpn.scm b/gnu/packages/vpn.scm
index 9f36595bfd..df8dff3def 100644
--- a/gnu/packages/vpn.scm
+++ b/gnu/packages/vpn.scm
@@ -1086,7 +1086,7 @@ (define-public sshoot
     (native-inputs
      (list python-pytest python-pytest-mock))
     (home-page "https://github.com/albertodonato/sshoot")
-    (synopsis "sshuttle VPN session manager")
+    (synopsis "VPN session manager (sshuttle)")
     (description "sshoot provides a command-line interface to manage multiple
 @command{sshuttle} virtual private networks.  It supports flexible profiles
 with configuration options for most of @command{sshuttle}’s features.")
diff --git a/gnu/packages/web.scm b/gnu/packages/web.scm
index 31ea668606..216d065347 100644
--- a/gnu/packages/web.scm
+++ b/gnu/packages/web.scm
@@ -8847,7 +8847,7 @@ (define-public buku-run
                       (string-append #$output path))))))))
     (inputs (list buku rofi))
     (home-page "https://github.com/carnager/buku_run")
-    (synopsis "rofi frontend for buku bookmarks manager")
+    (synopsis "@command{rofi} frontend for buku bookmarks manager")
     (description
      "This package provides a rofi frontend for the buku bookmark manager.")
     (license license:gpl3+)))
-- 
2.46.0






^ permalink raw reply related	[flat|nested] 3+ messages in thread

* [bug#74329] [PATCH 2/2] gnu: Lint descriptions.
       [not found] ` <handler.74329.B.173144383113227.ack@debbugs.gnu.org>
  2024-11-12 20:41   ` [bug#74329] [PATCH 1/2] gnu: Lint synopses Gabriel Wicki
@ 2024-11-12 20:42   ` Gabriel Wicki
  1 sibling, 0 replies; 3+ messages in thread
From: Gabriel Wicki @ 2024-11-12 20:42 UTC (permalink / raw)
  To: 74329

From 91cfde3b8e67bd7e783c508447a6880d908bf38f Mon Sep 17 00:00:00 2001
Message-ID: <91cfde3b8e67bd7e783c508447a6880d908bf38f.1731443064.git.gabriel@erlikon.ch>
In-Reply-To: <cover.1731443063.git.gabriel@erlikon.ch>
References: <cover.1731443063.git.gabriel@erlikon.ch>
From: Gabriel Wicki <gabriel@erlikon.ch>
Date: Tue, 5 Nov 2024 23:29:25 +0100
Subject: [PATCH 2/2] gnu: Lint descriptions.

Correct descriptions of a bunch of packages.

Change-Id: Ie13f55fc251b6935ef3404a54559229e4713fcff
---
 gnu/packages/astronomy.scm        |   4 +-
 gnu/packages/audio.scm            |   8 +-
 gnu/packages/autotools.scm        |   6 +-
 gnu/packages/axoloti.scm          |  12 +--
 gnu/packages/bioconductor.scm     |  25 ++++---
 gnu/packages/bioinformatics.scm   |   4 +-
 gnu/packages/calendar.scm         |   2 +-
 gnu/packages/check.scm            |  10 +--
 gnu/packages/chez.scm             |  16 ++--
 gnu/packages/code.scm             |   2 +-
 gnu/packages/compression.scm      |   4 +-
 gnu/packages/connman.scm          |   2 +-
 gnu/packages/cran.scm             |  56 +++++++-------
 gnu/packages/crates-graphics.scm  |  15 ++--
 gnu/packages/crates-io.scm        |  16 ++--
 gnu/packages/crates-web.scm       |   2 +-
 gnu/packages/crypto.scm           |   9 +--
 gnu/packages/databases.scm        |   2 +-
 gnu/packages/display-managers.scm |   2 +-
 gnu/packages/docker.scm           |   2 +-
 gnu/packages/elm.scm              |   2 +-
 gnu/packages/emacs-xyz.scm        | 118 ++++++++++++++---------------
 gnu/packages/emulators.scm        |   2 +-
 gnu/packages/fonts.scm            |   4 +-
 gnu/packages/fpga.scm             |   4 +-
 gnu/packages/freedesktop.scm      |   2 +-
 gnu/packages/game-development.scm |   4 +-
 gnu/packages/games.scm            |   6 +-
 gnu/packages/geo.scm              |   2 +-
 gnu/packages/gnunet.scm           |  10 +--
 gnu/packages/golang-check.scm     |   2 +-
 gnu/packages/golang-web.scm       |   2 +-
 gnu/packages/golang-xyz.scm       |  10 +--
 gnu/packages/golang.scm           |   7 +-
 gnu/packages/guile.scm            |   4 +-
 gnu/packages/haskell-check.scm    |  34 ++++-----
 gnu/packages/haskell-web.scm      |   2 +-
 gnu/packages/haskell-xyz.scm      |  80 +++++++++++---------
 gnu/packages/ibus.scm             |   2 +-
 gnu/packages/image.scm            |   9 ++-
 gnu/packages/ipfs.scm             |   4 +-
 gnu/packages/java-xml.scm         |   6 +-
 gnu/packages/java.scm             |  41 +++++-----
 gnu/packages/kodi.scm             |   7 +-
 gnu/packages/linux.scm            |  23 +++---
 gnu/packages/lisp-xyz.scm         |  16 ++--
 gnu/packages/machine-learning.scm |  24 +++---
 gnu/packages/messaging.scm        |   2 +-
 gnu/packages/minetest.scm         |   2 +-
 gnu/packages/monitoring.scm       |   2 +-
 gnu/packages/music.scm            |  11 ++-
 gnu/packages/node-xyz.scm         |   4 +-
 gnu/packages/ocaml.scm            |   6 +-
 gnu/packages/opencl.scm           |   2 +-
 gnu/packages/perl-check.scm       |   6 +-
 gnu/packages/perl.scm             |  14 ++--
 gnu/packages/python-xyz.scm       |  12 +--
 gnu/packages/qt.scm               |   5 +-
 gnu/packages/radio.scm            |   4 +-
 gnu/packages/rocm.scm             |   6 +-
 gnu/packages/rust-apps.scm        |   2 +-
 gnu/packages/scanner.scm          |  16 ++--
 gnu/packages/search.scm           |   2 +-
 gnu/packages/security-token.scm   |   6 +-
 gnu/packages/shells.scm           |   2 +-
 gnu/packages/shellutils.scm       |   8 +-
 gnu/packages/ssh.scm              |   2 +-
 gnu/packages/statistics.scm       |  14 ++--
 gnu/packages/tcl.scm              |   6 +-
 gnu/packages/tex.scm              | 120 +++++++++++++++---------------
 gnu/packages/text-editors.scm     |   6 +-
 gnu/packages/textutils.scm        |   5 +-
 gnu/packages/tor.scm              |   2 +-
 gnu/packages/xdisorg.scm          |   8 +-
 gnu/packages/xfce.scm             |   4 +-
 gnu/packages/xml.scm              |   7 +-
 gnu/packages/xorg.scm             |   2 +-
 77 files changed, 462 insertions(+), 452 deletions(-)

diff --git a/gnu/packages/astronomy.scm b/gnu/packages/astronomy.scm
index c022f2c7de..9fafe285ed 100644
--- a/gnu/packages/astronomy.scm
+++ b/gnu/packages/astronomy.scm
@@ -1519,7 +1519,7 @@ (define-public python-ads
     (synopsis "Python client to NASA's Astrophysics Data System")
     (description
      "This package provdies a Python Module to Interact with NASA's
-@acronym{Astrophysics Data System,ADS} that Doesn't Suck™.")
+@acronym{Astrophysics Data System,ADS}.")
     (license license:expat)))
 
 (define-public python-aplpy
@@ -6153,7 +6153,7 @@ (define-public python-tweakwcs
     (description
      "@code{tweakwcs} is a package that provides core algorithms for computing
 and applying corrections to @code{WCS} objects such as to minimize mismatch
-between image and reference catalogs. Currently only aligning images with
+between image and reference catalogs.  Currently only aligning images with
 @code{FITS WCS} and @code{JWST gWCS} are supported.")
     (license license:bsd-3)))
 
diff --git a/gnu/packages/audio.scm b/gnu/packages/audio.scm
index 467dc4a74f..7c3a2fc956 100644
--- a/gnu/packages/audio.scm
+++ b/gnu/packages/audio.scm
@@ -5784,12 +5784,12 @@ (define-public ecasound
     (home-page "https://nosignal.fi/ecasound/index.php")
     (synopsis "Multitrack audio processing")
     (description "Ecasound is a software package designed for multitrack audio
-processing. It can be used for simple tasks like audio playback, recording and
+processing.  It can be used for simple tasks like audio playback, recording and
 format conversions, as well as for multitrack effect processing, mixing,
-recording and signal recycling. Ecasound supports a wide range of audio inputs,
-outputs and effect algorithms. Effects and audio objects can be combined in
+recording and signal recycling.  Ecasound supports a wide range of audio inputs,
+outputs and effect algorithms.  Effects and audio objects can be combined in
 various ways, and their parameters can be controlled by operator objects like
-oscillators and MIDI-CCs. A versatile console mode user-interface is included
+oscillators and MIDI-CCs.  A versatile console mode user-interface is included
 in the package.")
     ;; As an exception to the above, the C, C++ and python implementations
     ;; of the Ecasound Control Interface (ECI) are licensed under the LGPL
diff --git a/gnu/packages/autotools.scm b/gnu/packages/autotools.scm
index 79d25b59a5..40fe93ab20 100644
--- a/gnu/packages/autotools.scm
+++ b/gnu/packages/autotools.scm
@@ -541,9 +541,9 @@ (define-public config
        (list help2man))
       (home-page "https://savannah.gnu.org/projects/config")
       (synopsis "Ubiquitous config.guess and config.sub scripts")
-      (description "The `config.guess' script tries to guess a canonical system triple,
-and `config.sub' validates and canonicalizes.  These are used as part of
-configuration in nearly all GNU packages (and many others).")
+      (description "The @emph{config.guess} script tries to guess a canonical
+system triple, and @emph{config.sub} validates and canonicalizes.  These are
+used as part of configuration in nearly all GNU packages (and many others).")
       (license gpl2+))))
 
 (define-public libltdl
diff --git a/gnu/packages/axoloti.scm b/gnu/packages/axoloti.scm
index 27e80082f0..591bd72f9b 100644
--- a/gnu/packages/axoloti.scm
+++ b/gnu/packages/axoloti.scm
@@ -758,9 +758,9 @@ (define-public ksoloti-runtime
     (home-page "https://ksoloti.github.io/")
     (synopsis "Audio development environment for the Ksoloti board")
     (description
-     "Ksoloti is an environment for generating and processing digital
-audio. It can be a programmable virtual modular synthesizer, polysynth, drone
-box, sequencer, chord generator, multi effect, sample player, looper, granular
+     "Ksoloti is an environment for generating and processing digital audio.
+It can be a programmable virtual modular synthesizer, polysynth, drone box,
+sequencer, chord generator, multi effect, sample player, looper, granular
 sampler, MIDI generator/processor, CV or trigger generator, anything in
 between, and more.
 
@@ -918,9 +918,9 @@ (define-public ksoloti-patcher
      (list ant zip                      ;for repacking the jar
            unzip))
     (description
-     "Ksoloti is an environment for generating and processing digital
-audio. It can be a programmable virtual modular synthesizer, polysynth, drone
-box, sequencer, chord generator, multi effect, sample player, looper, granular
+     "Ksoloti is an environment for generating and processing digital audio.
+It can be a programmable virtual modular synthesizer, polysynth, drone box,
+sequencer, chord generator, multi effect, sample player, looper, granular
 sampler, MIDI generator/processor, CV or trigger generator, anything in
 between, and more.
 
diff --git a/gnu/packages/bioconductor.scm b/gnu/packages/bioconductor.scm
index 59a291300d..509cab9509 100644
--- a/gnu/packages/bioconductor.scm
+++ b/gnu/packages/bioconductor.scm
@@ -18455,7 +18455,7 @@ (define-public r-biosigner
 assess the relevance of the variables for the prediction performances of the
 classifier.  The approach can be run in parallel with the PLS-DA, Random
 Forest, and SVM binary classifiers.  The signatures and the corresponding
-'restricted' models are returned, enabling future predictions on new
+@emph{restricted} models are returned, enabling future predictions on new
 datasets.")
     (license license:cecill)))
 
@@ -22818,17 +22818,18 @@ (define-public r-biocio
     (home-page "https://bioconductor.org/packages/BiocIO")
     (synopsis "Standard input and output for Bioconductor packages")
     (description
-      "This package implements `import()` and `export()` standard generics for
-importing and exporting biological data formats. `import()` supports
-whole-file as well as chunk-wise iterative import.  The `import()` interface
-optionally provides a standard mechanism for 'lazy' access via `filter()` (on
-row or element-like components of the file resource), `select()` (on
-column-like components of the file resource) and `collect()`.  The `import()`
-interface optionally provides transparent access to remote (e.g.  via https)
-as well as local access.  Developers can register a file extension, e.g.,
-`.loom` for dispatch from character-based URIs to specific `import()` /
-`export()` methods based on classes representing file types, e.g.,
-`LoomFile()`.")
+      "This package implements @code{import()} and @code{export()} standard
+generics for importing and exporting biological data formats. @code{import()}
+supports whole-file as well as chunk-wise iterative import.  The
+@code{import()} interface optionally provides a standard mechanism for
+@emph{lazy} access via @code{filter()} (on row or element-like components of
+the file resource), @code{select()} (on column-like components of the file
+resource) and @code{collect()}.  The @code{import()} interface optionally
+provides transparent access to remote (e.g.  via https) as well as local
+access.  Developers can register a file extension, e.g., @code{.loom} for
+dispatch from character-based URIs to specific @code{import()} /
+@code{export()} methods based on classes representing file types, e.g.,
+@code{LoomFile()}.")
     (license license:artistic2.0)))
 
 (define-public r-msmseda
diff --git a/gnu/packages/bioinformatics.scm b/gnu/packages/bioinformatics.scm
index a88b1e2077..74ce30afd2 100644
--- a/gnu/packages/bioinformatics.scm
+++ b/gnu/packages/bioinformatics.scm
@@ -6135,7 +6135,7 @@ (define-public trf
 locate and display tandem repeats in DNA sequences.  In order to use the
 program, the user submits a sequence in FASTA format.  The output consists of
 two files: a repeat table file and an alignment file.  Submitted sequences may
-be of arbitrary length. Repeats with pattern size in the range from 1 to 2000
+be of arbitrary length.  Repeats with pattern size in the range from 1 to 2000
 bases are detected.")
     (license license:agpl3+)))
 
@@ -19500,7 +19500,7 @@ (define-public ghc-int-interval-map
 memory (each interval is represented by about 3 words + whatever the
 cargo is) and has semantics that are appropriate for genomic intervals
 (namely, intervals can overlap and queries will return all matches
-together). It also designed to be used in two phases: a construction
+together).  It also designed to be used in two phases: a construction
 phase + query phase).")
       (license license:expat))))
 
diff --git a/gnu/packages/calendar.scm b/gnu/packages/calendar.scm
index 6717db867f..63d4ee6a62 100644
--- a/gnu/packages/calendar.scm
+++ b/gnu/packages/calendar.scm
@@ -220,7 +220,7 @@ (define-public khal
     (description "Khal is a standards based console calendar program,
 able to synchronize with CalDAV servers through vdirsyncer.  It includes
 both a @acronym{CLI, command-line interface} and a @acronym{TUI, textual user
-interface} named 'ikhal'.")
+interface} named @command{ikhal}.")
     (home-page "https://lostpackets.de/khal/")
     (license license:expat)))
 
diff --git a/gnu/packages/check.scm b/gnu/packages/check.scm
index 6593eadf6a..1303ffdafb 100644
--- a/gnu/packages/check.scm
+++ b/gnu/packages/check.scm
@@ -2701,11 +2701,11 @@ (define-public python-pytest-subtesthack
     (propagated-inputs
      (list python-pytest))
     (synopsis "Set-up and tear-down fixtures for unit tests")
-    (description "This plugin allows you to set up and tear down fixtures within
-unit test functions that use @code{py.test}. This is useful for using
-@command{hypothesis} inside py.test, as @command{hypothesis} will call the test
-function multiple times, without setting up or tearing down fixture state as is
-normally the case.")
+    (description "This plugin allows you to set up and tear down fixtures
+within unit test functions that use @code{py.test}.  This is useful for using
+@command{hypothesis} inside py.test, as @command{hypothesis} will call the
+test function multiple times, without setting up or tearing down fixture state
+as is normally the case.")
     (home-page "https://github.com/untitaker/pytest-subtesthack/")
     (license license:unlicense)))
 
diff --git a/gnu/packages/chez.scm b/gnu/packages/chez.scm
index a24e8aaf79..4ea02e3613 100644
--- a/gnu/packages/chez.scm
+++ b/gnu/packages/chez.scm
@@ -540,7 +540,7 @@ (define-public chez-scheme
     (synopsis "R6RS Scheme compiler and run-time")
     (description
      "Chez Scheme is both a programming language and a high-performance
-implementation of that language. The language is a superset of R6RS Scheme
+implementation of that language.  The language is a superset of R6RS Scheme
 with numerous extensions, including native threads, non-blocking I/O, local
 modules, and much more.  Chez Scheme compiles source expressions incrementally
 to machine code, providing the speed of compiled code in an interactive
@@ -680,15 +680,15 @@ (define-public chez-scheme-bootstrap-bootfiles
     (home-page "https://cisco.github.io/ChezScheme/")
     (synopsis "Bootstrapped Chez Scheme boot files")
     (description
-     "Chez Scheme is a self-hosting compiler: building it requires
-``boot files'' containing the Scheme-implemented portions compiled for the
-current platform.  (Chez can then cross-compile bootfiles for all other
-supported platforms.)
+     "Chez Scheme is a self-hosting compiler: building it requires ``boot
+files'' containing the Scheme-implemented portions compiled for the current
+platform.  (Chez can then cross-compile bootfiles for all other supported
+platforms.)
 
 This package provides boot files for the released version of Chez Scheme
-bootstrapped by @code{chez-scheme-for-racket}. Chez Scheme 9.5.4 or any later
-version can be used for bootstrapping. Guix ultimately uses the Racket package
-@code{cs-bootstrap} to bootstrap its initial version of Chez Scheme.")
+bootstrapped by @code{chez-scheme-for-racket}.  Chez Scheme 9.5.4 or any later
+version can be used for bootstrapping.  Guix ultimately uses the Racket
+package @code{cs-bootstrap} to bootstrap its initial version of Chez Scheme.")
     (license asl2.0)))
 
 ;;
diff --git a/gnu/packages/code.scm b/gnu/packages/code.scm
index 04ca4dfd6b..a9c2074511 100644
--- a/gnu/packages/code.scm
+++ b/gnu/packages/code.scm
@@ -1044,7 +1044,7 @@ (define-public cscope
     (home-page "https://cscope.sourceforge.net")
     (synopsis "Tool for browsing source code")
     (description
-     "Cscope is a text screen based source browsing tool. Although it is
+     "Cscope is a text screen based source browsing tool.  Although it is
 primarily designed to search C code (including lex and yacc files), it can
 also be used for C++ code.
 
diff --git a/gnu/packages/compression.scm b/gnu/packages/compression.scm
index 7627717db6..48eea0701b 100644
--- a/gnu/packages/compression.scm
+++ b/gnu/packages/compression.scm
@@ -2772,8 +2772,8 @@ (define-public c-blosc
     (home-page "https://blosc.org")
     (synopsis "Blocking, shuffling and lossless compression library")
     (description
-     "Blosc is a high performance compressor optimized for binary data. It has
-been designed to transmit data to the processor cache faster than the
+     "Blosc is a high performance compressor optimized for binary data.  It
+has been designed to transmit data to the processor cache faster than the
 traditional, non-compressed, direct memory fetch approach via a
 @code{memcpy()} system call.  Blosc is meant not only to reduce the size of
 large datasets on-disk or in-memory, but also to accelerate memory-bound
diff --git a/gnu/packages/connman.scm b/gnu/packages/connman.scm
index a13b6d199e..bc6328926a 100644
--- a/gnu/packages/connman.scm
+++ b/gnu/packages/connman.scm
@@ -107,7 +107,7 @@ (define-public connman
     (synopsis "Connection management daemon")
     (description "Connman provides a daemon for managing Internet connections.
 The Connection Manager is designed to be slim and to use as few resources as
-possible. It is fully modular system that can be extended through plug-ins.
+possible.  It is fully modular system that can be extended through plug-ins.
 The plug-in approach allows for easy adaption and modification for various use
 cases.  Connman implements DNS resolving and caching, DHCP clients for both
 IPv4 and IPv6, link-local IPv4 address handling and tethering (IP connection
diff --git a/gnu/packages/cran.scm b/gnu/packages/cran.scm
index c93df13675..6d8b60c639 100644
--- a/gnu/packages/cran.scm
+++ b/gnu/packages/cran.scm
@@ -25506,8 +25506,8 @@ (define-public r-hapassoc
     (synopsis "Inference of trait associations with SNP haplotypes")
     (description
      "Hapassoc performs likelihood inference of trait associations with
-haplotypes and other covariates in @dfn{generalized linear models} (GLMs). The
-functions are developed primarily for data collected in cohort or
+haplotypes and other covariates in @dfn{generalized linear models} (GLMs).
+The functions are developed primarily for data collected in cohort or
 cross-sectional studies.  They can accommodate uncertain haplotype phase and
 handle missing genotypes at some SNPs.")
     (license license:gpl2)))
@@ -28615,9 +28615,9 @@ (define-public r-systemfonts
     (description
      "This package provides system native access to the font catalogue.  As
 font handling varies between systems it is difficult to correctly locate
-installed fonts across different operating systems.  The 'systemfonts' package
-provides bindings to the native libraries for finding font files that can then
-be used further by e.g. graphic devices.")
+installed fonts across different operating systems.  The @emph{systemfonts}
+package provides bindings to the native libraries for finding font files that
+can then be used further by e.g. graphic devices.")
     (license license:expat)))
 
 (define-public r-graphlayouts
@@ -34195,7 +34195,7 @@ (define-public r-rstan
 and analyze Stan models by accessing the header-only Stan library provided by
 the StanHeaders package.  The Stan project develops a probabilistic
 programming language that implements full Bayesian statistical inference via
-Markov Chain Monte Carlo, rough Bayesian inference via 'variational'
+Markov Chain Monte Carlo, rough Bayesian inference via @emph{variational}
 approximation, and (optionally penalized) maximum likelihood estimation via
 optimization.  In all three cases, automatic differentiation is used to
 quickly and accurately evaluate gradients without burdening the user with the
@@ -35283,17 +35283,18 @@ (define-public r-brms
      "Bayesian Regression Models using 'Stan'")
     (description
      "Fit Bayesian generalized (non-)linear multivariate multilevel models
-using 'Stan' for full Bayesian inference. A wide range of distributions and
-link functions are supported, allowing users to fit -- among others -- linear,
-robust linear, count data, survival, response times, ordinal, zero-inflated,
-hurdle, and even self-defined mixture models all in a multilevel context.
-Further modeling options include non-linear and smooth terms, auto-correlation
-structures, censored data, meta-analytic standard errors, and quite a few
-more. In addition, all parameters of the response distribution can be
-predicted in order to perform distributional regression. Prior specifications
-are flexible and explicitly encourage users to apply prior distributions that
-actually reflect their beliefs. Model fit can easily be assessed and compared
-with posterior predictive checks and leave-one-out cross-validation.")
+using @emph{Stan} for full Bayesian inference. A wide range of distributions
+and link functions are supported, allowing users to fit -- among others --
+linear, robust linear, count data, survival, response times, ordinal,
+zero-inflated, hurdle, and even self-defined mixture models all in a
+multilevel context.  Further modeling options include non-linear and smooth
+terms, auto-correlation structures, censored data, meta-analytic standard
+errors, and quite a few more. In addition, all parameters of the response
+distribution can be predicted in order to perform distributional
+regression. Prior specifications are flexible and explicitly encourage users
+to apply prior distributions that actually reflect their beliefs. Model fit
+can easily be assessed and compared with posterior predictive checks and
+leave-one-out cross-validation.")
     (license license:gpl2)))
 
 (define-public r-mstate
@@ -35921,9 +35922,9 @@ (define-public r-iml
 @item Feature importance described by Fisher et al. (2018),
 @item accumulated local effects plots described by Apley (2018),
 @item partial dependence plots described by Friedman (2001),
-@item individual conditional expectation ('ice') plots described by Goldstein
+@item individual conditional expectation (@emph{ice}) plots described by Goldstein
   et al. (2013) @url{https://doi.org/10.1080/10618600.2014.907095},
-@item local models (variant of 'lime') described by Ribeiro et. al (2016),
+@item local models (variant of @emph{lime}) described by Ribeiro et. al (2016),
 @item the Shapley Value described by Strumbelj et. al (2014)
   @url{https://doi.org/10.1007/s10115-013-0679-x},
 @item feature interactions described by Friedman et. al
@@ -36971,10 +36972,10 @@ (define-public r-survminer
     (synopsis "Drawing survival curves using ggplot2")
     (description
      "This package contains the function @code{ggsurvplot()} for easily
-drawing beautiful and 'ready-to-publish' survival curves with the 'number at
-risk' table and 'censoring count plot'.  Other functions are also available to
-plot adjusted curves for Cox model and to visually examine Cox model
-assumptions.")
+drawing beautiful and @emph{ready-to-publish} survival curves with the
+@emph{number at risk} table and @emph{censoring count plot}.  Other functions
+are also available to plot adjusted curves for Cox model and to visually
+examine Cox model assumptions.")
     (license license:gpl2)))
 
 (define-public r-forge
@@ -38804,10 +38805,9 @@ (define-public r-lpme
       "https://cran.r-project.org/web/packages/lpme/")
     (synopsis "Nonparametric Estimation of Measurement Error Models")
     (description
-      "Provide nonparametric methods for mean regression model,
-modal regression and conditional density estimation in the
-presence/absence of measurement error. Bandwidth selection is
-also provided for each method.")
+      "Provide nonparametric methods for mean regression model, modal
+regression and conditional density estimation in the presence/absence of
+measurement error.  Bandwidth selection is also provided for each method.")
     (license license:gpl2+)))
 
 (define-public r-aws-signature
@@ -38831,7 +38831,7 @@ (define-public r-aws-signature
      "This package generates version 2 and 4 request signatures for Amazon Web
 Services (AWS) and provides a mechanism for retrieving credentials from
 environment variables, AWS credentials files, and EC2 instance metadata.  For
-use on EC2 instances, the package 'aws.ec2metadata' is suggested.")
+use on EC2 instances, the package @emph{aws.ec2metadata} is suggested.")
     (license license:gpl2+)))
 
 (define-public r-aws-s3
diff --git a/gnu/packages/crates-graphics.scm b/gnu/packages/crates-graphics.scm
index 42ba239bf5..e0b37b07fa 100644
--- a/gnu/packages/crates-graphics.scm
+++ b/gnu/packages/crates-graphics.scm
@@ -455,8 +455,8 @@ (define-public rust-avif-serialize-0.8
     (description
      "This package provides a minimal writer for AVIF header structure.  This
 is a tiny alternative to @code{libavif}.  It creates the jungle of
-MPEG/HEIF/MIAF/ISO-BMFF ``boxes'' as appropriate for AVIF files.  It supports
-alpha channel embedding.")
+MPEG/HEIF/MIAF/ISO-BMFF @emph{boxes} as appropriate for AVIF files.  It
+supports alpha channel embedding.")
     (license license:bsd-3)))
 
 (define-public rust-avif-serialize-0.7
@@ -5208,14 +5208,13 @@ (define-public rust-winit-0.29
     (home-page "https://github.com/rust-windowing/winit")
     (synopsis "Window creation library")
     (description
-     "Winit is a window creation and management library. It can create
-windows and lets you handle events (for example: the window being
-resized, a key being pressed, a mouse movement, etc.) produced by
-window.
+     "Winit is a window creation and management library.  It can create
+windows and lets you handle events (for example: the window being resized, a
+key being pressed, a mouse movement, etc.) produced by window.
 
 Winit is designed to be a low-level brick in a hierarchy of libraries.
-Consequently, in order to show something on the window you need to use
-the platform-specific getters provided by winit, or another library.")
+Consequently, in order to show something on the window you need to use the
+platform-specific getters provided by winit, or another library.")
     (license license:asl2.0)))
 
 (define-public rust-winit-0.28
diff --git a/gnu/packages/crates-io.scm b/gnu/packages/crates-io.scm
index 654667359d..509c3b52d9 100644
--- a/gnu/packages/crates-io.scm
+++ b/gnu/packages/crates-io.scm
@@ -2847,7 +2847,7 @@ (define-public rust-arr-macro-0.1
         ("rust-proc-macro-hack" ,rust-proc-macro-hack-0.5))))
     (home-page "https://github.com/JoshMcguigan/arr_macro")
     (synopsis "Initialize arrays with ease")
-    (description "Array macro helps initialize arrays. It is useful when
+    (description "Array macro helps initialize arrays.  It is useful when
 initializing large arrays (greater than 32 elements), or arrays of types which
 do not implement the copy or default traits.")
     (license (list license:expat license:asl2.0))))
@@ -5448,7 +5448,7 @@ (define-public rust-async-process-1
      "This crate is an async version of @code{std::process}.  A background
 thread named @code{async-process} is lazily created on first use, which waits
 for spawned child processes to exit and then calls the @code{wait()} syscall
-to clean up the ``zombie'' processes.
+to clean up the @emph{zombie} processes.
 
 This is unlike the process API in the standard library, where dropping
 a running Child leaks its resources.")
@@ -12151,7 +12151,7 @@ (define-public rust-chan-0.1
        #:cargo-inputs (("rust-rand" ,rust-rand-0.3))))
     (home-page "https://github.com/BurntSushi/chan")
     (synopsis "DEPRECATED. Use crossbeam-channel instead")
-    (description "DEPRECATED. Use crossbeam-channel instead.")
+    (description "DEPRECATED.  Use crossbeam-channel instead.")
     (license (list license:unlicense license:expat))))
 
 (define-public rust-chalk-derive-0.75
@@ -35273,8 +35273,8 @@ (define-public rust-is-debug-1
     (build-system cargo-build-system)
     (arguments `(#:skip-build? #t))
     (home-page "https://github.com/baoyachi/rust_is_debug")
-    (description "get build model is debug")
     (synopsis "Get build model is debug")
+    (description "Get build model is debug.")
     (license (list license:expat license:asl2.0))))
 
 (define-public rust-is-docker-0.2
@@ -42998,8 +42998,8 @@ (define-public rust-minimal-lexical-0.2
     (home-page "https://github.com/Alexhuszagh/minimal-lexical")
     (synopsis "Float parsing conversion routines")
     (description "This is a minimal version of rust-lexical, meant to allow
-efficient round-trip float parsing. Minimal-lexical implements a correct, fast
-float parser.")
+efficient round-trip float parsing.  Minimal-lexical implements a correct,
+fast float parser.")
     (license (list license:expat license:asl2.0))))
 
 (define-public rust-minimp3-0.5
@@ -74940,8 +74940,8 @@ (define-public rust-stringprep-0.1
     (home-page "https://github.com/sfackler/rust-stringprep")
     (synopsis "Implementation of the ``stringprep'' algorithm")
     (description
-     "This package provides an implementation of the ``stringprep'' algorithm
-as defined in RFC 3454.")
+     "This package provides an implementation of the @emph{stringprep}
+algorithm as defined in RFC 3454.")
     (license (list license:expat license:asl2.0))))
 
 (define-public rust-strip-ansi-escapes-0.2
diff --git a/gnu/packages/crates-web.scm b/gnu/packages/crates-web.scm
index 6b1e6928e1..5a30f2e3b4 100644
--- a/gnu/packages/crates-web.scm
+++ b/gnu/packages/crates-web.scm
@@ -2956,7 +2956,7 @@ (define-public rust-hickory-recursor-0.24
     (synopsis
      "Hickory DNS Recursor is a DNS recursive resolver with DNSSEC support")
     (description
-     "*WARNING* This library is experimental
+     "@emph{WARNING} This library is experimental
 
 Hickory DNS Recursor is a safe and secure DNS recursive resolver with DNSSEC
 support.  Hickory DNS is based on the Tokio and Futures libraries, which means
diff --git a/gnu/packages/crypto.scm b/gnu/packages/crypto.scm
index 2a298c4caf..4088944b92 100644
--- a/gnu/packages/crypto.scm
+++ b/gnu/packages/crypto.scm
@@ -1664,11 +1664,10 @@ (define-public libxcrypt
     (synopsis
      "Extended crypt library for descrypt, md5crypt, bcrypt, and others")
     (description
-     "libxcrypt is a modern library for one-way hashing of
-passwords. It supports a wide variety of both modern and historical
-hashing methods: yescrypt, gost-yescrypt, scrypt, bcrypt, sha512crypt,
-sha256crypt, md5crypt, SunMD5, sha1crypt, NT, bsdicrypt, bigcrypt, and
-descrypt.")
+     "libxcrypt is a modern library for one-way hashing of passwords.  It
+supports a wide variety of both modern and historical hashing methods:
+yescrypt, gost-yescrypt, scrypt, bcrypt, sha512crypt, sha256crypt, md5crypt,
+SunMD5, sha1crypt, NT, bsdicrypt, bigcrypt, and descrypt.")
     (home-page "https://github.com/besser82/libxcrypt")
     (license license:lgpl2.1)))
 
diff --git a/gnu/packages/databases.scm b/gnu/packages/databases.scm
index 06158f19e7..4779c238d8 100644
--- a/gnu/packages/databases.scm
+++ b/gnu/packages/databases.scm
@@ -2932,7 +2932,7 @@ (define-public guile-wiredtiger
      (list guile2.2-bytestructures))
     (synopsis "WiredTiger bindings for GNU Guile")
     (description
-     "This package provides Guile bindings to the WiredTiger ``NoSQL''
+     "This package provides Guile bindings to the WiredTiger @emph{NoSQL}
 database.")
     (home-page "https://framagit.org/a-guile-mind/guile-wiredtiger")
     (license license:gpl3+)))
diff --git a/gnu/packages/display-managers.scm b/gnu/packages/display-managers.scm
index 5152eb6479..c2b3ffdb37 100644
--- a/gnu/packages/display-managers.scm
+++ b/gnu/packages/display-managers.scm
@@ -190,7 +190,7 @@ (define-public abstractdark-sddm-theme
       (synopsis "Abstract Dark theme for SDDM")
       (description
        "This package provides a minimalistic dark theme for SDDM, black
-background with abstract shapes. Inspired by solarized-sddm-theme.")
+background with abstract shapes.  Inspired by solarized-sddm-theme.")
       (license license:gpl3+))))
 
 (define-public dexy-color-sddm-theme
diff --git a/gnu/packages/docker.scm b/gnu/packages/docker.scm
index b49dc58bd0..a10ab3d1d0 100644
--- a/gnu/packages/docker.scm
+++ b/gnu/packages/docker.scm
@@ -800,7 +800,7 @@ (define-public docker-registry
     (home-page "https://github.com/docker/distribution")
     (synopsis "Docker registry server and associated tools")
     (description "The Docker registry server enable you to host your own
-docker registry. With it, there is also two other utilities:
+docker registry.  With it, there is also two other utilities:
 @itemize
 @item The digest utility is a tool that generates checksums compatibles with
 various docker manifest files.
diff --git a/gnu/packages/elm.scm b/gnu/packages/elm.scm
index a74d294ae5..6bad22e154 100644
--- a/gnu/packages/elm.scm
+++ b/gnu/packages/elm.scm
@@ -775,7 +775,7 @@ (define-public elm-terezka-intervals
     (description
      "This package provides an Elm library for producing nice intervals for
 charts.  It's useful in combination with @code{terezka/elm-charts}.  When I
-say ``nice'', I just mean that I try to calculate intervals which begin with
+say \"nice\", I just mean that I try to calculate intervals which begin with
 10, 5, 3, 2, or 1 (adjusted to magnitude, of course!).  For dates, I try to
 hit whole days, weeks, and months or hours, minutes, and seconds.")
     (license license:bsd-3)))
diff --git a/gnu/packages/emacs-xyz.scm b/gnu/packages/emacs-xyz.scm
index 620363fd31..ceaf424a6f 100644
--- a/gnu/packages/emacs-xyz.scm
+++ b/gnu/packages/emacs-xyz.scm
@@ -449,7 +449,7 @@ (define-public emacs-bookmark-plus
     (synopsis "Extensions to the Bookmark library in Emacs")
     (description
      "Bookmarks are a powerful Emacs feature.  This package makes them even
-more versatile. You can bookmark many more kinds of data.  You can add tags.
+more versatile.  You can bookmark many more kinds of data.  You can add tags.
 There are many more ways to organize and display your bookmarks.  I recommend
 reading the extensive documentation about BookmarkPlus on the Emacs Wiki.")
     (license license:gpl3+)))
@@ -3385,9 +3385,10 @@ (define-public emacs-xah-fly-keys
       (home-page "http://xahlee.info/emacs/misc/ergoemacs_vi_mode.html")
       (synopsis "Modal keybinding system for Emacs, based on command frequency and
 ergonomics")
-      (description "xah-fly-keys.el is a modal editing mode for Emacs, like Vi,
-but the design of key/command choice is based on command frequency statistics
-and ease-of-key score.  Most frequently used commands have most easy keys.")
+      (description "@emph{xah-fly-keys.el} is a modal editing mode for Emacs,
+like Vi, but the design of key/command choice is based on command frequency
+statistics and ease-of-key score.  Most frequently used commands have most
+easy keys.")
       (license license:gpl3))))
 
 (define-public emacs-xr
@@ -4618,7 +4619,7 @@ (define-public emacs-dhall-mode
       (synopsis "Major mode for working with Dhall configuration language")
       (description
        "Dhall-mode provides an Emacs Major mode for working with the Dhall
-configuration language. It features:
+configuration language.  It features:
 
 @itemize
 @item Syntax highlighting
@@ -4723,10 +4724,10 @@ (define-public emacs-aio
      (list emacs-elfeed emacs-skewer-mode))
     (home-page "https://github.com/skeeto/emacs-aio")
     (synopsis "Async/Await for Emacs Lisp")
-    (description "@code{aio} is to Emacs Lisp as @code{asyncio} is to
-Python. This package builds upon Emacs generators to provide functions that
-pause while they wait on asynchronous events.  They do not block any thread
-while paused.")
+    (description "@code{aio} is to Emacs Lisp as @code{asyncio} is to Python.
+This package builds upon Emacs generators to provide functions that pause
+while they wait on asynchronous events.  They do not block any thread while
+paused.")
     (license license:unlicense)))
 
 (define-public emacs-async
@@ -6623,11 +6624,11 @@ (define-public emacs-ligature
       (home-page "https://github.com/mickeynp/ligature.el")
       (synopsis "Typographic ligatures in Emacs")
       (description
-       "This package maps ordinary graphemes (characters) to fancy
-ligatures, if both your version of Emacs and the font supports it.  With this
-package you can control where Emacs must display ligatures. That is useful if
-you only want a subset of the ligatures in certain major modes, for instance,
-or if you want to ensure that some modes have no ligatures at all.")
+       "This package maps ordinary graphemes (characters) to fancy ligatures,
+if both your version of Emacs and the font supports it.  With this package you
+can control where Emacs must display ligatures.  That is useful if you only
+want a subset of the ligatures in certain major modes, for instance, or if you
+want to ensure that some modes have no ligatures at all.")
       (license license:gpl3+))))
 
 (define-public emacs-olivetti
@@ -7284,7 +7285,7 @@ (define-public emacs-gdscript-mode
     (synopsis "GDScript support and syntax highlighting in Emacs")
     (description
      "This package adds support for the GDScript programming language from the
-Godot game engine in Emacs. It features all the essentials, e.g., syntax
+Godot game engine in Emacs.  It features all the essentials, e.g., syntax
 highlighting, code folding, indentation, automatic pairing, auto-completion,
 and code formatting.")
     (license license:gpl3+)))
@@ -9677,7 +9678,7 @@ (define-public emacs-ob-asymptote
      "This package provides Org Babel support for evaluating Asymptote source
 code.  This differs from most standard languages in that:
 @itemize
-@item there is no such thing as a ``session'' in Asymptote,
+@item there is no such thing as a @emph{session} in Asymptote,
 @item we are generally only going to return results of type @code{file},
 @item we are adding the @code{file} and @code{cmdline} header arguments, if
 file is omitted then the @samp{-V} option is passed to the @command{asy}
@@ -13991,8 +13992,8 @@ (define-public emacs-swiper
 The search regex can be split into groups with a space.  Each group is
 highlighted with a different face.
 
-It can double as a quick `regex-builder', although only single lines will be
-matched.")
+It can double as a quick @code{regex-builder}, although only single lines will
+be matched.")
     (license license:gpl3+)))
 
 (define-public emacs-ivy-xref
@@ -15444,7 +15445,7 @@ (define-public emacs-elfeed-goodies
         emacs-link-hint))
       (home-page "https://github.com/jeetelongname/elfeed-goodies")
       (synopsis
-       "Various bits and pieces to enhance the Elfeed user experience.")
+       "Various bits and pieces to enhance the Elfeed user experience")
       (description
        "This package enhances the vanilla Elfeed user experience with:
 @itemize @bullet
@@ -15603,7 +15604,7 @@ (define-public emacs-el-x
              #t)))))
     (home-page "https://github.com/sigma/el-x")
     (synopsis "Emacs Lisp extensions")
-    (description "command@{emacs-el-x} defines the @code{dflet} macro to
+    (description "@command{emacs-el-x} defines the @code{dflet} macro to
 provide the historic behavior of @code{flet}, as well as
 @code{declare-function} stub for older Emacs.")
     (license license:gpl2+)))
@@ -15627,11 +15628,11 @@ (define-public emacs-epithet
       (home-page "https://github.com/oantolin/epithet")
       (synopsis "Rename Emacs buffers with descriptive names")
       (description
-       "This package provides a function---@code{epithet-rename-buffer}---to rename
-the current buffer with a descriptive name. The name suggestion is governed by
-the @code{epithet-suggesters} hook variable: each hook should return either a
-name suggestion or @code{nil}, they are called in turn and the first non-nil
-suggestion is taken.")
+       "This package provides a function---@code{epithet-rename-buffer}---to
+rename the current buffer with a descriptive name.  The name suggestion is
+governed by the @code{epithet-suggesters} hook variable: each hook should
+return either a name suggestion or @code{nil}, they are called in turn and the
+first non-nil suggestion is taken.")
       (license license:gpl3+))))
 
 (define-public emacs-eterm-256color
@@ -15827,8 +15828,8 @@ (define-public emacs-pyvenv
      (list emacs-ert-runner emacs-mocker))
     (home-page "https://github.com/jorgenschaefer/pyvenv")
     (synopsis "Python virtual environment interface for Emacs")
-    (description "pyvenv.el is a minor mode to support using Python virtual
-environments (virtualenv) inside Emacs.")
+    (description "@emph{pyvenv.el} is a minor mode to support using Python
+virtual environments (virtualenv) inside Emacs.")
     (license license:gpl3+)))
 
 (define-public emacs-highlight-indent-guides
@@ -18174,7 +18175,7 @@ (define-public emacs-flx
      "Flx provides fuzzy matching for emacs a la sublime text.
 The sorting algorithm is a balance between word beginnings (abbreviation)
 and contiguous matches (substring).  The longer the substring match,
-the higher it scores. This maps well to how we think about matching.
+the higher it scores.  This maps well to how we think about matching.
 Flx has support for ido (interactively do things) through flx-ido.")
     (license license:gpl3+)))
 
@@ -18673,7 +18674,7 @@ (define-public emacs-beframe
       (description
        "Beframe enables a frame-oriented Emacs workflow where each frame has
 access to the list of buffers visited therein.  In the interest of brevity, we
-call buffers that belong to frames ``beframed''.  Producing multiple frames
+call buffers that belong to frames \"beframed\".  Producing multiple frames
 does not generate multiple buffer lists.  There still is only one global list
 of buffers.  Beframing them simply filters the list.")
       (license (list license:gpl3+
@@ -18720,7 +18721,7 @@ (define-public emacs-gnosis
     (synopsis "Spaced repetition system for GNU Emacs")
     (description
      "Gnosis is a spaced repetition system for note-taking and self-testing
-where notes are formatted as Question/Answer/Explanation. Notes are reviewed
+where notes are formatted as Question/Answer/Explanation.  Notes are reviewed
 at spaced intervals based on the success or failure in recalling the answer to
 each question.")
     (license license:gpl3+)))
@@ -22387,10 +22388,10 @@ (define-public emacs-envrc
     (description
      "This is library which uses Direnv to set environment variables on
 a per-buffer basis.  This means that when you work across multiple projects
-which have @file{.envrc} files, all processes launched from the buffers ``in''
-those projects will be executed with the environment variables specified in
-those files.  This allows different versions of linters and other tools to be
-used in each project if desired.")
+which have @file{.envrc} files, all processes launched from the buffers
+@emph{in} those projects will be executed with the environment variables
+specified in those files.  This allows different versions of linters and other
+tools to be used in each project if desired.")
     (license license:gpl3+)))
 
 (define-public emacs-prop-menu
@@ -25122,16 +25123,15 @@ (define-public emacs-citar-org-roam
     (propagated-inputs (list emacs-citar emacs-org-roam))
     (home-page "https://github.com/emacs-citar/citar-org-roam")
     (synopsis "Emacs package to provide tighter Citar and Org-Roam integration")
-    (description "\
-Out-of-box, Citar provides default support for file-per-note bibliographic
-notes that are compatible with Org-Roam v2.  This package integrates directly
-with the Org-Roam database, and provides the following additional features to
-Citar note support:
+    (description "Out-of-box, Citar provides default support for file-per-note
+bibliographic notes that are compatible with Org-Roam v2.  This package
+integrates directly with the Org-Roam database, and provides the following
+additional features to Citar note support:
 @itemize
 @item multiple references per note
 @item multiple reference notes per file
 @item ability to query note citations by reference
-@item ``live'' updating of Citar UI for presence of notes
+@item \"live\" updating of Citar UI for presence of notes
 @end itemize")
     (license license:gpl3+)))
 
@@ -25939,7 +25939,7 @@ (define-public emacs-kind-icon
     (home-page "https://github.com/jdtsmith/kind-icon")
     (synopsis "Completion kind icons in Emacs")
     (description "Kind-icon mode adds a colorful icon or text prefix based on
-@code{:company-kind} for compatible completion UIs.  The ``kind'' prefix is
+@code{:company-kind} for compatible completion UIs.  The @code{kind} prefix is
 typically used for differentiating completion candidates such as variables or
 functions.")
     (license license:gpl3+)))
@@ -26940,7 +26940,7 @@ (define-public emacs-vcsh
     (home-page "https://gitlab.com/stepnem/vcsh-el")
     (synopsis "Emacs VCSH integration")
     (description
-     "This library provides basic ``enter'' functionality and a few
+     "This library provides basic @code{enter} functionality and a few
 convenience commands to initialize a @acronym{VCSH, Version Control System for
 $HOME} repository and add files to it.  It can be used in conjunction with
 Magit.")
@@ -30193,7 +30193,7 @@ (define-public emacs-org-web-tools
 for retrieving web page content and processing it into Org mode content.
 
 For example, you can copy a URL to the clipboard or kill-ring, then run
-a command that downloads the page, isolates the ``readable'' content with
+a command that downloads the page, isolates the @emph{readable} content with
 @command{eww-readable}, converts it to Org mode content with Pandoc, and
 displays it in an Org mode buffer.  Another command does all of that but
 inserts it as an Org entry instead of displaying it in a new buffer.")
@@ -33813,7 +33813,7 @@ (define-public emacs-org-drill-table
       (synopsis "Generate Org drill cards using Org mode tables")
       (description
        "This package generates drill cards based on an Org mode table in the
-current subtree.  The cards are inserted under a new ``Cards'' heading in the
+current subtree.  The cards are inserted under a new @emph{Cards} heading in the
 current tree.")
       (license license:gpl3+))))
 
@@ -34580,20 +34580,20 @@ (define-public emacs-nhexl-mode
 
 This minor mode implements similar functionality to @command{hexl-mode},
 but using a different implementation technique, which makes it
-usable as a \"plain\" minor mode.  It works on any buffer, and does
+usable as a @emph{plain} minor mode.  It works on any buffer, and does
 not mess with the undo log or with the major mode.
 
 It also comes with:
 
 @itemize
-@item @command{nhexl-nibble-edit-mode}: a \"nibble editor\" minor mode, where
-the cursor pretends to advance by nibbles (4-bit) and the self-insertion keys
-(which only work for hex-digits) will only modify the nibble under point.
+@item @command{nhexl-nibble-edit-mode}: a @emph{nibble editor} minor mode,
+where the cursor pretends to advance by nibbles (4-bit) and the self-insertion
+keys (which only work for hex-digits) will only modify the nibble under point.
 @item @command{nhexl-overwrite-only-mode}: a minor mode to try and avoid
 moving text.  In this minor mode, not only self-inserting keys overwrite
-existing text, but commands like `yank' and @command{kill-region} as well.
-@item It overrides @code{C-u} to use hexadecimal, so you can do @code{C-u a 4
-C-f} to advance by #xa4 characters.
+existing text, but commands like @command{yank} and @command{kill-region} as
+well.  @item It overrides @code{C-u} to use hexadecimal, so you can do
+@code{C-u a 4 C-f} to advance by #xa4 characters.
 @end itemize")
     (license license:gpl3+)))
 
@@ -38716,8 +38716,8 @@ (define-public emacs-trashed
     (synopsis "View and edit system trash can in Emacs")
     (description "Open, view, browse, restore or permanently delete trashed
 files or directories in trash can with Dired-like look and feel.  The trash
-can has to be compliant with freedesktop.org. In Emacs, you can trash files by
-deleting them with @code{(setq delete-by-moving-to-trash t)}.  This package
+can has to be compliant with freedesktop.org.  In Emacs, you can trash files
+by deleting them with @code{(setq delete-by-moving-to-trash t)}.  This package
 provides a simple but convenient user interface to manage those trashed
 files.")
     (license license:gpl3+)))
@@ -39990,9 +39990,9 @@ (define-public emacs-ivy-hydra
     (home-page "https://github.com/abo-abo/swiper")
     (synopsis "Additional key bindings for Ivy")
     (description
-     "This package provides the `hydra-ivy/body' command, which is a
-quasi-prefix map, with many useful bindings.  These bindings are
-shorter than usual, using mostly unprefixed keys.")
+     "This package provides the @command{hydra-ivy/body} command, which is a
+quasi-prefix map, with many useful bindings.  These bindings are shorter than
+usual, using mostly unprefixed keys.")
     (license license:gpl3+)))
 
 (define-public emacs-cwl-mode
@@ -40468,7 +40468,7 @@ (define-public emacs-citre
     (synopsis "Ctags IDE on Emacs")
     (description
      "Citre is an advanced Ctags (or actually, readtags) frontend for
-Emacs. It offers Completion At Point, Xref and Imenu integration.  It also
+Emacs.  It offers Completion At Point, Xref and Imenu integration.  It also
 provides a Completing Read UI for jumping to definition and a powerful code
 reading tool that lets you go down the rabbit hole without leaving current
 buffer.")
@@ -41395,8 +41395,8 @@ (define-public emacs-waveform
       (home-page "https://github.com/sachac/waveform-el/")
       (synopsis "Display a waveform and use it to navigate")
       (description
-       "This package displays a waveform of a sound file. You can then play or
-navigate through it.")
+       "This package displays a waveform of a sound file.  You can then play
+or navigate through it.")
       (license license:gpl3+))))
 
 (define-public emacs-project-x
diff --git a/gnu/packages/emulators.scm b/gnu/packages/emulators.scm
index f0a60c0b49..4bdd0ae9d6 100644
--- a/gnu/packages/emulators.scm
+++ b/gnu/packages/emulators.scm
@@ -3672,7 +3672,7 @@ (define-public ppsspp
     (home-page "https://www.ppsspp.org/")
     (synopsis "PSP emulator")
     (description
-     "PPSSPP is a ``high-level'' emulator simulating the PSP operating
+     "PPSSPP is a @emph{high-level} emulator simulating the PSP operating
 system.")
     (license license:gpl2+)))
 
diff --git a/gnu/packages/fonts.scm b/gnu/packages/fonts.scm
index 65232db3b8..ade214b739 100644
--- a/gnu/packages/fonts.scm
+++ b/gnu/packages/fonts.scm
@@ -3300,8 +3300,8 @@ (define-public font-bravura
 the W3C Standard Music Font Layout (SMuFL).  Bravura draws on the heritage of
 the finest European music engraving of the 19th and early 20th centuries, with
 a bolder and more substantial look than most other music fonts: thin strokes
-are slightly thicker than in other fonts, improving the overall ``blackness''
-of the font and its legibility when read at a distance.
+are slightly thicker than in other fonts, improving the overall
+@emph{blackness} of the font and its legibility when read at a distance.
 
 In addition to Bravura itself, which is for use with music notation
 software (such as MuseScore), the family includes a Bravura Text variant
diff --git a/gnu/packages/fpga.scm b/gnu/packages/fpga.scm
index c812ed3b7e..7920fe86e5 100644
--- a/gnu/packages/fpga.scm
+++ b/gnu/packages/fpga.scm
@@ -556,10 +556,10 @@ (define-public verilator
     (synopsis "Fast Verilog/SystemVerilog simulator")
     (description
      "Verilator is invoked with parameters similar to GCC or Synopsys’s VCS.
-It ``Verilates'' the specified Verilog or SystemVerilog code by reading it,
+It @emph{verilates} the specified Verilog or SystemVerilog code by reading it,
 performing lint checks, and optionally inserting assertion checks and
 coverage-analysis points.  It outputs single- or multi-threaded @file{.cpp}
-and @file{.h} files, the ``Verilated'' code.
+and @file{.h} files, the @emph{verilated} code.
 
 The user writes a little C++/SystemC wrapper file, which instantiates the
 Verilated model of the user’s top level module.  These C++/SystemC files are
diff --git a/gnu/packages/freedesktop.scm b/gnu/packages/freedesktop.scm
index 0ab0bb5104..3a723a9ab6 100644
--- a/gnu/packages/freedesktop.scm
+++ b/gnu/packages/freedesktop.scm
@@ -2504,7 +2504,7 @@ (define-public xdg-user-dirs
     (home-page "https://www.freedesktop.org/wiki/Software/xdg-user-dirs/")
     (synopsis "Tool to help manage \"well known\" user directories")
     (description "xdg-user-dirs is a tool to help manage \"well known\" user
-directories, such as the desktop folder or the music folder. It also handles
+directories, such as the desktop folder or the music folder.  It also handles
 localization (i.e. translation) of the file names.  Designed to be
 automatically run when a user logs in, xdg-user-dirs can also be run
 manually by a user.")
diff --git a/gnu/packages/game-development.scm b/gnu/packages/game-development.scm
index ee869c9cc5..8782e05381 100644
--- a/gnu/packages/game-development.scm
+++ b/gnu/packages/game-development.scm
@@ -288,7 +288,7 @@ (define-public deutex
    (home-page "https://github.com/Doom-Utils/deutex")
    (synopsis "WAD file composer for Doom and related games")
    (description
-    "DeuTex is a wad composer for Doom, Heretic, Hexen and Strife. It can be
+    "DeuTex is a wad composer for Doom, Heretic, Hexen and Strife.  It can be
 used to extract the lumps of a wad and save them as individual files.
 Conversely, it can also build a wad from separate files.  When extracting a
 lump to a file, it does not just copy the raw data, it converts it to an
@@ -353,7 +353,7 @@ (define-public grfcodec
       (synopsis "GRF development tools")
       (description
        "The @dfn{Graphics Resource File} (GRF) development tools are a set of
-tools for developing (New)GRFs. It includes a number of smaller programs, each
+tools for developing (New)GRFs.  It includes a number of smaller programs, each
 with a specific task:
 @enumerate
 @item @code{grfcodec} decodes and encodes GRF files for OpenTTD.
diff --git a/gnu/packages/games.scm b/gnu/packages/games.scm
index c40a574c3b..54257c7126 100644
--- a/gnu/packages/games.scm
+++ b/gnu/packages/games.scm
@@ -7118,7 +7118,7 @@ (define-public chroma
      (list pkg-config))
     (home-page "http://level7.org.uk/chroma/")
     (synopsis "Abstract puzzle game")
-    (description "Chroma is an abstract puzzle game. A variety of colourful
+    (description "Chroma is an abstract puzzle game.  A variety of colourful
 shapes are arranged in a series of increasingly complex patterns, forming
 fiendish traps that must be disarmed and mysterious puzzles that must be
 manipulated in order to give up their subtle secrets.  Initially so
@@ -11415,8 +11415,8 @@ (define-public passage
      "Passage is meant to be a memento mori game.  It presents an entire life,
 from young adulthood through old age and death, in the span of five minutes.
 Of course, it's a game, not a painting or a film, so the choices that you make
-as the player are crucial.  There's no ``right'' way to play Passage, just as
-there's no right way to interpret it.")
+as the player are crucial.  There's no @emph{right} way to play Passage, just
+as there's no right way to interpret it.")
     (license license:public-domain)))
 
 (define-public paperview
diff --git a/gnu/packages/geo.scm b/gnu/packages/geo.scm
index affa50c515..77e8cf59b8 100644
--- a/gnu/packages/geo.scm
+++ b/gnu/packages/geo.scm
@@ -2017,7 +2017,7 @@ (define-public xygrib
      "XyGrib is a Grib file reader and visualizes meteorological data providing
 an off-line capability to analyse weather forecasts or hindcasts.  It is
 intended to be used as a capable weather work station for anyone with a serious
-interest in examining weather. This would include members of the sailing
+interest in examining weather.  This would include members of the sailing
 community, private and sport aviators, farmers, weather buffs and many more.
 XyGrib is the continuation of the zyGrib software package with a new team of
 volunteers.")
diff --git a/gnu/packages/gnunet.scm b/gnu/packages/gnunet.scm
index cf731f3fcc..ede16f8901 100644
--- a/gnu/packages/gnunet.scm
+++ b/gnu/packages/gnunet.scm
@@ -351,11 +351,11 @@ (define-public gnunet-scheme
                          guile-quickcheck)) ;for tests
     (synopsis "Guile implementation of GNUnet client libraries")
     (description
-     "This package provides Guile modules for connecting to various
-GNUnet services. It also has infrastructure for writing new GNUnet services and
-connecting to them and can be used from multi-threaded environments.  It is not
-to be confused with @code{guile-gnunet} -- @code{guile-gnunet} supports a different
-set of services.
+     "This package provides Guile modules for connecting to various GNUnet
+services.  It also has infrastructure for writing new GNUnet services and
+connecting to them and can be used from multi-threaded environments.  It is
+not to be confused with @code{guile-gnunet} -- @code{guile-gnunet} supports a
+different set of services.
 
 The following services are supported:
 
diff --git a/gnu/packages/golang-check.scm b/gnu/packages/golang-check.scm
index 3ebb8f20a5..8888e6d3e7 100644
--- a/gnu/packages/golang-check.scm
+++ b/gnu/packages/golang-check.scm
@@ -1077,7 +1077,7 @@ (define-public go-github.com-smartystreets-goconvey
      (list go-github-com-jtolds-gls go-github.com-smartystreets-assertions))
     (home-page "https://github.com/smartystreets/goconvey")
     (synopsis "Go testing tool with both a web and terminal user interface")
-    (description "GoConvey is a testing tool for Go. It integrates with go
+    (description "GoConvey is a testing tool for Go.  It integrates with go
 test, can show test coverage and has a web user interface that will refresh
 automatically.")
     (license license:expat)))
diff --git a/gnu/packages/golang-web.scm b/gnu/packages/golang-web.scm
index 931d926e57..bf2726326a 100644
--- a/gnu/packages/golang-web.scm
+++ b/gnu/packages/golang-web.scm
@@ -2659,7 +2659,7 @@ (define-public go-github-com-jsimonetti-rtnetlink
     (synopsis "Low-level access to the Linux rtnetlink API")
     (description
      "This package allows the kernel's routing tables to be read and
-altered. Network routes, IP addresses, Link parameters, Neighbor
+altered.  Network routes, IP addresses, Link parameters, Neighbor
 setups,Queueing disciplines, Traffic classes and Packet classifiers may all be
 controlled.  It is based on netlink messages.")
     (license license:expat)))
diff --git a/gnu/packages/golang-xyz.scm b/gnu/packages/golang-xyz.scm
index f8584359c4..dbca5404db 100644
--- a/gnu/packages/golang-xyz.scm
+++ b/gnu/packages/golang-xyz.scm
@@ -1597,9 +1597,9 @@ (define-public go-github-com-containerd-cgroups
     (synopsis "Cgroups for Golang")
     (description
      "This package implements a functinoality for creating, managing,
-inspecting, and destroying cgroups. The resources format for settings on the
+inspecting, and destroying cgroups.  The resources format for settings on the
 cgroup uses the OCI runtime-spec found
-@url{https://github.com/opencontainers/runtime-spec,here}.")
+@url{https://github.com/opencontainers/runtime-spec, here}.")
     (license license:asl2.0)))
 
 (define-public go-github-com-containerd-fifo
@@ -6263,7 +6263,7 @@ (define-public go-github-com-songmu-gitconfig
     (home-page "https://github.com/songmu/gitconfig")
     (synopsis "Go library to get configuration values from gitconfig")
     (description
-     "@{gitconfig} is a package to get configuration values from gitconfig.")
+     "@emph{gitconfig} is a package to get configuration values from gitconfig.")
     (license license:expat)))
 
 (define-public go-github-com-soniakeys-quant
@@ -7729,7 +7729,7 @@ (define-public go-tomlv
       #:unpack-path "github.com/BurntSushi/toml"))
     (description
      (string-append (package-description go-github-com-burntsushi-toml)
-                    " This package provides an command line interface (CLI)
+                    "  This package provides an command line interface (CLI)
 tool."))))
 
 (define-public go-ulid
@@ -7745,7 +7745,7 @@ (define-public go-ulid
      (list go-github-com-pborman-getopt))
     (description
      (string-append (package-description go-github-com-oklog-ulid)
-                    " This package provides an command line interface (CLI)
+                    "  This package provides an command line interface (CLI)
 tool."))))
 
 ;;;
diff --git a/gnu/packages/golang.scm b/gnu/packages/golang.scm
index 7dbafd9bcb..9513b1d69d 100644
--- a/gnu/packages/golang.scm
+++ b/gnu/packages/golang.scm
@@ -7828,10 +7828,9 @@ (define-public go-sigs-k8s-io-yaml
     (description
      "This package provides a Go library that first converts YAML to JSON
 using @code{go-yaml} and then uses @code{json.Marshal} and
-@code{json.Unmarshal} to convert to or from the struct. This means that
-it effectively reuses the JSON struct tags as well as the custom JSON
-methods @code{MarshalJSON} and @code{UnmarshalJSON} unlike
-@code{go-yaml}.
+@code{json.Unmarshal} to convert to or from the struct.  This means that it
+effectively reuses the JSON struct tags as well as the custom JSON methods
+@code{MarshalJSON} and @code{UnmarshalJSON} unlike @code{go-yaml}.
 
 kubernetes-sigs/yaml is a permanent fork of
 @url{https://github.com/ghodss/yaml,ghodss/yaml}.")
diff --git a/gnu/packages/guile.scm b/gnu/packages/guile.scm
index 8dabbb2c5e..d7ad4bf7d2 100644
--- a/gnu/packages/guile.scm
+++ b/gnu/packages/guile.scm
@@ -994,8 +994,8 @@ (define-public guile-zstd
     (inputs (list `(,zstd "lib") guile-3.0))
     (synopsis "GNU Guile bindings to the zstd compression library")
     (description
-     "This package provides a GNU Guile interface to the zstd (``zstandard'')
-compression library.")
+     "This package provides a GNU Guile interface to the zstd
+(@emph{zstandard}) compression library.")
     (license license:gpl3+)))
 
 (define-public guile-lzma
diff --git a/gnu/packages/haskell-check.scm b/gnu/packages/haskell-check.scm
index 6f6ac3fd08..44da569bfa 100644
--- a/gnu/packages/haskell-check.scm
+++ b/gnu/packages/haskell-check.scm
@@ -355,7 +355,7 @@ (define-public ghc-tasty-expected-failure
     (description
      "With the function @code{Test.Tasty.ExpectedFailure.expectFail} in the
 provided module @code{Test.Tasty.ExpectedFailure}, you can mark that you
-expect test cases to fail, and not to pass. This can be used for test-driven
+expect test cases to fail, and not to pass.  This can be used for test-driven
 development.")
     (license license:expat)))
 
@@ -1069,21 +1069,19 @@ (define-public ghc-quickcheck-classes-base
     (home-page "https://github.com/andrewthad/quickcheck-classes#readme")
     (synopsis "QuickCheck common typeclasses from `base`")
     (description
-      "This library is a minimal variant of `quickcheck-classes`
-that only provides laws for typeclasses from `base`. The main
-purpose of splitting this out is so that `primitive` can depend
-on `quickcheck-classes-base` in its test suite, avoiding the
-circular dependency that arises if `quickcheck-classes` is used
-instead. . This library provides QuickCheck properties to ensure
-that typeclass instances adhere to the set of laws that they are
-supposed to. There are other libraries that do similar things,
-such as `genvalidity-hspec` and `checkers`. This library differs
-from other solutions by not introducing any new typeclasses that
-the user needs to learn. . /Note:/ on GHC < 8.5, this library
-uses the higher-kinded typeclasses ('Data.Functor.Classes.Show1',
-'Data.Functor.Classes.Eq1', 'Data.Functor.Classes.Ord1', etc.),
-but on GHC >= 8.5, it uses `-XQuantifiedConstraints` to express
-these constraints more cleanly.")
+      "This library is a minimal variant of `quickcheck-classes` that only
+provides laws for typeclasses from `base`.  The main purpose of splitting this
+out is so that `primitive` can depend on `quickcheck-classes-base` in its test
+suite, avoiding the circular dependency that arises if `quickcheck-classes` is
+used instead.  This library provides QuickCheck properties to ensure that
+typeclass instances adhere to the set of laws that they are supposed to.
+There are other libraries that do similar things, such as `genvalidity-hspec`
+and `checkers`.  This library differs from other solutions by not introducing
+any new typeclasses that the user needs to learn.  @emph{Note:} on GHC < 8.5,
+this library uses the higher-kinded typeclasses
+(@code{Data.Functor.Classes.Show1}, @code{Data.Functor.Classes.Eq1},
+@code{Data.Functor.Classes.Ord1}, etc.), but on GHC >= 8.5, it uses
+`-XQuantifiedConstraints` to express these constraints more cleanly.")
     (license license:bsd-3)))
 
 (define-public ghc-doctest-lib
@@ -1101,7 +1099,7 @@ (define-public ghc-doctest-lib
     (home-page "https://hub.darcs.net/thielema/doctest-lib/")
     (synopsis "Parts of doctest exposed as library")
     (description
-      "Parts of doctest exposed as library. For use with the doctest-extract utility.")
+      "Parts of doctest exposed as library.  For use with the doctest-extract utility.")
     (license license:expat)))
 
 (define-public ghc-doctest-exitcode-stdio
@@ -1157,7 +1155,7 @@ (define-public ghc-tasty-silver
      "This package provides a fancy test runner and support for @dfn{golden
 testing}.  A golden test is an IO action that writes its result to a file.  To
 pass the test, this output file should be identical to the corresponding
-``golden'' file, which contains the correct result for the test.  The test
+@emph{golden} file, which contains the correct result for the test.  The test
 runner allows filtering tests using regexes, and to interactively inspect the
 result of golden tests.")
     (license license:expat)))
diff --git a/gnu/packages/haskell-web.scm b/gnu/packages/haskell-web.scm
index 540b167b7a..f211c870a3 100644
--- a/gnu/packages/haskell-web.scm
+++ b/gnu/packages/haskell-web.scm
@@ -1508,7 +1508,7 @@ (define-public ghc-hxt-unicode
     (description
      "This package provides Unicode encoding and decoding functions for
 encodings used in the Haskell XML Toolbox.  ISO Latin 1-16, utf8, utf16, ASCII
-are supported. Decoding is done with lazy functions, errors may be detected or
+are supported.  Decoding is done with lazy functions, errors may be detected or
 ignored.")
     (license license:expat)))
 
diff --git a/gnu/packages/haskell-xyz.scm b/gnu/packages/haskell-xyz.scm
index c91639cc93..482b3d23c4 100644
--- a/gnu/packages/haskell-xyz.scm
+++ b/gnu/packages/haskell-xyz.scm
@@ -4404,7 +4404,7 @@ (define-public ghc-fsnotify
     (home-page "https://github.com/haskell-fswatch/hfsnotify")
     (synopsis "Cross platform library for file change notification")
     (description "Cross platform library for file creation, modification, and
-deletion notification. This library builds upon existing libraries for platform
+deletion notification.  This library builds upon existing libraries for platform
 specific Windows, Mac, and Linux file system event notification.")
     (license license:bsd-3)))
 
@@ -4745,10 +4745,10 @@ (define-public ghc-gtk2hs-buildtools
     (synopsis "Tools to build the Gtk2Hs suite of user interface libraries")
     (description
      "This package provides a set of helper programs necessary to build the
-Gtk2Hs suite of libraries. These tools include a modified c2hs binding tool
+Gtk2Hs suite of libraries.  These tools include a modified c2hs binding tool
 that is used to generate FFI declarations, a tool to build a type hierarchy
 that mirrors the C type hierarchy of GObjects found in glib, and a generator
-for signal declarations that are used to call back from C to Haskell. These
+for signal declarations that are used to call back from C to Haskell.  These
 tools are not needed to actually run Gtk2Hs programs.")
     (license license:gpl2)))
 
@@ -5792,7 +5792,7 @@ (define-public ghc-hsyaml
 representation (including support for cyclic YAML data structures).
 
 @item Support for the standard (untyped) @emph{Failsafe}, (strict)
-@emph{JSON}, and (flexible) @emph{Core} ``schemas'' providing implicit
+@emph{JSON}, and (flexible) @emph{Core} @code{schemas} providing implicit
 typing rules as defined in the YAML 1.2 specification (including support
 for user-defined custom schemas).
 
@@ -8277,7 +8277,7 @@ (define-public ghc-operational
      "Implementation of difficult monads made easy with operational semantics")
     (description
      "This library makes it easy to implement monads with tricky control
-flow. This is useful for: writing web applications in a sequential style,
+flow.  This is useful for: writing web applications in a sequential style,
 programming games with a uniform interface for human and AI players and easy
 replay capababilities, implementing fast parser monads, designing monadic
 DSLs, etc.")
@@ -10278,9 +10278,9 @@ (define-public ghc-regex-tdfa
     (home-page "https://wiki.haskell.org/Regular_expressions")
     (synopsis "POSIX extended regular expressions in Haskell")
     (description
-     "Regex-tdfa is a pure Haskell regular expression library implementing POSIX
-extended regular expressions.  It is a \"tagged\" DFA regex engine. It is
-inspired by libtre.")
+     "Regex-tdfa is a pure Haskell regular expression library implementing
+POSIX extended regular expressions.  It is a @emph{tagged} DFA regex engine.
+It is inspired by libtre.")
     (license license:bsd-3)))
 
 (define-public ghc-repline
@@ -10481,7 +10481,7 @@ (define-public ghc-rio
      "This package works as a prelude replacement for Haskell,
 providing more functionality and types out of the box than the standard
 prelude (such as common data types like @code{ByteString} and
-@code{Text}), as well as removing common ``gotchas'', like partial
+@code{Text}), as well as removing common @emph{gotchas}, like partial
 functions and lazy I/O.  The guiding principle here is:
 @itemize
 @item If something is safe to use in general and has no expected naming
@@ -13670,7 +13670,7 @@ (define-public ghc-unsafe
     (home-page "https://hackage.haskell.org/package/unsafe")
     (synopsis "Unified interface to unsafe functions")
     (description "Safe Haskell introduced the notion of safe and unsafe
-modules.  In order to make as many as possible modules ``safe'', the
+modules.  In order to make as many as possible modules @emph{safe}, the
 well-known unsafe functions were moved to distinguished modules.  This
 makes it hard to write packages that work with both old and new versions
 of GHC.  This package provides a single module System.Unsafe that
@@ -15104,7 +15104,7 @@ (define-public ghc-commonmark
 
 Accurate information about source positions is available for all block and
 inline elements.  Thus the library can be used to create an accurate syntax
-highlighter or an editor with live preview. The parser has been designed for
+highlighter or an editor with live preview.  The parser has been designed for
 robust performance even in pathological cases that tend to cause stack
 overflows or exponential slowdowns in other parsers, with parsing speed that
 varies linearly with input length.")
@@ -15218,7 +15218,7 @@ (define-public ghc-template-haskell
     (synopsis "Support library for Template Haskell")
     (description
      "This package provides modules containing facilities for manipulating
-Haskell source code using Template Haskell. See
+Haskell source code using Template Haskell.  See
 @uref{http://www.haskell.org/haskellwiki/Template_Haskell} for more
 information.")
     (license license:bsd-3)))
@@ -15366,7 +15366,7 @@ (define-public ghc-mysql
 most of the MySQL client API.  The major departure from the C API is that in
 Haskell, resource management is mostly automatic and safe.
 
-This library deliberately avoids the question of providing a ``good'' API.
+This library deliberately avoids the question of providing a @emph{good} API.
 Its purpose is to serve as a base upon which higher-level libraries can be
 built.")
     (license license:bsd-3)))
@@ -16128,8 +16128,8 @@ (define-public ghc-witherable
     (home-page "https://github.com/fumieval/witherable")
     (synopsis "Filterable traversable")
     (description
-     "This package provides a stronger variant of `traverse` which can remove elements
-and generalised mapMaybe, catMaybes, filter")
+     "This package provides a stronger variant of @code{traverse} which can
+remove elements and generalised mapMaybe, catMaybes, filter")
     (license license:bsd-3)))
 
 (define-public ghc-hspec-discover
@@ -16238,22 +16238,28 @@ (define-public ghc-random-bytestring
     (home-page "https://www.github.com/larskuhtz/random-bytestring")
     (synopsis "Efficient generation of random bytestrings")
     (description
-     "__This package is deprecated__.  Please, use genByteString from the [random
-package (version >=1.2)](https://hackage.haskell.org/package/random) instead. .
-Efficient generation of random bytestrings.  The implementation populates
-uninitialized memory with uniformily distributed random 64 bit words (and 8 bit
-words for remaining bytes at the end of the bytestring). .  Random words are
-generated using the PRNG from the
-[mwc-random](https://hackage.haskell.org/package/mwc-random) package or the
-[pcg-random](https://hackage.haskell.org/package/pcg-random) package.  It is
-also possible to use a custom PRNG by providing an instance for the RandomWords
-type class and using the function generate from the module
-\"Data.ByteString.Random.Internal\". .  The generated byte strings are suitable
-for statistical applications.  They are /not/ suitable for cryptographic
-applications. .
-![benchmarks](https://hackage.haskell.org/package/random-bytestring-0.1.3.2/src/benchmarks.png)
-. ![detailed
-benchmarks](https://hackage.haskell.org/package/random-bytestring-0.1.3.2/src/benchmarks-details.png)")
+     "@emph{This package is deprecated}.  Please, use genByteString from the
+@url{https://hackage.haskell.org/package/random, random package (version >=1.2)]}
+instead.  Efficient generation of random bytestrings.  The implementation
+populates uninitialized memory with uniformily distributed random 64 bit words
+(and 8 bit words for remaining bytes at the end of the bytestring).  Random
+words are generated using the PRNG from the @url{https://hackage.haskell.org/package/mwc-random, mwc-random} package or the
+@url{https://hackage.haskell.org/package/pcg-random, pcg-random} package.  It is
+also possible to use a custom PRNG by providing an instance for the
+RandomWords type class and using the function generate from the module
+@code{Data.ByteString.Random.Internal}.  The generated byte strings are suitable
+for statistical applications.  They are @emph{not} suitable for cryptographic
+applications.
+@itemize
+
+@item
+@url{https://hackage.haskell.org/package/random-bytestring-0.1.3.2/src/benchmarks.png,
+benchmarks}
+
+@item
+@url{https://hackage.haskell.org/package/random-bytestring-0.1.3.2/src/benchmarks-details.png,
+detailed benchmarks}
+@end itemize")
     (license license:expat)))
 
 (define-public ghc-base64
@@ -16300,8 +16306,9 @@ (define-public ghc-ordered-containers
     (build-system haskell-build-system)
     (properties '((upstream-name . "ordered-containers")))
     (home-page "https://hackage.haskell.org/package/ordered-containers")
-    (description "")
     (synopsis "Haskell types")
+    (description "Set- and Map-like types that remember the order elements
+were inserted")
     (license license:bsd-3)))
 
 (define-public ghc-cabal-syntax
@@ -16565,7 +16572,7 @@ (define-public ghc-should-not-typecheck
     (native-inputs (list ghc-hspec ghc-hspec-expectations))
     (home-page "https://github.com/CRogers/should-not-typecheck")
     (synopsis
-     "A HUnit/hspec assertion library to verify that an expression does not typecheck")
+     "HUnit/hspec assertion library to verify that an expression does not typecheck")
     (description
      "For examples and an introduction to the library please take a look at the
 <https://github.com/CRogers/should-not-typecheck#should-not-typecheck- README>
@@ -16756,9 +16763,10 @@ (define-public ghc-boring
     (home-page "https://github.com/phadej/boring")
     (synopsis "Boring and Absurd types")
     (description
-     "* @@Boring@@ types are isomorphic to @@()@@. . * @@Absurd@@ types are isomorphic
-to @@Void@@. .  See [What does () mean in Haskell -answer by Conor
-McBride](https://stackoverflow.com/questions/33112439/what-does-mean-in-haskell/33115522#33115522)")
+     "@itemize
+@item @code{Boring} types are isomorphic to @code{()}.
+@item @code{Absurd} types are isomorphic to @code{Void}.
+@end itemize")
     (license license:bsd-3)))
 
 (define-public ghc-some
diff --git a/gnu/packages/ibus.scm b/gnu/packages/ibus.scm
index 0dfce29ea3..a1b54c0605 100644
--- a/gnu/packages/ibus.scm
+++ b/gnu/packages/ibus.scm
@@ -972,7 +972,7 @@ (define-public ibus-libhangul
     (home-page "https://github.com/libhangul/ibus-hangul")
     (synopsis "Hangul engine for IBus")
     (description
-     "ibus-hangul is a Korean input method engine for IBus.")
+     "Korean input method engine for IBus.")
     (license gpl2+)))
 
 (define-public ibus-table
diff --git a/gnu/packages/image.scm b/gnu/packages/image.scm
index 7337a27b88..84ccc91a44 100644
--- a/gnu/packages/image.scm
+++ b/gnu/packages/image.scm
@@ -1738,10 +1738,11 @@ (define-public steghide
     (home-page "https://steghide.sourceforge.net")
     (synopsis "`Hide' (nonconfidential) data in image or audio files")
     (description
-     "Steghide is a program to `hide' data in various kinds of image and audio
-files.  This practice is known as @dfn{steganography}, but the method used by
-steghide is not very secure and should not be used where security is at stake.
-Even if a password is used, steghide offers little plausible deniability.
+     "Steghide is a program to @emph{hide} data in various kinds of image and
+audio files.  This practice is known as @dfn{steganography}, but the method
+used by steghide is not very secure and should not be used where security is
+at stake.  Even if a password is used, steghide offers little plausible
+deniability.
 
 Nonetheless, neither color nor sample frequencies are changed, making the
 embedding resistant against first-order statistical tests not aimed
diff --git a/gnu/packages/ipfs.scm b/gnu/packages/ipfs.scm
index a1c6834390..4b79a6f736 100644
--- a/gnu/packages/ipfs.scm
+++ b/gnu/packages/ipfs.scm
@@ -117,8 +117,8 @@ (define-public go-github-com-ipfs-go-block-format
     (synopsis "Set of interfaces for CID addressable blocks of data")
     (description
      "Package @code{blocks} contains the lowest level of @acronym{IPLD,
-InterPlanetary Linked Data} data structures. A block is raw data accompanied
-by a @acronym{Content Identifiers,CID}. The CID contains the multihash
+InterPlanetary Linked Data} data structures.  A block is raw data accompanied
+by a @acronym{Content Identifiers,CID}.  The CID contains the multihash
 corresponding to the block.")
     (license license:expat)))
 
diff --git a/gnu/packages/java-xml.scm b/gnu/packages/java-xml.scm
index 9ec11fa83e..d3d8124bbd 100644
--- a/gnu/packages/java-xml.scm
+++ b/gnu/packages/java-xml.scm
@@ -548,9 +548,9 @@ (define-public java-kxml2
      (list java-junit))
     (home-page "http://kxml.org")
     (synopsis "XML pull parser")
-    (description "kXML is a small XML pull parser, specially designed for
-constrained environments such as Applets, Personal Java or devices compliant
-with the Mobile Information Device Profile (MIDP).")
+    (description "@emph{kXML} is a small XML pull parser, specially designed
+for constrained environments such as Applets, Personal Java or devices
+compliant with the Mobile Information Device Profile (MIDP).")
     (license license:expat)))
 
 (define-public java-stax
diff --git a/gnu/packages/java.scm b/gnu/packages/java.scm
index 4c28659241..74fa01be3f 100644
--- a/gnu/packages/java.scm
+++ b/gnu/packages/java.scm
@@ -13239,9 +13239,9 @@ (define-public java-jsch-agentproxy-core
        #:tests? #f)); no tests
     (home-page "https://github.com/ymnk/jsch-agent-proxy")
     (synopsis "Core component of the proxy to ssh-agent and Pageant in Java")
-    (description "jsch-agent-proxy is a proxy program to OpenSSH's ssh-agent
-and Pageant included Putty.  It will be easily integrated into JSch, and users
-will be allowed to use these programs for authentication.")
+    (description "@emph{jsch-agent-proxy} is a proxy program to OpenSSH's
+ssh-agent and Pageant included Putty.  It will be easily integrated into JSch,
+and users will be allowed to use these programs for authentication.")
     (license license:bsd-3)))
 
 (define-public java-jsch-agentproxy-sshagent
@@ -13255,9 +13255,9 @@ (define-public java-jsch-agentproxy-sshagent
     (inputs
      (list java-jsch-agentproxy-core))
     (synopsis "Proxy to ssh-agent")
-    (description "jsch-agent-proxy is a proxy program to OpenSSH's ssh-agent
-and Pageant included in Putty. This component contains the code for a proxy to
-ssh-agent.")))
+    (description "@emph{jsch-agent-proxy} is a proxy program to OpenSSH's
+ssh-agent and Pageant included in Putty.  This component contains the code for
+a proxy to ssh-agent.")))
 
 (define-public java-jsch-agentproxy-usocket-jna
   (package
@@ -13270,9 +13270,9 @@ (define-public java-jsch-agentproxy-usocket-jna
     (inputs
      (list java-jsch-agentproxy-core java-native-access))
     (synopsis "USocketFactory implementation using JNA")
-    (description "jsch-agent-proxy is a proxy program to OpenSSH's ssh-agent
-and Pageant included in Putty. This component contains an implementation of
-USocketFactory using @dfn{JNA} (Java Native Access).")))
+    (description "@emph{jsch-agent-proxy} is a proxy program to OpenSSH's
+ssh-agent and Pageant included in Putty.  This component contains an
+implementation of USocketFactory using @dfn{JNA} (Java Native Access).")))
 
 (define-public java-jsch-agentproxy-pageant
   (package
@@ -13286,9 +13286,9 @@ (define-public java-jsch-agentproxy-pageant
      (list java-jsch-agentproxy-core java-native-access
            java-native-access-platform))
     (synopsis "Proxy to pageant")
-    (description "jsch-agent-proxy is a proxy program to OpenSSH's ssh-agent
-and Pageant included in Putty. This component contains the code for a proxy to
-pageant.")))
+    (description "@emph{jsch-agent-proxy} is a proxy program to OpenSSH's
+ssh-agent and Pageant included in Putty.  This component contains the code for
+a proxy to pageant.")))
 
 (define-public java-jsch-agentproxy-usocket-nc
   (package
@@ -13301,9 +13301,9 @@ (define-public java-jsch-agentproxy-usocket-nc
     (inputs
      (list java-jsch-agentproxy-core))
     (synopsis "USocketFactory implementation using netcat")
-    (description "jsch-agent-proxy is a proxy program to OpenSSH's ssh-agent
-and Pageant included in Putty. This component contains an implementation of
-USocketFactory using netcat.")))
+    (description "@emph{jsch-agent-proxy} is a proxy program to OpenSSH's
+ssh-agent and Pageant included in Putty.  This component contains an
+implementation of USocketFactory using netcat.")))
 
 (define-public java-jsch-agentproxy-connector-factory
   (package
@@ -13318,8 +13318,9 @@ (define-public java-jsch-agentproxy-connector-factory
            java-jsch-agentproxy-usocket-jna java-jsch-agentproxy-pageant
            java-jsch-agentproxy-usocket-nc))
     (synopsis "Connector factory for jsch agent proxy")
-    (description "jsch-agent-proxy is a proxy program to OpenSSH's ssh-agent
-and Pageant included in Putty. This component contains a connector factory.")))
+    (description "@emph{jsch-agent-proxy} is a proxy program to OpenSSH's
+ssh-agent and Pageant included in Putty.  This component contains a connector
+factory.")))
 
 (define-public java-jsch-agentproxy-jsch
   (package
@@ -13332,9 +13333,9 @@ (define-public java-jsch-agentproxy-jsch
     (inputs
      (list java-jsch java-jsch-agentproxy-core))
     (synopsis "JSch integration library for agentproxy")
-    (description "jsch-agent-proxy is a proxy program to OpenSSH's ssh-agent
-and Pageant included in Putty. This component contains a library to use
-jsch-agent-proxy with JSch.")))
+    (description "@emph{jsch-agent-proxy} is a proxy program to OpenSSH's
+ssh-agent and Pageant included in Putty.  This component contains a library to
+use jsch-agent-proxy with JSch.")))
 
 (define-public java-apache-ivy
   (package
diff --git a/gnu/packages/kodi.scm b/gnu/packages/kodi.scm
index 432da7d3d5..589fb386ab 100644
--- a/gnu/packages/kodi.scm
+++ b/gnu/packages/kodi.scm
@@ -268,9 +268,10 @@ (define-public fstrcmp
     (synopsis "Fuzzy comparison of strings")
     (description
      "The fstrcmp project provides a library that is used to make fuzzy
-comparisons of strings and byte arrays, including multi-byte character strings.
-This can be useful in error messages, enabling the suggestion of likely valid
-alternatives. In compilers, this can reduce the cascade of secondary errors.")
+comparisons of strings and byte arrays, including multi-byte character
+strings.  This can be useful in error messages, enabling the suggestion of
+likely valid alternatives.  In compilers, this can reduce the cascade of
+secondary errors.")
     (license license:gpl3+)))
 
 (define-public kodi
diff --git a/gnu/packages/linux.scm b/gnu/packages/linux.scm
index b4d72a8db5..66b92f246a 100644
--- a/gnu/packages/linux.scm
+++ b/gnu/packages/linux.scm
@@ -1696,9 +1696,10 @@ (define-public tuxedo-keyboard
      "This package provides the @code{tuxedo_keyboard}, @code{tuxedo_io},
 @code{clevo_wmi} @acronym{WMI, Windows Management Engine} and the
 @code{clevo_acpi} @acronym{ACPI, Advanced Configuration and Power Interface}
-kernel modules to control the keyboard on most Tuxedo computers. Only white
-backlight only models are currently not supported. The @code{tuxedo_io} module
-is also needed for the @code{tuxedo-control-center} (short tcc) package.")
+kernel modules to control the keyboard on most Tuxedo computers.  Only white
+backlight only models are currently not supported.  The @code{tuxedo_io}
+module is also needed for the @code{tuxedo-control-center} (short tcc)
+package.")
     (license license:gpl3+)))
 
 (define-public evdi
@@ -1762,7 +1763,7 @@ (define-public libevdi
     (description
      "Libevdi is a library that gives applications easy access to
 @acronym{EVDI, Extensible Virtual Display Interface} devices provided by the
-@code{evdi} driver package.  ")
+@code{evdi} driver package.")
     (license license:lgpl2.1)))
 
 (define-public ec
@@ -2582,7 +2583,7 @@ (define-public dwarves
 it can be used to further format a number of records.
 
 Finally, the @command{btfdiff} command can be used to compare the output of
-pahole from BTF and DWARF, to make sure they produce the same results. ")
+pahole from BTF and DWARF, to make sure they produce the same results.")
     (license license:gpl2+)))
 
 (define-public fbset
@@ -6703,7 +6704,7 @@ (define-public f2fs-fsck/static
     (home-page (package-home-page f2fs-tools/static))
     (synopsis "Statically-linked fsck.f2fs command from f2fs-tools")
     (description "This package provides statically-linked fsck.f2fs command taken
-from the f2fs-tools package. It is meant to be used in initrds.")
+from the f2fs-tools package.  It is meant to be used in initrds.")
     (license (package-license f2fs-tools/static))))
 
 (define-public freefall
@@ -7166,9 +7167,9 @@ (define-public perftest
      (list autoconf automake libtool))
     (inputs (list pciutils rdma-core))
     (synopsis "Open Fabrics Enterprise Distribution (OFED) Performance Tests")
-    (description "This is a collection of tests written over uverbs intended for
-use as a performance micro-benchmark. The tests may be used for hardware or
-software tuning as well as for functional testing.
+    (description "This is a collection of tests written over uverbs intended
+for use as a performance micro-benchmark.  The tests may be used for hardware
+or software tuning as well as for functional testing.
 
 The collection contains a set of bandwidth and latency benchmark such as:
 @enumerate
@@ -8532,8 +8533,8 @@ (define-public libnetfilter-cthelper
     (native-inputs (list pkg-config))
     (inputs (list libmnl))
     (synopsis "Library for user-space connection tracking helpers")
-    (description "libnetfilter_cthelper is a userspace library that provides a
-programming interface to user-space connection tracking helpers.
+    (description "@emph{libnetfilter_cthelper} is a userspace library that
+provides a programming interface to user-space connection tracking helpers.
 @enumerate
 @item
 register new user-space connection tracking helpers
diff --git a/gnu/packages/lisp-xyz.scm b/gnu/packages/lisp-xyz.scm
index decbe2590b..bd7a73a6d4 100644
--- a/gnu/packages/lisp-xyz.scm
+++ b/gnu/packages/lisp-xyz.scm
@@ -3805,7 +3805,7 @@ (define-public sbcl-circular-streams
      (synopsis "Circularly readable streams for Common Lisp")
      (description
       "Circular-Streams allows you to read streams circularly by wrapping real
-streams. Once you reach end-of-file of a stream, it's file position will be
+streams.  Once you reach end-of-file of a stream, its file position will be
 reset to 0 and you're able to read it again.")
      (license license:llgpl))))
 
@@ -5924,7 +5924,7 @@ (define-public sbcl-cl-geometry
        "This is a system for two dimensional computational geometry for Common Lisp.
 
 Note: the system assumes exact rational arithmetic, so no floating point
-coordinates are allowed. This is not checked when creating geometric
+coordinates are allowed.  This is not checked when creating geometric
 objects.")
       ;; The .asd says BSD-style but the LICENSE.txt is expat.
       (license license:expat))))
@@ -6263,8 +6263,8 @@ (define-public sbcl-cl-grnm
       (description
        "These common lisp sources contain two variants of the Nelder-Mead
 algorithm.  The original algorithm and a provably convergent, reliable variant
-by A. Bürmen et al, called the
-@acronym{GRNMA, Grid Restrained Nelder Mead Algorithm}.")
+by A. Bürmen et al, called the @acronym{GRNMA, Grid Restrained Nelder Mead
+Algorithm}.")
       (home-page "https://github.com/quil-lang/cl-grnm")
       (license license:expat))))
 
@@ -22275,7 +22275,7 @@ (define-public sbcl-nasdf
 
 @itemize
 @item Simple way to fetch Git submodules and “do the right thing” for
-setup. This may effectively supersede Quicklisp. A benefit of using Git
+setup.  This may effectively supersede Quicklisp.  A benefit of using Git
 submodules over the default Quicklisp distribution is improved
 reproducibility.
 @item Test helpers, like distinction between offline and online tests, or
@@ -26701,7 +26701,7 @@ (define-public sbcl-sdl2kit
       (synopsis "Utility kit for CL-SDL2")
       (description
        "This is a utility kit for @code{cl-sdl2} that provides something similar to
-GLUT. However, it's also geared at being useful for \"real\" applications or
+GLUT.  However, it's also geared at being useful for \"real\" applications or
 games.")
       (license license:expat))))
 
@@ -27657,12 +27657,12 @@ (define-public emacs-slite
     (synopsis "SLIme-based TEst runner for FiveAM and Parachute Tests")
     (description
      "Slite interactively runs your Common Lisp tests (currently only FiveAM
-and Parachute are supported). It allows you to see the summary of test
+and Parachute are supported).  It allows you to see the summary of test
 failures, jump to test definitions, rerun tests with debugger all from inside
 Emacs.
 
 In order to work, this also requires the slite Common Lisp system to be
-present. See the code@{*cl-slite packages}.")))
+present.  See the code@{*cl-slite packages}.")))
 
 (define-public sbcl-slot-extra-options
   (let ((commit "29517d980325cd63744f1acf4cfe5c8ccec2b318"))
diff --git a/gnu/packages/machine-learning.scm b/gnu/packages/machine-learning.scm
index 988fac3b63..956a62748c 100644
--- a/gnu/packages/machine-learning.scm
+++ b/gnu/packages/machine-learning.scm
@@ -5800,18 +5800,18 @@ (define-public vosk-api
       (inputs (list kaldi openfst openblas))
       (home-page "https://alphacephei.com/vosk")
       (synopsis "Speech recognition toolkit based on @code{kaldi}")
-      (description "\
-This package provides a speech recognition toolkit based on @code{kaldi}.  It
-supports more than 20 languages and dialects - English, Indian English,
-German, French, Spanish, Portuguese, Chinese, Russian, Turkish, Vietnamese,
-Italian, Dutch, Catalan, Arabic, Greek, Farsi, Filipino, Ukrainian, Kazakh,
-Swedish, Japanese, Esperanto, Hindi, Czech, Polish. The program works offline,
-even on lightweight devices.  Portable per-language models are about 50Mb each,
-and there are much bigger and precise models available.
-
-Vosk API provides a streaming API allowing to use it `on-the-fly' and bindings
-for different programming languages.  It allows quick reconfiguration of
-vocabulary for better accuracy, and supports speaker identification beside
+      (description "This package provides a speech recognition toolkit based
+on @code{kaldi}.  It supports more than 20 languages and dialects - English,
+Indian English, German, French, Spanish, Portuguese, Chinese, Russian,
+Turkish, Vietnamese, Italian, Dutch, Catalan, Arabic, Greek, Farsi, Filipino,
+Ukrainian, Kazakh, Swedish, Japanese, Esperanto, Hindi, Czech, Polish.  The
+program works offline, even on lightweight devices.  Portable per-language
+models are about 50Mb each, and there are much bigger and precise models
+available.
+
+Vosk API provides a streaming API allowing to use it @emph{on-the-fly} and
+bindings for different programming languages.  It allows quick reconfiguration
+of vocabulary for better accuracy, and supports speaker identification beside
 simple speech recognition.")
       (license license:asl2.0))))
 
diff --git a/gnu/packages/messaging.scm b/gnu/packages/messaging.scm
index 8cbe98d613..89487ae155 100644
--- a/gnu/packages/messaging.scm
+++ b/gnu/packages/messaging.scm
@@ -214,7 +214,7 @@ (define-public biboumi
    (home-page "https://biboumi.louiz.org")
    (synopsis "XMPP gateway that connects to IRC")
    (description "Biboumi is a Free, Libre and Open Source XMPP gateway that connects to IRC
-servers and translates between the two protocols. Its goal is to let XMPP
+servers and translates between the two protocols.  Its goal is to let XMPP
 users take part in IRC discussions, using their favourite XMPP client.")
    (license license:zlib)))
 
diff --git a/gnu/packages/minetest.scm b/gnu/packages/minetest.scm
index 2552596ef8..318aeb2257 100644
--- a/gnu/packages/minetest.scm
+++ b/gnu/packages/minetest.scm
@@ -811,7 +811,7 @@ (define-public minetest-basic-trains
      "http://advtrains.de/wiki/doku.php?id=usage:trains:basic_trains")
     (synopsis "Collection of basic trains for the Advanced Trains mod")
     (description
-     "This modpack contains the trains which were the ``default'' trains in
+     "This modpack contains the trains which were the @emph{default} trains in
 advtrains up to version 2.2.1.")
     (license (list license:cc-by-sa3.0 license:agpl3+))
     (properties `((upstream-name . "orwell/basic_trains")))))
diff --git a/gnu/packages/monitoring.scm b/gnu/packages/monitoring.scm
index 6325c9b96f..3e86166e81 100644
--- a/gnu/packages/monitoring.scm
+++ b/gnu/packages/monitoring.scm
@@ -753,7 +753,7 @@ (define-public pw
 @item Interactively apply and remove filters on-the-fly, without interrupting
 the source.
 
-@item Make recurring patterns in the stream appear to ``freeze'' on the
+@item Make recurring patterns in the stream appear to @emph{freeze} on the
 screen, using triggers.
 
 @item Prevent the overwhelming amount of output from a program from flooding
diff --git a/gnu/packages/music.scm b/gnu/packages/music.scm
index 980bce6b30..2e7cc70e49 100644
--- a/gnu/packages/music.scm
+++ b/gnu/packages/music.scm
@@ -4486,7 +4486,7 @@ (define-public sooperlooper
     (synopsis "Live looping sampler")
     (description
      "SooperLooper is a live looping sampler capable of immediate loop
-recording, overdubbing, multiplying, reversing and more. It allows for
+recording, overdubbing, multiplying, reversing and more.  It allows for
 multiple simultaneous multi-channel loops limited only by your computer's
 available memory.")
     (license license:gpl2+)))
@@ -7939,11 +7939,10 @@ (define-public samplebrain
     (home-page "https://thentrythis.org/projects/samplebrain/")
     (synopsis "Sample mashing synthesizer designed by Aphex Twin")
     (description
-     "Samplebrain chops samples up into a 'brain' of
-interconnected small sections called blocks which are connected into a network
-by similarity.  It processes a target sample, chopping it up into blocks in
-the same way, and tries to match each block with one in its brain to play in
-realtime.")
+     "Samplebrain chops samples up into a @emph{brain} of interconnected small
+sections called blocks which are connected into a network by similarity.  It
+processes a target sample, chopping it up into blocks in the same way, and
+tries to match each block with one in its brain to play in realtime.")
     (license license:gpl2+)))
 
 (define-public le-biniou-data
diff --git a/gnu/packages/node-xyz.scm b/gnu/packages/node-xyz.scm
index cf6f50e3ce..d4adc5c64c 100644
--- a/gnu/packages/node-xyz.scm
+++ b/gnu/packages/node-xyz.scm
@@ -735,7 +735,7 @@ (define-public node-nan
      (list node-readable-stream))
     (home-page "https://github.com/nodejs/nan")
     (synopsis "Native Abstractions for Node.js")
-    (description "Native Abstractions for Node.js (``NaN'') provides a header
+    (description "Native Abstractions for Node.js (@emph{NaN}) provides a header
 file filled with macros and utilities for making add-on development for Node.js
 easier across versions.  The goal is to provide all logic necessary to develop
 native Node.js addons without having to inspect @code{NODE_MODULE_VERSION}.")
@@ -1380,7 +1380,7 @@ (define-public node-serialport-parser-ready
 
 Parsers are used to take raw binary data and transform them into usable
 messages.  This package provides @code{Ready}, a parser that waits for a
-specified sequence of ``ready'' bytes before emitting a ready event and
+specified sequence of @emph{ready} bytes before emitting a ready event and
 emitting data events.")))
 
 (define-public node-serialport-parser-regex
diff --git a/gnu/packages/ocaml.scm b/gnu/packages/ocaml.scm
index 89dc5a98c8..d827023c1e 100644
--- a/gnu/packages/ocaml.scm
+++ b/gnu/packages/ocaml.scm
@@ -9118,9 +9118,9 @@ (define-public ocaml-afl-persistent
     (home-page "https://github.com/stedolan/ocaml-afl-persistent")
     (synopsis "Use afl-fuzz in persistent mode")
     (description
-      "afl-fuzz normally works by repeatedly forking the program being tested.
-Using this package, you can run afl-fuzz in ``persistent mode'', which avoids
-repeated forking and is much faster.")
+      "@emph{afl-fuzz} normally works by repeatedly forking the program being
+tested.  Using this package, you can run afl-fuzz in @emph{persistent mode},
+which avoids repeated forking and is much faster.")
     (license license:expat)))
 
 (define-public ocaml-monolith
diff --git a/gnu/packages/opencl.scm b/gnu/packages/opencl.scm
index 036834f567..0856eb0121 100644
--- a/gnu/packages/opencl.scm
+++ b/gnu/packages/opencl.scm
@@ -380,7 +380,7 @@ (define-public python-pytools
     (home-page "https://pypi.org/project/pytools/")
     (synopsis "Assorted tools for Python")
     (description
-     "Pytools is a bag of things that are ``missing'' from the Python standard
+     "Pytools is a bag of things that are @emph{missing} from the Python standard
 library:
 
 @itemize
diff --git a/gnu/packages/perl-check.scm b/gnu/packages/perl-check.scm
index 5ef56227ce..ccc5614196 100644
--- a/gnu/packages/perl-check.scm
+++ b/gnu/packages/perl-check.scm
@@ -610,8 +610,8 @@ (define-public perl-test-file-contents
     (home-page "https://metacpan.org/release/Test-File-Contents")
     (synopsis "Test routines for examining the contents of files")
     (description
-     "@{Test::File::Contents} provides functions for testing the contents of
-files.")
+     "@emph{Test::File::Contents} provides functions for testing the contents
+of files.")
     (license perl-license)))
 
 (define-public perl-test-file-sharedir-dist
@@ -1077,7 +1077,7 @@ (define-public perl-test-object
 the parent classes.
 
 This should be done to ensure that the implementation of a subclass has not
-somehow ``broken'' the object's behaviour in a more general sense.
+somehow @emph{broken} the object's behaviour in a more general sense.
 
 Test::Object is a testing package designed to allow you to easily test what
 you believe is a valid object against the expected behaviour of all of the
diff --git a/gnu/packages/perl.scm b/gnu/packages/perl.scm
index faaac13bf1..548ae4480c 100644
--- a/gnu/packages/perl.scm
+++ b/gnu/packages/perl.scm
@@ -1650,9 +1650,9 @@ (define-public perl-class-load
            perl-module-runtime perl-module-implementation))
     (home-page "https://metacpan.org/release/Class-Load")
     (synopsis "Working (require \"Class::Name\") and more")
-    (description "\"require EXPR\" only accepts Class/Name.pm style module
-names, not Class::Name.  For that, this module provides \"load_class
-'Class::Name'\".")
+    (description "@code{require EXPR} only accepts Class/Name.pm style module
+names, not @code{Class::Name}.  For that, this module provides
+@code{load_class 'Class::Name'}.")
     (license (package-license perl))))
 
 (define-public perl-class-load-xs
@@ -3846,7 +3846,7 @@ (define-public perl-devel-globaldestruction
     (home-page "https://metacpan.org/release/Devel-GlobalDestruction")
     (synopsis "Provides equivalent of ${^GLOBAL_PHASE} eq 'DESTRUCT' for older perls")
     (description "Devel::GlobalDestruction provides a function returning the
-equivalent of \"$@{^GLOBAL_PHASE@} eq 'DESTRUCT'\" for older perls.")
+equivalent of @code{$@{^GLOBAL_PHASE@} eq 'DESTRUCT'} for older perls.")
     (license (package-license perl))))
 
 (define-public perl-devel-hide
@@ -5082,7 +5082,7 @@ (define-public perl-file-readbackwards
     (build-system perl-build-system)
     (home-page "https://metacpan.org/release/File-ReadBackwards")
     (synopsis "Read a file backwards by lines")
-    (description "This module reads a file backwards line by line. It is
+    (description "This module reads a file backwards line by line.  It is
 simple to use, memory efficient and fast.  It supports both an object and a
 tied handle interface.
 
@@ -5277,8 +5277,8 @@ (define-public perl-file-which
     (synopsis "Portable implementation of the `which' utility")
     (description
      "File::Which was created to be able to get the paths to executable
-programs on systems under which the `which' program wasn't implemented in the
-shell.")
+programs on systems under which the @command{which} program wasn't implemented
+in the shell.")
     (home-page "https://metacpan.org/release/File-Which")
     (license (package-license perl))))
 
diff --git a/gnu/packages/python-xyz.scm b/gnu/packages/python-xyz.scm
index f9fe28dfb4..71456381e4 100644
--- a/gnu/packages/python-xyz.scm
+++ b/gnu/packages/python-xyz.scm
@@ -6508,8 +6508,8 @@ (define-public python-jinja2-time
     (synopsis "Jinja2 Extension for Dates and Times")
     (description
      "This package provides an extension for the template engine Jinja2.  It
-adds a 'now' tag providing a convenient access to the arrow.now() API from
-templates.  A format string can be provided to control the output.")
+adds a @code{now} tag providing a convenient access to the arrow.now() API
+from templates.  A format string can be provided to control the output.")
     (license license:expat)))
 
 (define-public python-pypugjs
@@ -13272,7 +13272,7 @@ (define-public python-dbus
      `(("python" ,python-wrapper)
        ("dbus-glib" ,dbus-glib)))
     (synopsis "Python bindings for D-bus")
-    (description "python-dbus provides bindings for libdbus, the reference
+    (description "Bindings for libdbus, the reference
 implementation of D-Bus.")
     (home-page "https://www.freedesktop.org/wiki/Software/DBusBindings/")
     (properties `((python2-variant . ,(delay python2-dbus))))
@@ -14159,7 +14159,7 @@ (define-public python-qnorm
     (propagated-inputs (list python-numba python-numpy python-pandas))
     (home-page "https://github.com/Maarten-vd-Sande/qnorm")
     (synopsis "Quantile normalization")
-    (description "This tool implements quantile normalization. It properly
+    (description "This tool implements quantile normalization.  It properly
 resolves rank ties, which is important when ties happen frequently, such as
 when working with discrete numbers (integers) in count tables.  This
 implementation should be relatively fast, and can use multiple cores to sort
@@ -19166,7 +19166,7 @@ (define-public python-uncertainties
     (synopsis "Calculations with uncertainties")
     (description
      "The uncertainties package transparently handles calculations with
-numbers with uncertainties. It can also yield the derivatives of any
+numbers with uncertainties.  It can also yield the derivatives of any
 expression.")
     (license license:bsd-3)))
 
@@ -36508,7 +36508,7 @@ (define-public python-sre-yield
     (synopsis "Expands a regular expression to its possible matches")
     (description
      "The goal of sre_yield is to efficiently generate all values that can
-match a given regular expression, or count possible matches efficiently. It
+match a given regular expression, or count possible matches efficiently.  It
 uses the parsed regular expression, so you get a much more accurate result
 than trying to just split strings.")
     (license license:asl2.0)))
diff --git a/gnu/packages/qt.scm b/gnu/packages/qt.scm
index 1ac8dfc529..d948813f8d 100644
--- a/gnu/packages/qt.scm
+++ b/gnu/packages/qt.scm
@@ -4101,8 +4101,9 @@ (define-public python-pyqt6-sip
         (base32 "0y2pgc1kzskq3q230b5d48izvzy9dl4hkfjpcr7kv53ih1cf31i4"))))
     (synopsis "Sip module support for PyQt6")
     (description
-     "SIP is used to write self contained extension modules, i.e. without a library
-to be wrapped. This SIP extension module provides support for the PyQt6 package.")))
+     "SIP is used to write self contained extension modules, i.e. without a
+library to be wrapped.  This SIP extension module provides support for the
+PyQt6 package.")))
 
 (define-public python-pyqtwebengine
   (package
diff --git a/gnu/packages/radio.scm b/gnu/packages/radio.scm
index bafc5e5d8a..0b51585408 100644
--- a/gnu/packages/radio.scm
+++ b/gnu/packages/radio.scm
@@ -1453,7 +1453,7 @@ (define-public hackrf
      "Command line utilities and a C library for controlling the HackRF
 Software Defined Radio (SDR) over USB.  Installing this package installs the
 userspace hackrf utilities and C library.  To install the hackrf udev rules,
-you must extend 'udev-service-type' with this package.  E.g.:
+you must extend @code{udev-service-type} with this package.  E.g.:
 @code{(udev-rules-service 'hackrf hackrf #:groups '(\"dialout\"))}.")
     (license license:gpl2)))
 
@@ -1487,7 +1487,7 @@ (define-public bladerf
     (description
      "This package contains a library and command line utilities for
 controlling the BladeRF Software Defined Radio (SDR) over USB.  To install the
-bladerf udev rules, you must extend 'udev-service-type' with this package.
+bladerf udev rules, you must extend \"udev-service-type\" with this package.
 E.g.: @code{(udev-rules-service 'bladerf bladerf)}.")
     (license (list license:bsd-3
                    license:expat
diff --git a/gnu/packages/rocm.scm b/gnu/packages/rocm.scm
index e883371928..dca3d58387 100644
--- a/gnu/packages/rocm.scm
+++ b/gnu/packages/rocm.scm
@@ -306,9 +306,9 @@ (define-public rocm-bandwidth-test
     (home-page "https://github.com/RadeonOpenCompute/rocm_bandwidth_test")
     (synopsis "Bandwidth test for ROCm")
     (description "RocBandwidthTest is designed to capture the performance
-characteristics of buffer copying and kernel read/write operations. The help
+characteristics of buffer copying and kernel read/write operations.  The help
 screen of the benchmark shows various options one can use in initiating
-cop/read/writer operations.  In addition one can also query the topology of the
-system in terms of memory pools and their agents.")
+cop/read/writer operations.  In addition one can also query the topology of
+the system in terms of memory pools and their agents.")
     (license license:ncsa)))
 
diff --git a/gnu/packages/rust-apps.scm b/gnu/packages/rust-apps.scm
index e6cce4d372..e3ad9ba16d 100644
--- a/gnu/packages/rust-apps.scm
+++ b/gnu/packages/rust-apps.scm
@@ -1349,7 +1349,7 @@ (define-public just
                        '()))
     (inputs (list bash-minimal coreutils-minimal))
     (home-page "https://github.com/casey/just")
-    (synopsis "Just a command runner")
+    (synopsis "Command runner")
     (description "This package provides @code{just}, a command runner.
 @code{just} is a handy way to save and run project-specific commands.")
     (license license:cc0)))
diff --git a/gnu/packages/scanner.scm b/gnu/packages/scanner.scm
index a2faaa2728..1e9e5a4bfa 100644
--- a/gnu/packages/scanner.scm
+++ b/gnu/packages/scanner.scm
@@ -84,13 +84,13 @@ (define-public sane-airscan
     (synopsis "SANE backend for eSCL (AirScan) and WSD document scanners")
     (description ; no @acronym{eSCL} because the meaning isn't officially known
      "This SANE backend lets you scan documents and images from scanners and
-multi-function printers that speak eSCL (marketed as ``AirScan'') or
-@acronym{WSD, Web Services for Devices} (or ``WS-Scan'').
+multi-function printers that speak eSCL (marketed as @emph{AirScan}) or
+@acronym{WSD, Web Services for Devices} (or @emph{WS-Scan}).
 
-Both are vendor-neutral protocols that allow ``driverless'' scanning over IPv4
-and IPv6 networks without the vendor-specific drivers that make up most of the
-sane-backends collection.  This is similar to how most contemporary printers
-speak the universal @acronym{IPP, Internet Printing Protocol}.
+Both are vendor-neutral protocols that allow @emph{driverless} scanning over
+IPv4 and IPv6 networks without the vendor-specific drivers that make up most
+of the sane-backends collection.  This is similar to how most contemporary
+printers speak the universal @acronym{IPP, Internet Printing Protocol}.
 
 Only scanners that support eSCL will also work over USB.  This requires a
 suitable IPP-over-USB daemon like ipp-usb to be installed and configured.
@@ -98,8 +98,8 @@ (define-public sane-airscan
 Any eSCL or WSD-capable scanner should just work.  sane-airscan automatically
 discovers and configures devices, including which protocol to use.  It was
 successfully tested with many devices from Brother, Canon, Dell, Kyocera,
-Lexmark, Epson, HP, OKI, Panasonic, Pantum, Ricoh, Samsung, and Xerox, with both
-WSD and eSCL.")
+Lexmark, Epson, HP, OKI, Panasonic, Pantum, Ricoh, Samsung, and Xerox, with
+both WSD and eSCL.")
     (license (list license:gpl2+        ; the combined work
                    license:expat))))    ; http_parser.[ch]
 
diff --git a/gnu/packages/search.scm b/gnu/packages/search.scm
index 994dc0dba0..e92cb302d4 100644
--- a/gnu/packages/search.scm
+++ b/gnu/packages/search.scm
@@ -195,7 +195,7 @@ (define-public perl-search-xapian
     (description
      "Search::Xapian wraps most methods of most Xapian classes.  The missing
 classes and methods should be added in the future.  It also provides a
-simplified, more 'perlish' interface to some common operations.")
+simplified, more @emph{perlish} interface to some common operations.")
     (license license:perl-license)))
 
 (define-public libtocc
diff --git a/gnu/packages/security-token.scm b/gnu/packages/security-token.scm
index 5abb461c0c..f3d9e2e483 100644
--- a/gnu/packages/security-token.scm
+++ b/gnu/packages/security-token.scm
@@ -413,9 +413,9 @@ (define-public pkcs11-helper
     (home-page "https://github.com/OpenSC/pkcs11-helper")
     (synopsis "Library that simplifies the interaction with PKCS#11 providers")
     (description
-     "Pkcs11-helper is a library that simplifies the interaction with
-PKCS#11 providers for end-user applications. PKCS#11 is published standard.
-PKCS#11 is the de-facto standard to access cryptographic devices")
+     "Pkcs11-helper is a library that simplifies the interaction with PKCS#11
+providers for end-user applications.  PKCS#11 is published standard.  PKCS#11
+is the de-facto standard to access cryptographic devices")
     (license (list license:gpl2 license:bsd-3))))
 
 
diff --git a/gnu/packages/shells.scm b/gnu/packages/shells.scm
index 43a1fbb540..3a6e99ca29 100644
--- a/gnu/packages/shells.scm
+++ b/gnu/packages/shells.scm
@@ -1153,7 +1153,7 @@ (define-public nushell
 structure.  For example, when you list the contents of a directory, what you
 get back is a table of rows, where each row represents an item in that
 directory.  These values can be piped through a series of steps, in a series
-of commands called a ``pipeline''.")
+of commands called a @emph{pipeline}.")
     (license license:expat)))
 
 (define-public rust-nu-ansi-term-0.50
diff --git a/gnu/packages/shellutils.scm b/gnu/packages/shellutils.scm
index 7e9f85a5f2..d54fc11134 100644
--- a/gnu/packages/shellutils.scm
+++ b/gnu/packages/shellutils.scm
@@ -397,8 +397,8 @@ (define-public sh-z
                #t))))))
     (synopsis "Jump about directories")
     (description
-     "Tracks your most used directories, based on ``frecency''.  After a short
-learning phase, z will take you to the most ``frecent'' directory that matches
+     "Tracks your most used directories, based on @emph{frecency}.  After a short
+learning phase, z will take you to the most @emph{frecent} directory that matches
 all of the regexes given on the command line in order.")
     (home-page "https://github.com/rupa/z")
     (license license:expat)))
@@ -747,8 +747,8 @@ (define-public shell-functools
     (home-page "https://github.com/sharkdp/shell-functools/")
     (synopsis "Functional programming tools for the shell")
     (description "This package provides higher order functions like map,
-filter, foldl, sort_by and take_while as simple command-line tools. Following
-the UNIX philosophy, these commands are designed to be composed via pipes. A
+filter, foldl, sort_by and take_while as simple command-line tools.  Following
+the UNIX philosophy, these commands are designed to be composed via pipes.  A
 large collection of functions such as basename, replace, contains or is_dir
 are provided as arguments to these commands.")
     (license license:expat)))
diff --git a/gnu/packages/ssh.scm b/gnu/packages/ssh.scm
index 47c2c5aada..2a8ec340b0 100644
--- a/gnu/packages/ssh.scm
+++ b/gnu/packages/ssh.scm
@@ -1002,6 +1002,6 @@ (define-public x11-ssh-askpass
     (inputs (list libxt))
     (home-page "http://www.jmknoble.net/software/x11-ssh-askpass/")
     (synopsis "Lightweight passphrase dialog for SSH")
-    (description "code{x11-ssh-askpass} is an X11-based pass-phrase dialog for
+    (description "@code{x11-ssh-askpass} is an X11-based pass-phrase dialog for
 use with OpenSSH.")
     (license license:gpl2+)))
diff --git a/gnu/packages/statistics.scm b/gnu/packages/statistics.scm
index 7089030fcc..ecd606fa60 100644
--- a/gnu/packages/statistics.scm
+++ b/gnu/packages/statistics.scm
@@ -7475,13 +7475,13 @@ (define-public r-datasaurus
 different distributions.  The datasets represent a larger and quirkier object
 lesson that is typically taught via Anscombe's Quartet (available in the
 'datasets' package).  Anscombe's Quartet contains four very different
-distributions with the same summary statistics and as such highlights the value
-of visualisation in understanding data, over and above summary statistics.  As
-well as being an engaging variant on the Quartet, the data is generated in a
-novel way.  The simulated annealing process used to derive datasets from the
-original Datasaurus is detailed in \"Same Stats, Different Graphs: Generating
-Datasets with Varied Appearance and Identical Statistics through Simulated
-Annealing\" @url{doi:10.1145/3025453.3025912}.")
+distributions with the same summary statistics and as such highlights the
+value of visualisation in understanding data, over and above summary
+statistics.  As well as being an engaging variant on the Quartet, the data is
+generated in a novel way.  The simulated annealing process used to derive
+datasets from the original Datasaurus is detailed in @emph{Same Stats,
+Different Graphs: Generating Datasets with Varied Appearance and Identical
+Statistics through Simulated Annealing} @url{doi:10.1145/3025453.3025912}.")
     (license license:expat)))
 
 (define-public r-lmom
diff --git a/gnu/packages/tcl.scm b/gnu/packages/tcl.scm
index a888304e0f..ea6ed0cbae 100644
--- a/gnu/packages/tcl.scm
+++ b/gnu/packages/tcl.scm
@@ -143,9 +143,9 @@ (define-public itcl
     (home-page "https://incrtcl.sourceforge.net/")
     (synopsis "Object Oriented programming (OOP) extension for Tcl")
     (description
-     "[incr Tcl] is a widely used object-oriented system for Tcl.  The name is
-a play on C++, and [incr Tcl] provides a similar object model, including
-multiple inheritance and public and private classes and variables.")
+     "@emph{[incr Tcl]} is a widely used object-oriented system for Tcl.  The
+name is a play on C++, and [incr Tcl] provides a similar object model,
+including multiple inheritance and public and private classes and variables.")
     (license license:public-domain)))
 
 (define-public expect
diff --git a/gnu/packages/tex.scm b/gnu/packages/tex.scm
index 969b6b4352..bf1e861f94 100644
--- a/gnu/packages/tex.scm
+++ b/gnu/packages/tex.scm
@@ -7272,7 +7272,7 @@ (define-public texlive-biblatex-morenames
     (home-page "https://ctan.org/pkg/biblatex-morenames")
     (synopsis "New names for standard BibLaTeX entry type")
     (description
-     "This package adds new fields of ``name'' type to the standard entry
+     "This package adds new fields of @code{name} type to the standard entry
 types of BibLaTeX.  For example, @samp{maineditor}, for a @code{@@collection},
 means the editor of @code{@@mvcollection}, and not the editor of the
 @code{@@collection}.")
@@ -13859,9 +13859,9 @@ (define-public texlive-digiconfigs
     (synopsis "Writing ``configurations''")
     (description
      "In Stochastic Geometry and Digital Image Analysis some problems can be
-solved in terms of so-called ``configurations''.  A configuration is basically
-a square matrix of @code{\\circ} and @code{\\bullet} symbols.  This package
-provides a convenient and compact mechanism for displaying these
+solved in terms of so-called @emph{configurations}.  A configuration is
+basically a square matrix of @code{\\circ} and @code{\\bullet} symbols.  This
+package provides a convenient and compact mechanism for displaying these
 configurations.")
     (license license:lppl)))
 
@@ -21937,7 +21937,7 @@ (define-public texlive-jablantile
     (synopsis "Metafont version of tiles in the style of Slavik Jablan")
     (description
      "This is a Metafont font to implement the modular tiles described by
-Slavik Jablan. ")
+Slavik Jablan.")
     (license license:public-domain)))
 
 (define-public texlive-jacow
@@ -29914,10 +29914,10 @@ (define-public texlive-ordinalpt
     (synopsis "Counters as ordinal numbers in Portuguese")
     (description
      "The package provides a counter style (like @code{\\arabic},
-@code{\\alph} and others) which produces output strings like
-@samp{primeiro} (``first'' in Portuguese), @samp{segundo}, (``second''), and
-so on up to 1999th.  Separate counter commands are provided for different
-letter case variants, and for masculine and feminine gender inflections.")
+@code{\\alph} and others) which produces output strings like @samp{primeiro}
+(@emph{first} in Portuguese), @samp{segundo}, (@emph{second}), and so on up to
+1999th.  Separate counter commands are provided for different letter case
+variants, and for masculine and feminine gender inflections.")
     (license license:lppl)))
 
 (define-public texlive-orkhun
@@ -31176,7 +31176,7 @@ (define-public texlive-pmhanguljamo
     (synopsis "Poor man's Hangul Jamo input method")
     (description
      "This package provides a Hangul transliteration input method that allows
-to typeset Korean letters (Hangul) using the proper fonts. The use of XeLaTeX
+to typeset Korean letters (Hangul) using the proper fonts.  The use of XeLaTeX
 is recommended.")
     (license license:lppl1.3+)))
 
@@ -39169,7 +39169,7 @@ (define-public texlive-urcls
      "The bundle provides a Beamer-derived class and a theme style file for
 the corporate design of the @acronym{UR, University of Regensburg}.  It also
 contains a @code{scrlttr2}-derived class for letters using the corporate
-design of the UR. Users may use the class itself (URbeamer) or use the theme
+design of the UR.  Users may use the class itself (URbeamer) or use the theme
 in the usual way with @code{\\usetheme@{UR@}}.")
     (license license:lppl)))
 
@@ -40343,8 +40343,8 @@ (define-public texlive-xyling
     (description
      "The macros in this package model the construction of linguistic tree
 structures as a genuinely graphical problem: they contain two types of
-objects, ``branches'' and ``node labels'', and these are positioned relative
-to a ``grid''.  It is essential that each of these three elements is
+objects, @emph{branches} and @emph{node labels}, and these are positioned relative
+to a @emph{grid}.  It is essential that each of these three elements is
 constructed independent of the other two, and hence they can be modified
 without unwanted side effects.  The macros are based on the XY-Pic package.")
     (license license:lppl)))
@@ -40544,7 +40544,7 @@ (define-public texlive-yb-book
     (synopsis "Template for YB branded books")
     (description
      "This template helps the author design books published on Amazon under
-the ``Y.B.'' brand.")
+the @emph{Y.B.} brand.")
     (license license:expat)))
 
 (define-public texlive-yfonts
@@ -44194,7 +44194,7 @@ (define-public texlive-lambda-lists
     (description
      "These list-processing macros avoid the reassignments employed in the
 macros shown in Appendix D of the TeXbook: all the manipulations take place in
-what Knuth is pleased to call ``TeX's mouth''.")
+what Knuth is pleased to call @emph{TeX's mouth}.")
     (license license:lppl)))
 
 (define-public texlive-langcode
@@ -48881,7 +48881,7 @@ (define-public texlive-optexcount
     (synopsis "Python script for counting words in OpTeX documents")
     (description
      "OpTeXcount is a basic Python utility that analyzes OpTeX source code.
-It is inspired by already existing TeXcount for LaTeX. The functionality is
+It is inspired by already existing TeXcount for LaTeX.  The functionality is
 really lightweight and basic.  It counts words and other elements of OpTeX
 document and sorts them out into individual categories.  Users can print the
 source code with highlighted words using several colors, so they see what is
@@ -49027,7 +49027,7 @@ (define-public texlive-pdfjam
     (description
      "The package makes available the @command{pdfjam} shell script that
 provides a simple interface to much of the functionality of the excellent
-@code{pdfpages} package for LaTeX. The @command{pdfjam} script takes one or
+@code{pdfpages} package for LaTeX.  The @command{pdfjam} script takes one or
 more PDF files (and/or JPG/PNG graphics files) as input, and produces one or
 more PDF files as output.  It is useful for joining files together, selecting
 pages, reducing several source pages onto one output page, etc.")
@@ -70284,8 +70284,8 @@ (define-public texlive-texbytopic
     (synopsis "@emph{TeX by Topic} book")
     (description
      "@emph{TeX by Topic} is a book originally published by Addison-Wesley.
-It describes itself as ``a TeXnician's reference'', and covers the way
-TeX (the engine) works in as much detail as most ordinary TeX programmers will
+It describes itself as @emph{a TeXnician's reference}, and covers the way TeX
+(the engine) works in as much detail as most ordinary TeX programmers will
 ever need to know.")
     (license license:fdl1.3+)))
 
@@ -75711,7 +75711,7 @@ (define-public texlive-pst-geo
 @code{pst-map2d} provides conventional projections such as Mercator, Lambert,
 cylindrical, etc.  The package @code{pst-map3d} treats representation in three
 dimensions of the terrestrial sphere.  Packages @code{pst-map2dII} and
-@code{pst-map3dII} allow use of the CIA World DataBank II. Various parameters
+@code{pst-map3dII} allow use of the CIA World DataBank II.  Various parameters
 of the packages allow for choice of the level of the detail and the layouts
 possible (cities, borders, rivers etc).  Substantial data files are provided,
 in an (internally) compressed format.  Decompression happens on-the-fly as
@@ -75999,7 +75999,7 @@ (define-public texlive-pst-layout
     (home-page "https://ctan.org/pkg/pst-layout")
     (synopsis "Page layout macros based on PSTricks packages")
     (description
-     "The package provides a means of creating elaborate (``pseudo-tabular'')
+     "The package provides a means of creating elaborate (@emph{pseudo-tabular})
 layouts of material, typically to be overlaid on an included graphic.")
     (license license:lppl)))
 
@@ -94588,8 +94588,9 @@ (define-public texlive-cancel
     (home-page "https://ctan.org/pkg/cancel")
     (synopsis "Place lines through maths formulae")
     (description
-     "This package draws diagonal lines (``cancelling'' a term) and arrows with
-limits (cancelling a term ``to a value'') through parts of maths formulae.")
+     "This package draws diagonal lines (@emph{cancelling} a term) and arrows
+with limits (cancelling a term @emph{to a value}) through parts of maths
+formulae.")
     (license license:public-domain)))
 
 (define-public texlive-canoniclayout
@@ -103507,10 +103508,10 @@ (define-public texlive-flippdf
     (home-page "https://ctan.org/pkg/flippdf")
     (synopsis "Horizontal flipping of pages with pdfLaTeX")
     (description
-     "The package allows the production of a document with pages mirrored.  This is
-sometimes required by publishers who want camera-ready documents to be printed
-on transparent film (to be viewed from the ``wrong'' side).  The package only
-works with pdfLaTeX or LuaLaTeX in PDF output mode.")
+     "The package allows the production of a document with pages mirrored.
+This is sometimes required by publishers who want camera-ready documents to be
+printed on transparent film (to be viewed from the @emph{wrong} side).  The
+package only works with pdfLaTeX or LuaLaTeX in PDF output mode.")
     (license license:lppl1.3c)))
 
 (define-public texlive-floatrow
@@ -105420,9 +105421,9 @@ (define-public texlive-gmdoc-enhance
     (home-page "https://ctan.org/pkg/gmdoc-enhance")
     (synopsis "Some enhancements to the @code{gmdoc} package")
     (description
-     "This package provides some enhancements for the @code{gmdoc} package: nicer
-formatting for multiple line inline comments, an ability to comment out some
-code, and a macro to input other files in ``normal'' LaTeX mode.")
+     "This package provides some enhancements for the @code{gmdoc} package:
+nicer formatting for multiple line inline comments, an ability to comment out
+some code, and a macro to input other files in @emph{normal} LaTeX mode.")
     (license license:lppl)))
 
 (define-public texlive-gmiflink
@@ -108069,20 +108070,20 @@ (define-public texlive-keyfloat
     (home-page "https://ctan.org/pkg/keyfloat")
     (synopsis "Provides a key/value interface for generating floats")
     (description
-     "The @code{keyfloat} package provides a key/value user interface for quickly
-creating figures with a single image each, figures with arbitrary contents,
-tables, subfloats, rows of floats, floats located ``here'', floats in the
-margin, and floats with text wrapped around them.  Key/value combinations may
-specify a caption and label, a width proportional to @code{\\linewidth},
-a fixed width and/or height, rotation, scaling, a tight or loose frame, an
-@code{\\arraystretch}, a continued float, additional supplemental text, and an
-artist/author's name with automatic index entry.  When used with the
-@code{tocdata} package, the name also appears in the list of figures.  Floats
-may be placed into a @code{row} environment, and are typeset to fit within the
-given number of columns, continuing to the next row if necessary.  Nested
-sub-rows may be used to generate layouts such as two small figures placed
-vertically next to one larger figure.  Subfloats are supported by two
-environments.")
+     "The @code{keyfloat} package provides a key/value user interface for
+quickly creating figures with a single image each, figures with arbitrary
+contents, tables, subfloats, rows of floats, floats located @emph{here},
+floats in the margin, and floats with text wrapped around them.  Key/value
+combinations may specify a caption and label, a width proportional to
+@code{\\linewidth}, a fixed width and/or height, rotation, scaling, a tight or
+loose frame, an @code{\\arraystretch}, a continued float, additional
+supplemental text, and an artist/author's name with automatic index entry.
+When used with the @code{tocdata} package, the name also appears in the list
+of figures.  Floats may be placed into a @code{row} environment, and are
+typeset to fit within the given number of columns, continuing to the next row
+if necessary.  Nested sub-rows may be used to generate layouts such as two
+small figures placed vertically next to one larger figure.  Subfloats are
+supported by two environments.")
     (license license:lppl1.3+)))
 
 (define-public texlive-keyindex
@@ -110616,10 +110617,10 @@ (define-public texlive-marginfit
     (home-page "https://ctan.org/pkg/marginfit")
     (synopsis "Improved margin notes")
     (description
-     "This package fixes various bugs with the margin paragraph implementation of
-LaTeX. Those bugs include margin notes that are attached to the wrong side as
-well as those that stick out of the bottom of the page.  This package provides
-a drop-in replacement solution.")
+     "This package fixes various bugs with the margin paragraph implementation
+of LaTeX.  Those bugs include margin notes that are attached to the wrong side
+as well as those that stick out of the bottom of the page.  This package
+provides a drop-in replacement solution.")
     (license license:lppl1.3+)))
 
 (define-public texlive-mathexam
@@ -114578,7 +114579,7 @@ (define-public texlive-pas-tableur
     (synopsis "Create a spreadsheet layout")
     (description
      "The package provides commands for creating a grid of rectangles, and commands
-for populating locations in the grid. PGF/TikZ is used for placement and
+for populating locations in the grid.  PGF/TikZ is used for placement and
 population of the cells.")
     (license license:lppl)))
 
@@ -120706,8 +120707,8 @@ (define-public texlive-stex
     (home-page "https://ctan.org/pkg/stex")
     (synopsis "Infrastructure for semantic preloading of LaTeX documents")
     (description
-     "The sTeX package collection is a version of (La)TeX that allows to
-markup (La)TeX documents semantically without leaving the document format,
+     "The sTeX package collection is a version of (La)TeX that allows marking
+up (La)TeX documents semantically without leaving the document format,
 essentially turning it into a document format for mathematical knowledge
 management (MKM).")
     (license license:lppl)))
@@ -120792,7 +120793,7 @@ (define-public texlive-sttools
      "This package provides a collection of tools and macros, providing:
 miscellaneous float control, page styles for floats, multipage tabulars, even
 columns at end of twocolumn region, switching between one- and two-column
-anywhere, simulating the effect of ``midfloats'', a package to manipulate
+anywhere, simulating the effect of @emph{midfloats}, a package to manipulate
 numerical lists and arrays.")
     (license license:lppl1.3+)))
 
@@ -121059,10 +121060,10 @@ (define-public texlive-suppose
     (home-page "https://ctan.org/pkg/suppose")
     (synopsis "Abbreviate the word @emph{Suppose}")
     (description
-     "This package provides commands for abbreviating the word ``Suppose'' in six
-fonts and with other variations.  The author recommends only using these
-commands when the immediately succeeding strings are mathematical in nature.
-He does not recommend using them in formal work.")
+     "This package provides commands for abbreviating the word @emph{Suppose}
+in six fonts and with other variations.  The author recommends only using
+these commands when the immediately succeeding strings are mathematical in
+nature.  He does not recommend using them in formal work.")
     (license license:lppl1.3c)))
 
 (define-public texlive-svgcolor
@@ -124282,8 +124283,9 @@ (define-public texlive-vgrid
     (home-page "https://ctan.org/pkg/vgrid")
     (synopsis "Overlay a grid on the printed page")
     (description
-     "The package overlays a grid (whose spacing is @code{\\baselineskip}, which
-offers guidelines for considering the ``rhythm'' of the document on the page.")
+     "The package overlays a grid (whose spacing is @code{\\baselineskip},
+which offers guidelines for considering the @emph{rhythm} of the document on
+the page.")
     (license license:lppl1.3+)))
 
 (define-public texlive-vhistory
@@ -124737,7 +124739,7 @@ (define-public texlive-wordlike
 
 The package aims at making life easier for users who are discontent with
 LaTeX's standard layout settings because they need a layout that resembles the
-usual ``wordlike'' output.")
+usual @emph{wordlike} output.")
     (license license:lppl)))
 
 (define-public texlive-worksheet
diff --git a/gnu/packages/text-editors.scm b/gnu/packages/text-editors.scm
index fae021f012..f0b154330a 100644
--- a/gnu/packages/text-editors.scm
+++ b/gnu/packages/text-editors.scm
@@ -577,9 +577,9 @@ (define-public jucipp
            universal-ctags))
     (synopsis "Lightweight C++ IDE")
     (description
-     "juCi++ is a small @acronym{IDE, Integrated Development Environment}
-designed especially towards libclang with speed, stability, and ease of use
-in mind.
+     "@emph{juCi++} is a small @acronym{IDE, Integrated Development
+Environment} designed especially towards libclang with speed, stability, and
+ease of use in mind.
 
 It supports autocompletion, on-the-fly warnings and errors, syntax
 highlighting, and integrates with Git as well as the CMake and Meson build
diff --git a/gnu/packages/textutils.scm b/gnu/packages/textutils.scm
index deebd893d6..0c61080be4 100644
--- a/gnu/packages/textutils.scm
+++ b/gnu/packages/textutils.scm
@@ -703,7 +703,8 @@ (define-public catdoc
     (synopsis "MS-Word to TeX or plain text converter")
     (description "@command{catdoc} extracts text from MS-Word files, trying to
 preserve as many special printable characters as possible.  It supports
-everything up to Word-97. Also supported are MS Write documents and RTF files.
+everything up to Word-97.  Also supported are MS Write documents and RTF
+files.
 
 @command{catdoc} does not preserve complex word formatting, but it can
 translate some non-ASCII characters into TeX escape codes.  It's goal is to
@@ -1264,7 +1265,7 @@ (define-public bibutils
     (home-page "https://bibutils.sourceforge.io/")
     (synopsis "Convert between various bibliography formats")
     (description "This package provides converters for various bibliography
-formats (e.g. Bibtex, RIS, ...) using a common XML intermediate.")
+formats (e.g. Bibtex, RIS, etc.) using a common XML intermediate.")
     (license license:gpl2)))
 
 (define-public goawk
diff --git a/gnu/packages/tor.scm b/gnu/packages/tor.scm
index ab1483245f..1d768e2670 100644
--- a/gnu/packages/tor.scm
+++ b/gnu/packages/tor.scm
@@ -130,7 +130,7 @@ (define-public tor
 applications based on the TCP protocol.
 
 This package is the full featured @code{tor} which is needed for running
-relays, bridges or directory authorities. If you just want to access the Tor
+relays, bridges or directory authorities.  If you just want to access the Tor
 network or to setup an onion service you may install @code{tor-client}
 instead.")
     (license license:bsd-3)))
diff --git a/gnu/packages/xdisorg.scm b/gnu/packages/xdisorg.scm
index ca50bebab4..96fcaeffd1 100644
--- a/gnu/packages/xdisorg.scm
+++ b/gnu/packages/xdisorg.scm
@@ -2375,10 +2375,10 @@ (define-public xftwidth
     (home-page "https://github.com/vixus0/xftwidth")
     (synopsis "Calculator for determining pixel widths of displayed text using Xft fonts")
     (description "xftwidth is a small C program for calculating the pixel
-widths of displayed text using Xft fonts. It is especially useful in scripts
+widths of displayed text using Xft fonts.  It is especially useful in scripts
 for displaying text in graphical panels, menus, popups, and notification
-windows generated using dzen. These scripts are often used in conjunction with
-minimalistic tiling window managers such as herbstluftwm and bspwm.")
+windows generated using dzen.  These scripts are often used in conjunction
+with minimalistic tiling window managers such as herbstluftwm and bspwm.")
     (license license:expat)))
 
 (define-public xcb-util-xrm
@@ -3103,7 +3103,7 @@ (define-public xwallpaper
     (synopsis "Wallpaper setting utility for X")
     (description
      "The xwallpaper utility allows you to set image files as your X
-wallpaper. JPEG, PNG, and XPM file formats are supported.
+wallpaper.  JPEG, PNG, and XPM file formats are supported.
 
 The wallpaper is also advertised to programs which support semi-transparent
 backgrounds.")
diff --git a/gnu/packages/xfce.scm b/gnu/packages/xfce.scm
index 48fdfc8fdc..544d8075dc 100644
--- a/gnu/packages/xfce.scm
+++ b/gnu/packages/xfce.scm
@@ -1596,8 +1596,8 @@ (define-public xfce4-volumed-pulse
     (home-page "https://goodies.xfce.org/projects/applications/xfce4-volumed")
     (synopsis "XFCE volume keys daemon")
     (description
-     "This is a volume keys control daemon for Xfce Desktop environment. It controls
- the volume using multimedia keys. It also provides volume change notifications.")
+     "This is a volume keys control daemon for Xfce Desktop environment.  It controls
+ the volume using multimedia keys.  It also provides volume change notifications.")
     (license gpl3+)))
 
 (define-public xfce4-cpugraph-plugin
diff --git a/gnu/packages/xml.scm b/gnu/packages/xml.scm
index 4a3936b66d..615b0835a2 100644
--- a/gnu/packages/xml.scm
+++ b/gnu/packages/xml.scm
@@ -633,10 +633,9 @@ (define-public perl-libxml
     (license license:perl-license)
     (synopsis "Perl modules for working with XML")
     (description
-     "libxml-perl is a collection of smaller Perl modules, scripts, and
-documents for working with XML in Perl.  libxml-perl software works in
-combination with @code{XML::Parser}, PerlSAX, @code{XML::DOM},
-@code{XML::Grove}, and others.")
+     "A collection of smaller Perl modules, scripts, and documents for working
+with XML in Perl.  libxml-perl software works in combination with
+@code{XML::Parser}, PerlSAX, @code{XML::DOM}, @code{XML::Grove}, and others.")
     (home-page "https://metacpan.org/release/libxml-perl")))
 
 (define-public perl-xml-libxml
diff --git a/gnu/packages/xorg.scm b/gnu/packages/xorg.scm
index 0de08a4ad1..6203791c2d 100644
--- a/gnu/packages/xorg.scm
+++ b/gnu/packages/xorg.scm
@@ -3731,7 +3731,7 @@ (define-public xkbprint
     (home-page "https://www.x.org/wiki/")
     (synopsis "Visualise an XKB keyboard layout description")
     (description
-     "The @command{xkbprint} utility visualises (``prints'') an XKB keyboard
+     "The @command{xkbprint} utility visualises (@emph{prints}) an XKB keyboard
 description as printable or encapsulated PostScript.  It accepts any compiled
 keymap (@file{.xkm}) file that includes a geometry description, or can obtain
 one from a running X server.")
-- 
2.46.0






^ permalink raw reply related	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2024-11-12 20:43 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2024-11-12 20:36 [bug#74329] [PATCH 0/2] Extensively lint descriptions and synopses Gabriel Wicki
     [not found] ` <handler.74329.B.173144383113227.ack@debbugs.gnu.org>
2024-11-12 20:41   ` [bug#74329] [PATCH 1/2] gnu: Lint synopses Gabriel Wicki
2024-11-12 20:42   ` [bug#74329] [PATCH 2/2] gnu: Lint descriptions Gabriel Wicki

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/guix.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).