summary refs log tree commit diff
path: root/pkgs/development/libraries/glibc
diff options
context:
space:
mode:
authorVladimír Čunát <vcunat@gmail.com>2018-04-22 11:55:23 +0200
committerVladimír Čunát <vcunat@gmail.com>2018-04-22 11:55:23 +0200
commit17c4b83d05931bdc1364419b8264ea2c15b23223 (patch)
treef5a111724caf06466ecb069e53f0e117af86536e /pkgs/development/libraries/glibc
parenta1703436af652c435559278043bd5c220e7d756b (diff)
parente4afe8fc6c19ca62baa6e7c2c1bb64d7b09f3440 (diff)
downloadnixlib-17c4b83d05931bdc1364419b8264ea2c15b23223.tar
nixlib-17c4b83d05931bdc1364419b8264ea2c15b23223.tar.gz
nixlib-17c4b83d05931bdc1364419b8264ea2c15b23223.tar.bz2
nixlib-17c4b83d05931bdc1364419b8264ea2c15b23223.tar.lz
nixlib-17c4b83d05931bdc1364419b8264ea2c15b23223.tar.xz
nixlib-17c4b83d05931bdc1364419b8264ea2c15b23223.tar.zst
nixlib-17c4b83d05931bdc1364419b8264ea2c15b23223.zip
Merge #31320: docs and glibc: explicit comments on outputs
Diffstat (limited to 'pkgs/development/libraries/glibc')
-rw-r--r--pkgs/development/libraries/glibc/common.nix18
1 files changed, 17 insertions, 1 deletions
diff --git a/pkgs/development/libraries/glibc/common.nix b/pkgs/development/libraries/glibc/common.nix
index 517c98e9f644..c8716bfdc796 100644
--- a/pkgs/development/libraries/glibc/common.nix
+++ b/pkgs/development/libraries/glibc/common.nix
@@ -1,5 +1,21 @@
 /* Build configuration used to build glibc, Info files, and locale
-   information.  */
+   information.
+
+   Note that this derivation has multiple outputs and does not respect the
+   standard convention of putting the executables into the first output. The
+   first output is `lib` so that the libraries provided by this derivation
+   can be accessed directly, e.g.
+
+     "${pkgs.glibc}/lib/ld-linux-x86_64.so.2"
+
+   The executables are put into `bin` output and need to be referenced via
+   the `bin` attribute of the main package, e.g.
+
+     "${pkgs.glibc.bin}/bin/ldd".
+
+  The executables provided by glibc typically include `ldd`, `locale`, `iconv`
+  but the exact set depends on the library version and the configuration.
+*/
 
 { stdenv, lib
 , buildPlatform, hostPlatform