Re: [PATCH] gnu: Document xorg packages.

[ludo@gnu.org (Ludovic Courtès)]

Alex Kost <alezost@gmail.com> skribis:

> Oh god!  I didn't realize it would be so much, when I began many days
> ago :-)  I can't imagine, how Andreas managed to package all this stuff!

Indeed!  And I wonder how you managed to clean up all these
synopses/descriptions.  :-)

Anyway, that’s really a great idea, I was tired of seeing them when
browsing gnu.org/s/guix/packages.  ;-)

> And one more thing: there are "windowswmproto" and "libwindowswm"
> packages that have something to do with MS Windows and Cygwin.  Do we
> need them?

If that’s really what they are, let’s remove them.

> From 9b0d9bec0e1b1a3ce949f7d93a6598b75b050c86 Mon Sep 17 00:00:00 2001
> From: Alex Kost <alezost@gmail.com>
> Date: Sun, 12 Jul 2015 19:47:39 +0300
> Subject: [PATCH] gnu: Document xorg packages.
>
> * gnu/packages/xorg.scm: Add/imrove 'synopsis'/'description' fields of
>   many packages.

OK!

> +    (description
> +     "XExtProto provides the following extensions:
> +
> +DOUBLE-BUFFER
> +DPMS
> +Extended-Visual-Information
> +Generic Event Extension
> +LBX
> +MIT-SHM
> +MIT-SUNDRY-NONSTANDARD
> +Multi-Buffering
> +SECURITY
> +SHAPE
> +SYNC
> +TOG-CUP
> +XC-APPGROUP
> +XTEST")

Formatting will be lost in UIs, so this should be a comma-separated list
instead.

> +    (description
> +     "XKBUtils is a collection of small utilities for X Keyboard (XKB)
> +extension to the X11 protocol.  It includes:
> +
> +  - xkbbell  - generate XKB bell events;
> +  - xkbvleds - display the state of LEDs on an XKB keyboard in a window;
> +  - xkbwatch - reports changes in the XKB keyboard state.")

Likewise.

> +    (description
> +     "libxcb provides an interface to the X Window System protocol,
> +which replaces the current Xlib interface.  It has several advantages
> +over Xlib, including:
> +
> +- size: small, simple library, and lower memory footprint;
> +- latency hiding: batch several requests and wait for the replies later;
> +- direct protocol access: interface and protocol correspond exactly;
> +- proven thread support: transparently access XCB from multiple threads;
> +- easy extension implementation: interfaces auto-generated from XML-XCB.")

Likewise.

>  The XCB util module provides the following libraries:
> -aux: Convenient access to connection setup and some core requests.
> -atom: Standard core X atom constants and atom caching.
> -event: Some utilities that have little to do with events any more.")
> +- aux: Convenient access to connection setup and some core requests.
> +- atom: Standard core X atom constants and atom caching.
> +- event: Some utilities that have little to do with events any more.")
>      (license license:x11)))
>  

Likewise.

>  The XCB util-wm module provides the following libraries:
> -ewmh: Both client and window-manager helpers for EWMH.
> -icccm: Both client and window-manager helpers for ICCCM.")
> +- ewmh: Both client and window-manager helpers for EWMH.
> +- icccm: Both client and window-manager helpers for ICCCM.")

Likewise.

OK with these changes.

Thanks for the herculean work!

Ludo’.