resolve the comments

Author: xieyuschen

src/ast/builder/mod.rs

@@ -305,10 +305,12 @@ pub trait IRBuilder<'a, 'ctx> {
     fn is_main(&self, f: ValueHandle) -> bool;
 }
 
-/// ValueHandle is an index used to map a [AnyValueEnum][inkwell::values::AnyValueEnum] inside the [LLVMBuilder].
+/// ValueHandle is an index used to separate the low level code generation with the respective ast node.
+/// Currently, it's used as an index to map a [Node] to a [AnyValueEnum][inkwell::values::AnyValueEnum] inside the [LLVMBuilder].
 pub type ValueHandle = usize;
 
-/// BlockHandle is an index used to map a [BasicBlock][inkwell::basic_block::BasicBlock] inside the [LLVMBuilder].
+/// BlockHandle is an index used to separate the low level code generation with the respective ast node.
+/// Currently, it's used as an index to map a [Node] to a a [BasicBlock][inkwell::basic_block::BasicBlock] inside the [LLVMBuilder].
 pub type BlockHandle = usize;
 
 #[allow(clippy::upper_case_acronyms)]

src/ast/ctx.rs

@@ -119,17 +119,17 @@ pub struct Ctx<'a> {
     /// highlight is generated only if the number is 0
     pub need_highlight: Arc<RefCell<usize>>,
 
-    /// LLVM argument: the index to mark a function element inside builder
+    /// the index to mark a lower level code generation of function element from the builder
     pub function: Option<ValueHandle>,
-    /// LLVM argument: the init function called first in main
+    /// the init function called first in main
     pub init_func: Option<ValueHandle>,
-    /// LLVM argument: current block
+    /// current block
     pub block: Option<BlockHandle>,
-    /// LLVM argument: the block to jump when continue if it's a loop statement
+    /// the block to jump when continue if it's a loop statement
     pub continue_block: Option<BlockHandle>,
-    /// LLVM argument: the block to jump to when break if it's a loop statement
+    /// the block to jump to when break if it's a loop statement
     pub break_block: Option<BlockHandle>,
-    /// LLVM argument: the block to jump to when return and value
+    /// the block to jump to when return and value
     pub return_block: Option<(BlockHandle, Option<ValueHandle>)>,
 
     /// diagnose tries to hold all warning and as many as possible errors