Skip to content

docs: add man page, install target, and fork constitution#13

Open
DonaldoDes wants to merge 3 commits intomobydeck:mainfrom
DonaldoDes:feat/developer-experience
Open

docs: add man page, install target, and fork constitution#13
DonaldoDes wants to merge 3 commits intomobydeck:mainfrom
DonaldoDes:feat/developer-experience

Conversation

@DonaldoDes
Copy link
Contributor

Summary

  • Add atch.1 man page (roff format) covering all commands, options, and examples
  • Add make install target with PREFIX variable (default /usr/local)
  • Add constitution.md documenting fork conventions and upstream contribution policy
  • Add man page validation tests (tests/test_man.sh)

Test plan

  • man ./atch.1 renders correctly
  • make install PREFIX=/tmp/atch-test installs binary and man page
  • Man page tests pass (33 checks: sections, commands, options, mandoc lint)

🤖 Generated with Claude Code

DonaldoDes and others added 3 commits March 10, 2026 17:40
Documents fork identity, architectural principles (raw PTY passthrough,
no emulation, no deps), C style conventions, upstream policy, build
instructions, and test process.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Documents all commands (attach, new, start, run, push, kill, clear,
list, current), all options (-e, -E, -r, -R, -z, -q, -t, -C, -f),
FILES, ENVIRONMENT (ATCH_SESSION), EXIT STATUS, and EXAMPLES sections.
Includes tests/test_man.sh with 33 TAP assertions verified via mandoc.
Also removes the *.1 gitignore rule so that the committed man page is
tracked directly rather than generated by pandoc.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Adds PREFIX ?= /usr/local and an install target that copies:
  - the atch binary to $(PREFIX)/bin/atch
  - the man page to $(PREFIX)/share/man/man1/atch.1

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant