From a459e3c1a9c3f485c7073aa06a2c09b3ff884570 Mon Sep 17 00:00:00 2001
From: "Dylan K. Taylor" <dktapps@pmmp.io>
Date: Tue, 9 Jan 2024 13:35:36 +0000
Subject: [PATCH] Block: improve some documentation

---
 src/block/Block.php | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/src/block/Block.php b/src/block/Block.php
index d6158ea94..dbc269c63 100644
--- a/src/block/Block.php
+++ b/src/block/Block.php
@@ -402,7 +402,7 @@ class Block{
 	}
 
 	/**
-	 * AKA: Block->isPlaceable
+	 * Returns whether this block can be placed when obtained as an item.
 	 */
 	public function canBePlaced() : bool{
 		return true;
@@ -572,6 +572,9 @@ class Block{
 		return $this->getLightFilter() > 0;
 	}
 
+	/**
+	 * Returns whether this block allows any light to pass through it.
+	 */
 	public function isTransparent() : bool{
 		return false;
 	}
@@ -590,7 +593,7 @@ class Block{
 	}
 
 	/**
-	 * AKA: Block->isFlowable
+	 * Returns whether this block can be destroyed by liquid flowing into its cell.
 	 */
 	public function canBeFlowedInto() : bool{
 		return false;