/usr/share/doc/libbobcat3-dev/man/xpointer.3.html is in libbobcat-dev 3.19.01-1ubuntu1.
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 | <html><head>
<title>FBB::Xpointer</title>
<link rev="made" href="mailto:Frank B. Brokken: f.b.brokken@rug.nl">
</head>
<body text="#27408B" bgcolor="#FFFAF0">
<hr>
<h1>FBB::Xpointer</h1>
<h2>libbobcat-dev_3.19.01-x.tar.gz</h2>
<h2>2005-2013</h2>
<html><head>
<link rev="made" href="mailto:Frank B. Brokken: f.b.brokken@rug.nl">
</head>
<body text="#27408B" bgcolor="#FFFAF0">
<hr>
<h1></h1>
<html><head>
<title>FBB::Xpointer(3bobcat)</title>
<link rev="made" href="mailto:Frank B. Brokken: f.b.brokken@rug.nl">
</head>
<body text="#27408B" bgcolor="#FFFAF0">
<hr>
<h1>FBB::Xpointer(3bobcat)</h1>
<h2>libbobcat-dev_3.19.01-x.tar.gz Sets the X-pointer</h2>
<h2>2005-2013</h2>
<p>
<h2>NAME</h2>FBB::Xpointer - Sets the location of the X-windows pointer
<p>
<h2>SYNOPSIS</h2>
<strong>#include <bobcat/xpointer></strong><br>
<p>
Linking option: <em>-lbobcat -lX11</em>
<p>
<h2>DESCRIPTION</h2>
This class allows programs running within the X-graphical environment to
set and retrieve the X-windows pointer location.
<p>
<h2>NAMESPACE</h2>
<strong>FBB</strong><br>
All constructors, members, operators and manipulators, mentioned in this
man-page, are defined in the namespace <strong>FBB</strong>.
<p>
<h2>INHERITS FROM</h2>
-
<p>
<h2>CONSTRUCTORS</h2>
<ul>
<li> <strong>Xpointer()</strong>:<br>
The default constructor. Connects to the Display. throws an <strong>Exception</strong>
exception if the display cannot be opened. With multiple <strong>Xpointer</strong> objects,
the connection to the display is opened only once.
<p>
This constructor throws an <em>Exception</em> exception if it could not connect
to the Display.
</ul>
The copy constructor is available.
<p>
<h2>MEMBER FUNCTIONS</h2>
<ul>
<li> <strong>bool get(int *x, int *y) const</strong>:<br>
Returns in its arguments the currnet pointer coordinates relative to
the root-window. On success <em>true</em> is returned; <em>false</em> is returned if the
pointer could not be moved.
<li> <strong>bool set(int x, int y) const</strong>:<br>
Sets the pointer to a location whose pixel coordinates are given with
respect to the root-window. A negative x-coordinate is measured from the
right screen-margin of the root window (going left), a negative y-coordinate
is measured from the bottom screen-margin of the root window (going up). On
success <em>true</em> is returned; <em>false</em> is returned if the pointer could not
be moved.
<li> <strong>void verify() const</strong>:<br>
Obsoleted, will be removed in a future Bobcat release.
</ul>
<p>
<h2>EXAMPLE</h2>
<pre>
#include <iostream>
#include <string>
#include <bobcat/xpointer>
using namespace FBB;
int main()
try
{
Xpointer xpointer;
xpointer.verify();
if (!xpointer.set(100, 200))
throw string("Set pointer failed");
int x;
int y;
if (!xpointer.get(&x, &y))
throw string("Get pointer failed");
cout << "Pointer now at " << x << ", " << y << endl;
return 0;
}
catch (string msg)
{
cout << msg << endl;
return 1;
}
</pre>
<p>
<h2>FILES</h2>
<em>bobcat/xpointer</em> - defines the class interface
<p>
<h2>SEE ALSO</h2>
<strong>bobcat</strong>(7)
<p>
<h2>BUGS</h2>
<p>
Note that <em>-lX11</em> must be specified as well.
<p>
<h2>DISTRIBUTION FILES</h2>
<ul>
<li> <em>bobcat_3.19.01-x.dsc</em>: detached signature;
<li> <em>bobcat_3.19.01-x.tar.gz</em>: source archive;
<li> <em>bobcat_3.19.01-x_i386.changes</em>: change log;
<li> <em>libbobcat1_3.19.01-x_*.deb</em>: debian package holding the
libraries;
<li> <em>libbobcat1-dev_3.19.01-x_*.deb</em>: debian package holding the
libraries, headers and manual pages;
<li> <em>http://sourceforge.net/projects/bobcat</em>: public archive location;
</ul>
<p>
<h2>BOBCAT</h2>
Bobcat is an acronym of `Brokken's Own Base Classes And Templates'.
<p>
<h2>COPYRIGHT</h2>
This is free software, distributed under the terms of the
GNU General Public License (GPL).
<p>
<h2>AUTHOR</h2>
Frank B. Brokken (<strong>f.b.brokken@rug.nl</strong>).
<p>
|