'\" t
.\" Title: ligcc
.\" Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.78.1
.\" Date: 20 April,2012
.\" Manual: Listaller Project
.\" Source: Listaller Project
.\" Language: English
.\"
.TH "LIGCC" "1" "20 April,2012" "Listaller Project" "Listaller Project"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ligcc \- Wrapper around gcc to create more portable apps
.SH "SYNOPSIS"
.HP \w'\fBligcc\fR\ 'u
\fBligcc\fR [\fBOPTION \&.\&.\&.\fR]
.SH "DESCRIPTION"
.PP
This manual page documents briefly the
\fBligcc\fR
command\&.
.PP
\fBligcc\fR
is a wrapper around gcc\&. It allows you to create more portable executables by doing three things:
.PP
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Forces the linker to link against older glibc symbols\&. Users who are using an older version of glibc will no longer get "undefined symbol GLIBC_2\&.4 in /lib/libc\&.so"\-style error messages\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Allows you to easily statically link to any other library\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Automatically removes bogus dependencies\&. For example, your program uses libfoo\&. libfoo uses libpng internally, but your app does not\&. Yet the pkg\-config file for libfoo specifies "\-lfoo \-lpng" is linker parameters\&. And tadaa \- you now have a bogus dependency on libpng! LiGCC automatically removes the \-lpng for you if your app doesn\*(Aqt use libpng directly\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Add $ORIGIN/\&.\&./lib to the binary\*(Aqs library search path\&. $ORIGIN is the directory in which the binary exists\&. This ensures that your binary can find library dependencies which are placed in the \*(Aqlib\*(Aq folder under the same prefix\&. You might want to install custom libraries into /lib\&. If you set $APBUILD_PROJECTNAME, ligcc will also add $ORIGIN/\&.\&./lib/$APBUILD_PROJECTNAME to the library search path\&.
.RE
.sp
.SH "OPTIONS"
.PP
See the manpage of gcc(1) for more information about possible options\&.
.PP
There are also several environment variables available to modify ligcc\*(Aqs behavior check the documentation for more information\&.
.SH "SEE ALSO"
.PP
lig++ (1), gcc(1)\&.
.PP
Additional documentation can be found on http://listaller\&.tenstral\&.net\&.
.SH "AUTHOR"
.PP
This manual page was written by Matthias Klumpp
\&.
.SH "COPYRIGHT"
.br
Copyright \(co 2009-2012 Matthias Klumpp
.br