tinymux/docs/generated-files.md
Stephen Dennis 709198c353 Add tools/ansify: MUX percent-color to ANSI (Ragel → C)
Import the retired FTP contrib ansify as a Ragel -G2 scanner under
tools/ansify, matching muxescape/color_ops.  Check in generated ansify.c
so a normal `make` / `make test` only needs a C compiler; use `make regen`
when ansify.rl changes.  Binary stays gitignored.

Document under AGENTS.md and docs/generated-files.md.
2026-08-01 17:12:16 -06:00

2.5 KiB

Generated Files

Do not hand-edit generated files in this repository. Edit the source input and regenerate the derived output instead.

Review Rule

  • If a generated file changes, the diff should also include the source input or the regeneration step that justifies that output change.
  • If only the generated output changed, treat that as suspicious until proven otherwise.

Generated File Map

Generated file Edit this instead Regenerate with
mux/modules/engine/art_scan.cpp mux/modules/engine/art_scan.rl ragel -G2
mux/modules/engine/ast_scan.cpp mux/modules/engine/ast_scan.rl ragel -G2
mux/lib/color_ops.c mux/lib/color_ops.rl ragel -G2 -C
mux/lib/date_scan.cpp mux/lib/date_scan.rl ragel -G2
mux/muxescape/muxescape.cpp mux/muxescape/muxescape.rl ragel -G2
tools/ansify/ansify.c tools/ansify/ansify.rl ragel -G2 -C
mux/include/utf8tables.h Unicode inputs under utf/ utf/ pipeline / make
mux/lib/utf8tables.cpp Unicode inputs under utf/ utf/ pipeline / make
mux/include/unicode_tables_c.h Unicode inputs under utf/ utf/ pipeline / make
mux/lib/unicode_tables.c Unicode inputs under utf/ utf/ pipeline / make
mux/include/ducet_cetable.h utf/allkeys.txt utf/gen_ducet.pl
mux/rv64/src/unicode_tables.c Unicode inputs under utf/ utf/ pipeline / make
mux/configure mux/configure.ac autoconf
mux/aclocal.m4 Autoconf inputs aclocal / autoconf toolchain
client/*/src/hydra.pb.h mux/proxy/hydra.proto protoc
client/*/src/hydra.pb.cc mux/proxy/hydra.proto protoc
client/*/src/hydra.grpc.pb.h mux/proxy/hydra.proto protoc
client/*/src/hydra.grpc.pb.cc mux/proxy/hydra.proto protoc
client/*/src/proto/hydra.pb.h mux/proxy/hydra.proto protoc
client/*/src/proto/hydra.pb.cc mux/proxy/hydra.proto protoc
client/*/src/proto/hydra.grpc.pb.h mux/proxy/hydra.proto protoc
client/*/src/proto/hydra.grpc.pb.cc mux/proxy/hydra.proto protoc
mux/sqlite/sqlite3.c SQLite upstream source replace generated amalgamation
mux/sqlite/sqlite3.h SQLite upstream source replace generated amalgamation

Notes

  • Generated files may also be marked read-only on disk or checked by hooks, but those safeguards do not replace review discipline.
  • When in doubt, search for the generator before editing the output.