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

badly formatted man pages #126

Open
teuben opened this issue Dec 9, 2023 · 2 comments
Open

badly formatted man pages #126

teuben opened this issue Dec 9, 2023 · 2 comments

Comments

@teuben
Copy link
Owner

teuben commented Dec 9, 2023

This is a very old issue. With the "manpdf" script a man page can be turned into a pretty pdf file, but tab alignments (e.g. in the HISTORY section) is different from the terminal version.
Generally we use ".ta +1.5i +5.5i"

Secondly, to gives examples of code, we should not use the ".nf .fi" section, but use ".EX .EE". Example of this fix is in mkplummer and hackdens.

There probably are more issues. man pages are probably considered legacy, but darn useful in a terminal.

@teuben
Copy link
Owner Author

teuben commented Jun 26, 2024

It seems ".ta +1.25i +4.5i" is a better default for the output PDF, but tight for terminals.

@teuben
Copy link
Owner Author

teuben commented Jul 8, 2024

Another new formatting idea is to put ".br" before the default. But now we have several ways how to write the default:

[Default: 1.0]
[1.0]
Default: 1.0
default: 1.0

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant