Template:Bug/doc

Note
This page is a template. It contains some standardized, often used text, which can be transcluded inside other pages. As this template is widely used in our wiki, it may be protected in which case only staff members can change it. Use the discussion page to propose enhancements or fixes, or to voice your opinion.

Link to bugs at several bugtrackers (default is https://bugs.gentoo.org).

Template parameters
This template prefers inline formatting of parameters.
Parameter		Description	Type	Status
Bug number/term	`1`	Specify a bug number (''search'' default). If you search by package, specify a package string. If you search by product, specify the product Example 12345	String	required
Site	`site`	Specify a different bugtracker than Gentoo's. Supported are "kde", "freedesktop"/"fdo" and "launchpad".	String	optional
Search	`search`	Specify a search method: by ''id'' (default), by ''package'' name or by ''product'' (Bugzilla only).	String	optional
Component	`component`	Specify a component (only valid for ''product'' search).	String	optional
Link text	`text`	Specify a custom text to override the automatic link text.	Content	optional

Usage

See the template's testcases:

Correct

One anonymous parameter: bug number

Wiki code

{{Bug|100}}

Main version

Make sure to see bug #100 about...

Sandbox version

Make sure to see bug #100 about...

Parameter site

Wiki code

{{Bug|100|site=fdo}}

Main version

Freedesktop.org bug #100

Sandbox version

Freedesktop.org bug #100

Using search=package to search by package name

Wiki code

{{Bug|sys-apps/portage|search=package}}

Main version

Gentoo bugtracker: known bugs

Sandbox version

Gentoo bugtracker: known bugs

Using search=product to search by product name

Wiki code

{{Bug|PulseAudio|search=product|site=fdo}}

Main version

Freedesktop.org bugtracker: known bugs

Sandbox version

Freedesktop.org bugtracker: known bugs

Using search=product and component

Wiki code

{{Bug|Gentoo%20Linux|component=KDE|search=product}}

Main version

Gentoo bugtracker: known bugs

Sandbox version

Gentoo bugtracker: known bugs

Parameter text

Wiki code

{{Bug|100|text=Some text}}

Main version

Some text

Sandbox version

Some text

Using search=email to search by assigned to email

Wiki code

{{Bug|wiki@gentoo.org|search=email}}

Main version

Gentoo bugtracker: known bugs

Sandbox version

Gentoo bugtracker: known bugs

Incorrect

No parameter (error message)

Wiki code

{{Bug}}

Main version

Parameter 1 not defined. For correct usage see Bug template's documentation on the 1 parameter.

Sandbox version

Parameter 1 not defined. For correct usage see Bug template's documentation on the 1 parameter.

Development

This template relies on functionality inherited via the following sub-templates: