From 4c37acea605e2505d447b6ed240788da1917bf92 Mon Sep 17 00:00:00 2001
From: "Marat Zakiyanov (Mario79)" <mario79@bk.ru>
Date: Wed, 11 Dec 2013 19:37:52 +0000
Subject: [PATCH] Additions and changes to the documentation for the clipboard.

git-svn-id: svn://kolibrios.org@4343 a494cfbc-eb01-0410-851d-a64ba20cac60
---
 .../clipboard/clipboard_container_eng.txt     | 34 +++++++++++++++++++
 ...tainer.txt => clipboard_container_rus.txt} | 12 ++++---
 2 files changed, 42 insertions(+), 4 deletions(-)
 create mode 100644 programs/develop/examples/clipboard/clipboard_container_eng.txt
 rename programs/develop/examples/clipboard/{clipboard_container.txt => clipboard_container_rus.txt} (79%)

diff --git a/programs/develop/examples/clipboard/clipboard_container_eng.txt b/programs/develop/examples/clipboard/clipboard_container_eng.txt
new file mode 100644
index 0000000000..97ab82f140
--- /dev/null
+++ b/programs/develop/examples/clipboard/clipboard_container_eng.txt
@@ -0,0 +1,34 @@
+Сontents of container from clipboard
+
+1. First dword - contains the total length of data in the container
+
+2. Second dword - indicates the type of data:
+   0 = Text
+   1 = Highlighted text block
+   2 = Image
+   3 = RAW
+   4 and above reserved
+
+2.1 Text
+    Data in the third dword contain type:
+    0 = UTF
+    1 = 0866    
+    2 = 1251
+    3 and above reserved
+    
+2.2 Highlighted text block
+    Differs from 2.1 - that all rows have the same length.
+
+2.3 Image
+    Third dword - X size
+    Fourth dword - Y size
+    Fifth dword - bit color depth (8, 16, 24, 32, 48, 64)
+    Sixth dword - Pointer to the palette (the offset from the beginning of the file).
+                   If the palette is not set then value 0
+    Seventh dword - The size of the palette, the maximum value of 256 * 4 = 1024 bytes.
+                   If the palette is not set then value 0
+    Eighth dword - A pointer to the pixel data for the R, G, B.
+    Ninth dword - The size of the data for pixels.
+    
+2.4 RAW
+    Can contain any data, because content at the discretion of the programmer
diff --git a/programs/develop/examples/clipboard/clipboard_container.txt b/programs/develop/examples/clipboard/clipboard_container_rus.txt
similarity index 79%
rename from programs/develop/examples/clipboard/clipboard_container.txt
rename to programs/develop/examples/clipboard/clipboard_container_rus.txt
index 3921ca50b5..c0741f771a 100644
--- a/programs/develop/examples/clipboard/clipboard_container.txt
+++ b/programs/develop/examples/clipboard/clipboard_container_rus.txt
@@ -4,8 +4,9 @@
 
 2. Второй dword указывает тип данныx:
    0 = Текст
-   1 = Изображение
-   2 = RAW
+   1 = Текст с блочным выделением
+   2 = Изображение
+   3 = RAW
    4 и выше зарезервировано
 
 2.1 Текст
@@ -15,7 +16,10 @@
     2 = 1251
     3 и выше зарезервировано
 
-2.2 Изображение
+2.2 Текст с блочным выделением
+    Отличается от п.2.1 только тем, что все строки имеют одинаковую длинну.
+
+2.3 Изображение
     Третий dword - размер по X
     Четвертый dword - размер по Y
     Пятый dword - глубина цвета в битах (8, 16, 24, 32, 48, 64)
@@ -26,5 +30,5 @@
     Восьмой dword - Указатель на данные пикселей для R, G, B.
     Девятый dword - Размер области данных для пикселей.
     
-2.3 RAW
+2.4 RAW
     Может содержать любые данные, т.к. содержимое на усмотрение программиста