ObjFW  objfw-compile.1 at [d14ff4a3bd]

File utils/objfw-compile.1 artifact 5f6cec4ea1 part of check-in d14ff4a3bd


.\"
.\" Copyright (c) 2008-2024 Jonathan Schleifer <js@nil.im>
.\"
.\" All rights reserved.
.\"
.\" This program is free software: you can redistribute it and/or modify it
.\" under the terms of the GNU Lesser General Public License version 3.0 only,
.\" as published by the Free Software Foundation.
.\"
.\" This program is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
.\" version 3.0 for more details.
.\"
.\" You should have received a copy of the GNU Lesser General Public License
.\" version 3.0 along with this program. If not, see
.\" <https://www.gnu.org/licenses/>.
.\"
.TH objfw-compile 1
.SH NAME
objfw-compile - compile simple projects using ObjFW
.SH SYNOPSIS
.B objfw-config
[\fBoptions\fR]
\fB\-o\fR \fIoutname\fR
\fIsources\fR
.SH DESCRIPTION
.B objfw-compile
is a program to compile simple projects using ObjFW.
.SH OPTIONS
.TP
.BR \fB\-o\fR " " \fIoutname\fR
Specify the output name (not the file name!).
.TP
.BR \fB\-\-arc\fR
Use automatic reference counting.
.TP
.BR \fB\-\-lib\fR " " \fIversion\fR
Compile a static library (with the specified version) instead of an application.
.TP
.BR \fB\-\-plugin\fR
Compile a plugin instead of an application.
.TP
.BR \fB\-\-package\fR " " \fIname\fR
Use the specified package.
.TP
.BR \fB\-\-builddir\fR " " \fIdir\fR
Place built objects into the specified directory.
.TP
.BR \fB\-D\fIdefine\fR ", " \fB\-D\fR " " \fIdefine\fR
Pass the specified define to the compiler.
.TP
.BR \fB\-framework\fR " " \fIframework\fR
Pass the specified -framework argument to the linker (macOS / iOS only).
.TP
.BR \fB\-f\fIflag\fR
Pass the specified -f flag to the compiler.
.TP
.BR \fB\-F\fIdir\fR ", " \fB\-F\fR " " \fIdir\fR
Pass the specified -F flag to the linker (macOS / iOS only).
.TP
.BR \fB\-g\fIflag\fR
Pass the specified -g flag to the compiler.
.TP
.BR \fB\-I\fIdir\fR ", " \fB\-I\fR " " \fIdir\fR
Pass the specified -I flag to the compiler.
.TP
.BR \fB\-l\fIlib\fR ", " \fB\-l\fR " " \fIlib\fR
Pass the specified -l flag to the linker.
.TP
.BR \fB\-L\fIdir\fR ", " \fB\-L\fR " " \fIdir\fR
Pass the specified -L flag to the linker.
.TP
.BR \fB\-m\fIflag\fR
Pass the specified -m flag to the compiler.
.TP
.BR \fB\-O\fIlevel\fR
Pass the specified -O flag to the compiler.
.TP
.BR \fB\-pthread\fR
Pass -pthread to the compiler and linker.
.TP
.BR \fB\-std=\fIlang\fR
Pass the specified -std= flag to the compiler.
.TP
.BR \fB\-Wl,\fIflag\fR
Pass the specified -Wl, flag to the linker.
.TP
.BR \fB\-W\fIwarning\fR
Pass the specified -W flag to the compiler.
.TP
.BR \fB\-\-help\fR
Show the help.
.SH EXAMPLES
Compile a program with two source files:
.PP
	objfw-compile -o myprog MyProg.m SomeClass.m
.PP
Compile a library with library version 1.0:
.PP
	objfw-compile --lib 1.0 -o mylib Class1.m Class2.m
.SH SEE ALSO
\fIobjfw-config\fR(1)