/usr/share/doc/libantelope-java/manual/bk01ch08.html is in libantelope-java-doc 3.5.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 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 8. Editing the Build File</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><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="bk01ch07.html" title="Chapter 7. Displaying Ant Properties"><link rel="next" href="bk01ch09.html" title="Chapter 9. Tracing Target Execution"></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 8. Editing the Build File</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="bk01ch07.html">Prev</a> </td><th width="60%" align="center">Antelope Users Guide, Version @buildnum@</th><td width="20%" align="right"> <a accesskey="n" href="bk01ch09.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 8. Editing the Build File"><div class="titlepage"><div><div><h2 class="title"><a name="editing"></a>Chapter 8. Editing the Build File</h2></div></div></div>
@style@
<p>
Clicking the "Edit" button puts Antelope in 'edit' mode. Antelope will display a tree representing the build file. Clicking on any item in the tree moves the cursor in the editor to that item in the build file.
</p><p>
As a jEdit plugin, clicking the "Edit" button will open the build file in a jEdit buffer.
</p><p>
As a stand-alone application, clicking the "Edit" button opens the "Edit" tab to edit the build file.
</p><p>
When the file is saved (either by saving the buffer in jEdit or by using the File - Save Build File menu item in stand-alone mode), Antelope will immediately reload the build file to pick up any changes and refresh the button panel to reflect those changes.
</p><p>
<span class="emphasis"><em>
Note: If the build file has an xml format error, the target buttons will disappear when the file is saved. To make the buttons reappear, correct the error and resave. Usually the output will give some indication of the error in the build file.
</em></span>
</p><p>
Here is Antelope in edit mode:
</p><p>
</p><div class="figure"><a name="id2508578"></a><p class="title"><b>Figure 8.1. Antelope in 'Edit' Mode</b></p><div class="figure-contents"><img src="editmode.gif" alt="Antelope in 'Edit' Mode"></div></div><p><br class="figure-break">
</p><p>
Icons:
</p><p>
<span class="inlinemediaobject"><img src="ant.gif"></span>
An Ant Project.
</p><p>
<span class="inlinemediaobject"><img src="red_ant.gif"></span>
An imported Ant Project.
</p><p>
<span class="inlinemediaobject"><img src="Target16.gif"></span>
An Ant Target in the main project file.
</p><p>
<span class="inlinemediaobject"><img src="RedTarget16.gif"></span>
An Ant Target in an imported project file.
</p><p>
<span class="inlinemediaobject"><img src="Wrench16.gif"></span>
An Ant Task.
</p><p>
Note the navigation arrows circled in red in the above image. As you click on items in the edit tree, the cursor in the editor panel will move to that item in the build file. The navigation arrows allow you to go back and forward, much like the back and forward buttons on a web browser. <span class="emphasis"><em>Beware that clicking on a target imported from another file will cause that file to be opened in the editor panel.</em></span>
</p><p>
</p><div class="figure"><a name="id2508695"></a><p class="title"><b>Figure 8.2. Dependency Tree</b></p><div class="figure-contents"><img src="dependency_tree.gif" alt="Dependency Tree"></div></div><p><br class="figure-break">
</p><p>
Right clicking on a target in the edit tree shows a dependency tree for that target. A "dependency tree" shows a list of targets that the selected target will by virtue of the targets being listed in the targets' 'depends' attribute, as well as any targets that may be called by <ant> and <antcall> tasks contained in the target. Like the edit tree, clicking on targets in the dependency tree will also move the cursor in the editor panel to the selected item.
</p><p><a name="tip"></a>
<span class="bold"><strong>Tip:</strong></span> Antelope can open most xml files and display them in the editor and in the tree. If the xml file is not a build file (as determined by the root element being "project"), then the "Run" and "Trace" mode buttons will be disabled.
</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="bk01ch07.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="bk01ch09.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 7. Displaying Ant Properties </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 9. Tracing Target Execution</td></tr></table></div></body></html>
|