D-Bus: Use proper source_object in callbacks of async calls with GDBus
[vala-lang.git] / doc / valac.1
blobaa0e2629bdc5edf5eaf497053c4f6f7edef0042f
1 .TH valac 1 "13 April 2010" "vala-0.8.0" "Vala"
2 .SH NAME
3 valac \- compiler that translates Vala source code into C source and header files
4 .SH SYNOPSIS
5 .B valac
6 [\fIOPTION\fR]... [\fIFILE\fR]...
7 .SH DESCRIPTION
8 Vala  is  a  new  programming  language  that  aims  to  bring  modern
9 programming language features to GNOME developers without imposing any
10 additional  runtime requirements  and  without using  a different  ABI
11 compared to applications and libraries written in C.
13 valac, the Vala compiler, is a self-hosting compiler that translates
14 Vala source code into C source and header files. It uses the GObject
15 type system to create classes and interfaces declared in the Vala
16 source code.
17 .SH OPTIONS
18 .TP
19 .B \--help
20 .TP
21 .B \--girdir=\fIDIRECTORY\fR...
22 Look for .gir files in \fIDIRECTORY\fR
23 .TP
24 .B \--vapidir=\fIDIRECTORY\fR...
25 Look for package bindings in \fIDIRECTORY\fR
26 .TP
27 .B \--pkg=\fIPACKAGE\fR...
28 Include binding for \fIPACKAGE\fR
29 .TP
30 .B \--vapi=\fIFILE\fR
31 Output VAPI file name
32 .TP
33 .B \--library=\fINAME\fR
34 Library name
35 .TP
36 .B \--gir=\fINAME\fR-\fIVERSION\fR.gir
37 GObject-Introspection repository file name
38 .TP
39 .B \-b, --basedir=\fIDIRECTORY\fR
40 Base source directory
41 .TP
42 .B \-d, --directory=\fIDIRECTORY\fR
43 Output directory
44 .TP
45 .B \--version
46 Display version number
47 .TP
48 .B \-C, --ccode
49 Output C code
50 .TP
51 .B \-H, --header=\fIFILE\fR
52 Output C header file
53 .TP
54 .B \--use-header
55 Use C header file
56 .TP
57 .B \--includedir=\fIDIRECTORY\fR
58 Directory used to include the C header file
59 .TP
60 .B \-h, --internal-header=\fIFILE\fR
61 Output internal C header file
62 .TP
63 .B \--internal-vapi=\fIFILE\fR
64 Output vapi with internal api
65 .TP
66 .B \--symbols=\fIFILE\fR
67 Output symbols file
68 .TP
69 .B \-c, --compile
70 Compile but do not link
71 .TP
72 .B \-o, --output=\fIFILE\fR
73 Place output in file \fIFILE\fR
74 .TP
75 .B \-g, --debug
76 Produce debug information
77 .TP
78 .B \--thread
79 Enable multithreading support
80 .TP
81 .B \--enable-mem-profiler
82 Enable GLib memory profiler
83 .TP
84 .B \-D, --define=SYMBOL...
85 Define SYMBOL
86 .TP
87 .B \--main=SYMBOL...
88 Use SYMBOL as entry point
89 .TP
90 .B \--nostdpkg
91 Do not include standard packages
92 .TP
93 .B \--disable-assert
94 Disable assertions
95 .TP
96 .B \--enable-checking
97 Enable additional run-time checks
98 .TP
99 .B \--enable-deprecated
100 Enable deprecated features
102 .B \--enable-experimental
103 Enable experimental features
105 .B \--disable-warnings
106 Disable warnings
108 .B \--fatal-warnings
109 Treat warnings as fatal
111 .B \--enable-experimental-non-null
112 Enable experimental enhancements for non-null types
114 .B \--disable-dbus-transformation
115 Disable transformation of D-Bus member names
117 .B \--cc=\fICOMMAND\fR
118 Use \fICOMMAND\fR as C compiler command
120 .B \-X, --Xcc=\fIOPTION\fR...
121 Pass \fIOPTION\fR. to the C compiler
123 .B \--dump-tree=\fIFILE\fR
124 Write code tree to \fIFILE\fR
126 .B \--save-temps
127 Keep temporary files
129 .B \--profile=\fIPROFILE\fR
130 Use the given profile instead of the default
132 .B \-q, --quiet
133 Do not print messages to the console
135 .B \-v, --verbose
136 Print additional messages to the console
138 .B \--target-glib=\fIMAJOR\fR.\fIMINOR\fR
139 Target version of glib for code generation
141 .B \--enable-version-header
142 Write vala build version in generated files
144 .B \--disable-version-header
145 Do not write vala build version in generated files
146 .SH FEATURES
147 Interfaces, properties, signals, foreach, lambda expressions, type
148 inference for local variables, generics, non-null types, assisted memory
149 management, exception handling
150 .SH HOMEPAGE AND BUG REPORT
151 http://www.vala-project.org/
152 .SH AUTHORS
153 Jürg Billeter, Raffaele Sandrini.
155 Man page written to conform with Debian by Marc-Andre Lureau.