summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2019-05-06 12:44:48 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2019-05-07 10:23:42 +0100
commit59f95aaae45e3b9f6c6a2d3f2acc387ea49add07 (patch)
tree5d5525a1d6489f0ba806d21c5ab316b839e4232f /documentation
parent2a540a95a52e5b750d708f7531acf759c8630763 (diff)
downloadopenembedded-core-contrib-59f95aaae45e3b9f6c6a2d3f2acc387ea49add07.tar.gz
documentation: Cleaned up "plug-in"/"plugin" terminology.
The YP manual set was using the plugin term inconsistently. It was appearing as "plugin" as well as "plug-in". The plugins in the project are all named without a hyphen. The term itself is either/or according to Google. I have changed all references to plugin so that they do not use a hyphen. (From yocto-docs rev: 715bb58e2347c5e37a49da7d9e3e230503672337) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r--documentation/bsp-guide/bsp.xml2
-rw-r--r--documentation/dev-manual/dev-manual-common-tasks.xml76
-rw-r--r--documentation/ref-manual/migration.xml6
-rw-r--r--documentation/ref-manual/ref-kickstart.xml14
4 files changed, 49 insertions, 49 deletions
diff --git a/documentation/bsp-guide/bsp.xml b/documentation/bsp-guide/bsp.xml
index 1d37a443ec..6904a81ee9 100644
--- a/documentation/bsp-guide/bsp.xml
+++ b/documentation/bsp-guide/bsp.xml
@@ -2147,7 +2147,7 @@
Files installed into the device's boot partition
when preparing the image using the Wic tool
with the <filename>bootimg-partition</filename>
- source plug-in.
+ source plugin.
</para></listitem>
</itemizedlist>
</para>
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 0fcb7b7064..0056ae7ac7 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -7387,17 +7387,17 @@
it is based on is by definition incomplete.
The purpose of the command is to allow the generation of
customized images, and as such, was designed to be
- completely extensible through a plug-in interface.
+ completely extensible through a plugin interface.
See the
- "<link linkend='wic-using-the-wic-plug-ins-interface'>Using the Wic Plug-Ins Interface</link>"
- section for information on these plug-ins.
+ "<link linkend='wic-using-the-wic-plugin-interface'>Using the Wic PlugIn Interface</link>"
+ section for information on these plugins.
</para>
<para>
This section provides some background information on Wic,
describes what you need to have in
place to run the tool, provides instruction on how to use
- the Wic utility, provides information on using the Wic plug-ins
+ the Wic utility, provides information on using the Wic plugins
interface, and provides several examples that show how to use
Wic.
</para>
@@ -7792,28 +7792,28 @@
</para>
</section>
- <section id='wic-using-the-wic-plug-ins-interface'>
- <title>Using the Wic Plug-Ins Interface</title>
+ <section id='wic-using-the-wic-plugin-interface'>
+ <title>Using the Wic Plugin Interface</title>
<para>
You can extend and specialize Wic functionality by using
- Wic plug-ins.
- This section explains the Wic plug-in interface.
+ Wic plugins.
+ This section explains the Wic plugin interface.
<note>
- Wic plug-ins consist of "source" and "imager" plug-ins.
- Imager plug-ins are beyond the scope of this section.
+ Wic plugins consist of "source" and "imager" plugins.
+ Imager plugins are beyond the scope of this section.
</note>
</para>
<para>
- Source plug-ins provide a mechanism to customize partition
+ Source plugins provide a mechanism to customize partition
content during the Wic image generation process.
- You can use source plug-ins to map values that you specify
+ You can use source plugins to map values that you specify
using <filename>--source</filename> commands in kickstart
- files (i.e. <filename>*.wks</filename>) to a plug-in
+ files (i.e. <filename>*.wks</filename>) to a plugin
implementation used to populate a given partition.
<note>
- If you use plug-ins that have build-time dependencies
+ If you use plugins that have build-time dependencies
(e.g. native tools, bootloaders, and so forth)
when building a Wic image, you need to specify those
dependencies using the
@@ -7823,43 +7823,43 @@
</para>
<para>
- Source plug-ins are subclasses defined in plug-in files.
- As shipped, the Yocto Project provides several plug-in
+ Source plugins are subclasses defined in plugin files.
+ As shipped, the Yocto Project provides several plugin
files.
- You can see the source plug-in files that ship with the
+ You can see the source plugin files that ship with the
Yocto Project
<ulink url='&YOCTO_GIT_URL;/cgit/cgit.cgi/poky/tree/scripts/lib/wic/plugins/source'>here</ulink>.
- Each of these plug-in files contains source plug-ins that
+ Each of these plugin files contains source plugins that
are designed to populate a specific Wic image partition.
</para>
<para>
- Source plug-ins are subclasses of the
+ Source plugins are subclasses of the
<filename>SourcePlugin</filename> class, which is
defined in the
<filename>poky/scripts/lib/wic/pluginbase.py</filename>
file.
For example, the <filename>BootimgEFIPlugin</filename>
- source plug-in found in the
+ source plugin found in the
<filename>bootimg-efi.py</filename> file is a subclass of
the <filename>SourcePlugin</filename> class, which is found
in the <filename>pluginbase.py</filename> file.
</para>
<para>
- You can also implement source plug-ins in a layer outside
+ You can also implement source plugins in a layer outside
of the Source Repositories (external layer).
- To do so, be sure that your plug-in files are located in
+ To do so, be sure that your plugin files are located in
a directory whose path is
<filename>scripts/lib/wic/plugins/source/</filename>
within your external layer.
- When the plug-in files are located there, the source
- plug-ins they contain are made available to Wic.
+ When the plugin files are located there, the source
+ plugins they contain are made available to Wic.
</para>
<para>
When the Wic implementation needs to invoke a
- partition-specific implementation, it looks for the plug-in
+ partition-specific implementation, it looks for the plugin
with the same name as the <filename>--source</filename>
parameter used in the kickstart file given to that
partition.
@@ -7869,13 +7869,13 @@
part /boot --source bootimg-pcbios --ondisk sda --label boot --active --align 1024
</literallayout>
The methods defined as class members of the matching
- source plug-in (i.e. <filename>bootimg-pcbios</filename>)
- in the <filename>bootimg-pcbios.py</filename> plug-in file
+ source plugin (i.e. <filename>bootimg-pcbios</filename>)
+ in the <filename>bootimg-pcbios.py</filename> plugin file
are used.
</para>
<para>
- To be more concrete, here is the corresponding plug-in
+ To be more concrete, here is the corresponding plugin
definition from the <filename>bootimg-pcbios.py</filename>
file for the previous command along with an example
method called by the Wic implementation when it needs to
@@ -7907,19 +7907,19 @@
.
.
</literallayout>
- If a subclass (plug-in) itself does not implement a
+ If a subclass (plugin) itself does not implement a
particular function, Wic locates and uses the default
version in the superclass.
- It is for this reason that all source plug-ins are derived
+ It is for this reason that all source plugins are derived
from the <filename>SourcePlugin</filename> class.
</para>
<para>
The <filename>SourcePlugin</filename> class defined in
the <filename>pluginbase.py</filename> file defines
- a set of methods that source plug-ins can implement or
+ a set of methods that source plugins can implement or
override.
- Any plug-ins (subclass of
+ Any plugins (subclass of
<filename>SourcePlugin</filename>) that do not implement
a particular method inherit the implementation of the
method from the <filename>SourcePlugin</filename> class.
@@ -7980,11 +7980,11 @@
</para>
<para>
- You can extend the source plug-in mechanism.
- To add more hooks, create more source plug-in methods
+ You can extend the source plugin mechanism.
+ To add more hooks, create more source plugin methods
within <filename>SourcePlugin</filename> and the
corresponding derived subclasses.
- The code that calls the plug-in methods uses the
+ The code that calls the plugin methods uses the
<filename>plugin.get_source_plugin_methods()</filename>
function to find the method or methods needed by the call.
Retrieval of those methods is accomplished by filling up
@@ -9404,7 +9404,7 @@
<para>
Many pieces of software split functionality into optional
- modules (or plug-ins) and the plug-ins that are built
+ modules (or plugins) and the plugins that are built
might depend on configuration options.
To avoid having to duplicate the logic that determines what
modules are available in your recipe or to avoid having
@@ -15061,12 +15061,12 @@
</para>
<para>
- Specifying audio and video plug-ins as part of the
+ Specifying audio and video plugins as part of the
<filename>COMMERCIAL_AUDIO_PLUGINS</filename> and
<filename>COMMERCIAL_VIDEO_PLUGINS</filename> statements
(along with the enabling
<filename>LICENSE_FLAGS_WHITELIST</filename>) includes the
- plug-ins or components into built images, thus adding
+ plugins or components into built images, thus adding
support for media formats or components.
</para>
</section>
diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index 4f57c1e1d3..1ecf5b9996 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -4506,8 +4506,8 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
</para></listitem>
<listitem><para>
<emphasis>fsimage Plug-in Removed:</emphasis>
- The Wic fsimage plug-in has been removed as it duplicates
- functionality of the rawcopy plug-in.
+ The Wic fsimage plugin has been removed as it duplicates
+ functionality of the rawcopy plugin.
</para></listitem>
</itemizedlist>
</para>
@@ -6363,7 +6363,7 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
Support for the Eclipse IDE has been removed.
Support continues for those releases prior to 2.7 that did include
support.
- The 2.7 release does not include the Eclipse Yocto plug-in.
+ The 2.7 release does not include the Eclipse Yocto plugin.
</para>
</section>
diff --git a/documentation/ref-manual/ref-kickstart.xml b/documentation/ref-manual/ref-kickstart.xml
index a58f9d7c96..1128bd50d0 100644
--- a/documentation/ref-manual/ref-kickstart.xml
+++ b/documentation/ref-manual/ref-kickstart.xml
@@ -117,9 +117,9 @@
This option is a Wic-specific option that names the source
of the data that populates the partition.
The most common value for this option is "rootfs", but you
- can use any value that maps to a valid source plug-in.
- For information on the source plug-ins, see the
- "<ulink url='&YOCTO_DOCS_DEV_URL;#wic-using-the-wic-plug-ins-interface'>Using the Wic Plug-Ins Interface</ulink>"
+ can use any value that maps to a valid source plugin.
+ For information on the source plugins, see the
+ "<ulink url='&YOCTO_DOCS_DEV_URL;#wic-using-the-wic-plugin-interface'>Using the Wic Plugins Interface</ulink>"
section in the Yocto Project Development Tasks Manual.
</para>
@@ -139,12 +139,12 @@
<filename>--source <replaceable>plugin-name</replaceable></filename>,
Wic creates a partition as large as needed and fills it
with the contents of the partition that is generated by the
- specified plug-in name using the data pointed to by the
+ specified plugin name using the data pointed to by the
<filename>-r</filename> command-line option or the
equivalent rootfs derived from the <filename>-e</filename>
command-line option.
Exactly what those contents are and filesystem type used are
- dependent on the given plug-in implementation.
+ dependent on the given plugin implementation.
</para>
<para>If you do not use the <filename>--source</filename>
@@ -220,7 +220,7 @@
This option is a Wic-specific option that excludes the given
relative path from the resulting image.
This option is only effective with the rootfs source
- plug-in.
+ plugin.
</para></listitem>
<listitem><para>
<emphasis><filename>--extra-space</filename>:</emphasis>
@@ -299,7 +299,7 @@
supports the following options:
<note>
Bootloader functionality and boot partitions are implemented by
- the various <filename>--source</filename> plug-ins that
+ the various <filename>--source</filename> plugins that
implement bootloader functionality.
The bootloader command essentially provides a means of
modifying bootloader configuration.