/usr/share/doc/libantelope-java/manual/bk01ch05.html is in libantelope-java-doc 3.5.1-4.
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 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 5. Running Antelope</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"><link rel="home" href="index.html" title="Antelope Users Guide"><link rel="up" href="bk01.html" title="Antelope Users Guide, Version @buildnum@"><link rel="prev" href="bk01ch04.html" title="Chapter 4. Requirements"><link rel="next" href="bk01ch05s02.html" title="Antelope as a Stand-Alone Application"></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">Chapter 5. Running Antelope</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="bk01ch04.html">Prev</a> </td><th width="60%" align="center">Antelope Users Guide, Version @buildnum@</th><td width="20%" align="right"> <a accesskey="n" href="bk01ch05s02.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a name="runningantelope"></a>Chapter 5. Running Antelope</h1></div></div></div><div class="toc"><p><b>Table of Contents</b></p><ul class="toc"><li><span class="section"><a href="bk01ch05.html#options">Option Settings</a></span></li><li><span class="section"><a href="bk01ch05s02.html">Antelope as a Stand-Alone Application</a></span></li><li><span class="section"><a href="bk01ch05s03.html">Antelope as a jEdit Plugin</a></span></li></ul></div>
@style@
<div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="options"></a>Option Settings</h2></div></div></div>
@style@
<p>
Either way, Antelope is operated almost identically. To set up Antelope, click on the "Options" button. This will display the following:
</p><p>
</p><div class="figure"><a name="idm96"></a><p class="title"><b>Figure 5.1. Options Panel</b></p><div class="figure-contents"><img src="options_general.gif" alt="Options Panel"></div></div><p><br class="figure-break">
</p><p>
When running Antelope as a stand-alone application, the options "Save all files before running targets" and "Use error parsing" are not available. This is the only difference between the stand-alone and the plugin.
</p><p>
The available options on the "General" tab are:
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
<span class="bold"><strong>Save all files before running targets</strong></span> <span class="emphasis"><em>This is only available when running as a jEdit plugin.</em></span> If checked, all files that are currently open for editing in jEdit will be saved before running the selected target. The default setting is checked, that is, do save all files before executing the target.
</p></li><li class="listitem"><p>
<span class="bold"><strong>Use error parsing</strong></span> <span class="emphasis"><em>This is only available when running as a jEdit plugin.</em></span> If checked, output from the target will be passes through the Console plugin error parser and errors will be displayed in the ErrorList plugin. This is useful for tasks such as javac that produce standard error messages. Other tasks may not produce output suitable for error parsing, in which case, the output might be cleaner if this options is turned off. The default setting is checked, that is, do use error parsing.
</p></li><li class="listitem"><p>
<span class="bold"><strong>Show performance statistics</strong></span> If checked, Antelope will keep track of the amount of time that each target and task takes to execute. At the end of the build, these times will be sorted from fastest to slowest and displayed following the build output. This can be useful to pinpoint slow and/or inefficient spots in the build process and identify those areas that could benefit from optimization. The default setting is unchecked, that is, do not show performance statistics.
</p></li><li class="listitem"><p>
<span class="bold"><strong>Automatically reload build file</strong></span> If checked, Antelope will automatically reload the build file before running a target. That means that all properties will be reset to their original values or reloaded from property files as necessary. Keep in mind that properties set via the "Properties" button and dialog are not applied until the build file is reloaded. The default setting is checked, that is, do automatically reload the build file prior to each build. On the other hand, if there are properties that are loaded via a <property file="filename.props"/> or <loadproperties srcfile="filename"/>, Antelope will watch those files and reload the build file automatically if they change. Changes to such files cause a reload regardless of this setting.
</p></li></ul></div><p>
The available options on the "Targets" tab are:
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
<span class="bold"><strong>Show subtargets</strong></span> There are several common conventions for designating "primary" targets and "subtargets", also referred to as "public" and "private" targets. Primary (or public) targets are those that are invoked directly, while subtargets (or private targets) are generally "helper" targets that are invoked from other targets. Antelope supports three of the most common conventions:
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><p>
One method of distinguishing between primary and subtargets is only giving descriptions to primary targets. Unchecking the "Show targets without descriptions" will cause Antelope to display buttons only for targets that have a description.
</p></li><li class="listitem"><p>
Another common method to designate subtargets is to use "dot" notation, for example, a "clean" target may have two helper targets, "clean.docs" and "clean.api.docs". Unchecking the "Show targets with dots" will cause Antelope to display a button for the "clean" target but not the "clean.docs" nor the "clean.api.docs" targets.
</p></li><li class="listitem"><p>
The third method of designating subtargets is to start the names of these targets with a dash, for example, "-clean.docs" and "-clean.api.docs". Unchecking the "Show targets with dash" will cause Antelope to display a button for each such target.
</p></li></ul></div><p>
By default, none of these options are selected. Antelope displays all private targets in italics.
</p></li><li class="listitem"><p>
<span class="bold"><strong>Sort target buttons</strong></span> By default, the target buttons are sorted alphabetically by target name. Unchecking this box will cause the target buttons to be displayed in the order that they appear in the build file.
</p></li></ul></div><p>
The available options on the "Messages" tab are:
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
<span class="bold"><strong>Set message level</strong></span> There are five message levels available and are in order of verbosity, "Error" being the least verbose and "Debug" being the most. For general use, "Information" is about right and is the default setting.
</p></li></ul></div><p>
The available options on the "General" tab are:
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
<span class="bold"><strong>Show message events</strong></span> Ant produces messages on various events as it runs a target. Generally, all Ant messages are useful, but these can be adjusted as necessary. Turning off 'Target events' and 'Task events' will generally show all the important information without too much excess output. The default is that 'Build events' and 'Log events' are checked.
</p></li></ul></div><p>
The available options on the "Appearance" tab are:
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
<span class="bold"><strong>Show button text</strong></span> This will turn on or off the display of the text on the control buttons.
</p></li><li class="listitem"><p>
<span class="bold"><strong>Show button icon</strong></span> This will turn on or off the display of the icon on the control buttons.
</p></li></ul></div><p>
All option settings are stored per build file (except for the Appearance settings), which means that when you close one file and open another, the option settings for the new file will be retrieved and automatically set.
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="bk01ch04.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="bk01.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="bk01ch05s02.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 4. Requirements </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Antelope as a Stand-Alone Application</td></tr></table></div></body></html>
|