From 1e5cc961999f3267b1f37ca8cc3bc87477057bd3 Mon Sep 17 00:00:00 2001
From: Ivan Epifanov <isage.dna@gmail.com>
Date: Mon, 8 Mar 2021 19:05:19 +0300
Subject: [PATCH] Docs

---
 docs/README-vita.md | 27 +++++++++++++++++++++++++++
 docs/README.md      |  1 +
 2 files changed, 28 insertions(+)
 create mode 100644 docs/README-vita.md

diff --git a/docs/README-vita.md b/docs/README-vita.md
new file mode 100644
index 000000000..095caceb5
--- /dev/null
+++ b/docs/README-vita.md
@@ -0,0 +1,27 @@
+PS Vita
+=======
+SDL port for the Sony Playstation Vita ans Sony Playstation TV
+
+Credit to
+* xerpi and rsn8887 for initial (vita2d) port
+* vitasdk/dolcesdk devs
+* CBPS discord (Namely Graphene and SonicMastr)
+
+Building
+--------
+To build for the PSP, make sure you have vitasdk and cmake installed and run:
+```
+   cmake -S. -Bbuild -DCMAKE_TOOLCHAIN_FILE=${VITASDK}/share/vita.toolchain.cmake -DCMAKE_BUILD_TYPE=Release
+   cmake --build build
+   cmake --install build
+```
+
+
+Notes
+-----
+* There are two renderers: native gxm and pigs-in-a-blanket gles2.  
+  By default gxm one is used. gles2 renderer is slow and only usable if you want to bind SDL_Texture to GL context.  
+  You can create gles2 renderer by using hint or `1` as a renderer index in `SDL_CreateRenderer`.
+* By default SDL emits mouse events for touch events on every touchscreen.  
+  Vita has two touchscreens, so it's recommended to use `SDL_SetHint(SDL_HINT_TOUCH_MOUSE_EVENTS, "0");` and handle touch events instead.
+* Support for L2/R2/R3/R3 buttons, haptic feedback and gamepad led only available on PSTV, or when using external ds4 gamepad on vita.
\ No newline at end of file
diff --git a/docs/README.md b/docs/README.md
index e44d7cf66..6ef6ba23f 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -49,6 +49,7 @@ More documentation and FAQs are available online at [the wiki](https://github.co
 - [WinCE](README-wince.md)
 - [Windows](README-windows.md)
 - [WinRT](README-winrt.md)
+- [PSVita](README-vita.md)
 
 If you need help with the library, or just want to discuss SDL related
 issues, you can join the [SDL Discourse](https://discourse.libsdl.org/),