NAME

       BuildProgram - compile, link with Gnuastro library and its dependencies, and run a C program

SYNOPSIS

       astbuildprog [OPTION...] C-source [ARGUMENTS TO RUN]

DESCRIPTION

       BuildProgram  is  part  of  GNU Astronomy Utilities 0.16.  BuildProgram will compile and run a C program,
       while automatically linking with libraries that Gnuastro depends on. Hence you do not have to worry about
       explicitly linking with CFITSIO for example if you want to work on a FITS file, or with GSL if  you  want
       to use GNU Scientific Library's functions. The standard compiler options of '-I', '-L', and '-l' are also
       available for further customization of the build.

       For  more information, please run any of the following commands. In particular the second contains a very
       comprehensive explanation  of  BuildProgram's  invocation:  expected  input(s),  output(s),  and  a  full
       description of all the options.

       All options and their values:
              $ astbuildprog -P

       Inputs/Outputs and options:
              $ info astbuildprog

       Full section in manual/book:
              $ info BuildProgram

       Full Gnuastro manual/book:
              $ info gnuastro

       If  you  couldn't find your answer in the manual, you can get direct help from experienced Gnuastro users
       and developers. For more information, please run:

              $ info help-gnuastro

       BuildProgram options:

              Input:

       -a, --la=STR
              Libtool '.la' to use instead of default.

       -c, --cc=STR
              Name of C compiler's executable.

       -e, --noenv
              No env. (e.g., LDFLAGS or CPPFLAGS) in build.

       -I, --includedir=STR
              Directories to search for '#include's.

       -l, --linklib=STR
              Link libraries, e.g., for libgsl: '-lgsl'.

       -L, --linkdir=STR
              Directory to search for libraries to link.

       -t, --tag=STR
              Libtool '--tag': programming language.

              Output:

       -b, --onlybuild
              Don't run the built program.

       -d, --deletecompiled
              Delete compiled program after running.

       -D, --dontdelete
              Don't delete output if it exists.

       -g, --debug
              Debugging information in compiled binary.

       -K, --keepinputdir
              Keep input directory for automatic output.

       -o, --output=STR
              Output file name.

       -O, --optimize=INT
              Optimization level: 0, 1, 2, 3.

       -W, --warning=STR
              Compilation warnings on command-line.

              Operating modes:

       -?, --help
              give this help list

       --checkconfig
              List all config files and variables read.

       --cite BibTeX citation for this program.

       --config=STR
              Read configuration file STR immediately.

       --lastconfig
              Do not parse any more configuration files.

       --minmapsize=INT
              Min. bytes to avoid RAM automatically.

       --onlyversion=STR
              Only run if the program version is STR.

       -P, --printparams
              Print parameter values to be used and abort.

       --quietmmap
              Don't print mmap'd file's name and size.

       -q, --quiet
              Only report errors, remain quiet about steps.

       -S, --setdirconf
              Set default values for this directory and abort.

       --usage
              give a short usage message

       -U, --setusrconf
              Set default values for this user and abort.

       -V, --version
              print program version

       Mandatory or optional arguments to long options are also mandatory  or  optional  for  any  corresponding
       short options.

       GNU Astronomy Utilities home page: http://www.gnu.org/software/gnuastro/

REPORTING BUGS

       Report bugs to bug-gnuastro@gnu.org.

COPYRIGHT

       Copyright © 2015-2021, Free Software Foundation, Inc.  License GPLv3+: GNU General public license version
       3 or later.
       This  is  free software: you are free to change and redistribute it.  There is NO WARRANTY, to the extent
       permitted by law.

       Written/developed by Mohammad Akhlaghi

SEE ALSO

       The full documentation for BuildProgram is maintained as a Texinfo manual.  If the info and  BuildProgram
       programs are properly installed at your site, the command

              info BuildProgram

       should give you access to the complete manual.

GNU Astronomy Utilities 0.16                      October 2021                                   BUILDPROGRAM(1)