Document non-obvious USE flags on metadata.xml.

Package-Manager: portage-2.1.4_rc11

3 files changed, 64 insertions, 12 deletions

diff --git a/media-libs/xine-lib/ChangeLog b/media-libs/xine-lib/ChangeLog
index a24b9d7968d7..3636e296b9ec 100644
--- a/media-libs/xine-lib/ChangeLog
+++ b/media-libs/xine-lib/ChangeLog
@@ -1,6 +1,9 @@
 # ChangeLog for media-libs/xine-lib
 # Copyright 1999-2007 Gentoo Foundation; Distributed under the GPL v2
-# $Header: /var/cvsroot/gentoo-x86/media-libs/xine-lib/ChangeLog,v 1.484 2007/10/08 17:20:23 corsair Exp $
+# $Header: /var/cvsroot/gentoo-x86/media-libs/xine-lib/ChangeLog,v 1.485 2007/12/30 14:04:13 flameeyes Exp $
+
+  30 Dec 2007; Diego Pettenò <flameeyes@gentoo.org> metadata.xml:
+  Document non-obvious USE flags on metadata.xml.
 
   08 Oct 2007; Markus Rothe <corsair@gentoo.org> xine-lib-1.1.8.ebuild:
   Stable on ppc64; bug #192577
diff --git a/media-libs/xine-lib/Manifest b/media-libs/xine-lib/Manifest
index d5faaa60670f..1e09e931be20 100644
--- a/media-libs/xine-lib/Manifest
+++ b/media-libs/xine-lib/Manifest
@@ -34,14 +34,14 @@ EBUILD xine-lib-1.1.8.ebuild 5659 RMD160 8750f9f4c64a721f4589786c00d2b9df8043a0d
 MD5 6c079ace267ca1d4d2b1618f2e34fb5a xine-lib-1.1.8.ebuild 5659
 RMD160 8750f9f4c64a721f4589786c00d2b9df8043a0d9 xine-lib-1.1.8.ebuild 5659
 SHA256 17f65227a0d34a90217478ee110e95dfcef3840da8396ceec3eb4a5a6eb383f1 xine-lib-1.1.8.ebuild 5659
-MISC ChangeLog 53577 RMD160 7707b6dc9d2e9b6be81464690d27a7277ab067da SHA1 7715ecc2c2d1a8f1ce3539c3f108dc1098738ede SHA256 19b9a957dc638cd52f5cb736c5855a94f738e06aa5362e3df0feca23e26479b5
-MD5 b04d5505132e889faa0b741bf3ba5768 ChangeLog 53577
-RMD160 7707b6dc9d2e9b6be81464690d27a7277ab067da ChangeLog 53577
-SHA256 19b9a957dc638cd52f5cb736c5855a94f738e06aa5362e3df0feca23e26479b5 ChangeLog 53577
-MISC metadata.xml 306 RMD160 032164f452f69c128150b68ddf2c837a20fa11e7 SHA1 1b6a82c8dbb60a55051e663290b1fa4fbd0cdb2e SHA256 cc2402ccd44aff7c94a0865c12d43a8250e8277253395924cb145fe99a6fb560
-MD5 baed93b1b1c2bcbdce8ae48aa25df8fd metadata.xml 306
-RMD160 032164f452f69c128150b68ddf2c837a20fa11e7 metadata.xml 306
-SHA256 cc2402ccd44aff7c94a0865c12d43a8250e8277253395924cb145fe99a6fb560 metadata.xml 306
+MISC ChangeLog 53697 RMD160 fe4ecbfb2bcc3730ecca00dea80aca2473c747e5 SHA1 87be1202cb6ca01b614b6e26fa430c69fa4babb5 SHA256 82ffeb8fd2462714cbcf9ea953aea95737622f594c6acaab783ce34df18c690a
+MD5 82b6c2546da6d779c68b2f5884fed829 ChangeLog 53697
+RMD160 fe4ecbfb2bcc3730ecca00dea80aca2473c747e5 ChangeLog 53697
+SHA256 82ffeb8fd2462714cbcf9ea953aea95737622f594c6acaab783ce34df18c690a ChangeLog 53697
+MISC metadata.xml 2559 RMD160 f8ae3331071ee8b4e99ed4b81fa2352a0d7d79b3 SHA1 9c93a986bebdf908f8bab1fbafc111c0cffb5da9 SHA256 53585093644ab317ca0b11074e4fa86e67af3889e480b0ed9f5b467a85372fcd
+MD5 95155a1c956f6afd32d49dc656807b3a metadata.xml 2559
+RMD160 f8ae3331071ee8b4e99ed4b81fa2352a0d7d79b3 metadata.xml 2559
+SHA256 53585093644ab317ca0b11074e4fa86e67af3889e480b0ed9f5b467a85372fcd metadata.xml 2559
 MD5 a772cb8123385cb3185e9b3f19b5906a files/digest-xine-lib-1.1.4-r2 512
 RMD160 180e6a88dda4bf1ef40d2edad8567aed17b43383 files/digest-xine-lib-1.1.4-r2 512
 SHA256 360727ef64b680578258f7c715c18cd8084ab53bc5ceb3973f8ad63bd6083a4c files/digest-xine-lib-1.1.4-r2 512
@@ -57,7 +57,7 @@ SHA256 e6eb4aa02af1961a4192b5be866a421c8065bba1b10c841323d58fda78a12e09 files/di
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v2.0.8 (GNU/Linux)
 
-iEYEARECAAYFAkd2MfkACgkQj9hvisErhMIGkgCg6CfpPjwsuw1iqAg6J4Et0zll
-/PUAoM/+R9ww1bNIhHMO6i9pVsnXLjfd
-=7L3+
+iEYEARECAAYFAkd3o9sACgkQAiZjviIA2XifNQCfYDd4kyS5QV2MHJn5yijJqo2C
+JZ8An0ia5QBD0GStwjczhzRqT2wcaaBD
+=kpK4
 -----END PGP SIGNATURE-----
diff --git a/media-libs/xine-lib/metadata.xml b/media-libs/xine-lib/metadata.xml
index 397dc4e0676c..a7d72bceddf0 100644
--- a/media-libs/xine-lib/metadata.xml
+++ b/media-libs/xine-lib/metadata.xml
@@ -6,4 +6,53 @@
   <email>media-video@gentoo.org</email>
 </maintainer>
 <longdescription>An open source library for media applications</longdescription>
+<use>
+  <flag name="real">
+    Enable support for loading and using RealPlayer binary codecs on x86 and
+    amd64 Linux. Enabling this USE flag might make the package
+    non-redistributable in binary form.
+  </flag>
+  <flag name="win32codecs">
+    Enable support for loading and using Windows 32-bit binary codecs on x86
+    Linux and FreeBSD. Enabling this USE flag might make the package
+    non-redistributable in binary form.
+  </flag>
+  <flag name="mad">
+    Build the <pkg>media-libs/libmad</pkg> based mp3 decoder. This mp3 decoder
+    has superior support compared to the one coming from FFmpeg that is used as
+    a fallback. If you experience any bad behaviour with mp3 files (skipping,
+    distorted sound) make sure you enabled this USE flag.
+  </flag>
+  <flag name="flac">
+    Build the <pkg>media-libs/flac</pkg> based FLAC demuxer and decoder. This
+    flag is not needed for playing FLAC content, neither standalone nor in Ogg
+    container (OggFLAC), but might have better support for exotic features like
+    24-bit samples or 96kHz sample rates.
+  </flag>
+  <flag name="gtk">
+    Build the gdkpixbuf-based image decoder plugin.
+  </flag>
+  <flag name="imagemagick">
+    Build the ImageMagick-based image decoder plugin.
+  </flag>
+  <flag name="gnome">
+    Build the <pkg>gnome-base/gnome-vfs</pkg> based input plugin. This plugin is
+    used to access any resource that can be accessed through Nautilus's (and
+    others') URLs.
+  </flag>
+  <flag name="mmap">
+    Use mmap() function while reading file from local disks. Using mmap() will
+    use more virtual memory space, but leaves to the Kernel the task of caching
+    the file's data. mmap() access should be faster, but might misbehave if the
+    device where the file resides in is removed during playback.
+  </flag>
+  <flag name="truetype">
+    Use <pkg>media-libs/freetype</pkg> for font rendering and
+    <pkg>media-libs/fontconfig</pkg> for font discovery. Enabling this USE flag
+    will allow OSD (such as subtitles) to use more advanced font and to more
+    easily select which font to use. The support for TrueType fonts in xine-lib
+    is still experimental, and might not be as good looking as the bitmap fonts
+    used with this USE flag disabled.
+  </flag>
+</use>
 </pkgmetadata>