From mboxrd@z Thu Jan 1 00:00:00 1970 From: Pierre Neidhardt Subject: bug#37850: Glib documentation is missing Date: Mon, 04 Nov 2019 10:46:55 +0100 Message-ID: <87ftj4m0s0.fsf@ambrevar.xyz> References: <87pniq9y2e.fsf@ambrevar.xyz> <8736fjwcd2.fsf@devup.no> <87wocvwbmy.fsf@ambrevar.xyz> <87pnikldtt.fsf@gnu.org> <87v9sbj2ru.fsf@ambrevar.xyz> <87h83ret3a.fsf@ambrevar.xyz> <87k18gncbn.fsf@ambrevar.xyz> <8736f4ok77.fsf@devup.no> Mime-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha256; protocol="application/pgp-signature" Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:46557) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iRYxv-0002Ap-QF for bug-guix@gnu.org; Mon, 04 Nov 2019 04:48:06 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iRYxu-0001as-Iv for bug-guix@gnu.org; Mon, 04 Nov 2019 04:48:03 -0500 Received: from debbugs.gnu.org ([209.51.188.43]:55292) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iRYxu-0001ac-6E for bug-guix@gnu.org; Mon, 04 Nov 2019 04:48:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1iRYxu-0001Bd-0i for bug-guix@gnu.org; Mon, 04 Nov 2019 04:48:02 -0500 Sender: "Debbugs-submit" Resent-Message-ID: In-Reply-To: <8736f4ok77.fsf@devup.no> List-Id: Bug reports for GNU Guix List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org Sender: "bug-Guix" To: Marius Bakke , Ludovic =?UTF-8?Q?Court=C3=A8s?= Cc: 37850@debbugs.gnu.org --=-=-= Content-Type: text/plain Content-Transfer-Encoding: quoted-printable Marius Bakke writes: > Pierre Neidhardt writes: > >> From 893613a3b99c20688cc331d2926dbee28cc143d7 Mon Sep 17 00:00:00 2001 >> From: Pierre Neidhardt >> Date: Sun, 3 Nov 2019 17:36:17 +0100 >> Subject: [PATCH] gnu: Add glib-minimal and build glib doc. >> >> glib documentation must be built with gtk-doc which in turn depends on g= lib, >> so we need to define glib-minimal which does not depend on gtk-doc. >> >> * gnu/packages/glib.scm (glib-minimal): New variable. >> (glib)[source]: Don't use `name'. >> * gnu/packages/avahi.scm: Use glib-minimal when necessary. >> * gnu/packages/cups.scm: Use glib-minimal when necessary. >> * gnu/packages/gnome.scm: Use glib-minimal when necessary. >> * gnu/packages/graphviz.scm: Use glib-minimal when necessary. >> * gnu/packages/gtk.scm: Use glib-minimal when necessary. >> * gnu/packages/inkscape.scm: Use glib-minimal when necessary. >> * gnu/packages/pdf.scm: Use glib-minimal when necessary. > > Please mention all changed variables and inputs here, as we always do. Sure, I didn't because I wasn't sure it was a good idea either :p > That said, I'm not certain this is a good solution. Why do some > packages use glib-minimal and others not? What does "necessary" mean in > this context? > > What about 'hiding' the normal glib package, and expose a > 'glib-with-documentation' variant to end users, similar to how the > 'cmake' package works? cmake-minimal builds the doc already, I don't see a cmake-with-documentation. Did you mean something else? I see a couple packages with the "-documentation" prefix, so we could use "glib-documentation". In a previous email, I explained that I wanted to put the documentation in the "doc" output of glib for 2 reasons: =2D For consistency with the other packages from the GTK family. =2D To restore the missing "gtk:doc" output. If I understand correctly, we don't have a provision to deprecate outputs, only packages. I think this is a bug. Now my current patch is admittedly not pretty. If we fix the output deprecation feature, then glib:doc could be forwarded to glib-documentation. And I guess we can live without complete consistency. Thoughts? =2D-=20 Pierre Neidhardt https://ambrevar.xyz/ --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQEzBAEBCAAdFiEEUPM+LlsMPZAEJKvom9z0l6S7zH8FAl2/848ACgkQm9z0l6S7 zH+eYQf/XfqZrRT1dUCWX9fHSlWFNVLLXhU87+IUNd9gRMRcnVId2wnYTF8PcU33 s0UqyV3ox2bYvv9Yk9fVjqWb1imHexqI2srX6MCUxvlPDHW3PNwKSDTOoije8D+Y TYNOHpaHOPMIbOJFQrTKpUIV+WFsT9ekciqCK1HX3NTVbnn6cr7Vy2SA/4Ipz1b/ Cq/zs2/ODokCB+HAHfs9hfL15ACso6WLCB1UzauS4RkChrvudtZViCeV5JDuYxLi bL1HBA4xfHuhMbhALD7YjxKG2PtLyLjkHhxm4eMJjhXOCZ0ICNSorON/HJqS1BKo SyJWOkAajrA51ASmOUuh2QJUn/ST6w== =UOPh -----END PGP SIGNATURE----- --=-=-=--