Merge pull request #189 from ClickHouse/Enmk-translate-comments

Translated comments

Author: Enmk

clickhouse/base/compressed.cpp

@@ -75,7 +75,7 @@ bool CompressedInput::Decompress() {
 
         Buffer tmp(compressed);
 
-        // Заполнить заголовок сжатых данных.
+        // Data header
         {
             BufferOutput out(&tmp);
             out.Write(&method,     sizeof(method));

clickhouse/protocol.h

@@ -2,38 +2,37 @@
 
 namespace clickhouse {
 
-    /// То, что передаёт сервер.
+    /// Types of packets received from server
     namespace ServerCodes {
         enum {
-            Hello                = 0,    /// Имя, версия, ревизия.
-            Data                 = 1,    /// Блок данных со сжатием или без.
-            Exception            = 2,    /// Исключение во время обработки запроса.
-            Progress             = 3,    /// Прогресс выполнения запроса: строк считано, байт считано.
-            Pong                 = 4,    /// Ответ на Ping.
-            EndOfStream          = 5,    /// Все пакеты были переданы.
-            ProfileInfo          = 6,    /// Пакет с профайлинговой информацией.
-            Totals               = 7,    /// Блок данных с тотальными значениями, со сжатием или без.
-            Extremes             = 8,    /// Блок данных с минимумами и максимумами, аналогично.
-            TablesStatusResponse = 9,    /// Ответ на запрос TableStatus.
-            Log                  = 10,   /// Системный лог исполнения запроса.
+            Hello                = 0,    /// Name, version, revision.
+            Data                 = 1,    /// `Block` of data, may be compressed.
+            Exception            = 2,    /// Exception that occured on server side during query execution.
+            Progress             = 3,    /// Query execcution progress: rows and bytes read.
+            Pong                 = 4,    /// response to Ping sent by client.
+            EndOfStream          = 5,    /// All packets were sent.
+            ProfileInfo          = 6,    /// Profiling data
+            Totals               = 7,    /// Block of totals, may be compressed.
+            Extremes             = 8,    /// Block of mins and maxs, may be compressed.
+            TablesStatusResponse = 9,    /// Response to TableStatus.
+            Log                  = 10,   /// Query execution log.
         };
     }
 
-    /// То, что передаёт клиент.
+    /// Types of packets sent by client.
     namespace ClientCodes {
         enum {
-            Hello       = 0,    /// Имя, версия, ревизия, БД по-умолчанию.
-            Query       = 1,    /** Идентификатор запроса, настройки на отдельный запрос,
-                                  * информация, до какой стадии исполнять запрос,
-                                  * использовать ли сжатие, текст запроса (без данных для INSERT-а).
+            Hello       = 0,    /// Name, version, default database name.
+            Query       = 1,    /** Query id, query settings, query processing stage, 
+                                  * compression status, and query text (no INSERT data).
                                   */
-            Data        = 2,    /// Блок данных со сжатием или без.
-            Cancel      = 3,    /// Отменить выполнение запроса.
-            Ping        = 4,    /// Проверка живости соединения с сервером.
+            Data        = 2,    /// Data `Block` (e.g. INSERT data), may be compressed.
+            Cancel      = 3,    /// Cancel query.
+            Ping        = 4,    /// Check server connection.
         };
     }
 
-    /// Использовать ли сжатие.
+    /// Should we compress `Block`s of data 
     namespace CompressionState {
         enum {
             Disable     = 0,

clickhouse/query.h

@@ -14,11 +14,11 @@ namespace clickhouse {
  * Settings of individual query.
  */
 struct QuerySettings {
-    /// Максимальное количество потоков выполнения запроса. По-умолчанию - определять автоматически.
+    /// Maximum thread to use on the server-side to process a query. Default - let the server choose.
     int max_threads = 0;
-    /// Считать минимумы и максимумы столбцов результата.
+    /// Compute min and max values of the result.
     bool extremes = false;
-    /// Тихо пропускать недоступные шарды.
+    /// Silently skip unavailable shards.
     bool skip_unavailable_shards = false;
     /// Write statistics about read rows, bytes, time elapsed, etc.
     bool output_format_write_statistics = true;