From dedfdb982a822df2859796900af12f5b57c4ef48 Mon Sep 17 00:00:00 2001 From: Gregory Nutt Date: Fri, 3 Jan 2014 15:49:00 -0600 Subject: [PATCH] Update READMEs --- README.txt | 54 +++++++++++++++++++++++++++++++++++++----------------- 1 file changed, 37 insertions(+), 17 deletions(-) diff --git a/README.txt b/README.txt index ac0fac0b20..18271a8bfb 100644 --- a/README.txt +++ b/README.txt @@ -291,8 +291,8 @@ NuttX Configuration Tool This automated tool is based on the kconfig-frontends application available at http://ymorin.is-a-geek.org/projects/kconfig-frontends (A snapshot of this tool is also available at ../misc/tools). This - application provides a tool called 'mconf' that is used by the NuttX - top-level Makefile. The following make target is provided: + application provides a tool called 'kconfig-mconf' that is used by + the NuttX top-level Makefile. The following make target is provided: make menuconfig @@ -314,21 +314,27 @@ NuttX Configuration Tool NOTE: For a description of the syntax of this configuration file, see ../misc/tools/kconfig-language.txt. - 2. The 'mconf' tool. 'mconf' is part of the kconfig-frontends - package. You can download that package from the website - http://ymorin.is-a-geek.org/projects/kconfig-frontends or you - can use the snapshot in ../misc/tools. + 2. The 'kconfig-mconf' tool. 'kconfig-mconf' is part of the + kconfig-frontends package. You can download that package from + the website http://ymorin.is-a-geek.org/projects/kconfig-frontends + or you can use the snapshot in ../misc/tools. - Building may be as simple as 'configure; make; make install' - but there may be some build complexities, especially if you - are building under Cygwin. See the more detailed build - instructions at ../misc/tools/README.txt + Building kconfig-frontends under Linux may be as simple as + 'configure; make; make install' but there may be some build + complexities, especially if you are building under Cygwin. See + the more detailed build instructions at ../misc/tools/README.txt - The 'make install' step will, by default, install the 'mconf' + The 'make install' step will, by default, install the 'kconfig-mconf' tool at /usr/local/bin/mconf. Where ever you choose to - install 'mconf', make certain that your PATH variable includes + install 'kconfig-mconf', make certain that your PATH variable includes a path to that installation directory. + The kconfig-frontends tools will not build in a native Windows + environment directly "out-of-the-box". For the Windows native + case, you should should the modified version of kconfig-frontends + that can be found at + http://uvc.de/posts/linux-kernel-configuration-tool-mconf-under-windows.html + The basic configuration order is "bottom-up": - Select the build environment, @@ -341,6 +347,17 @@ NuttX Configuration Tool This is pretty straight forward for creating new configurations but may be less intuitive for modifying existing configurations. + If you have an environment that suppots the Qt or GTK graphical systems + (probably KDE or gnome, respectively), then you can also build the + graphical kconfig-frontends, kconfig-qconf and kconfig-gconf. In + these case, you can start the graphical configurator with either: + + make qconfig + + or + + make gconfig + Refreshing Configurations with 'make oldconfig' ----------------------------------------------- @@ -460,11 +477,14 @@ NuttX Configuration Tool under DOS Recent versions of NuttX support building NuttX from a native Windows console window (see "Native Windows Build" below). But kconfig-frontends - is a Linux tool. There have been some successes building a Windows - native version of the kconfig-frontends tool, but that is not ready - for prime time. + is a Linux tool. At one time this was a problem for Windows users, but + now there is a specially modified version of the kconfig-frontends tools + that can be used: + http://uvc.de/posts/linux-kernel-configuration-tool-mconf-under-windows.html - At this point, there are only a few options for the Windows user: + It is also possible to use the version of kconfig-frontends built + under Cygwin outside of the Cygwin "sandbox" in a native Windows + environment: 1. You can run the configuration tool using Cygwin. However, the Cygwin Makefile.win will complain so to do this will, you have @@ -486,7 +506,7 @@ NuttX Configuration Tool under DOS kconfig-mconf Kconfig - There is a Windows bacht file at tools/kconfig.bat that automates + There is a Windows batch file at tools/kconfig.bat that automates these steps: tools/kconfig menuconfig