Merge pull request #70 from rainers/master

changes for v0.44rc-2

Author: rainers

CHANGES

@@ -850,4 +850,5 @@ unreleased Version 0.44
       - new sorting modes "by type" using classification by the semantic engine,
         "by declaration", effectively using scopes as discovered by the semantic engine
       - without any match, still keep the completion box open with recent items
-	  - less flashing when updating the results
+      - less flashing when updating the results
+      - code snippets now added to possible expansions

VERSION

@@ -2,4 +2,4 @@
 #define VERSION_MINOR      44
 #define VERSION_REVISION   0
 #define VERSION_BETA       -rc
-#define VERSION_BUILD      1
+#define VERSION_BUILD      2

doc/Debugging.dd

@@ -56,11 +56,11 @@ $(P The visual studio debuggers obviously had 64-bit support, and mago followed
 $(H2 VS 2012-2013 New debug engine)
 
 $(P Starting with Visual Studio 2012, Microsoft introduced a new debugger that replaced
-the native debug engine. Unfortunately, it lost some of the capabilities of the
-preceding debug engine. This includes displaying variables in the Watch Window and
+the native debug engine. Unfortunately, it had some incompatibilites with the
+preceding debug engine. This includes displaying D variables in the Watch Window and
 interpretation of the visualizer macros in autoexp.dat. The new engine has
-extended visualizer capabilities, but these are targeted to C/C++ and don't work with
-D syntax.)
+extended visualizer capabilities, but these are targeted to C/C++ and don't work well
+with D syntax.)
 
 $(P You can switch back to the old debug engine by going to Tools->Options and then under the debugger
 settings, turn on native edit and continue. This is a global setting and will also affect your
@@ -69,25 +69,27 @@ C++ projects, though.)
 $(P Mago is uneffected by this change.
 The VS 2013 debugger engine fixed some of the problems with displaying local variables.)
 
+<a id="concord"></a>
 $(H2 VS 2015 Concord extensions)
 
 $(P With the next version of the debug engine supporting "native edit and continue", the fallback to
 the old debug engine no longer works in VS 2015. Instead Microsoft
 released information about the extensibility of this debug engine (introduced with VS2012) called
 $(LINK2 https://github.com/Microsoft/ConcordExtensibilitySamples/wiki/Overview, Concord),
 late in 2015. It consists of more modular components than older engines. This allows taking
-advantage of most features of the debug engine, but just replace language specific
+advantage of most features of the debug engine by just replacing language specific
 parts, i.e. the expression evaluator. In addition, debugging mixed languages is no problem
 anymore.)
 
-$(P Taking the expression evaluator out of Mago allowed to implement this for D pretty easily:)
+$(P Using Mago's expression evaluator allowed to implement this for D pretty easily:)
 
 	<div align="center"><img src="images/concord_mark.png" width="90%"/></div>
 
 $(P The debugger engine needs to detect the source language of the code location. This information
 is added to the debug information starting with dmd 2.072 when compiled for COFF object
 files (-m64 or -m32mscoff) with -g, but not with
--gc, i.e. you should select debug info for Mago even when using the VS debug engine.)
+-gc, i.e. you should select debug info for Mago even when using the VS debug engine.) Unfortunately,
+LDC does not yet emit this source language information.
 
 <a id="recommendation"></a>
 $(H3 Recommendation for VS 2015)
@@ -101,8 +103,8 @@ $(UL
   $(LI choose the Visual Studio debugger on the project configuration page Debugging)
 )
 
-$(P If you are using the new Visual C/C++ project integration, all you have to do is select debug information
-"for D debug engines" on the project configuration page "D Compiler->Code generation".)
+$(P If you are using the new $(VDLINK vcxproject, Visual C/C++ project integration), all you have to do is
+select debug information "for D debug engines" on the project configuration page "D Compiler->Code generation".)
 
 $(H2 Exceptions)
 
@@ -112,12 +114,14 @@ is thrown by the debuggee. With earlier versions, you'll have to add an entry wi
 
 $(H3 Exceptions with Mago)
 
-$(P Mago displays exceptions thrown by the debuggee in the output window. You can also stop execution
+$(P The Mago debug engine displays exceptions thrown by the debuggee in the output window. You can also stop execution
 by enabling the respective box in the Debug->Exception dialog. Due to a bug, you currently cannot
 simply enable the "D Exceptions" entry, but must select the specific exceptions while keeping the
 "D Exceptions" entry unchecked. So, the dialog should look something like this:)
 
 $(IMG_CENTER images/d_exceptions.png)
 
+Please note that these specific exception settings only apply to the Mago debug engine, not the Concord extension.
+
 Macros:
 	TITLE=Debugging

doc/StartPage.dd

@@ -54,6 +54,13 @@ $(H2 News)
 $(P $(LINK2 VersionHistory.html, Full version history and complete details...)
 )
 
+2017-02-06 Version 0.44
+$(UL
+  $(LI $(VDLINK vcxproject, integration) with msbuild and Visual C/C++ projects)
+  $(LI enhanced $(LINK2 Debugging.html#concord, integration) with the Visual Studio debugger by only adding mago's expression evaluator)
+  $(LI improvements to completion lists)
+)
+
 2015-11-28 Version 0.3.43
 $(UL
  $(LI improved VS 2015 support)

doc/VersionHistory.dd

@@ -1,5 +1,66 @@
 Ddoc
 
+$(H2 2017-02-08 Version 0.44)
+ $(UL
+  $(LI installation
+   $(UL
+    $(LI added preliminary support for VS 2017 RC)
+	$(LI new version scheme removing the gratuitious .3 from the Visual D version)
+   ))
+  $(LI project management
+   $(UL
+    $(LI added integration with msbuild and VC++ projects)
+    $(LI can now read and write Mono-D project files (but likely to be incomplete because this was
+      a failed attempt to integrate with msbuild and the VC projects))
+    $(LI when linking with MS linker, options for the map file broke the command line)
+    $(LI bugzilla 16063: missing option -L/DLL when linking a DLL with MS linker)
+    $(LI added $(DOLLAR)(Platform) as a settings macro replacement in addition to $(DOLLAR)(PlatformName))
+    $(LI changed default output directory to $(DOLLAR)(PlatformName)/$(DOLLAR)(ConfigurationName))
+    $(LI added x64 configurations to project templates)
+    $(LI added project template to build with DMD, LDC and GDC for x86 and x64)
+    $(LI building a library with LDC now always adds "-oq -od=$(DOLLAR)(IntDir)" to the command line)
+   ))
+  $(LI mago:
+   $(UL
+    $(LI bring back support to run on Windows XP)
+    $(LI display const modifier on type, recover string types)
+    $(LI add and install Concord debug engine plugin for VS 2012-2015)
+   ))
+  $(LI cv2pdb:
+   $(UL
+    $(LI fix crashes with very long symbols)
+    $(LI can now be enabled independent of debug engine)
+   ))
+  $(LI language service
+   $(UL
+    $(LI added automatic brace completion)
+    $(LI dparser: semantic analysis no longer times out after 500ms, but cancels previous requests)
+    $(LI dparser: improved performance by adding name lookup cache)
+    $(LI Improvements to completion lists:
+	 $(UL
+      $(LI completion box no longer pops up if caret has been moved elsewhere)
+      $(LI new option to disable exact start match (searches case insensitive sub string))
+      $(LI free functions show different icon than member functions)
+      $(LI aliases show other icon than variables)
+      $(LI new sorting modes "by type" using classification by the semantic engine,
+        "by declaration", effectively using scopes as discovered by the semantic engine)
+      $(LI without any match, still keep the completion box open to update when deleting the last character)
+     ))
+   ))
+  $(LI build
+   $(UL
+    $(LI now builds with dmd 2.073)
+    $(LI added AppVeyor integration builds)
+    $(LI VS SDK 2013 now needed to build Visual D)
+   ))
+  $(LI miscellaneous
+   $(UL
+    $(LI dustmite: error messages written to stderr not grepped)
+    $(LI menu entries now disabled if they require the focus on a D file, but it is elsewhere)
+    $(LI reduced idle processing by only updating the active view)
+   ))
+ )
+
 $(H2 2015-11-28 Version 0.3.43)
  $(UL
   $(LI installation

doc/vcxproject.dd

@@ -14,7 +14,7 @@ $(IMG_CENTER images/vcxproject_general.png)
 
 $(P A couple of things to note:)
 $(UL
-  $(LI Only COFF files are generated, there is no support for OMF files that DMD geberates for Win32 by default.)
+  $(LI Only COFF files are generated, there is no support for OMF files that DMD generates for Win32 by default.)
   $(LI Selecting the C runtime library is supported starting with DMD 2.073)
   $(LI The D project templates include a console application template based on a VC project, but just containing a D file.)
 )

doc/visuald.ddoc

@@ -1,4 +1,4 @@
-VERSION = 0.44
+VERSION = 0.44.0
 ROOT_DIR = http://www.dlang.org/
 ROOT = http://www.dlang.org
 BODYCLASS = visuald