Improve README.

GitOrigin-RevId: 846c79e12b2df885629b5dc86e0d22e4538cdd4f

CHANGELOG.md

@@ -11,7 +11,7 @@ Changes in 1.1.0:
 * Added methods `td::Log::set_fatal_error_callback` and `td_set_log_fatal_error_callback` for providing callbacks
   on fatal errors.
 * JNI-bindings are now package-agnostic. Use CMake option `TD_ENABLE_JNI` to enable JNI-bindings.
-* Added a Java example. See [Readme](example/java/README.md) for build and usage instructions.
+* Added a Java example. See [README](example/java/README.md) for build and usage instructions.
 * Added support for text entities in media captions.
   - Added new type `formattedText` containing a text with entities.
   - Replaced all string fields `caption` with fields of type `formattedText`.
@@ -26,7 +26,7 @@ Changes in 1.1.0:
   - Added parameter `other_user_ids` to method `registerDevice` to support multiple accounts.
   - It is now possible to specify tokens for VoIP pushes, WNS, web Push API, Tizen Push Service as `DeviceToken`.
   - Added support for Apple Push Notification Service inside App Sandbox.
-* Add method `searchChatsOnServer` analogous to `searchChats`, but using server search.
+* Added method `searchChatsOnServer` analogous to `searchChats`, but using server search.
 * Results from the `searchChatsOnServer` method are now excluded from `searchPublicChats` results,
   so `searchChatsOnServer` (along with `searchContacts`) should be called whenever `searchPublicChats` is called
   to ensure that no results were omitted.

README.md

@@ -42,8 +42,8 @@ Take a look at our [examples](https://github.com/tdlib/td/tree/master/example) a
 * zlib
 * gperf (build only)
 * CMake (3.0.2+, build only)
-* PHP (optional, for docs generation)
+* PHP (optional, for documentation generation)
-* Doxygen (optional, for docs generation)
+* Doxygen (optional, for documentation generation)
 
 <a name="building"></a>
 ## Building

example/csharp/README.md

@@ -11,6 +11,7 @@ This is an example of building TDLib with `C++/CLI` support and an example of TD
 ```
 C:\src\vcpkg> .\vcpkg.exe install openssl:x64-windows openssl:x86-windows zlib:x64-windows zlib:x86-windows
 ```
+* (Optional. For XML documentation generation.) Download [PHP](https://windows.php.net/download#php-7.2). Add the path to php.exe to the PATH environment variable.
 * Download and install [gperf](https://sourceforge.net/projects/gnuwin32/files/gperf/3.0.1/). Add the path to gperf.exe to the PATH environment variable.
 * Build `TDLib` with CMake enabling `.NET` support and specifying correct path to `vcpkg` toolchain file:
 ```

example/uwp/README.md

@@ -11,6 +11,7 @@ This is an example of building TDLib SDK for Universal Windows Platform and an e
 ```
 C:\src\vcpkg> .\vcpkg.exe install openssl:arm-uwp openssl:x64-uwp openssl:x86-uwp zlib:arm-uwp zlib:x64-uwp zlib:x86-uwp
 ```
+* (Optional. For XML documentation generation.) Download [PHP](https://windows.php.net/download#php-7.2). Add the path to php.exe to the PATH environment variable.
 * Download and install [gperf](https://sourceforge.net/projects/gnuwin32/files/gperf/3.0.1/). Add the path to gperf.exe to the PATH environment variable.
 * Download and install [7-Zip](http://www.7-zip.org/download.html) archiver, which is used by the `build.ps1` script to create a Telegram.Td.UWP Visual Studio Extension. Add the path to 7z.exe to the PATH environment variable.
   Alternatively `build.ps1` supports compressing using [WinRAR](https://en.wikipedia.org/wiki/WinRAR) with option `-compress winrar` and compressing using [zip](http://gnuwin32.sourceforge.net/packages/zip.htm) with `-compress zip`.

td/generate/scheme/td_api.tl

@@ -204,7 +204,7 @@ sticker set_id:int64 width:int32 height:int32 emoji:string is_mask:Bool mask_pos
 
 //@description Describes a video file @duration Duration of the video, in seconds; as defined by the sender @width Video width; as defined by the sender @height Video height; as defined by the sender
 //@file_name Original name of the file; as defined by the sender @mime_type MIME type of the file; as defined by the sender @has_stickers True, if stickers were added to the photo
-//@supports_streaming True, if the video should be tried to streamed @thumbnail Video thumbnail; as defined by the sender; may be null @video File containing the video
+//@supports_streaming True, if the video should be tried to be streamed @thumbnail Video thumbnail; as defined by the sender; may be null @video File containing the video
 video duration:int32 width:int32 height:int32 file_name:string mime_type:string has_stickers:Bool supports_streaming:Bool thumbnail:photoSize video:file = Video;
 
 //@description Describes a video note. The video must be equal in width and height, cropped to a circle, and stored in MPEG4 format @duration Duration of the video, in seconds; as defined by the sender @length Video width and height; as defined by the sender @thumbnail Video thumbnail; as defined by the sender; may be null @video File containing the video
@@ -990,7 +990,7 @@ inputMessagePhoto photo:InputFile thumbnail:inputThumbnail added_sticker_file_id
 inputMessageSticker sticker:InputFile thumbnail:inputThumbnail width:int32 height:int32 = InputMessageContent;
 
 //@description A video message @video Video to be sent @thumbnail Video thumbnail, if available @added_sticker_file_ids File identifiers of the stickers added to the video, if applicable
-//@duration Duration of the video, in seconds @width Video width @height Video height @supports_streaming True, if the video should be tried to streamed
+//@duration Duration of the video, in seconds @width Video width @height Video height @supports_streaming True, if the video should be tried to be streamed
 //@caption Video caption; 0-200 characters @ttl Video TTL (Time To Live), in seconds (0-60). A non-zero TTL can be specified only in private chats
 inputMessageVideo video:InputFile thumbnail:inputThumbnail added_sticker_file_ids:vector<int32> duration:int32 width:int32 height:int32 supports_streaming:Bool caption:formattedText ttl:int32 = InputMessageContent;