boldinventions.com

KCMD Command Processor Documentation - Getting Started 2

<-- PREV PAGE blank space NEXT PAGE -->

Now that we have a Hello, World program compiling and running, we want to add the KCMD command line processor. We need to accomplish the following easy steps.

Change the Project Settings to Add the KCMD Source Path for Include Files

Right click on the name of the project in the solution explorer, and select 'Properties' from the bottom of the menu which pops up. NOTE: Be very careful to click on the 'Project' and not the 'Solution'. The Solution properties are different. Make sure you right-click on the right thing! In the picture below, we right-clicked on 'demo_msvc2008', which was the name of the Project, not the Solution.

click-on-project-properties

In the properties dialog for the project, on the left open up 'configuration properties' and then 'C/C++', and click on 'General'. From there click on the empty bar next to 'Additional Include Directories' in the big panel on the right. When you click on that empty bar, a little button with a '...' will show up. Click on that to browse for the kcmd source files.

msvc2008-include-path-setting

This will bring up the include directory dialog. Click on the thing that looks like a new-folder icon. When you do, another little '...' button will show up which will allow you to browse for the KCMD source folder.

msvc2008-include-path-dialog

Now browse to where the folder named 'kcmd' was unzipped. This is a child folder of a folder called 'source'. It is important that the selected folder is the kcmd folder and not the one named 'source'. In the picture below, it is the 'kcmd' folder which is highlighted in blue when we hit the ok button.

msvc2008-pick-kcmd-folder

Now have added the include path.

Next we need to add the kcmd source files to the project. But first we want to make a folder called 'kcmd' in the project to keep the kcmd files seperate from the rest of our sources. So we right-click on the 'Source Files' folder in our solution explorer, and the choose Add->New Filter

msvc2008-source-add-filter

A new subfolder of 'Source Files' appears. Rename it from 'NewFilter1' to 'kcmd'.

Now we right-click on the new folder called 'kcmd' and choose Add->Existing Item

msvc2008-sources-add-existing

In the file open dialog, browse to the kcmd folder where the sources are and select all the .c and .h files.

msvc2008_add_source_files

Now do the same process to add new folders 'commands' and 'port' to the 'kcmd' folder, and add the source files.

After adding all the source files, the Solution Explorer should look like this:

msvc2008-all-sources-added

On the next page we finish configuring the project and writing the few lines of code necessary to make KCMD work.

<-- PREV PAGE blank space NEXT PAGE -->