Mandoc
From Gentoo Wiki
mandoc is a suite of tools for mdoc(7), the semantic roff macro language preferred for BSD manual pages, and man(7), the historical presentation-based roff macro language for UNIX manuals.
Installation
USE flags
USE flags for app-text/mandoc Suite of tools compiling mdoc and man
cgi
|
build man.cgi web plugin for viewing man pages |
selinux
|
!!internal use only!! Security Enhanced Linux support, this must be set by the selinux profile or breakage will occur |
system-man
|
set as the default man provider |
test
|
Enable dependencies and/or preparations necessary to run tests (usually controlled by FEATURES=test but can be toggled independently) |
Before enabling the system-man USE flag, please refer to #The system-man USE flag section.
Emerge
root #emerge --ask app-text/mandocThe system-man USE flag
The system-man USE flag makes mandoc the default software for accessing man pages.
Warning
During installation, man pages are compressed using the value of the PORTAGE_COMPRESS variable, which by default is "bzip2". However, mandoc does not handle bzip2'd man pages, so after changing this flag, those man pages will no longer be readable.
During installation, man pages are compressed using the value of the PORTAGE_COMPRESS variable, which by default is "bzip2". However, mandoc does not handle bzip2'd man pages, so after changing this flag, those man pages will no longer be readable.
To ensure mandoc can display man pages, set the value of the PORTAGE_COMPRESS_EXCLUDE_SUFFIXES variable in /etc/portage/make.conf and reinstall packages containing man pages:
FILE
/etc/portage/make.confPORTAGE_COMPRESS_EXCLUDE_SUFFIXES="[1-9] n [013]p [1357]ssl"
Packages that will need to be reinstalled include:
- sys-apps/coreutils
- sys-apps/shadow
- sys-apps/man-pages
- sys-apps/man-pages-posix
- sys-apps/portage
- app-portage/gentoolkit
See also
man page — contains system reference documentation. It is found on most Unix-like systems.
External resources
- The mdoc(7) man page