Search.setIndex({"docnames": ["contents", "dune-common", "index"], "filenames": ["contents.rst", "dune-common.rst", "index.rst"], "titles": ["<no title>", "dune-common", "dune-common CMake reference"], "terms": {"spdx": [1, 2], "filecopyrightinfo": [1, 2], "copyright": [1, 2], "c": [1, 2], "project": [1, 2], "contributor": [1, 2], "see": [1, 2], "licens": [1, 2], "md": [1, 2], "root": [1, 2], "identifi": [1, 2], "licenseref": [1, 2], "gpl": [1, 2], "2": [1, 2], "0": [1, 2], "onli": [1, 2], "except": [1, 2], "open": 1, "tool": 1, "develop": 1, "kitwar": 1, "offer": 1, "one": 1, "solut": 1, "all": 1, "task": 1, "like": 1, "configur": 1, "gener": 1, "It": 1, "support": 1, "set": 1, "backend": 1, "portabl": 1, "control": 1, "ONE": 1, "rather": 1, "simpl": 1, "languag": 1, "you": 1, "instal": 1, "through": 1, "your": 1, "favorit": 1, "manag": 1, "download": 1, "code": 1, "The": 1, "minimum": 1, "requir": 1, "version": 1, "3": 1, "13": 1, "process": 1, "script": 1, "dunecontrol": 1, "locat": 1, "bin": 1, "There": 1, "compat": 1, "layer": 1, "translat": 1, "opt": 1, "correspond": 1, "while": 1, "great": 1, "determin": 1, "transit": 1, "long": 1, "approach": 1, "pickup": 1, "variabl": 1, "cmake_flag": 1, "command": 1, "line": 1, "option": 1, "ani": 1, "defin": 1, "": 1, "d": 1, "just": 1, "pre": 1, "processor": 1, "most": 1, "import": 1, "part": 1, "tell": 1, "look": 1, "brows": 1, "input": 1, "refer": 1, "section": 1, "document": 1, "list": 1, "pick": 1, "up": 1, "everi": 1, "directori": 1, "contain": 1, "cmakelist": 1, "txt": 1, "which": 1, "written": 1, "think": 1, "distribut": 1, "top": 1, "level": 1, "execut": 1, "whenev": 1, "add_subdirectori": 1, "encount": 1, "sub": 1, "special": 1, "becaus": 1, "entir": 1, "correctli": 1, "delet": 1, "auto": 1, "addition": 1, "export": 1, "some": 1, "A": 1, "more": 1, "macro": 1, "meant": 1, "downstream": 1, "If": 1, "provid": 1, "thei": 1, "found": 1, "subfold": 1, "foo": 1, "dunefoomacro": 1, "howev": 1, "Its": 1, "content": 1, "alwai": 1, "when": 1, "other": 1, "suggest": 1, "perfect": 1, "place": 1, "put": 1, "below": 1, "config": 1, "h": 1, "templat": 1, "again": 1, "multipl": 1, "wai": 1, "easi": 1, "For": 1, "each": 1, "add_dune_": 1, "_flag": 1, "those": 1, "cover": 1, "exampl": 1, "usag": 1, "add_execut": 1, "cc": 1, "add_dune_umfpack_flag": 1, "add_dune_mpi_flag": 1, "also": 1, "add_dune_all_flag": 1, "same": 1, "registri": 1, "mechan": 1, "want": 1, "fulli": 1, "so": 1, "entiti": 1, "have": 1, "properti": 1, "access": 1, "via": 1, "get_properti": 1, "set_properti": 1, "compile_definit": 1, "include_directori": 1, "append": 1, "somedefinit": 1, "somepath": 1, "full": 1, "manual": 1, "done": 1, "target_link_librari": 1, "instead": 1, "tweak": 1, "might": 1, "mani": 1, "applic": 1, "work": 1, "clean": 1, "find": 1, "follow": 1, "specif": 1, "name": 1, "scheme": 1, "somepackag": 1, "findsomepackag": 1, "note": 1, "treat": 1, "case": 1, "sensit": 1, "find_packag": 1, "search": 1, "its": 1, "includ": 1, "path": 1, "good": 1, "read": 1, "start": 1, "write": 1, "page": 1, "wiki": 1, "mai": 1, "even": 1, "need": 1, "own": 1, "ship": 1, "simpli": 1, "internet": 1, "profit": 1, "consid": 1, "style": 1, "add_dune_somepackage_flag": 1, "leav": 1, "tree": 1, "untouch": 1, "differ": 1, "mirror": 1, "structur": 1, "seen": 1, "assum": 1, "src": 1, "subdirectori": 1, "makefil": 1, "unix": 1, "advantag": 1, "clear": 1, "separ": 1, "time": 1, "default": 1, "In": 1, "strongli": 1, "discourag": 1, "By": 1, "within": 1, "custom": 1, "folder": 1, "builddir": 1, "give": 1, "absolut": 1, "someth": 1, "abl": 1, "collect": 1, "much": 1, "easier": 1, "remov": 1, "ad": 1, "enabl": 1, "featur": 1, "dune_enable_all_packag": 1, "befor": 1, "add": 1, "To": 1, "regist": 1, "care": 1, "ha": 1, "carefulli": 1, "dune_register_package_flag": 1, "dune_library_add_sourc": 1, "cmake_": 1, "lang": 1, "_compil": 1, "being": 1, "cxx": 1, "e": 1, "g": 1, "dcmake_cxx_compil": 1, "otherc": 1, "environ": 1, "fc": 1, "etc": 1, "first": 1, "recommend": 1, "known": 1, "bug": 1, "issu": 1, "warn": 1, "violat": 1, "Such": 1, "under": 1, "function": 1, "dune_symlink_to_source_tre": 1, "dune_symlink_to_source_fil": 1, "dune_add_copy_command": 1, "dune_add_copy_depend": 1, "dune_add_copy_target": 1, "simplest": 1, "solv": 1, "problem": 1, "symlink": 1, "src_dir": 1, "point": 1, "platform": 1, "As": 1, "alreadi": 1, "said": 1, "mere": 1, "match": 1, "charact": 1, "space": 1, "highlight": 1, "error": 1, "emac": 1, "mode": 1, "setq": 1, "regexp": 1, "alist": 1, "1": 1, "9": 1, "nil": 1, "info": 1, "Then": 1, "two": 1, "predefin": 1, "symbol": 1, "philosophi": 1, "achiev": 1, "ish": 1, "would": 1, "we": 1, "nevertheless": 1, "implement": 1, "workaround": 1, "allow_cxxflags_overwrit": 1, "type": 1, "furthermor": 1, "form": 1, "dvar": 1, "valu": 1, "overload": 1, "gridtyp": 1, "base": 1, "sever": 1, "bash": 1, "must": 1, "avail": 1, "built": 1, "autotool": 1, "wrapper": 1, "around": 1, "ctest": 1, "lot": 1, "choos": 1, "regular": 1, "express": 1, "show": 1, "output": 1, "fail": 1, "program": 1, "automat": 1, "them": 1, "build_test": 1, "upper": 1, "bound": 1, "number": 1, "core": 1, "singl": 1, "dune_max_test_cor": 1, "dcmake_disable_find_package_foo": 1, "true": 1, "canon": 1, "right": 1, "sure": 1, "cach": 1, "result": 1, "cf": 1, "mpi": 1, "despit": 1, "explicitli": 1, "dcmake_disable_find_package_mpi": 1, "describ": 1, "been": 1, "enable_headercheck": 1, "step": 1, "necessari": 1, "larg": 1, "amount": 1, "addit": 1, "better": 1, "yet": 1, "fit": 1, "git": 1, "archiv": 1, "repositori": 1, "binari": 1, "deb": 1, "rpm": 1, "servic": 1, "opensus": 1, "relat": 1, "Or": 1, "accord": 1, "choic": 1, "dpkg": 1, "buildpackag": 1, "debuild": 1, "debian": 1, "cpack": 1, "past": 1, "our": 1, "were": 1, "satisfi": 1, "extens": 1, "aspect": 1, "descript": 1, "dunepythoncommonmacro": 1, "piec": 1, "mention": 1, "inther": 1, "aggress": 1, "bad": 1, "recogn": 1, "trigger": 1, "fresh": 1, "cmakecach": 1, "mayb": 1, "save": 1, "afterward": 1, "experi": 1, "nice": 1, "trick": 1, "exec": 1, "rm": 1, "rf": 1, "later": 1, "log": 1, "cmakeerror": 1, "cmakefil": 1, "send": 1, "mail": 1, "alongsid": 1, "effort": 1, "u": 1, "Of": 1, "cours": 1, "googl": 1, "stackoverflow": 1, "ask": 1, "dune": 2, "file": 2, "common": 2, "what": 2, "i": 2, "cmake": 2, "anywai": 2, "how": 2, "do": 2, "us": 2, "belong": 2, "build": 2, "system": 2, "modifi": 2, "flag": 2, "link": 2, "librari": 2, "given": 2, "target": 2, "against": 2, "extern": 2, "ar": 2, "check": 2, "an": 2, "out": 2, "sourc": 2, "simplifi": 2, "chang": 2, "my": 2, "compil": 2, "should": 2, "handl": 2, "ini": 2, "grid": 2, "setup": 2, "id": 2, "usual": 2, "cxxflag": 2, "upon": 2, "call": 2, "make": 2, "can": 2, "thi": 2, "run": 2, "test": 2, "suit": 2, "from": 2, "disabl": 2, "depend": 2, "switch": 2, "between": 2, "parallel": 2, "sequenti": 2, "why": 2, "possibl": 2, "anymor": 2, "headercheck": 2, "creat": 2, "tarbal": 2, "packag": 2, "doe": 2, "python": 2, "troubleshoot": 2, "where": 2, "get": 2, "help": 2}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"dune": 1, "common": 1, "what": 1, "i": 1, "cmake": 1, "anywai": 1, "how": 1, "do": 1, "us": 1, "file": 1, "modul": [1, 2], "belong": 1, "build": 1, "system": 1, "modifi": 1, "flag": 1, "link": 1, "librari": 1, "given": 1, "target": 1, "against": 1, "extern": 1, "ar": 1, "check": 1, "an": 1, "out": 1, "sourc": 1, "simplifi": 1, "chang": 1, "my": 1, "compil": 1, "should": 1, "handl": 1, "ini": 1, "grid": 1, "setup": 1, "id": 1, "usual": 1, "cxxflag": 1, "upon": 1, "call": 1, "make": 1, "can": 1, "thi": 1, "run": 1, "test": 1, "suit": 1, "from": 1, "disabl": 1, "depend": 1, "switch": 1, "between": 1, "parallel": 1, "sequenti": 1, "why": 1, "possibl": 1, "anymor": 1, "headercheck": 1, "creat": 1, "tarbal": 1, "packag": 1, "doe": 1, "python": 1, "troubleshoot": 1, "where": 1, "get": 1, "help": 1, "introduct": 2, "input": 2, "variabl": 2, "refer": 2, "command": 2}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx": 57}, "alltitles": {"dune-common": [[1, "dune-common"]], "What is CMake anyway?": [[1, "what-is-cmake-anyway"]], "How do I use Dune with CMake?": [[1, "how-do-i-use-dune-with-cmake"]], "What files in a dune module belong to the CMake build system?": [[1, "what-files-in-a-dune-module-belong-to-the-cmake-build-system"]], "How do I modify the flags and linked libraries of a given target?": [[1, "how-do-i-modify-the-flags-and-linked-libraries-of-a-given-target"]], "How do I link against external libraries, that are not checked for by Dune?": [[1, "how-do-i-link-against-external-libraries-that-are-not-checked-for-by-dune"]], "What is an out-of-source build?": [[1, "what-is-an-out-of-source-build"]], "What is the simplified build system and how do I use it?": [[1, "what-is-the-simplified-build-system-and-how-do-i-use-it"]], "How do I change my compiler and compiler flags?": [[1, "how-do-i-change-my-compiler-and-compiler-flags"]], "How should I handle ini and grid files in an out-of-source-build setup?": [[1, "how-should-i-handle-ini-and-grid-files-in-an-out-of-source-build-setup"]], "How do I use CMake with IDEs?": [[1, "how-do-i-use-cmake-with-ides"]], "I usually modify my CXXFLAGS upon calling make. How can I do this in CMake?": [[1, "i-usually-modify-my-cxxflags-upon-calling-make-how-can-i-do-this-in-cmake"]], "How do I run the test suite from CMake?": [[1, "how-do-i-run-the-test-suite-from-cmake"]], "Can I disable an external dependency?": [[1, "can-i-disable-an-external-dependency"]], "How do I switch between parallel and sequential builds?": [[1, "how-do-i-switch-between-parallel-and-sequential-builds"]], "Why is it not possible anymore to do make headercheck?": [[1, "why-is-it-not-possible-anymore-to-do-make-headercheck"]], "How do I create tarballs or packages?": [[1, "how-do-i-create-tarballs-or-packages"]], "How does the Dune build system handle Python?": [[1, "how-does-the-dune-build-system-handle-python"]], "How do I troubleshoot?": [[1, "how-do-i-troubleshoot"]], "Where can I get help?": [[1, "where-can-i-get-help"]], "Introduction": [[2, "introduction"]], "Input Variable reference": [[2, "input-variable-reference"]], "Command reference": [[2, "command-reference"]], "Module reference": [[2, "module-reference"]]}, "indexentries": {}})