diff options
| -rw-r--r-- | misc/tools/README.txt | 35 | ||||
| -rw-r--r-- | nuttx/README.txt | 54 |
2 files changed, 72 insertions, 17 deletions
diff --git a/misc/tools/README.txt b/misc/tools/README.txt index 2991190f7..194f80e94 100644 --- a/misc/tools/README.txt +++ b/misc/tools/README.txt @@ -59,6 +59,32 @@ kconfig-frontends The default installation location for the tools is /usr/local/bin. You may require root privileges to 'make install'. +Graphical Configuration Tools +----------------------------- + + 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: + + ./configure --enable-mconf --disable-nconf --disable-gconf --enable-qconf + make + make install + + Or, + + ./configure --enable-mconf --disable-nconf --enable-gconf --disable-qconf + make + make install + + In these case, you can start the graphical configurator in the nuttx/ + directory with either: + + make qconfig + + or + + make gconfig + --program-prefix= ----------------- @@ -135,6 +161,15 @@ There two known solutions to this: kconfig-frontends for Windows ----------------------------- +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. 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 + +[The remainder of the text in this section is for historical interest only] + From http://tech.groups.yahoo.com/group/nuttx/message/2900: "The build was quite simple: diff --git a/nuttx/README.txt b/nuttx/README.txt index ac0fac0b2..18271a8bf 100644 --- a/nuttx/README.txt +++ b/nuttx/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 |