doc/valac.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.6.
   2 .TH VALAC "1" "August 2018" "valac 0.41.92" "User Commands"
   3 .SH NAME
   4 valac \- compiler that translates Vala source code into C source and header files
   5 .SH SYNOPSIS
   6 .B valac
   7 [\fIOPTION\fR]... [\fIFILE\fR]...
   8 .SH 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.
  18 .SS "Usage:"
  19 .IP
  20 valac [OPTION?] FILE... \- Vala Compiler
  21 .SS "Help Options:"
  22 .TP
  23 \-?, \fB\-\-help\fR
  24 Show help options
  25 .SS "Application Options:"
  26 .TP
  27 \fB\-\-vapidir\fR=\fI\,DIRECTORY\/\fR...
  28 Look for package bindings in DIRECTORY
  29 .TP
  30 \fB\-\-girdir\fR=\fI\,DIRECTORY\/\fR...
  31 Look for .gir files in DIRECTORY
  32 .TP
  33 \fB\-\-metadatadir\fR=\fI\,DIRECTORY\/\fR...
  34 Look for GIR .metadata files in DIRECTORY
  35 .TP
  36 \fB\-\-pkg\fR=\fI\,PACKAGE\/\fR...
  37 Include binding for PACKAGE
  38 .TP
  39 \fB\-\-vapi\fR=\fI\,FILE\/\fR
  40 Output VAPI file name
  41 .TP
  42 \fB\-\-library\fR=\fI\,NAME\/\fR
  43 Library name
  44 .TP
  45 \fB\-\-shared\-library\fR=\fI\,NAME\/\fR
  46 Shared library name used in generated gir
  47 .TP
  48 \fB\-\-gir\fR=\fI\,NAME\-VERSION\/\fR.gir
  49 GObject\-Introspection repository file name
  50 .TP
  51 \fB\-b\fR, \fB\-\-basedir\fR=\fI\,DIRECTORY\/\fR
  52 Base source directory
  53 .TP
  54 \fB\-d\fR, \fB\-\-directory\fR=\fI\,DIRECTORY\/\fR
  55 Change output directory from current working directory
  56 .TP
  57 \fB\-\-version\fR
  58 Display version number
  59 .TP
  60 \fB\-\-api\-version\fR
  61 Display API version number
  62 .TP
  63 \fB\-C\fR, \fB\-\-ccode\fR
  64 Output C code
  65 .TP
  66 \fB\-H\fR, \fB\-\-header\fR=\fI\,FILE\/\fR
  67 Output C header file
  68 .TP
  69 \fB\-\-use\-header\fR
  70 Use C header file
  71 .TP
  72 \fB\-\-includedir\fR=\fI\,DIRECTORY\/\fR
  73 Directory used to include the C header file
  74 .TP
  75 \fB\-h\fR, \fB\-\-internal\-header\fR=\fI\,FILE\/\fR
  76 Output internal C header file
  77 .TP
  78 \fB\-\-internal\-vapi\fR=\fI\,FILE\/\fR
  79 Output vapi with internal api
  80 .TP
  81 \fB\-\-fast\-vapi\fR
  82 Output vapi without performing symbol resolution
  83 .TP
  84 \fB\-\-use\-fast\-vapi\fR
  85 Use \fB\-\-fast\-vapi\fR output during this compile
  86 .TP
  87 \fB\-\-vapi\-comments\fR
  88 Include comments in generated vapi
  89 .TP
  90 \fB\-\-deps\fR
  91 Write make\-style dependency information to this file
  92 .TP
  93 \fB\-\-symbols\fR=\fI\,FILE\/\fR
  94 Output symbols file
  95 .TP
  96 \fB\-c\fR, \fB\-\-compile\fR
  97 Compile but do not link
  98 .TP
  99 \fB\-o\fR, \fB\-\-output\fR=\fI\,FILE\/\fR
 100 Place output in file FILE
 101 .TP
 102 \fB\-g\fR, \fB\-\-debug\fR
 103 Produce debug information
 104 .TP
 105 \fB\-\-thread\fR
 106 Enable multithreading support (DEPRECATED AND IGNORED)
 107 .TP
 108 \fB\-\-enable\-mem\-profiler\fR
 109 Enable GLib memory profiler
 110 .TP
 111 \fB\-D\fR, \fB\-\-define\fR=\fI\,SYMBOL\/\fR...
 112 Define SYMBOL
 113 .TP
 114 \fB\-\-main\fR=\fI\,SYMBOL\/\fR...
 115 Use SYMBOL as entry point
 116 .TP
 117 \fB\-\-nostdpkg\fR
 118 Do not include standard packages
 119 .TP
 120 \fB\-\-disable\-assert\fR
 121 Disable assertions
 122 .TP
 123 \fB\-\-enable\-checking\fR
 124 Enable additional run\-time checks
 125 .TP
 126 \fB\-\-enable\-deprecated\fR
 127 Enable deprecated features
 128 .TP
 129 \fB\-\-hide\-internal\fR
 130 Hide symbols marked as internal
 131 .TP
 132 \fB\-\-enable\-experimental\fR
 133 Enable experimental features
 134 .TP
 135 \fB\-\-disable\-warnings\fR
 136 Disable warnings
 137 .TP
 138 \fB\-\-fatal\-warnings\fR
 139 Treat warnings as fatal
 140 .TP
 141 \fB\-\-disable\-since\-check\fR
 142 Do not check whether used symbols exist in local packages
 143 .TP
 144 \fB\-\-enable\-experimental\-non\-null\fR
 145 Enable experimental enhancements for non\-null types
 146 .TP
 147 \fB\-\-enable\-gobject\-tracing\fR
 148 Enable GObject creation tracing
 149 .TP
 150 \fB\-\-cc\fR=\fI\,COMMAND\/\fR
 151 Use COMMAND as C compiler command
 152 .TP
 153 \fB\-X\fR, \fB\-\-Xcc\fR=\fI\,OPTION\/\fR...
 154 Pass OPTION to the C compiler
 155 .TP
 156 \fB\-\-pkg\-config\fR=\fI\,COMMAND\/\fR
 157 Use COMMAND as pkg\-config command
 158 .TP
 159 \fB\-\-dump\-tree\fR=\fI\,FILE\/\fR
 160 Write code tree to FILE
 161 .TP
 162 \fB\-\-save\-temps\fR
 163 Keep temporary files
 164 .TP
 165 \fB\-\-profile\fR=\fI\,PROFILE\/\fR
 166 Use the given profile instead of the default
 167 .TP
 168 \fB\-q\fR, \fB\-\-quiet\fR
 169 Do not print messages to the console
 170 .TP
 171 \fB\-v\fR, \fB\-\-verbose\fR
 172 Print additional messages to the console
 173 .TP
 174 \fB\-\-no\-color\fR
 175 Disable colored output, alias for \fB\-\-color\fR=\fI\,never\/\fR
 176 .TP
 177 \fB\-\-color\fR=\fI\,WHEN\/\fR
 178 Enable color output, options are 'always', 'never', or 'auto'
 179 .RS
 180 When no value is given \fIalways\fR is implied. When neither \fB--color\fR
 181 or \fB--no-color\fR are declared then \fB--color\fR=\fIauto\fR is used where
 182 output is colored when stderr is a terminal.
 183 .RE
 184 .TP
 185 \fB\-\-target\-glib\fR=\fI\,MAJOR\/\fR.MINOR
 186 Target version of glib for code generation
 187 .TP
 188 \fB\-\-gresources\fR=\fI\,FILE\/\fR...
 189 XML of gresources
 190 .TP
 191 \fB\-\-gresourcesdir\fR=\fI\,DIRECTORY\/\fR...
 192 Look for resources in DIRECTORY
 193 .TP
 194 \fB\-\-enable\-version\-header\fR
 195 Write vala build version in generated files
 196 .TP
 197 \fB\-\-disable\-version\-header\fR
 198 Do not write vala build version in generated files
 199 .TP
 200 \fB\-\-run\-args\fR
 201 Arguments passed to directly compiled executeable
 202 .TP
 203 \fB\-\-abi\-stability\fR
 204 Enable support for ABI stability
 205 .RS
 206 This changes the current behaviour to output public members of classes and
 207 interfaces the same order as they appear in Vala source.
 208 For libraries is recommended to use \fB--abi-stability\fR to ensure the
 209 maintainability of the resulting Application Binary Interface (ABI).
 210 This option is disabled by default for backward compatibility because it can
 211 break ABI of existing projects.
 212 .RE
 213 .SH BUGS
 214 https://gitlab.gnome.org/GNOME/vala/issues
 215 .SH "HOMEPAGE OR CONTACT"
 216 https://wiki.gnome.org/Projects/Vala
 217 .SH FEATURES
 218 Interfaces, properties, signals, foreach, lambda expressions, type
 219 inference for local variables, generics, non-null types, assisted memory
 220 management, exception handling
 221 .SH AUTHORS
 222 J??rg Billeter, Raffaele Sandrini.