Difference between pages "Form:News" and "Package:Layman"

From Funtoo
(Difference between pages)
Jump to navigation Jump to search
 
m
 
Line 1: Line 1:
<noinclude>
{{Ebuild
__NOTOC__
|Summary=Tool to manage Gentoo overlays
|CatPkg=app-portage/layman
|Homepage=http://layman.sourceforge.net/
}}
Layman is an "overlay" external repository management tool.


== Create a News Item ==
=== Installation ===
<console>###i## emerge layman</console>
[[make.conf]] must source laymans overlays for emerge to pull in packages from external sources.  This line needs to be below everything else in make.conf.
<console>###i## echo "source /var/lib/layman/make.conf" >> /etc/portage/make.conf</console>


{{#forminput:form=News|query string=namespace=News}}
=== Using Layman ===
</noinclude><includeonly>
Fetch, and display a list of overlays:
{{{for template|News}}}
<console>###i## layman -L</console>
{{TableStart}}
<tr><th class="active">Summary</th><td>{{{field|Summary|input type=textarea|placeholder=Specify a short summary of the news item. One or two sentences max. If a "short" item, this is the only text that will be displayed.}}}</td></tr>
<tr><th class="active">Format</th><td>{{{field|News Format|input type=dropdown|values=Short,Extended|default=Short}}}
<tr><th class="active">Category</th><td>{{{field|News Category|input type=dropdown|values=Security,Infrastructure,General,Development,Packages}}}</td></tr>
<tr><th class="active">Author</th><td>{{{field|Author|autocomplete on namespace=User|size=100|placeholder=Specify username|default=current user}}}</td></tr>
<tr><th class="active">Publication Status</th><td>{{{field|Publication Status|input type=dropdown|values=Draft,Published|default=Draft}}}</td></tr>
<tr><th class="active">Deprecated by</th><td>{{{field|Deprecated By|placeholder=page of news item that deprecates/replaces this out-of-date news item.|values from namespace=News|remote autocompletion|cols=100}}}</td></tr>
<tr><th class="active">Publication Date</th><td>{{{field|Publication Date|input type=datepicker|default=now}}}</td></tr>
<tr><th class="active">Icon</th><td>{{{field|Icon|uploadable|placeholder=Image file. Leave blank to use your gravatar|values from namespace=File|size=100}}}</td></tr>
{{TableEnd}}
{{{end template}}}
== Documentation ==


If an extended news item, enter info here:
Add an overlay to your system:
<console>###i## layman -a <overlay name></console>


{{{standard input|free text|rows=30}}}
Delete an overlay from your system:
<console>###i## layman -d <overlay name></console>


{{{for template|NewsFooter}}}
==== Masking Overlay Packages ====
{{{end template}}}
Overlays have the power to override distro packages.  To avoid conflicts, mask everything in the overlay, and unmask the packages that are necessary to your system.


{{{standard input|summary}}}
{{file|name=/etc/portage/package.mask|lang=|desc=mask all packages in an overlay|body=
*/*::overlay-name
}}


{{{standard input|minor edit}}} {{{standard input|watch}}}
{{file|name=/etc/portage/package.unmask|lang=|desc=unmask packages to be used|body=
cat-egory/pack-age1
cat-egory/pack-age2
}}


{{{standard input|save}}} {{{standard input|preview}}} {{{standard input|changes}}} {{{standard input|cancel}}}
==== Sync ====
 
Sync a specific overlays ebuilds:
<console>###i## layman -s <overlay name></console>
 
Sync all overlays:
<console>###i## layman -S</console>
 
Sync all overlays via eix:
<console>###i## eix-sync</console>
 
=== Troubleshooting ===
Problem:
Warning: an installed db file was not found at: ['/var/lib/layman/cache***.xml']
 
Solution:
<console>###i## layman -L</console>
 
{{EbuildFooter}}

Revision as of 12:00, February 3, 2015

Layman

   Tip

We welcome improvements to this page. To edit this page, Create a Funtoo account. Then log in and then click here to edit this page. See our editing guidelines to becoming a wiki-editing pro.

Layman is an "overlay" external repository management tool.

Installation

root # emerge layman

make.conf must source laymans overlays for emerge to pull in packages from external sources. This line needs to be below everything else in make.conf.

root # echo "source /var/lib/layman/make.conf" >> /etc/portage/make.conf

Using Layman

Fetch, and display a list of overlays:

root # layman -L

Add an overlay to your system:

root # layman -a <overlay name>

Delete an overlay from your system:

root # layman -d <overlay name>

Masking Overlay Packages

Overlays have the power to override distro packages. To avoid conflicts, mask everything in the overlay, and unmask the packages that are necessary to your system.

   /etc/portage/package.mask - mask all packages in an overlay
*/*::overlay-name
   /etc/portage/package.unmask - unmask packages to be used
cat-egory/pack-age1
cat-egory/pack-age2

Sync

Sync a specific overlays ebuilds:

root # layman -s <overlay name>

Sync all overlays:

root # layman -S

Sync all overlays via eix:

root # eix-sync

Troubleshooting

Problem: Warning: an installed db file was not found at: ['/var/lib/layman/cache***.xml']

Solution:

root # layman -L