grog
Groff command-line option guesser
TLDR
Guess the groff command needed for a file
$ grog [file.roff]
Guess and immediately run groff$ grog [file.roff] | sh
Process multiple files at once$ grog [file1.roff] [file2.roff]
Read from standard input$ cat [file.roff] | grog
SYNOPSIS
grog [options] [files]
DESCRIPTION
grog analyzes roff input files and suggests the appropriate groff command line. It detects which macro packages and preprocessors are needed by examining document content for macro usage.The tool outputs the complete groff command with correct options, which can be piped to a shell for execution.
PARAMETERS
FILES
Files to analyze; reads standard input if omitted or given as "-".-C
Enable AT&T troff compatibility mode (also passed through to the guessed command).-v, --version
Display version information and exit.-h, --help
Display a usage message and exit.Any other groff(1) option (e.g. -T, -k) is passed through unchanged to the guessed command line.
INSTALL
sudo apt install groff-base
sudo dnf install groff-base
sudo pacman -S groff
sudo apk add groff
sudo zypper install groff
brew install groff
nix profile install nixpkgs#groff
CAVEATS
Part of groff package. May not detect all requirements. Suggestions should be verified.
HISTORY
grog was developed as part of GNU groff to simplify determining the correct options for complex documents.
