Changeset 1356 for libcacaTweet

Timestamp:

Nov 12, 2006, 11:32:38 AM (16 years ago)

Author:

Sam Hocevar

Message:

• 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.

File:

• libcaca/trunk/doc/caca-config.1 (modified) (4 diffs)

libcaca/trunk/doc/caca-config.1

@@ -8 +8 @@
 [ --exec-prefix=
 .IR DIR ]
-[ --version ] [ --libs | --plugin-libs ] [ --cflags ]
+[ --version ] [ --libs ] [ --cflags ]
 .SH DESCRIPTION
 .B caca-config
@@ -14 +14 @@
 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
@@ -24 +30 @@
 .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
@@ -61 +57 @@
 .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>.