reinstate text in docs, shorten some lines

Author: aram-cedarwood

pandas/core/frame.py

@@ -4560,8 +4560,9 @@ def query(self, expr: str, *, inplace: bool = False, **kwargs) -> DataFrame | No
         For other characters that fall outside the ASCII range (U+0001..U+007F)
         and those that are not further specified in PEP 3131,
         the query parser will raise an error.
-        This excludes whitespace different than the space character
-        and the backtick itself (backtick cannot be escaped).
+        This excludes whitespace different than the space character,
+        but also the hashtag (as it is used for comments) and the backtick
+        itself (backtick can also not be escaped).
 
         See also the `Python documentation about lexical analysis
         <https://docs.python.org/3/reference/lexical_analysis.html>`__
@@ -4620,16 +4621,15 @@ def query(self, expr: str, *, inplace: bool = False, **kwargs) -> DataFrame | No
         if any(("#" in col) or ("'" in col) or ('"' in col) for col in self.columns):
             # Create a copy of `self` with column names escaped
             escaped_self = self.copy()
-            escaped_self.columns = [
-                urllib.parse.quote(col) for col in escaped_self.columns
-            ]
+            escaped_self.columns = map(urllib.parse.quote, escaped_self.columns)
 
             # In expr, escape column names between backticks
-            column_name_to_escaped_name = {
+            column_name_to_escaped = {
                 col: urllib.parse.quote(col) for col in self.columns
             }
+            # Odd-number indexes are column names
             escaped_expr = "`".join(
-                (column_name_to_escaped_name.get(token, token) if (i % 2) else token)
+                (column_name_to_escaped.get(token, token) if (i % 2) else token)
                 for i, token in enumerate(expr.split("`"))
             )
 
@@ -4641,7 +4641,7 @@ def query(self, expr: str, *, inplace: bool = False, **kwargs) -> DataFrame | No
             if isinstance(res, Series) and res.name:
                 res.name = urllib.parse.unquote(res.name)
             elif isinstance(res, DataFrame):
-                res.columns = [urllib.parse.unquote(col) for col in res.columns]
+                res.columns = map(urllib.parse.unquote, res.columns)
         else:
             res = self.eval(expr, **kwargs)