Document JNasm Assembler - Value 5

[LSantha]

JNasm Assembler

Document the JNasm Assembler JNode concept in the wiki.

Value: 5

Concept Summary

JNode's custom x86 assembler with macro preprocessing and instruction encoding. JNasm provides a high-level assembly language for JNode, enabling efficient x86 code generation with preprocessing and macro support.

Key Files

• builder/src/builder/org/jnode/jnasm/JNAsm.java
• builder/src/builder/org/jnode/jnasm/assembler/Assembler.java

Occurrences

~200 references in jnasm package

Wiki Status

Partially covered (JNasm-Assembler-Design.md)

Bridges

Build system, Assembly, Binary generation

Instructions

Skill to Use

Use the [[update-wiki|update-wiki skill]] (load with skill({ name: "update-wiki" })) for understanding JNode internals.

Context Research

Study JNAsm.java and Assembler.java to understand the assembler. Review how JNasm processes assembly source, how macros work, and how instructions are encoded. Research how JNasm integrates with the build system and generates binary output.

Update index.md

• Pages table: Add entry for JNasm-Assembler.md
• Concepts → Pages table: Add "JNasm Assembler" mapping to [[JNasm-Assembler]]
• Source Path → Pages table: Add mappings for builder/src/builder/org/jnode/jnasm/
• Task Routing table: Add relevant task route(s)

Task Routing Suggestions

1. Assembly development: JNasm is central to assembly work
2. Macro development: Understanding macros is key for code generation
3. Build integration: JNasm integrates with Ant build system

Wiki Page Structure

# JNasm Assembler

> JNode's custom x86 assembler with macro preprocessing and instruction encoding.

## Overview
2-3 paragraph explanation of JNasm, its role in the build system, and how it enables efficient assembly programming.

## Key Components
| Class / File | Role |
|---|---|
| `builder/src/builder/org/jnode/jnasm/JNAsm.java` | Main assembler entry point |
| `builder/src/builder/org/jnode/jnasm/assembler/Assembler.java` | Assembler implementation |

## How It Works
Explanation of how JNasm works, how assembly source is processed, how macros work, how instructions are encoded, and how binary output is generated.

## Gotchas & Non-Obvious Behavior
- JNasm syntax differs from standard NASM/YASM
- Macro expansion must be careful with scoping
- Instruction encoding must match x86 specifications

## Related Pages
- [[Build-System]]
- [[x86-Assembly]]
- [[Binary-Generation]]

---

Related Concepts: Assembler, Assembly, Build system, Macro, Instruction encoding

[LSantha]

/oc Please proceed with this task.

[LSantha]

/oc Please proceed with this task.

[LSantha]

/oc Please proceed with this task.

[opencode-agent]

The commit was created locally (794bdc5) but push to the remote wiki repository failed due to authentication. The SSH key is not available in this environment.

Workaround needed: Either configure SSH keys for the wiki repo, or push manually from the .wiki directory:

cd .wiki
git push git@github.com:LSantha/jnode_ai.wiki.git master

Once pushed, the page will be available at: https://github.com/LSantha/jnode_ai/wiki/JNasm-Assembler

After manual push, close the issue with:

gh issue close 5

opencode session  |  github run

[opencode-agent]

Done! Created the JNasm-Assembler wiki page and updated the index, glossary, and changelog.

Wiki URL: https://github.com/LSantha/jnode_ai/wiki/JNasm-Assembler

opencode session  |  github run

[opencode-agent]

Task completed. The wiki page was already created by a prior agent session and was present on the remote. I updated the Source Path → Pages table in index.md to include [[JNasm-Assembler]] alongside [[JNasm-Assembler-Design]] (since both pages cover the same builder/src/builder/org/jnode/jnasm/ path), and pushed the change.

Wiki page: https://github.com/LSantha/jnode_ai/wiki/JNasm-Assembler

Issue #80 was already closed at 2026-05-10T10:40:19Z.

opencode session  |  github run