add comment docs

Author: xieguigang

studio/RData/Enums/CharFlags.vb

@@ -47,9 +47,19 @@ Namespace Flags
     Public Enum CharFlags
         HAS_HASH = 1
         BYTES = 1 << 1
+        ''' <summary>
+        ''' const LATIN1_MASK  = (1&lt;&lt;2);
+        ''' </summary>
         LATIN1 = 1 << 2
+        ''' <summary>
+        ''' const UTF8_MASK    = (1&lt;&lt;3);
+        ''' </summary>
         UTF8 = 1 << 3
         CACHED = 1 << 5
+
+        ''' <summary>
+        ''' const ASCII_MASK   = (1&lt;&lt;6);
+        ''' </summary>
         ASCII = 1 << 6
     End Enum
 End Namespace

studio/RData/Enums/FileTypes.vb

@@ -52,10 +52,25 @@ Namespace Flags
     Public Enum FileTypes
         Unknown = 0
 
+        ''' <summary>
+        ''' bzip2 compression
+        ''' </summary>
         <Description("bz2")> bzip2
+        ''' <summary>
+        ''' gzip compression
+        ''' </summary>
         <Description("gzip")> gzip
+        ''' <summary>
+        ''' xz compression
+        ''' </summary>
         <Description("xz")> xz
+        ''' <summary>
+        ''' rdata version 2 (binary)
+        ''' </summary>
         <Description("rdata version 2 (binary)")> rdata_binary_v2
+        ''' <summary>
+        ''' rdata version 3 (binary)
+        ''' </summary>
         <Description("rdata version 3 (binary)")> rdata_binary_v3
     End Enum
 End Namespace

studio/RData/Enums/RObjectType.vb

@@ -49,15 +49,15 @@ Namespace Flags
     ''' </summary>
     Public Enum RObjectType As Byte
         ''' <summary>
-        ''' NULL
+        ''' NULL, nil = NULL
         ''' </summary>
         NIL = 0
         ''' <summary>
         ''' symbols
         ''' </summary>
         SYM = 1
         ''' <summary>
-        ''' pairlists
+        ''' pairlists, lists of dotted pairs
         ''' </summary>
         LIST = 2
         ''' <summary>
@@ -69,23 +69,23 @@ Namespace Flags
         ''' </summary>
         ENV = 4
         ''' <summary>
-        ''' promises
+        ''' promises, promises: [un]evaluated closure arguments
         ''' </summary>
         PROM = 5
         ''' <summary>
-        ''' language objects
+        ''' language objects, language constructs (special lists)
         ''' </summary>
         LANG = 6
         ''' <summary>
         ''' special functions
         ''' </summary>
         SPECIAL = 7
         ''' <summary>
-        ''' builtin functions
+        ''' builtin functions, builtin non-special forms 
         ''' </summary>
         BUILTIN = 8
         ''' <summary>
-        ''' internal character strings
+        ''' internal character strings, "scalar" string type (internal only)
         ''' </summary>
         [CHAR] = 9
         ''' <summary>
@@ -114,6 +114,9 @@ Namespace Flags
         DOT = 17
         ''' <summary>
         ''' make “any” args work
+        ''' 
+        ''' Used in specifying types for symbol
+        ''' registration To mean anything Is okay
         ''' </summary>
         ANY = 18
         ''' <summary>
@@ -137,14 +140,19 @@ Namespace Flags
         ''' </summary>
         WEAKREF = 23
         ''' <summary>
-        ''' raw vector
+        ''' raw bytes vector
         ''' </summary>
         RAW = 24
         ''' <summary>
         ''' S4 classes Not Of simple type
         ''' </summary>
         S4 = 25
 
+        ''' <summary>
+        ''' Closure or Builtin or Special
+        ''' </summary>
+        FUNSXP = 99
+
         ''' <summary>
         ''' Alternative representations
         ''' </summary>

studio/RData/Enums/RdataFormats.vb

@@ -47,13 +47,22 @@ Imports System.ComponentModel
 Namespace Flags
 
     ''' <summary>
-    ''' Format of a R file.
+    ''' encoding format of a R file.
     ''' </summary>
     Public Enum RdataFormats
         Unknown = 0
 
+        ''' <summary>
+        ''' XDR encode
+        ''' </summary>
         <Description("XDR")> XDR
+        ''' <summary>
+        ''' ASCII encode
+        ''' </summary>
         <Description("ASCII")> ASCII
+        ''' <summary>
+        ''' binary encode
+        ''' </summary>
         <Description("binary")> binary
     End Enum
 End Namespace

studio/RData/RData.NET5.sln

@@ -1,7 +1,7 @@
 
 Microsoft Visual Studio Solution File, Format Version 12.00
-# Visual Studio Version 16
-VisualStudioVersion = 16.0.31911.196
+# Visual Studio Version 17
+VisualStudioVersion = 17.1.32127.271
 MinimumVisualStudioVersion = 10.0.40219.1
 Project("{778DAE3C-4631-46EA-AA77-85C1314464D9}") = "RData.NET5", "RData.NET5.vbproj", "{35E5BBE9-B096-46D9-8F04-4E759788EB44}"
 EndProject