Skip to content

Remake docgen #29

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Nov 10, 2024
Merged

Remake docgen #29

merged 3 commits into from
Nov 10, 2024

Conversation

k32
Copy link
Owner

@k32 k32 commented Nov 10, 2024

No description provided.

k32 added 2 commits November 10, 2024 21:43
Reasoning:

- Lee mainly targets CLI interfaces. Info is the most ergonomic format
for use in the terminal. Docbook can generate man pages, but rich
format is only available in HTML output.

- DocBook pipeline requires some obscure tools and packages, texi2any
is widely available.

- Previous pipeline tried to build a complete document, therefore it
required some hacks like `doc_root' metatype. The whole pipeline was
quite inflexible. The new generator creates files that are meant to be
embedded into other documents.
@k32 k32 force-pushed the remake-docgen branch 3 times, most recently from 2f5acc8 to 03f0b21 Compare November 10, 2024 22:45
@k32 k32 merged commit cdf3b55 into master Nov 10, 2024
1 of 2 checks passed
@k32 k32 deleted the remake-docgen branch November 10, 2024 23:17
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