Work towards message buttons

client/doc/concepts/sessions.rst

@@ -43,7 +43,7 @@ The :class:`session.Storage` abstract base class defines the required methods to
 Telethon comes with two built-in storages:
 
 * :class:`~session.SqliteSession`. This is used by default when a string or path is used.
-* :class:`~session.MemorySession`. This is used by default when the path is ``None``.
+* :class:`~session.MemorySession`. This is used by default when the path is :data:`None`.
   You can also use it directly when you have a :class:`~session.Session` instance.
   It's useful when you don't have file-system access.
 

client/doc/developing/migration-guide.rst

@@ -377,7 +377,7 @@ Now handlers are called in order until the filter for one returns :data:`True`.
 The default behaviour is that handlers after that one are not called.
 This behaviour can be changed with the ``check_all_handlers`` flag in :class:`Client` constructor.
 
-:class:`events.CallbackQuery` no longer also handles "inline bot callback queries".
+``events.CallbackQuery`` has been renamed to :class:`events.ButtonCallback` and no longer also handles "inline bot callback queries".
 This was a hacky workaround.
 
 :class:`events.MessageRead` no longer triggers when the *contents* of a message are read, such as voice notes being played.

client/doc/modules/client.rst

@@ -1 +1,12 @@
-.. autoclass:: telethon.Client
+.. currentmodule:: telethon
+
+Client class
+============
+
+The :class:`Client` class is the "entry point" of the library.
+
+Most client methods have an alias in the respective types.
+For example, :meth:`Client.forward_messages` can also be invoked from :meth:`types.Message.forward`.
+With a few exceptions, "client.verb_object" methods also exist as "object.verb".
+
+.. autoclass:: Client

client/doc/modules/types.rst

@@ -1,8 +1,25 @@
 Types
 =====
 
+This section contains most custom types used by the library.
+:doc:`events` and the :doc:`client` get their own section to prevent the page from growing out of control.
+
+Some of these are further divided into additional submodules.
+This keeps them neatly grouped and avoids polluting a single module too much.
+
+
+Core types
+----------
+
 .. automodule:: telethon.types
 
+
+Keyboard buttons
+----------------
+
+.. automodule:: telethon.types.buttons
+
+
 Errors
 ------