/usr/share/doc/medit/help/ch03s01.html is in medit 1.1.1-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 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 | <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Managing tools in Preferences dialog</title>
<link rel="stylesheet" type="text/css" href="medit.css">
<meta name="generator" content="DocBook XSL Stylesheets V1.77.1">
<link rel="home" href="index.html" title="medit manual">
<link rel="up" href="ch03.html" title="Chapter 3. User-defined tools">
<link rel="prev" href="ch03.html" title="Chapter 3. User-defined tools">
<link rel="next" href="ch03s02.html" title="Storing tools in files">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr><th colspan="3" align="center">Managing tools in <span class="guilabel">Preferences</span> dialog</th></tr>
<tr>
<td width="20%" align="left">
<a accesskey="p" href="ch03.html">Prev</a> </td>
<th width="60%" align="center">Chapter 3. User-defined tools</th>
<td width="20%" align="right"> <a accesskey="n" href="ch03s02.html">Next</a>
</td>
</tr>
</table>
<hr>
</div>
<div class="sect1">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="section-prefs-user-tools"></a>Managing tools in <span class="guilabel">Preferences</span> dialog</h2></div></div></div>
<p>
To create a new tool or to modify existing ones, open
<span class="guilabel">Preferences</span> dialog and select <span class="guilabel">Tools</span> in the list on the left.
</p>
<p>
Select the tool in the list or click the <span class="guibutton">New</span>
button to create a new one. To modify the order in which tools
appear in the <span class="guimenu">Tools</span> menu (or in the document
context menu), use <span class="guibutton">Up</span> and <span class="guibutton">Down</span> buttons. To rename a tool,
click its name in the list to select it and then click again to
edit the name. Use the <span class="guibutton">Delete</span> button to delete a tool.
</p>
<p>
The following controls are available to modify tools:
</p>
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
<li class="listitem">
<p>
<em class="parameter"><code><span class="guilabel">Files</span></code></em> entry specifies for which files the tool is going to be available. It can
contain the following:
</p>
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; ">
<li class="listitem">a comma-separated list of file patterns, e.g. <pre class="programlisting"><code class="code">*.c,*.h</code></pre>
</li>
<li class="listitem">a comma-separated list of languages prefixed with "<code class="code">langs:</code>", e.g.
<pre class="programlisting"><code class="code">langs: c, c++, objc</code></pre>
</li>
<li class="listitem">a regular expression matching document filename prefixed with "<code class="code">regex:</code>", e.g. the above
pattern list may be written as <pre class="programlisting"><code class="code">regex:\.[ch]$</code></pre>
</li>
</ul></div>
<p>
</p>
<p>Empty entry means that the tool will be available for all documents.</p>
</li>
<li class="listitem">
<em class="parameter"><code><span class="guilabel">Requires</span></code></em> combo box specifies whether the tool should be
enabled depending on current document.
<div class="variablelist"><table border="0" class="variablelist">
<colgroup>
<col align="left" valign="top">
<col>
</colgroup>
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>Nothing</code></em></span></p></td>
<td>the tool is enabled regardless whether there is an open document.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>Document</code></em></span></p></td>
<td>the tool is enabled only if there is an open document. For example, if the tool manipulates
current document text, then it needs a document to be there.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>File on disk</code></em></span></p></td>
<td>the tool is enabled only if current document is saved on disk (i.e. it is not "Untitled").
For example, to compile a TeX file, it needs to be saved first.</td>
</tr>
</tbody>
</table></div>
</li>
<li class="listitem">
<em class="parameter"><code><span class="guilabel">Save</span></code></em> combo box specifies what should be saved every time
before the command is executed.
<div class="variablelist"><table border="0" class="variablelist">
<colgroup>
<col align="left" valign="top">
<col>
</colgroup>
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>Nothing</code></em></span></p></td>
<td>nothing will be saved.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>Current document</code></em></span></p></td>
<td>current document will be automatically saved. For example, you probably want to save currrent
document before compiling it with latex.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>All documents</code></em></span></p></td>
<td>all open documents will be automatically saved. For example, if the tool builds a C project, then
you probably want to save all open files before running make.</td>
</tr>
</tbody>
</table></div>
</li>
<li class="listitem">
<em class="parameter"><code><span class="guilabel">Type</span></code></em> combo specifies the type of the tool: a Python script, a
Lua script, or a shell script.
</li>
<li class="listitem">
<span class="guilabel">Code</span> text field contains script or shell command text. See
<a class="xref" href="ch03s03.html" title="Shell scripts">the section called “Shell scripts”</a>, <a class="xref" href="ch03s04.html" title="Lua scripts">the section called “Lua scripts”</a>,
<a class="xref" href="ch03s05.html" title="Python scripts">the section called “Python scripts”</a> for details on what can be here.
</li>
</ul></div>
<p>
</p>
</div>
<div class="navfooter">
<hr>
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left">
<a accesskey="p" href="ch03.html">Prev</a> </td>
<td width="20%" align="center"><a accesskey="u" href="ch03.html">Up</a></td>
<td width="40%" align="right"> <a accesskey="n" href="ch03s02.html">Next</a>
</td>
</tr>
<tr>
<td width="40%" align="left" valign="top">Chapter 3. User-defined tools </td>
<td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td>
<td width="40%" align="right" valign="top"> Storing tools in files</td>
</tr>
</table>
</div>
</body>
</html>
|