valac-0.56 - Man Page

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.

Referenced By

The man page valac(1) is an alias of valac-0.56(1).

April 2024 Vala 0.56.17