/usr/share/doc/libdbus-java/dbus-java/dbus-javase8.html is in libdbus-java-doc 2.8-5.
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 | <?xml version="1.0" encoding="iso-8859-1" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!--http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd-->
<html xmlns="http://www.w3.org/1999/xhtml"
>
<head><title>Annotations</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<meta name="generator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)" />
<meta name="originator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)" />
<!-- xhtml,2,html -->
<meta name="src" content="dbus-java.tex" />
<meta name="date" content="2014-02-01 05:14:00" />
<link rel="stylesheet" type="text/css" href="dbus-java.css" />
</head><body
>
<!--l. 717--><div class="crosslinks"><p class="noindent">[<a
href="dbus-javase7.html" >prev</a>] [<a
href="dbus-javase7.html#taildbus-javase7.html" >prev-tail</a>] [<a
href="#taildbus-javase8.html">tail</a>] [<a
href="dbus-java.html# " >up</a>] </p></div>
<h3 class="sectionHead"><span class="titlemark">8 </span> <a
id="x29-330008"></a>Annotations</h3>
<!--l. 719--><p class="noindent" >You can annotate your D-Bus methods as in figure <a
href="#x29-3300115">15<!--tex4ht:ref: fig:annotation --></a> to provide hints to other users of your
API. Common annotations are listed in table <a
href="#x29-330022">2<!--tex4ht:ref: tab:annotations --></a>.
</p>
<hr class="figure" /><div class="figure"
>
<a
id="x29-3300115"></a>
<div class="center"
>
<!--l. 722--><p class="noindent" >
</p>
<div class="verbatim" id="verbatim-22">
package org.freedesktop;
 <br />import org.freedesktop.dbus.UInt32;
 <br />import org.freedesktop.dbus.DBusInterface;
 <br />
 <br />@org.freedesktop.DBus.Description("Some Methods");
 <br />public interface DBus extends DBusInterface
 <br />{
 <br />   @org.freedesktop.DBus.Description("Check if the name has an owner")
 <br />   public boolean NameHasOwner(String name);
 <br />   @org.freedesktop.DBus.Description("Request a name")
 <br />   @org.freedesktop.DBus.Deprecated()
 <br />   public UInt32 RequestName(String name, UInt32 flags);
 <br />}
</div>
<!--l. 737--><p class="nopar" ></p></div>
<br /> <div class="caption"
><span class="id">Figure 15: </span><span
class="content">An annotated method</span></div><!--tex4ht:label?: x29-3300115 -->
</div><hr class="endfigure" />
<div class="table">
<!--l. 744--><p class="indent" > <a
id="x29-330022"></a></p><hr class="float" /><div class="float"
>
<div class="tabular"> <table id="TBL-3" class="tabular"
cellspacing="0" cellpadding="0" rules="groups"
><colgroup id="TBL-3-1g"><col
id="TBL-3-1" /></colgroup><colgroup id="TBL-3-2g"><col
id="TBL-3-2" /></colgroup><tr
style="vertical-align:baseline;" id="TBL-3-1-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-1-1"
class="td11"><span
class="cmbx-12">Name </span></td><td style="white-space:nowrap; text-align:left;" id="TBL-3-1-2"
class="td11"><span
class="cmbx-12">Meaning </span></td>
</tr><tr
class="hline"><td><hr /></td><td><hr /></td></tr><tr
style="vertical-align:baseline;" id="TBL-3-2-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-2-1"
class="td11">org.freedesktop.DBus.Description </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-2-2"
class="td11">Provide a short 1-line description </td>
</tr><tr
style="vertical-align:baseline;" id="TBL-3-3-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-3-1"
class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-3-2"
class="td11">of the method or interface. </td></tr><tr
style="vertical-align:baseline;" id="TBL-3-4-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-4-1"
class="td11">org.freedesktop.DBus.Deprecated </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-4-2"
class="td11">This method or interface is Deprecated.</td>
</tr><tr
style="vertical-align:baseline;" id="TBL-3-5-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-5-1"
class="td11">org.freedesktop.DBus.Method.NoReply</td><td style="white-space:nowrap; text-align:left;" id="TBL-3-5-2"
class="td11">This method may be called and returned </td>
</tr><tr
style="vertical-align:baseline;" id="TBL-3-6-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-6-1"
class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-6-2"
class="td11">without waiting for a reply. </td>
</tr><tr
style="vertical-align:baseline;" id="TBL-3-7-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-7-1"
class="td11">org.freedesktop.DBus.Method.Error </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-7-2"
class="td11">This method may throw the listed Exception</td>
</tr><tr
style="vertical-align:baseline;" id="TBL-3-8-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-8-1"
class="td11"> </td><td style="white-space:nowrap; text-align:left;" id="TBL-3-8-2"
class="td11">in addition to the standard ones. </td>
</tr><tr
style="vertical-align:baseline;" id="TBL-3-9-"><td style="white-space:nowrap; text-align:left;" id="TBL-3-9-1"
class="td11"> </td></tr></table></div>
<br /> <div class="caption"
><span class="id">Table 2: </span><span
class="content">Common Annotations</span></div><!--tex4ht:label?: x29-330022 -->
</div><hr class="endfloat" />
</div>
<!--l. 760--><div class="crosslinks"><p class="noindent">[<a
href="dbus-javase7.html" >prev</a>] [<a
href="dbus-javase7.html#taildbus-javase7.html" >prev-tail</a>] [<a
href="dbus-javase8.html" >front</a>] [<a
href="dbus-java.html# " >up</a>] </p></div>
<!--l. 760--><p class="indent" > <a
id="taildbus-javase8.html"></a> </p>
</body></html>
|