Template:Man

{{{2}}}({{{1}}}) – Linux Manual

Template documentation

To be used for inserting manual page links into pages on Unix topics.

UsageEdit

ExamplesEdit

In	Out
{{man|3|printf}}	printf(3) – Linux Library Functions Manual
{{man|3|printf|||inline}}	printf(3)
{{man|3|printf|FreeBSD}}	printf(3) – FreeBSD Library Functions Manual
{{man|3|printf||formatted output conversion}}	printf(3): formatted output conversion – Linux Library Functions Manual

ParametersEdit

1. Manual section
2. Manual page name
3. Source (the name of a subpage in the Template:Man namespace e.g. FreeBSD. Leave blank for the current default.)
4. Page description
5. Style parameter; currently inline omits the attribution.

Available sourcesEdit

Please add to this table as you write new sources!

Source	Example	Result
die.net	{{man|1|ls|die.net}}	ls(1) – Linux User Commands Manual
default	{{man|1|ls}}	ls(1) – Linux User Commands Manual
Darwin	{{man|1|ls|Darwin}}	ls(1) – Darwin and Mac OS X General Commands Manual
Debian	{{man|1|ls|Debian}}	ls(1) – Debian General Commands Manual
DragonFly	{{man|1|ls|DragonFly BSD}}	ls(1) – DragonFly General Commands Manual
FreeBSD	{{man|1|ls|FreeBSD}}	ls(1) – FreeBSD General Commands Manual
HP-UX	{{man|1|ls|HP-UX}}	ls(1) – HP-UX 11i User Commands Manual
IRIX	{{man|1|ls|IRIX}}	ls(1) – IRIX 6.5 User Commands Manual
Linux	{{man|7|epoll|Linux}}	epoll(7) – Linux Programmer's Manual – Overview, Conventions and Miscellanea
LinuxManPages	{{man|1|ls|LinuxManPages}}	ls(1) – Linux General Commands Manual on linuxmanpages.com
MirOS BSD	{{man|1|ls|MirOS BSD}}	ls(1) – MirOS BSD i386 General Commands Manual
NetBSD	{{man|1|ls|NetBSD}}	ls(1) – NetBSD General Commands Manual
OpenBSD	{{man|1|ls|OpenBSD}}	ls(1) – OpenBSD General Commands Manual
Plan 9	{{man|1|ls|Plan 9}}	ls(1) – Plan 9 General Commands Manual
SUS	{{man|cu|ls|SUS}}	ls – Commands & Utilities Reference, The Single UNIX® Specification, Issue 7 from The Open Group
Solaris	{{man|1|ls|Solaris}}	ls(1) – Solaris 10 User Commands Reference Manual
Inferno	{{man|1|ls|Inferno}}	ls(1) – Inferno General commands Manual
perldoc	{{man|1|perlrun|perldoc}}	perlrun(1) – Perl Programming Documentation

Other sourcesEdit

Occasionally you will come across manual pages for which writing a source is overkill. In this case you can use Template:man/format directly with a URL for formatting:

In	Out
{{man/format|1|dbx|http://.../dbx.1.html|source-level debugging tool|[[Sun Studio]] Developer's Manual}}	dbx(1): source-level debugging tool – Sun Studio Developer's Manual

The interface of Template:man/format is therefore externally visible and needs to be kept constant.

HackingEdit

Writing sourcesEdit

A source takes three parameters:

1. Manual section
2. Manual page name
3. Output selector:
   • attrib for attribution
   • url for URL to page
   • display_section for section to display in parentheses.

See Template:Man/die.net for an example; see Template:Man/FreeBSD for a demonstration of varying the attribution by manual section.

InternalsEdit

Template:man handles choosing the default source and calling it for URL and attribution; the default source is Template:man/default, which is a template redirect currently to Template:man/die.net. Template:man/format actually formats the link and descriptions into a nice-looking link+auxilia in Unix style.