Skip to content
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

Find a suitable tool for manpages #45

Open
rehsack opened this issue Jun 6, 2014 · 6 comments
Open

Find a suitable tool for manpages #45

rehsack opened this issue Jun 6, 2014 · 6 comments
Milestone

Comments

@rehsack
Copy link
Collaborator

rehsack commented Jun 6, 2014

Since docbook2X is discontinues since ages, a new - actively developed tool for manpages and online-doc should be found.

@rehsack
Copy link
Collaborator Author

rehsack commented Jun 6, 2014

My requirements are

  • no feature reduce to what we use now (eg. tables in generated manpage)
  • target formats: groff (man), html, pdf(latex)

@rehsack rehsack added this to the 0.91.1 milestone Jun 13, 2014
@rehsack
Copy link
Collaborator Author

rehsack commented Jun 10, 2015

well - I stumbled over pod2latex (Pod::LaTeX), pod2man and pod2html are common.

So maybe Pod is suitable?

@cicku
Copy link
Contributor

cicku commented Aug 18, 2015

Is asciidoc acceptable?

@rehsack
Copy link
Collaborator Author

rehsack commented Aug 18, 2015

It has some learning curve, but it seems to fulfill all requirements. So, it's very likely acceptable ;)

@tdb
Copy link
Member

tdb commented Aug 18, 2015

I like the idea of something that's a fairly simple plaintext format that can be converted to the various useful formats we need (html and manpage mainly). Markdown seems fairly well known these days, but I'm not sure if it has enough features or if there are conversion tools around to do what we want.

@cicku
Copy link
Contributor

cicku commented Aug 20, 2015

a2x can generate manpage smoothly, while github favors markdown as well. BTW markdown is pretty popular now.

@tdb tdb modified the milestones: 0.91.1, 0.93 Jul 22, 2019
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

No branches or pull requests

3 participants