Comments added in to the root CMakeLists.txt.

CMakeLists.txt

+# Our project is called 'kicad' this is how it will be called in
+# visual studio, and in our makefiles. 
 PROJECT(kicad)
 
 CMAKE_MINIMUM_REQUIRED(VERSION 2.4 FATAL_ERROR)
 
 #SET(CMAKE_VERBOSE_MAKEFILE ON)
 
+# Here you can define what libraries of wxWidgets you need for your
+# application. You can figure out what libraries you need here;
+# http://www.wxwidgets.org/manuals/2.8/wx_librarieslist.html
 SET(wxWidgets_USE_LIBS base core adv gl html net)
 
+# We need the Find package for wxWidgets to work.
 FIND_PACKAGE(wxWidgets REQUIRED)
 
 #Locations for install targets
@@ -28,11 +34,17 @@ ENDIF(WIN32)
 IF(APPLE)
 ENDIF(APPLE)
 
+# Did we find wxWidgets ? This condition will fail
+# for as long as the internal vars do not point to
+# the proper wxWidgets configuration.
 IF(wxWidgets_FOUND)
 	MESSAGE("-- wxWidgets found")
 	
+	# Include wxWidgets macros.
         INCLUDE(${wxWidgets_USE_FILE})
 
+        # We define the include paths here, our source dirs 
+        # and also the include dirs defined by wxWidgets.
 	INCLUDE_DIRECTORIES(
 		${CMAKE_CURRENT_SOURCE_DIR}/include
 		${CMAKE_CURRENT_SOURCE_DIR}/share)
@@ -45,6 +57,7 @@ IF(wxWidgets_FOUND)
 	ADD_SUBDIRECTORY(kicad)
 	ADD_SUBDIRECTORY(pcbnew)
 ELSE(wxWidgets_FOUND)
+        # For convenience. When we cannot continue, inform the user.
         MESSAGE("wxWidgets is required to build KiCad!")
 ENDIF(wxWidgets_FOUND)
 

install.txt

@@ -88,11 +88,11 @@ Archive and doc files (Linux and windows ) are in ../kicad/wing3d
 goto www.wings3d.org to have more details.
 Pcbnew use the exported files in wrml (.wrl) format from wings3d (not the native .wings format).
 
-Documentation:
-Currenty only in french.
+== Documentation: ==
+Currenty not only in french.
 "On line" in html format.
-source files (200 sheets) are in OpenOffice (www.openoffice.org) format.
-Can be read, printed and/or modified with OpenOffice.
+Source files (200 sheets) are in OpenOffice.org (www.openoffice.org) format.
+Can be read, printed and/or modified with OpenOffice.org Writer.
 See files in kicad/help/doc_src/*
 
 KiCad tree: