/usr/share/doc/kildclient/html/ch09s01.xhtml is in kildclient-doc 3.2.0-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 | <?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html><html xmlns="http://www.w3.org/1999/xhtml"><head><title>9.1. Creating and Editing Aliases</title><link rel="stylesheet" type="text/css" href="docbook.css"/><link rel="stylesheet" type="text/css" href="kildclient.css"/><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"/><link rel="prev" href="chap_aliases.xhtml" title="Chapter 9. Aliases"/><link rel="next" href="ch09s02.xhtml" title="9.2. Using Aliases"/></head><body><header><div class="navheader"><table style="width: 100%; "><tr><th style="text-align: center; " colspan="3">9.1. Creating and Editing Aliases</th></tr><tr><td style="width: 20%; text-align: left; "><a accesskey="p" href="chap_aliases.xhtml">Prev</a> </td><th style="width: 60%; text-align: center; ">Chapter 9. Aliases</th><td style="width: 20%; text-align: right; "> <a accesskey="n" href="ch09s02.xhtml">Next</a></td></tr></table><hr/></div></header><section class="sect1" id="idm1545"><div class="titlepage"><div><div><h2 class="title" style="clear: both">9.1. Creating and Editing Aliases</h2></div></div></div><p>The easiest way to create and alter aliases is from the World
Editor, the place where all settings of a World are altered (see <a class="xref" href="chap_world_editor.xhtml" title="Chapter 4. Editing a World">Chapter 4, <em>Editing a World</em></a>).</p><p>Aliases are defined in the <span class="guilabel">Aliases</span> section
inside the <span class="guilabel">Automation</span> section. When you open that
section, you'll see a list of the defined aliases and some buttons
like this:</p><div class="figure" id="idm1553"><div class="figure-title">Figure 9.1. The graphical Alias editor</div><div class="figure-contents"><div class="mediaobject"><img src="images/we_aliases.png" alt="The graphical Alias editor."/></div></div></div><br class="figure-break"/><p>The main part of the window is the list of defined aliases. The
columns are as follows:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><span class="guilabel">Enabled</span> specifies whether the
alias is enabled or not. Aliases that are not enabled are not active
and will not be tried when a command is entered, but they remain in
the list so that they can later be enabled again.</p></li><li class="listitem"><p><span class="guilabel">Name</span> is a name that is assigned
to an alias. This helps you identify the alias' purpose and is
useful when editing an alias via the command line (as described in
<a class="xref" href="sec_alias_cmdline.xhtml#sec_edit_alias_cmdline" title="9.3.1. Editing Aliases">Section 9.3.1, “Editing Aliases”</a>). Assigning a name to an
alias is optional.</p></li><li class="listitem"><p><span class="guilabel">Pattern</span> and
<span class="guilabel">Substitution</span> are the parameters for the alias,
and they define the alias' action, as described above.</p></li><li class="listitem"><p><span class="guilabel">I Case</span> (for "Ignore Case"), if
set, means the case is not considered while matching the pattern,
that is, a case-insensitive match is done.</p></li><li class="listitem"><p><span class="guilabel">Eval as Perl</span> controls how the
alias is evaluated. This option will be described
later.</p></li><li class="listitem"><p><span class="guilabel">Plugin</span>: if this is non-empty,
it means that the alias belongs to a plugin (and the name of the
plugin is displayed). However, by default plugin aliases are not
displayed. See <a class="xref" href="sec_we_advanced.xhtml" title="4.7. Advanced">Section 4.7, “Advanced”</a> for information on
how to display plugin aliases here.</p></li></ul></div><section class="sect2" id="sec_add_alias_gui"><div class="titlepage"><div><div><h3 class="title">9.1.1. Adding Aliases</h3></div></div></div><p>To add a new alias, press the <span class="guilabel">Add</span> button.
This will open a window for you to edit the new alias' parameters:</p><div class="figure" id="idm1589"><div class="figure-title">Figure 9.2. The window to edit aliases</div><div class="figure-contents"><div class="mediaobject"><img src="images/we_alias_edit.png" alt="The window to edit aliases."/></div></div></div><br class="figure-break"/><p>What can be set represents the columns described above. The only
thing that needs explanation is the <span class="guilabel">Eval Substitution as
Perl statement</span> option, corresponding to the <span class="guilabel">Eval
as Perl</span> column. As mentioned before, aliases are actually a
substitution, using Perl's <code class="literal">s//</code> construct. It is
also possible to have aliases that use a <code class="literal">s//e</code>
construct, that is, whose substitution is actually composed of Perl
statements evaluated when a match is found. When that option is
enabled, the substitution is evaluated as a Perl statement.</p><p>When you are finished, press <span class="guilabel">OK</span> and the
alias will be added. If you change your mind, press
<span class="guilabel">Cancel</span> and the alias will not be added.</p></section><section class="sect2" id="idm1605"><div class="titlepage"><div><div><h3 class="title">9.1.2. Editing Aliases</h3></div></div></div><p>To edit an alias, select it by clicking its line in the list
(the line will be highlighted), and press the
<span class="guilabel">Edit</span> button. A window like the one used for
adding aliases (see <a class="xref" href="ch09s01.xhtml#sec_add_alias_gui" title="9.1.1. Adding Aliases">Section 9.1.1, “Adding Aliases”</a>) will be
opened, filled with the alias' parameters. Change what you want, and
press the <span class="guilabel">OK</span> to commit the changes. If, however,
you change you mind, press <span class="guilabel">Cancel</span> and the changes
will be not be made, the alias will remain as it was before.</p><p>Another shorter way to edit an alias is to double click its line
in the list.</p><p>It is also possible to change the value of the
<span class="guilabel">Enabled</span> and <span class="guilabel">Eval as Perl</span>
flags directly from the alias list. Make sure that the alias you want
to change is selected, and click in the check button. The state will
be toggled.</p><p>To delete an alias, select it and press the
<span class="guilabel">Delete</span> button. You will be asked for
confirmation, and can cancel the operation, but once deleted, you
cannot recover the alias. If you want, you can disable this
confirmation dialog, but if you do so and click the
<span class="guilabel">Delete</span> button, the only way to undo your action
will be creating the alias again. See <a class="xref" href="sec_we_advanced.xhtml" title="4.7. Advanced">Section 4.7, “Advanced”</a>. To delete several aliases at once, select
them all and press <span class="guilabel">Delete</span>.</p><p>The final thing that needs to be explained with regard to
aliases is how to reorder them. Aliases as tried from the first one to
the last, so in a few cases the order might matter. To move an alias
up or down in the list, select it and press the corresponding
button.</p></section></section><footer><div class="navfooter"><hr/><table style="width: 100%; "><tr><td style="width: 40%; text-align: left; "><a accesskey="p" href="chap_aliases.xhtml">Prev</a> </td><td style="width: 20%; text-align: center; "><a accesskey="u" href="chap_aliases.xhtml">Up</a></td><td style="width: 40%; text-align: right; "> <a accesskey="n" href="ch09s02.xhtml">Next</a></td></tr><tr><td style="width: 40%; text-align: left; vertical-align: top; ">Chapter 9. Aliases </td><td style="width: 20%; text-align: center; "><a accesskey="h" href="index.xhtml">Home</a></td><td style="width: 40%; text-align: right; vertical-align: top; "> 9.2. Using Aliases</td></tr></table></div></footer></body></html>
|