From b0a9948f5e0d91582b9f3bc457d813227d9aea0c Mon Sep 17 00:00:00 2001
From: Sam Hocevar <sam@hocevar.net>
Date: Sun, 12 Nov 2006 10:32:38 +0000
Subject: [PATCH]   * Mention caca-config being deprecated in its manpage, and
 removed mention     of --plugin-libs from it. The option is still here but
 does the same as     --libs.

---
 doc/caca-config.1 | 41 +++++++++++++++++------------------------
 1 file changed, 17 insertions(+), 24 deletions(-)

diff --git a/doc/caca-config.1 b/doc/caca-config.1
index a68e9cd..a5711b5 100644
--- a/doc/caca-config.1
+++ b/doc/caca-config.1
@@ -7,12 +7,18 @@ caca-config \- script to get information about the installed version of libcaca
 .IR DIR ]
 [ --exec-prefix=
 .IR DIR ]
-[ --version ] [ --libs | --plugin-libs ] [ --cflags ]
+[ --version ] [ --libs ] [ --cflags ]
 .SH DESCRIPTION
 .B caca-config
 is a tool that is used to configure and determine the compiler and linker
 flags that should be used to compile and link progams, libraries, and
 plugins that use libcaca.
+
+The use of
+.B caca-config
+is deprecated. The more generic tool
+.B pkg-config
+should be used instead.
 .SH OPTIONS
 .TP
 .B --cflags
@@ -23,29 +29,19 @@ that uses libcaca.
 If specified, use
 .I DIR
 instead of the installation exec prefix that libcaca was build with when
-computing the output for the --cflags, --libs, and --plugin-libs options.
-This option must be specified before any of the --cflags, --libs, and
---plugin-libs options.
+computing the output for the --cflags and --libs options.
+This option must be specified before any of the --cflags and --libs options.
 .TP
 .B --libs
-Print the linker flags that are necessary to link a program that uses
-libcaca.
-.TP
-.B --plugin-libs
-Print the linker flags that are necessary to link a libcaca-using object that
-is to be accessed via
-.IR dlopen (3).
-This may include static objects with PIC symbol information.  This option
-should
-.B not
-be used for standalone applications.
+Print the linker flags that are necessary to link a program or library
+that uses libcaca.
 .TP
 .BI --prefix= DIR
 If specified, use PREFIX instead of the installation prefix that libcaca
-was built with when computing the output for the --cflags, --libs,
-and --plugin-libs options.  This option is also used for the exec prefix
-if --exec-prefix was not specified.  This option must be specified before
-any of the --cflags, --libs, and --plugin-libs options.
+was built with when computing the output for the --cflags and --libs
+options.  This option is also used for the exec prefix if --exec-prefix
+was not specified.  This option must be specified before any of the --cflags
+and --libs options.
 .TP
 .B --version
 Prints the currently installed version of libcaca on standard output.
@@ -60,11 +56,8 @@ gcc -o my_app $(caca-config --libs) main.o util.o
 is how you might use
 .B caca-config
 to link compiled objects into an executable program.
-.TP
-gcc -o libcaca_plugin.so $(caca-config --plugin-libs) caca_plugin.o stubs.o
-is how you might use
-.B caca-config
-to link compiled objects into a plugin for use by another program.
+.SH SEE ALSO
+pkg-config(1)
 .SH AUTHOR
 The libcaca library was written by Sam Hocevar <sam@zoy.org>.
 .PP