Kconfiglib.git/README.rst, branch v8.0.0

Make 8.0.0 release

2018-07-10T07:13:54Z

New features: - 2433deb ("Add Kconfig preprocessor") implements a new Kconfig preprocessor, documented in https://github.com/torvalds/linux/blob/master/Documentation/kbuild/kconfig-macro-language.txt. It is required to parse the linux-next Kconfigs now, and will appear in Linux 4.18. 'option env=...' symbols and the $FOO syntax for expanding environment variables will be supported for backwards compatibility for a while. Consider switching to $(FOO) though, which is the new syntax (and removing 'option env=...' symbols). Changed behavior: - c19fc11 ("Drop some compatibility and tighten up lexing") makes Kconfiglib flag invalid characters in Kconfig files as a syntax error in all context. They were previously ignored in some places for compatibility with old sloppy versions of the C tools. The C tools fixed it with commit c2264564 ("kconfig: warn of unhandled characters in Kconfig commands") in July 2015. Older kernels might require fixing up the Kconfig files a bit now. New warnings: - 4200e25 ("Generalize select-with-unsatisfied-deps warning") makes the select-with-unsatisfied-dependencies warning trigger when a symbol with m-valued direct dependencies is y-selected.

Remove reference to "speedy" test suite option in README

2018-07-10T06:54:08Z

Has been removed (and is now always on).

Add Kconfig preprocessor

2018-07-10T05:56:37Z

Implement the Kconfig preprocessor described in https://github.com/torvalds/linux/blob/master/Documentation/kbuild/kconfig-macro-language.txt (which is now in linux-next and will appear in Linux 4.18). A new Kconfig.variables property holds all the preprocessor variables so that they can be inspected programmatically. Preprocessor variables are represented by a new Variable class. With the preprocessor, environment variables are referenced with $(FOO) instead of $FOO. For backwards compatibility, $FOO is accepted as well for now (and leaves "$FOO" as-is if FOO doesn't exist). The $FOO syntax might be dropped at some point in the future (together with a major version increase). It should be supported for a few months at least. Some internals were cleaned up too, mostly related to parsing. Some outdated documentation was fixed as well.

Make 7.0.0 release

2018-06-22T04:09:35Z

New features: - db92bb7 ("Add dependency loop detection") adds long-overdue dependency loop detection. Previously, dependency loops would trigger hard-to-debug Python RecursionError exceptions during evaluation. They now generate a KconfigError instead, with a helpful message that shows the items in the loop. Backwards-incompatible changes (major version bumped to 7): - eb6c21a ("Turn MenuNode/Symbol/Choice.referenced() into a @property") fixes some inconsistency in the recently-added referenced-symbols APIs. Oversight. Other changes: - f6eb4f4 ("Add Symbol/Choice.referenced() convenience methods") makes it easier to get all the symbols/choices referenced by a symbol or choice. Previously, you'd have to loop through all the menu nodes (definition locations) yourself, which might not be obvious. - ca89ca0 ("Rename KconfigSyntaxError to KconfigError") changes to a better exception name, as KconfigSyntaxError was raised for some things that aren't syntax errors. The old name is kept as an alias for now for backwards compatibility.

Add dependency loop detection

2018-06-19T20:14:09Z

Pretty long overdue. Until now, dependency loops have raised a hard-to-debug Python RecursionError during evaluation. A Kconfiglib exception is raised now instead, with a message that lists all the items in the loop. See the comment at the start of _check_dep_loop_sym() for an overview of the algorithm. At a high level, it's loop detection in a directed graph by keeping track of unvisited/visited nodes during depth-first search. (A third "visited, known to not be in a dependency loop" state is used as well.) Choices complicate things, as they're inherently loopy: The choice depends on the choice symbols and vice versa, and the choice symbols in a sense all depend on each other. Add the choice-to-choice-symbol dependencies separately after dependency loop detection, so that there's just the choice-symbol-to-choice dependencies to deal with. It simplifies things, as it makes it possible to tell dependencies from 'prompt' and 'default' conditions on the choice from choice symbol dependencies. Do some flag shenanigans to prevent the choice from being "re-entered" while looping through the choice symbols. Maybe this could be cleaned up a bit somehow... Example exception message: Dependency loop =============== A (defined at tests/Kdeploop10:1), with definition... config A bool depends on B ...depends on B (defined at tests/Kdeploop10:5), with definition... config B bool depends on C = 7 ...depends on C (defined at tests/Kdeploop10:9), with definition... config C int range D 8 ...depends on D (defined at tests/Kdeploop10:13), with definition... config D int default 3 if E default 8 ...depends on E (defined at tests/Kdeploop10:18), with definition... config E bool (select-related dependencies: F && G) ...depends on G (defined at tests/Kdeploop10:25), with definition... config G bool depends on H ...depends on the choice symbol H (defined at tests/Kdeploop10:32), with definition... config H bool prompt "H" if I && depends on I && ...depends on the choice symbol I (defined at tests/Kdeploop10:41), with definition... config I bool prompt "I" if depends on ...depends on (defined at tests/Kdeploop10:38), with definition... choice bool prompt "choice" if J ...depends on J (defined at tests/Kdeploop10:46), with definition... config J bool depends on A ...depends again on A (defined at tests/Kdeploop10:1)

Link to ACRN utilities

2018-06-15T21:28:06Z

Make 6.1.1 release

2018-06-14T18:43:34Z

Just adds commit dc0b022 ("Correctly report choice locations in some warnings").

Make 6.1.0 release

2018-06-14T18:03:48Z

Fixes: - c880151 ("Fix incorrectly ordered properties for some nested multi.def. symbols") fixes a bug that could cause symbols/choices defined in multiple locations and nested in particular ways within if's and menus to get their properties in the wrong order. The Linux kernel wasn't affected (which is how it managed to slip through), but projects that make heavy use of symbols defined in multiple locations might have been. Comprehensive selftests have been added to cover property ordering on nested multi.def. symbols/choices. New features: - 4af3e0c ("menuconfig: Support starting a search from the info dialog") and 330017a ("menuconfig: Support viewing symbol info from within the jump-to dialog") makes working with the menuconfig a bit smoother to work with. - 68043b2 ("Add MenuNode function that returns referenced items") makes it easier to find out what symbols/choices a symbol, choice, menu, or comment references, which is handy e.g. for searching.

README nit

2018-06-11T10:35:27Z

README: Mention environment variable expansion in README

2018-06-11T10:31:32Z

Also move the description of the Kconfig extensions out of 'Other features' and into a separate section under 'Library features'.