New mandoc feature: -T html -O toc (Table of contents)

https://undeadly.org/cgi?action=article;sid=20181002175838

by brynet • 8 years ago

47 4 8 years ago

enriquto• 8 years ago

mandoc is great! It could replace legacy man almost everywhere

Annatar• 8 years ago

It's really cool how they solved it without breaking backward compatibility or the interface: unless specifically requested, mandoc(1) will work as before, but the overall capability of the software has been enhanced. That's what I call system engineering.

justinmk• 8 years ago

Neovim's ":Man" command also shows a ToC when you type "gO" (mnemonic: "outline").

See also:

    :help gO

Currently Nvim builds this ToC with its own hacks, so it would be nice to get that info from mandoc instead. But IIUC, "-O toc" only works with HTML output of mandoc? How can non-HTML tools get the ToC from mandoc?

mineo• 8 years ago

Similarly, man and woman in Emacs generate a ToC that imenu (M-x imenu) can use.

New mandoc feature: -T html -O toc (Table of contents)

Related Stories