Just show 'PythonBlock' in doc for Context::run.

Author: m-ou-se

src/context.rs

@@ -142,10 +142,15 @@ impl Context {
 	/// ```
 	///
 	/// This function panics if the Python code fails.
-	pub fn run<F: FnOnce(&Bound<PyDict>)>(&self, code: PythonBlock<F>) {
+	pub fn run(
+		&self,
+		#[cfg(not(doc))] code: PythonBlock<impl FnOnce(&Bound<PyDict>)>,
+		#[cfg(doc)] code: PythonBlock, // Just show 'PythonBlock' in the docs.
+	) {
 		Python::with_gil(|py| self.run_with_gil(py, code));
 	}
 
+	#[cfg(not(doc))]
 	pub(crate) fn run_with_gil<F: FnOnce(&Bound<PyDict>)>(&self, py: Python<'_>, block: PythonBlock<F>) {
 		(block.set_variables)(self.globals().bind(py));
 		if let Err(err) = run_python_code(py, self, block.bytecode) {

src/lib.rs

@@ -172,6 +172,7 @@ impl<F: FnOnce(&Bound<PyDict>)> FromInlinePython<F> for Context {
 }
 
 /// Using a `python!{}` block as a `PythonBlock` object will not do anything yet.
+#[cfg(not(doc))]
 impl<F: FnOnce(&Bound<PyDict>)> FromInlinePython<F> for PythonBlock<F> {
 	fn from_python_macro(bytecode: &'static [u8], set_variables: F, panic: fn(String) -> !) -> Self {
 		Self {
@@ -183,9 +184,15 @@ impl<F: FnOnce(&Bound<PyDict>)> FromInlinePython<F> for PythonBlock<F> {
 }
 
 /// Represents a `python!{}` block.
-#[doc(hidden)]
+#[cfg(not(doc))]
 pub struct PythonBlock<F> {
 	bytecode: &'static [u8],
 	set_variables: F,
 	panic: fn(String) -> !,
 }
+
+/// In the documentation, we just show `PythonBlock` in
+/// `Context::run`'s signature, without any generic arguments.
+#[cfg(doc)]
+#[doc(hidden)]
+pub struct PythonBlock;