manned/README.md
Yorhel 682321d1be ManUtils: Move, use ExtUtils::MakeMaker and get rid of AnyEvent
I mean, I like AnyEvent, but this can be done with core modules as well
(albeit somewhat more verbose and error-prone...)
2025-02-24 19:00:09 +01:00

30 lines
897 B
Markdown

# The Manned.org Source Code
This repository holds the source code of Manned.org. For a description of the
site, check out [https://manned.org/info/about](https://manned.org/info/about).
Ironically, documentation about how things work is completely lacking.
## Requirements
- perl: 5.36+
- postgresql: A somewhat recent version
- rust: Version who-knows-which
### Web front-end
- FU
### Man page indexer
- curl
- psql
## File structure
- **indexer/** -> The Rust program that scans package repositories for updates, fetches new packages and extracts the man pages.
- **lib/ManUtils/** -> Perl/XS helper module to format man pages into HTML (uses **web/**).
- **sql/** -> Database schema & updates.
- **util/** -> Cron job and scripts to run **indexer/** on the right repositories.
- **web/** -> Badly named Rust library to convert man pages into HTML.
- **www/** -> The web front-end.