i2p/haiku-beta6
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update userguide translations

Browse Source 
Also purge old documents
This commit is contained in:
Autocommitter
2018-10-20 16:28:58 -04:00
committed by waddlesplash
parent 4fd69b6cc2
commit 7852aa0525
323 changed files with 2291 additions and 7101 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/userguide/ca/applications/cli-apps.html
+14 -7
View File
@@ -4,7 +4,7 @@
<head>
<!--
*
* Copyright 2010-2016, Haiku. All rights reserved.
* Copyright 2010-2018, Haiku. All rights reserved.
* Distributed under the terms of the MIT License.
*
* Authors:
@@ -48,8 +48,8 @@
</ul>
<span>
 «  <a href="list-cli-apps.html">List of commands</a> 
::  <a href="../applications.html#cli-apps" class="uplink">Applications</a> 
« <a href="list-cli-apps.html">List of commands</a>
:: <a href="../applications.html#cli-apps" class="uplink">Applications</a>
</span></div>
</div>
@@ -88,18 +88,25 @@ For more details on a parameter, append "--help", e.g. <tt>pkgman search --help<
<table summary="scripting cli tools" border="0" cellpadding="2" cellspacing="0">
<tr><td><p><span class="cli">alert</span></p></td><td style="width:10px;"> </td>
<td valign="top"><p><span class="cli">alert</span> conjures up the typical alert window with a pre-defined icon, explanatory text and up to three buttons. It will return the title of the pressed button and an exit status (starting with 0). For example, this is made of the line:</p>
<pre class="terminal">alert --idea "FantasticApp(tm) installed successfully!
<pre class="terminal">alert --idea "FantasticApp(tm) installed successfully! \
Would you like a link to it?" "On Desktop" "In Deskbar" "No thanks"</pre>
<p><img src="../images/apps-images/cli-alert.png" alt="cli-alert.png" /></p>
</td></tr>
<tr><td><p><span class="cli">filepanel</span></p></td><td style="width:10px;"> </td>
<td valign="top"><p><span class="cli">filepanel</span> displays a load or save file panel and lets the user choose a file or location. As a return value you'll get the chosen file or folder's path. There are several parameters available, for example to set a starting directory, a window title, a default name when saving or restrictions to the allowed types of files. This is an example of</p>
<pre class="terminal">filepanel -s -t "Save your logfile" -d ~/config/settings -n Fantastic.log</pre>
<p><img src="../images/apps-images/cli-filepanel.png" alt="cli-alert.png" /></p>
<p><img src="../images/apps-images/cli-filepanel.png" alt="cli-filepanel.png" /></p>
</td></tr>
<tr><td><p><span class="cli">hey</span></p></td><td style="width:10px;"> </td>
<td valign="top"><p><span class="cli">hey</span> is a littler helper tool that sends BMessages to applications and prints out their answer. It can be used for application scripting, i.e. "remote controlling" a program from a script or the command line. It's usage is a bit complex... <a href="https://www.haiku-os.org/blog/humdinger/2017-11-05_scripting_the_gui_with_hey/">Humdinger's blog post</a> serves as a good introduction, and thanks to Scot Hacker's BeOS Bible, there is a much more comprehensive <a href="http://www.birdhouse.org/beos/bible/bos/ch_scripting6.html">hey tutorial</a> by Chris Herborth.</p>
</td></tr>
<tr><td><p><span class="cli">notify</span></p></td><td style="width:10px;"> </td>
<td valign="top"><p><span class="cli">notify</span> shows a notification panel with a message. There are various parameters that are described when you call <span class="cli">notify --help</span>. A notification can also be used to show the progress of some action. When doing that, it's important to set a <i>messageID</i> and always use it when you update the progress (a float between 0.0 and 1.0 that's printed as percent). Otherwise you'll see several notification panels if you update quicker then the set timeout.<br />
An example:</p>
<pre class="terminal">notify --type progress --group "--group" --title "--title" --icon /boot/home/bebook.hvif \
--messageID MyMessageID --progress .75 "Keep waiting"</pre>
<p><img src="../images/apps-images/cli-notification.png" alt="cli-notification.png" /></p>
</td></tr>
<tr><td><p><span class="cli">query</span></p></td><td style="width:10px;"> </td>
<td valign="top"><p><span class="cli">query</span> is the commandline version of the Find panel. In fact, a quick way to generate the search term is to build a query in the Find panel, switch to <span class="menu">by formula</span>, add double quotes (<tt>"</tt>) in front and back and paste the whole string after your <span class="cli">query</span> command in Terminal or your script.</p>
</td></tr>
@@ -158,8 +165,8 @@ mountvolume RAMimage</pre>
<div class="nav">
<div class="inner"><span>
 «  <a href="list-cli-apps.html">List of commands</a> 
::  <a href="../applications.html#cli-apps" class="uplink">Aplicacions</a> 
« <a href="list-cli-apps.html">List of commands</a>
:: <a href="../applications.html#cli-apps" class="uplink">Aplicacions</a>
</span></div>
</div>