From f0505e8e6b3b6f1e34161b7fbb5467314bfd3600 Mon Sep 17 00:00:00 2001
From: Daniel Huppmann <dh@dergelbesalon.at>
Date: Wed, 3 Jun 2020 15:28:07 +0200
Subject: [PATCH] refactor to rst

---
 pyam/iiasa.py | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/pyam/iiasa.py b/pyam/iiasa.py
index dea557734..ed2611b72 100644
--- a/pyam/iiasa.py
+++ b/pyam/iiasa.py
@@ -356,10 +356,14 @@ def query(self, **kwargs):
         Examples
         --------
 
-        ```
-        Connection.query(model='MESSAGE', scenario='SSP2*',
-                         variable=['Emissions|CO2', 'Primary Energy'])
-        ```
+        You can read from a :class:`pyam.iiasa.Connection` instance using
+        keyword arguments similar to filtering an :class:`IamDataFrame`:
+
+        .. code-block:: python
+
+            Connection.query(model='MESSAGE', scenario='SSP2*',
+                             variable=['Emissions|CO2', 'Primary Energy'])
+
         """
         headers = {
             'Authorization': 'Bearer {}'.format(self._token),