codegen: Fix floating reference regression with Variants
[vala-gnome.git] / doc / valac.h2m
blobc50d8b9424a82ded14a18c9cf766227a2a329c1c
1 [NAME]
2 valac \- compiler that translates Vala source code into C source and header files
4 [SYNOPSIS]
5 .B valac
6 [\fIOPTION\fR]... [\fIFILE\fR]...
8 [DESCRIPTION]
9 Vala  is  a  programming  language  that  aims  to  bring  modern
10 programming language features to GNOME developers without imposing any
11 additional  runtime requirements  and  without using  a different  ABI
12 compared to applications and libraries written in C.
13 .TP
14 valac, the Vala compiler, is a self-hosting compiler that translates
15 Vala source code into C source and header files. It uses the GObject
16 type system to create classes and interfaces declared in the Vala
17 source code.
19 /Enable color output/
20 .RS
21 When no value is given \fIalways\fR is implied. When neither \fB--color\fR
22 or \fB--no-color\fR are declared then \fB--color\fR=\fIauto\fR is used where
23 output is colored when stderr is a terminal.
24 .RE
26 /Enable support for ABI stability/
27 .RS
28 This changes the current behaviour to output public members of classes and
29 interfaces the same order as they appear in Vala source.
30 For libraries is recommended to use \fB--abi-stability\fR to ensure the
31 maintainability of the resulting Application Binary Interface (ABI).
32 This option is disabled by default for backward compatibility because it can
33 break ABI of existing projects.
34 .RE
36 [BUGS]
37 https://gitlab.gnome.org/GNOME/vala/issues
39 [HOMEPAGE or CONTACT]
40 https://wiki.gnome.org/Projects/Vala
42 [FEATURES]
43 Interfaces, properties, signals, foreach, lambda expressions, type
44 inference for local variables, generics, non-null types, assisted memory
45 management, exception handling
47 [AUTHORS]
48 Jürg Billeter, Raffaele Sandrini.