This file is indexed.

/usr/share/doc/swi-prolog-doc/UserGuide/sec-E.2.html is in swi-prolog-doc 5.6.59-1.

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
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">

<HTML>
<HEAD>
<TITLE>Programming in XPCE/Prolog: Section E.2</TITLE><LINK REL=home HREF="index.html">
<LINK REL=contents HREF="Contents.html">
<LINK REL=index HREF="DocIndex.html">
<LINK REL=summary HREF="summary.html">
<LINK REL=previous HREF="sec-E.1.html">
<LINK REL=next HREF="sec-E.3.html">
<STYLE type="text/css">
/* Style sheet for SWI-Prolog latex2html
*/

dd.defbody
{ margin-bottom: 1em;
}

dt.pubdef
{ background-color: #c5e1ff;
}

pre.code
{ margin-left: 1.5em;
margin-right: 1.5em;
border: 1px dotted;
padding-top: 5px;
padding-left: 5px;
padding-bottom: 5px;
background-color: #f8f8f8;
}

div.navigate
{ text-align: center;
background-color: #f0f0f0;
border: 1px dotted;
padding: 5px;
}

div.title
{ text-align: center;
padding-bottom: 1em;
font-size: 200%;
font-weight: bold;
}

div.author
{ text-align: center;
font-style: italic;
}

div.abstract
{ margin-top: 2em;
background-color: #f0f0f0;
border: 1px dotted;
padding: 5px;
margin-left: 10%; margin-right:10%;
}

div.abstract-title
{ text-align: center;
padding: 5px;
font-size: 120%;
font-weight: bold;
}

div.toc-h1
{ font-size: 200%;
font-weight: bold;
}

div.toc-h2
{ font-size: 120%;
font-weight: bold;
margin-left: 2em;
}

div.toc-h3
{ font-size: 100%;
font-weight: bold;
margin-left: 4em;
}

div.toc-h4
{ font-size: 100%;
margin-left: 6em;
}

span.sec-nr
{ 
}

span.sec-title
{ 
}

span.pred-ext
{ font-weight: bold;
}

/* Footnotes */

sup.fn { color: blue; text-decoration: underline; }
span.fn-text: { display: none; }
sup.fn span {display: none;}
sup:hover span 
{ display: block !important;
position: absolute; top: auto; left: auto; width: 80%;
color: #000; background: white;
border: 2px solid;
padding: 5px; margin: 10px; z-index: 100;
font-size: smaller;
}
</STYLE>
</HEAD>
<BODY BGCOLOR="white">
<DIV class="navigate"><A class="nav" href="index.html"><IMG SRC="home.gif" BORDER=0 ALT="Home"></A>
<A class="nav" href="Contents.html"><IMG SRC="index.gif" BORDER=0 ALT="Contents"></A>
<A class="nav" href="DocIndex.html"><IMG SRC="yellow_pages.gif" BORDER=0 ALT="Index"></A>
<A class="nav" href="summary.html"><IMG SRC="info.gif" BORDER=0 ALT="Summary"></A>
<A class="nav" href="sec-E.1.html"><IMG SRC="prev.gif" BORDER=0 ALT="Previous"></A>
<A class="nav" href="sec-E.3.html"><IMG SRC="next.gif" BORDER=0 ALT="Next"></A>
</DIV>

<H2><A NAME="sec:E.2"><SPAN class="sec-nr">E.2</SPAN> <SPAN class="sec-title">Practical 
considerations</SPAN></A></H2>

<P><A NAME="idx:objectmanagement:716"></A>The principal predicates <A NAME="idx:new2:717"></A><A class="pred" href="sec-D.1.html#new/2">new/2</A>, <A NAME="idx:send212:718"></A><A class="pred" href="sec-7.1.html#send/[2-12]">send/[2-12]</A> 
and <A NAME="idx:get313:719"></A><A class="pred" href="sec-D.1.html#get/3">get/[3-13]</A> 
will destroy all argument- and answer- objects created during their 
execution except for the object created by <A NAME="idx:new2:720"></A><A class="pred" href="sec-D.1.html#new/2">new/2</A> 
and the object returned by <A NAME="idx:get313:721"></A><A class="pred" href="sec-D.1.html#get/3">get/[3-13]</A>.

<P>An object created by <A NAME="idx:new2:722"></A><A class="pred" href="sec-D.1.html#new/2">new/2</A> 
with an integer (anonymous) object reference must either be attached to 
another object, locked against PCE's garbage collector or destroyed 
using <A NAME="idx:objectsenddone:723"></A>`<B>object<CODE>-&gt;</CODE>done</B>' 
if it is created during the
<EM>initialisation</EM> of the application or in a loop that is passed 
many times. Such objects will be automatically reclaimed if (1) the 
object is created while handling a user-event after handling the event 
is finished or (2) the object is created in the implementation of a 
method on a user-defined class and the method terminates execution.

<P>If is is not known whether or not the result of <A NAME="idx:get313:724"></A><A class="pred" href="sec-D.1.html#get/3">get/[3-13]</A> 
is a computed object the user should invoke <A NAME="idx:objectsenddone:725"></A>`<B>object<CODE>-&gt;</CODE>done</B>' 
to this result when the result is no longer needed. This will free the 
result if it was a computed (and no longer referenced) object and has no 
effect otherwise. If the result of the get operation is known to be an 
integer, no such message should be send.

<P></BODY></HTML>