From fc6ff10acb9d00ea1c8c5924869e0efbd38093c5 Mon Sep 17 00:00:00 2001
From: Zuhaitz Méndez Fernández de Aránguiz <zuhaitz@debian>
Date: Thu, 29 Jan 2026 13:17:30 +0000
Subject: Objective-C interop + a few improvements

---
 docs/std/stack.md | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 docs/std/stack.md

(limited to 'docs/std/stack.md')

diff --git a/docs/std/stack.md b/docs/std/stack.md
new file mode 100644
index 0000000..6e5da84
--- /dev/null
+++ b/docs/std/stack.md
@@ -0,0 +1,38 @@
+# Stack (`std/stack.zc`)
+
+The `std/stack` module provides a LIFO (Last-In, First-Out) stack data structure.
+
+## Usage
+
+```zc
+import "std/stack.zc"
+```
+
+## Types
+
+### Struct `Stack<T>`
+
+A generic stack.
+
+#### Methods
+
+- **`fn new() -> Stack<T>`**
+  Creates a new empty stack.
+
+- **`fn push(self, value: T)`**
+  Pushes a value onto the top of the stack.
+
+- **`fn pop(self) -> Option<T>`**
+  Removes and returns the top element of the stack. Returns `None` if empty.
+
+- **`fn length(self) -> usize`**
+  Returns the number of elements in the stack.
+
+- **`fn is_empty(self) -> bool`**
+  Returns `true` if the stack contains no elements.
+
+- **`fn clear(self)`**
+  Removes all elements from the stack.
+
+- **`fn clone(self) -> Stack<T>`**
+  Creates a deep copy of the stack.
-- 
cgit v1.2.3