VALAC(1) User Commands VALAC(1)
NAME
valac - compiler that translates Vala source code into C source and
header files
SYNOPSIS
valac [
OPTION]... [
FILE]...
DESCRIPTION
Vala is a programming language that aims to bring modern
programming language features to GNOME developers without imposing
any additional runtime requirements and without using a different
ABI compared to applications and libraries written in C.
valac, the Vala compiler, is a self-hosting compiler that translates
Vala source code into C source and header files. It uses the
GObject type system to create classes and interfaces declared
in the Vala source code.
Usage: valac [OPTION?] FILE... - Vala Compiler
Help Options: -?,
--help Show help options
Application Options: --vapidir=
DIRECTORY...
Look for package bindings in DIRECTORY
--girdir=
DIRECTORY...
Look for .gir files in DIRECTORY
--metadatadir=
DIRECTORY...
Look for GIR .metadata files in DIRECTORY
--pkg=
PACKAGE...
Include binding for PACKAGE
--vapi=
FILE Output VAPI file name
--library=
NAME Library name
--shared-library=
NAME Shared library name used in generated gir
--gir=
NAME-VERSION.gir
GObject-Introspection repository file name
-b,
--basedir=
DIRECTORY Base source directory
-d,
--directory=
DIRECTORY Change output directory from current working directory
--version Display version number
--api-version Display API version number
-C,
--ccode Output C code
-H,
--header=
FILE Output C header file
--use-header Use C header file (DEPRECATED AND IGNORED)
--includedir=
DIRECTORY Directory used to include the C header file
-h,
--internal-header=
FILE Output internal C header file
--internal-vapi=
FILE Output vapi with internal api
--fast-vapi Output vapi without performing symbol resolution
--use-fast-vapi Use
--fast-vapi output during this compile
--vapi-comments Include comments in generated vapi
--deps Write make-style dependency information to this file
--depfile Write make-style external dependency information for build
systems to this file
--list-sources Output a list of all source and binding files which are used
--symbols=
FILE Output symbols file
-c,
--compile Compile but do not link
-o,
--output=
FILE Place output in file FILE
-g,
--debug Produce debug information
--thread Enable multithreading support (DEPRECATED AND IGNORED)
--enable-mem-profiler Enable GLib memory profiler
-D,
--define=
SYMBOL...
Define SYMBOL
--main=
SYMBOL...
Use SYMBOL as entry point
--nostdpkg Do not include standard packages
--disable-assert Disable assertions
--enable-checking Enable additional run-time checks
--enable-deprecated Enable deprecated features
--hide-internal Hide symbols marked as internal
--enable-experimental Enable experimental features
--disable-warnings Disable warnings
--fatal-warnings Treat warnings as fatal
--disable-since-check Do not check whether used symbols exist in local packages
-k,
--keep-going Continue as much as possible after an error
--enable-experimental-non-null Enable experimental enhancements for non-null types
--enable-gobject-tracing Enable GObject creation tracing
--cc=
COMMAND Use COMMAND as C compiler command
-X,
--Xcc=
OPTION...
Pass OPTION to the C compiler
--pkg-config=
COMMAND Use COMMAND as pkg-config command
--dump-tree=
FILE Write code tree to FILE
--save-temps Keep temporary files
--profile=
PROFILE Minimum runtime dependency: 'gobject' (default) or 'posix'
(minimal libc)
gobject enables GLib's GType runtime type system. The runtime
environment will usually require libgobject and its small
number of dependencies.
posix removes the dependency on GLib
and disables the runtime type system. The profile either
generates alternative code or errors at compile time if a Vala
language feature is used that requires the runtime type
system. This is useful for writing code, for example, that
targets microcontrollers or for extremely small system
utilities or container images. The runtime environment will
usually require a small subset of the ISO C standard library.
-q,
--quiet Do not print messages to the console
-v,
--verbose Print additional messages to the console
--no-color Disable colored output, alias for
--color=
never --color=
WHEN Enable color output, options are 'always', 'never', or 'auto'
When no value is given
always is implied. When neither
--color or
--no-color are declared then
--color=
auto is used where
output is colored when stderr is a terminal.
--target-glib='MAJOR.MINOR', or 'auto'
Target version of glib for code generation
--gresources=
FILE...
XML of gresources
--gresourcesdir=
DIRECTORY...
Look for resources in DIRECTORY
--enable-version-header Write vala build version in generated files
--disable-version-header Do not write vala build version in generated files
--run-args Arguments passed to directly compiled executable
--abi-stability Enable support for ABI stability
This changes the current behaviour to output public members of
classes and interfaces the same order as they appear in Vala
source. For libraries is recommended to use
--abi-stability to ensure the maintainability of the resulting Application
Binary Interface (ABI). This option is disabled by default
for backward compatibility because it can break ABI of
existing projects.
BUGS
https://gitlab.gnome.org/GNOME/vala/issues
HOMEPAGE OR CONTACT
https://wiki.gnome.org/Projects/Vala
FEATURES
Interfaces, properties, signals, foreach, lambda expressions, type
inference for local variables, generics, non-null types, assisted
memory management, exception handling
AUTHORS
J??rg Billeter, Raffaele Sandrini, Rico Tzschichholz.
Vala 0.56.1 April 2022 VALAC(1)
