(doc-group cc
  «C compiler.»)

(defdoc (make-cc (fn-err NIL))
  «Return a new C compiler object.

   The optional argument `fn-err` is used to print any error messages and warnings
   during compilation of C code by the returned object.»
  :doc-group cc)

(defdoc (cc? v)
  «Return `T` if the value is a C compiler object, `NIL` otherwise.»
  :doc-group cc)

(defdoc (cc-add-file cc path)
  «Add a file to the C compiler object and return `T` on success, `NIL` otherwise.

   The file can be a C file, a library, an object file or a linker scripts.»
  :doc-group cc
  :doc-see cc-compile)

(defdoc (cc-add-include-path cc path)
  «Append a directory to the list of the include search paths.»
  :doc-group cc)

(defdoc (cc-add-sysinclude-path cc path)
  «Append a directory to the the list of the system-specific include
   search paths.»
  :doc-group cc)

(defdoc (cc-add-library-path cc path)
  «Add a directory to the end of the list of the library search paths.»
  :doc-group cc)

(defdoc (cc-define cc name (str NIL))
  «Define a macro. Same as `#define …`.»
  :doc-group cc
  :doc-see cc-undefine)

(defdoc (cc-undefine cc name)
  «Undefine a macro. Same as `#undef …`.»
  :doc-group cc
  :doc-see cc-define)

(defdoc (cc-set-options cc str)
  «Append to the list of the C compiler options. Multiple options can be specified
   in the string, separated with spaces.»
  :doc-group cc)

(defdoc (cc-compile cc code (decl-fn NIL) (define-fn NIL))
  «Compile the C code, passing all declarations and macro definitions to the optional
   callbacks.

   The code can be either a string or an IO object.

   Returns `T` on success, `NIL` otherwise.»
  :doc-group cc)

(defdoc (cc-relocate cc)
  «Perform all relocations, return `T` on success, `NIL` otherwise.

   After relocation has been performed, the resulting code can be executed.»
  :doc-group cc
  :doc-see cc-compile)