tallow icon indicating copy to clipboard operation
tallow copied to clipboard

Added second level headers to man page docs.

Open intelkevinputnam opened this issue 5 years ago • 6 comments

This improves integration with automated document publishing systems like Sphinx. Plan is to incorporate all man pages into Clear Linux Documentation site.

Signed-off-by: Kevin Putnam [email protected]

intelkevinputnam avatar Apr 14 '20 21:04 intelkevinputnam

@ahkok Can you take a look?

intelkevinputnam avatar Apr 20 '20 20:04 intelkevinputnam

This effectively reverts a large part of https://github.com/clearlinux/tallow/commit/03f4d64ff66a61f5bc9063b8932173c7441fb1ab

ahkok avatar Apr 20 '20 20:04 ahkok

The reason I'm inclined to not want this is because we converted from ronn to pandoc recently and in order for indenting to work properly with pandoc, we had to remove 1 indent.

This change therefore breaks pandoc rendering and indents.

ahkok avatar Apr 20 '20 20:04 ahkok

I'm not sure what a good solution would be. Either we need to massage pandoc or sphinx. But this change is not desired until we figure that out first.

ahkok avatar Apr 20 '20 20:04 ahkok

What it is the output target of pandoc? I'd be happy to take a look.

intelkevinputnam avatar Apr 20 '20 21:04 intelkevinputnam

See e.g. https://github.com/clearlinux/tallow/blob/master/Makefile.am#L42

ahkok avatar Apr 20 '20 22:04 ahkok