/usr/share/doc/libantelope-java/manual/bk02ch03s02.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 53 54 55 56 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Formatting</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="bk02ch03.html" title="Chapter 3. Build File Structure and Formatting"><link rel="prev" href="bk02ch03.html" title="Chapter 3. Build File Structure and Formatting"><link rel="next" href="bk02ch04.html" title="Chapter 4. Projects"></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">Formatting</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="bk02ch03.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Build File Structure and Formatting</th><td width="20%" align="right"> <a accesskey="n" href="bk02ch04.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="idm572"></a>Formatting</h2></div></div></div><p>
Four spaces should be used as the unit of indentation.
</p><p>
Do not use tabs instead, use 4 spaces in place of a single tab. Many editors can do this automatically.
</p><p>
Vertically align start and end tags for an element. Indent child elements.
</p><p>
Avoid lines longer than 80 characters, since they're not handled well by many terminals and tools.
</p><p>
Use a single space after a comma.
</p><p>
Group properties by use, for example, group directory definitions together. Insert a single blank line between groups.
</p><p>
Insert two blank lines between targets.
</p><p>
Insert one blank line between tasks within a target.
</p><p>
When an expression will not fit on a single line, break it according to these general principles:
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Break before an attribute.</p></li><li class="listitem"><p>Break after a space or comma.</p></li><li class="listitem"><p>Prefer higher-level breaks to lower-level breaks.</p></li><li class="listitem"><p>Align the new line with the beginning of the expression at the same level on the previous line.</p></li><li class="listitem"><p>If the above rules lead to confusing code or to code that's squished up against the right margin, just indent 8 spaces instead.</p></li></ul></div><p>
</p><p>
Examples:
</p><p>
</p><pre class="programlisting">
<property name="modules"
value="libs, junit_tests, images, docs, api_docs, external_libs,
sources" />
<copy todir="${unit_test_deploy}" overwrite="true">
<fileset dir="${unit_test_home}">
<exclude name="**/CVS" />
</fileset>
</copy>
</pre><p>
</p><p>
This is wrong:
</p><p>
</p><pre class="programlisting">
<target name="test_all" depends="clean,setupApp,
setupTests,setupLogger,
startReportServlet,runTests"/>
</pre><p>
</p><p>
This is right:
</p><p>
</p><pre class="programlisting">
<target name="test_all"
depends="clean, setupApp, setupTests, setupLogger,
startReportServlet, runTests"/>
</pre><p>
</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="bk02ch03.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="bk02ch03.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="bk02ch04.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 3. Build File Structure and Formatting </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 4. Projects</td></tr></table></div></body></html>
|