Rename Clojure/Nim to Bara Lang in documentation
This commit is contained in:
@@ -3,11 +3,11 @@
|
||||
|
||||
---
|
||||
|
||||
# Clojure/Nim Architecture
|
||||
# Bara Lang Architecture
|
||||
|
||||
## Overview
|
||||
|
||||
Clojure/Nim is a **compiler**, not an interpreter. It follows the model of ClojureScript: Clojure source is read, macro-expanded, analyzed, and emitted as Nim source code, which then compiles to C and finally to a native binary.
|
||||
Bara Lang is a **compiler**, not an interpreter. It follows the model of ClojureScript: Clojure source is read, macro-expanded, analyzed, and emitted as Nim source code, which then compiles to C and finally to a native binary.
|
||||
|
||||
## Compilation Pipeline
|
||||
|
||||
@@ -48,14 +48,14 @@ Clojure/Nim is a **compiler**, not an interpreter. It follows the model of Cloju
|
||||
## Unique Advantages
|
||||
|
||||
### Independence from the Java Ecosystem
|
||||
Clojure/Nim is the **only** Clojure dialect with absolutely no dependency on the Java ecosystem:
|
||||
Bara Lang is the **only** Clojure dialect with absolutely no dependency on the Java ecosystem:
|
||||
|
||||
| Dialect | JVM Required | GraalVM | Google Closure | Java stdlib |
|
||||
|---------|-------------|---------|----------------|-------------|
|
||||
| Clojure (JVM) | ✅ | ❌ | ❌ | ✅ |
|
||||
| ClojureScript | ❌ | ❌ | ✅ | ❌ |
|
||||
| Babashka | ❌ | ✅ | ❌ | Partial |
|
||||
| **Clojure/Nim** | ❌ | ❌ | ❌ | ❌ |
|
||||
| **Bara Lang** | ❌ | ❌ | ❌ | ❌ |
|
||||
|
||||
This means:
|
||||
- **No JVM warmup** — binaries start instantly
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
|
||||
---
|
||||
|
||||
# Clojure/Nim User Guide
|
||||
# Bara Lang User Guide
|
||||
|
||||
## Installation
|
||||
|
||||
@@ -48,7 +48,7 @@ Shows the Clojure AST as S-expressions.
|
||||
./cljnim repl --json
|
||||
```
|
||||
|
||||
## Writing Clojure/Nim Programs
|
||||
## Writing Bara Lang Programs
|
||||
|
||||
### Basic Syntax
|
||||
```clojure
|
||||
|
||||
@@ -5,7 +5,7 @@
|
||||
|
||||
# Clojure Test Suite Compatibility
|
||||
|
||||
Clojure/Nim participates in the cross-dialect **[jank-lang/clojure-test-suite](https://github.com/jank-lang/clojure-test-suite)** — the standard Clojure compliance test suite that validates behavior across all Clojure dialects.
|
||||
Bara Lang participates in the cross-dialect **[jank-lang/clojure-test-suite](https://github.com/jank-lang/clojure-test-suite)** — the standard Clojure compliance test suite that validates behavior across all Clojure dialects.
|
||||
|
||||
## Supported Dialects
|
||||
|
||||
@@ -18,7 +18,7 @@ The Clojure Test Suite is officially maintained for these dialects:
|
||||
| Babashka | ✅ Official | GraalVM native-image |
|
||||
| Clojure CLR | ✅ Official | .NET CLR |
|
||||
| Basilisp | ✅ Official | Python |
|
||||
| **Clojure/Nim** | 🚀 Candidate | **Nim → C → Native** |
|
||||
| **Bara Lang** | 🚀 Candidate | **Nim → C → Native** |
|
||||
|
||||
## Quick Start
|
||||
|
||||
@@ -66,7 +66,7 @@ Each test file is a `.cljc` (cross-platform Clojure/ClojureScript) file with a s
|
||||
|
||||
## Reader Conditional Handling
|
||||
|
||||
Clojure/Nim's `test_single.py` pre-processes `.cljc` files, stripping `#?` and `#?@` reader conditionals and extracting the `:default` branch:
|
||||
Bara Lang's `test_single.py` pre-processes `.cljc` files, stripping `#?` and `#?@` reader conditionals and extracting the `:default` branch:
|
||||
|
||||
```clojure
|
||||
;; Before
|
||||
@@ -86,7 +86,7 @@ This follows the standard cross-dialect convention — each dialect resolves `:d
|
||||
|
||||
## Current Test Scope
|
||||
|
||||
The test suite covers **212+ `clojure.core` functions** and **8 `clojure.string` functions**. Clojure/Nim is working toward full compliance.
|
||||
The test suite covers **212+ `clojure.core` functions** and **8 `clojure.string` functions**. Bara Lang is working toward full compliance.
|
||||
|
||||
See the [Roadmap](06-roadmap.md) for implementation status.
|
||||
|
||||
@@ -103,7 +103,7 @@ For reference, here are links to the official dialect setup guides for running t
|
||||
| Babashka | [babashka.md](https://github.com/jank-lang/clojure-test-suite/blob/main/doc/babashka.md) |
|
||||
| Clojure CLR | [clojureclr.md](https://github.com/jank-lang/clojure-test-suite/blob/main/doc/clojureclr.md) |
|
||||
| Basilisp | [basilisp.md](https://github.com/jank-lang/clojure-test-suite/blob/main/doc/basilisp.md) |
|
||||
| **Clojure/Nim** | **This document** |
|
||||
| **Bara Lang** | **This document** |
|
||||
|
||||
---
|
||||
|
||||
|
||||
+4
-4
@@ -1,4 +1,4 @@
|
||||
# Clojure/Nim Documentation
|
||||
# Bara Lang Documentation
|
||||
|
||||
> A Clojure dialect that compiles to Nim → C → native binaries.
|
||||
> **The only standalone Clojure implementation completely free from the Java ecosystem.**
|
||||
@@ -17,16 +17,16 @@
|
||||
- **AI Integration:** DeepSeek API, OpenAI-compatible, Xiaomi MiMo
|
||||
- **Test Suite:** [Clojure Test Suite Compatibility](07-clojure-test-suite.md) — cross-dialect compliance testing
|
||||
|
||||
## Why Clojure/Nim?
|
||||
## Why Bara Lang?
|
||||
|
||||
Unlike every other Clojure dialect, Clojure/Nim has **zero dependency on the Java ecosystem** — no JVM, no GraalVM, no Google Closure Compiler, no Java standard library.
|
||||
Unlike every other Clojure dialect, Bara Lang has **zero dependency on the Java ecosystem** — no JVM, no GraalVM, no Google Closure Compiler, no Java standard library.
|
||||
|
||||
| Dialect | Java Ecosystem Dependency |
|
||||
|---------|---------------------------|
|
||||
| Clojure (JVM) | Full — runs on JVM |
|
||||
| ClojureScript | Heavy — Google Closure Compiler |
|
||||
| Babashka | Medium — GraalVM native-image |
|
||||
| **Clojure/Nim** | **None — completely standalone** |
|
||||
| **Bara Lang** | **None — completely standalone** |
|
||||
|
||||
### Unique Advantages
|
||||
|
||||
|
||||
Reference in New Issue
Block a user