Linux command
soelim 命令
文件
复制后可按需替换文件名、目录或参数。
常用示例
Process a file
soelim [path/to/file]
Process with additional include directories
soelim -I [path/to/includes] [path/to/file]
Process without emitting .lf requests
soelim -r [path/to/file]
Output for TeX processing
soelim -t [path/to/file]
Process multiple files
soelim [file1] [file2] [file3]
说明
soelim is a preprocessor for the groff document formatting system. It processes roff input files and replaces .so (source) requests with the actual contents of the referenced files, recursively flattening a tree of included documents. The .so request in roff documents is used to include other files, similar to #include in C. However, these inclusions are normally processed by troff (the formatter) rather than preprocessors. soelim allows included files to be preprocessed before formatting, which is necessary when included files contain preprocessor directives. soelim is typically invoked automatically by groff when the -s option is used. It reads from standard input if no files are specified.
参数
- -C
- Recognize .so requests even if characters other than space or newline follow.
- -I _dir_
- Add directory to the search path for included files. Can be specified multiple times.
- -r
- Do not emit .lf line number requests. Useful for non-groff files.
- -t
- Emit TeX-style comment lines (%) instead of .lf requests for file and line tracking.
- -v, --version
- Print version number and exit.
- --help
- Display usage message and exit.
FAQ
What is the soelim command used for?
soelim is a preprocessor for the groff document formatting system. It processes roff input files and replaces .so (source) requests with the actual contents of the referenced files, recursively flattening a tree of included documents. The .so request in roff documents is used to include other files, similar to #include in C. However, these inclusions are normally processed by troff (the formatter) rather than preprocessors. soelim allows included files to be preprocessed before formatting, which is necessary when included files contain preprocessor directives. soelim is typically invoked automatically by groff when the -s option is used. It reads from standard input if no files are specified.
How do I run a basic soelim example?
Run `soelim [path/to/file]` in a terminal, then adjust file names, paths, flags, or remote targets for your system.
What does -C do in soelim?
Recognize .so requests even if characters other than space or newline follow.