diff --git a/doc/org.eclipse.cdt.doc.user/images/prop_crefs.png b/doc/org.eclipse.cdt.doc.user/images/prop_crefs.png
index dbc037bd896..8b00965c192 100644
Binary files a/doc/org.eclipse.cdt.doc.user/images/prop_crefs.png and b/doc/org.eclipse.cdt.doc.user/images/prop_crefs.png differ
diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_prop_general_pns_ref.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_prop_general_pns_ref.htm
index b16c12e9de6..e3430f4cce9 100644
--- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_prop_general_pns_ref.htm
+++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_prop_general_pns_ref.htm
@@ -9,26 +9,53 @@
 <body>
 <h1>C/C++ Project Properties, Paths and Symbols, Project References</h1>
 <p>
-User can adjust references among CDT projects.<br>
-Unlike Eclipse Common <a href=cdt_u_prop_ref.htm>References page</a>, 
-current page allows setting references to specific configuration.
-</p>
+Project references are a powerful way of expressing dependencies between
+Build configurations in different projects. Specifically they perform 2 roles:
+<ul>
+<li>Automatic propogation of <a href="cdt_u_prop_general_exp.htm"><i>Exported Settings</i></a> from one project
+to another which depends on it</li>
+<li>Build, if necessary, referenced projects before dependent project</li>
+</ul> 
+<p>
+Unlike the Eclipse Common <a href=cdt_u_prop_ref.htm>References page</a>, 
+this page allows setting references to specific configurations.
+
+<p> <b>Since CDT 7</b> this functionality has been improved:
+<ul>
+<li>
+  <b>Referenced projects are ordered</b><p> and this order can be changed using the buttons provided.
+Referenced projects are built in the order listed in the dialog, and the order is used in the build for setting
+up the Include paths and Library link lines.
+</li>
+<li>
+  <b>Can reference another configuration in the same project</b><p>It's allowed to reference another configuration 
+  in the same project.
+</li>
+<li>
+  <b>Referenced projects which don't exist in the workspace are shown in gray.</b>
+</li>
+</ul>
+
 <p><img img="" src="../images/prop_crefs.png"
  alt="C/C++ Project, Paths and Symbols, Project References"></p>
 <p></p>
 <dl>
   <dt>Projects list (main pane)</dt>
   <dd>Displays all other CDT projects which current project can refer to. 
-  All configurations are displayed for each project. Put check mark on
-  projects and configurations to make them referred. Note that only
-  one configuration can be checked.<br>[Active] configuration presents
-  in each configs list and represents current active configuration.</dd>
+  All configurations are displayed for each project. A check mark indicates the configuration is referenced.
+  Note that only one configuration can be checked in any given project.
+  <br>[Active] configuration presents
+  in each configs list and represents current active configuration.
+  <br> Configurations can reference another configuration in the same project.
+  <br> Referenced projects, which don't exist in the workspace, are shown in gray.</dd>
   <dt>Expand all</dt>
   <dd>Expands all configuration lists</dd>
-  <dt>Show checked</dt>
-  <dd>Expands configuration lists for referred projects only.</dd>
   <dt>Collapse all</dt>
   <dd>Collapses all configuration lists</dd>
+  <dt>Move up</dt>
+  <dd>Move the project up in the references list</dd>
+  <dt>Move down</dt>
+  <dd>Move the project down in the references list</dd>
   <dt><br>Available for :</dt>
   <dd>CDT projects</dd>
 </dl>
