From 647bd2839e83267bf92fc5909f1b86e630bf395f Mon Sep 17 00:00:00 2001
From: Mark Schulte <mark@mjs.pw>
Date: Wed, 12 Apr 2017 23:04:13 -0700
Subject: [modules] Add kconfig module

Add a kconfig module to allow meson to integrate with existing projects
that use kconfig.
---
 docs/markdown/Kconfig-module.md   | 44 +++++++++++++++++++++++++++++++++++++++
 docs/markdown/snippets/kconfig.md |  5 +++++
 2 files changed, 49 insertions(+)
 create mode 100644 docs/markdown/Kconfig-module.md
 create mode 100644 docs/markdown/snippets/kconfig.md

(limited to 'docs/markdown')

diff --git a/docs/markdown/Kconfig-module.md b/docs/markdown/Kconfig-module.md
new file mode 100644
index 0000000..b13f7ec
--- /dev/null
+++ b/docs/markdown/Kconfig-module.md
@@ -0,0 +1,44 @@
+---
+short-description: Unstable kconfig module
+authors:
+    - name: Mark Schulte, Paolo Bonzini
+      years: [2017, 2019]
+      has-copyright: false
+...
+
+# Unstable kconfig module
+
+This module parses Kconfig output files to allow use of kconfig
+configurations in meson projects.
+
+**Note**: this does not provide kconfig frontend tooling to generate a
+configuration. You still need something such as kconfig frontends (see
+link below) to parse your Kconfig files, and then (after you've
+choosen the configuration options), output a ".config" file.
+
+  [kconfig-frontends]: http://ymorin.is-a-geek.org/projects/kconfig-frontends
+
+## Usage
+
+The module may be imported as follows:
+
+``` meson
+kconfig = import('unstable-kconfig')
+```
+
+The following functions will then be available as methods on the object
+with the name `kconfig`. You can, of course, replace the name
+`kconfig` with anything else.
+
+### kconfig.load()
+
+This function loads a kconfig output file and returns a dictionary object.
+
+`kconfig.load()` makes no attempt at parsing the values in the
+file.  Therefore, true boolean values will be represented as the string "y"
+and integer values will have to be converted with `.to_int()`.
+
+* The first (and only) argument is the path to the configuration file to
+  load (usually ".config").
+
+**Returns**: a [dictionary object](Reference-manual.md#dictionary-object).
diff --git a/docs/markdown/snippets/kconfig.md b/docs/markdown/snippets/kconfig.md
new file mode 100644
index 0000000..d4d5c9b
--- /dev/null
+++ b/docs/markdown/snippets/kconfig.md
@@ -0,0 +1,5 @@
+## New module to parse kconfig output files
+
+The new module `unstable-kconfig` adds the ability to parse and use kconfig output
+files from `meson.build`.
+
-- 
cgit v1.1