Rename and add xml doc

Author: GrahamTheCoder

…onverter/CSharp/ByRefParameterVisitor.cs …CSharp/HoistedDeclarationStateVisitor.csCodeConverter/CSharp/ByRefParameterVisitor.cs renamed to CodeConverter/CSharp/HoistedDeclarationStateVisitor.cs CodeConverter/CSharp/ByRefParameterVisitor.cs renamed to CodeConverter/CSharp/HoistedDeclarationStateVisitor.cs

@@ -12,14 +12,20 @@
 
 namespace ICSharpCode.CodeConverter.CSharp
 {
-    public class ByRefParameterVisitor : VBasic.VisualBasicSyntaxVisitor<Task<SyntaxList<StatementSyntax>>>
+    /// <summary>
+    /// Allows adding a declaration to the surrounding scope (by sharing an instance of AdditionalLocals)
+    /// e.g. Add a local variable declaration in the scope immediately before the expression currently being visited.
+    /// e.g. Add a member declaration in the scope immediately before the member currently being visited.
+    /// The current implementation uses a guid variable name, then replaces it later with a unique name by tracking the annotation added to it.
+    /// </summary>
+    public class HoistedDeclarationStateVisitor : VBasic.VisualBasicSyntaxVisitor<Task<SyntaxList<StatementSyntax>>>
     {
         private readonly VBasic.VisualBasicSyntaxVisitor<Task<SyntaxList<StatementSyntax>>> _wrappedVisitor;
         private readonly AdditionalLocals _additionalLocals;
         private readonly SemanticModel _semanticModel;
         private readonly HashSet<string> _generatedNames;
 
-        public ByRefParameterVisitor(VBasic.VisualBasicSyntaxVisitor<Task<SyntaxList<StatementSyntax>>> wrappedVisitor, AdditionalLocals additionalLocals,
+        public HoistedDeclarationStateVisitor(VBasic.VisualBasicSyntaxVisitor<Task<SyntaxList<StatementSyntax>>> wrappedVisitor, AdditionalLocals additionalLocals,
             SemanticModel semanticModel, HashSet<string> generatedNames)
         {
             _wrappedVisitor = wrappedVisitor;

CodeConverter/CSharp/MethodBodyExecutableStatementVisitor.cs

@@ -63,7 +63,7 @@ private MethodBodyExecutableStatementVisitor(VBasic.VisualBasicSyntaxNode method
             _withBlockLhs = withBlockLhs;
             _extraUsingDirectives = extraUsingDirectives;
             _methodsWithHandles = methodsWithHandles;
-            var byRefParameterVisitor = new ByRefParameterVisitor(this, additionalLocals, semanticModel, _generatedNames);
+            var byRefParameterVisitor = new HoistedDeclarationStateVisitor(this, additionalLocals, semanticModel, _generatedNames);
             CommentConvertingVisitor = new CommentConvertingMethodBodyVisitor(byRefParameterVisitor);
             _vbBooleanTypeSymbol = _semanticModel.Compilation.GetTypeByMetadataName("System.Boolean");
             _localsToInlineInLoop = localsToInlineInLoop;