Skip to content

Commit

Permalink
Integrated debian patches (thanks, George Khaznadar)
Browse files Browse the repository at this point in the history
  • Loading branch information
pnegre committed Jun 7, 2011
1 parent 0893a08 commit 9efc2a1
Show file tree
Hide file tree
Showing 15 changed files with 289 additions and 74 deletions.
34 changes: 23 additions & 11 deletions README
@@ -1,15 +1,19 @@
Linux Electronic Whiteboard with Wiimote
========================================

This program allows you to build and operate an electronic whiteboard using gnu/linux, a wiimote and an IR pen.
This program allows you to build and operate an electronic whiteboard using
gnu/linux, a wiimote and an IR pen.

If you have git installed on your system you can get the latest (development) version, typing:
If you have git installed on your system you can get the latest (development)
version, typing:

$ git clone git://github.com/pnegre/python-whiteboard.git

To download packaged versions of the program, point your browser to http://github.com/pnegre/python-whiteboard/downloads
To download packaged versions of the program, point your browser to
http://github.com/pnegre/python-whiteboard/downloads

It's recommended to disable the desktop effects, to avoid program crashes and malfunctions.
It's recommended to disable the desktop effects, to avoid program crashes and
malfunctions.


Compilation and installation
Expand All @@ -26,31 +30,39 @@ $ make deb

Required packages:

- To run the program: python-bluez python-qt4 python-numpy python-cwiid python-xlib python python-support
- To run the program: python-bluez python-qt4 python-numpy python-cwiid
python-xlib python python-support
- To run make: libqt4-dev qt4-dev-tools python-qt4-dev
- To build the deb package: build-essential fakeroot dpkg-dev debhelper



Configuration
-------------

The configuration screen has been integrated into the main screen. Siply push the button labeled "Show configuration".
The configuration screen has been integrated into the main screen. Siply push
the button labeled "Show configuration".

There are three tabs. In the first one, you can assign actions to the offscreen areas. In the second one, you can manage the wiimote devices. And in the third one, you'll find some more options.
There are three tabs. In the first one, you can assign actions to the offscreen
areas. In the second one, you can manage the wiimote devices. And in the third
one, you'll find some more options.


Calibration
-----------

The calibration process can be done in two ways:

- You can choose "fullscreen calibration": The application will change into a white fullscreen and will draw four crosses, that you have to mark clockwise.
- You can choose "fullscreen calibration": The application will change into a
white fullscreen and will draw four crosses, that you have to mark clockwise.

- If you don't mark the "fullscreen" check in the configuration dialog, the calibration process is done in the same way, but you have to point at the four corners of the SCREEN, in the same order as before: top-left, top-right, bottom-left, bottom-right.
- If you don't mark the "fullscreen" check in the configuration dialog, the
calibration process is done in the same way, but you have to point at the
four corners of the SCREEN, in the same order as before: top-left, top-right,
bottom-left, bottom-right.

After that, you simply push "activate".

In the calibration screen, you can use the UP/DOWN keys to actually move inwards the calibration points, making it easier to do the process.
In the calibration screen, you can use the UP/DOWN keys to actually move
inwards the calibration points, making it easier to do the process.


12 changes: 12 additions & 0 deletions debian/README.source
@@ -0,0 +1,12 @@
python-whiteboard for Debian
----------------------------

the source comes from https://github.com/pnegre/python-whiteboard.git

modifications are managed by quilt, see
"/usr/share/doc/quilt/README.source"




-- Georges Khaznadar <georgesk@ofset.org>, Sat, 28 May 2011 23:41:52 +0200
26 changes: 23 additions & 3 deletions debian/changelog
@@ -1,9 +1,30 @@
python-whiteboard (0.9.7) unstable; urgency=low

* Added french translation
* Applied debian patches (thanks to George Khaznadar)
* Long click

-- pnegre <pere.negre@gmail.com> Sun, 29 May 2011 22:25:56 +0200
-- pnegre <pnegre@andromeda.lan> Tue, 07 Jun 2011 23:15:59 +0200

python-whiteboard (0.9.6+git20110528-3) unstable; urgency=low

* added a French localization

-- Georges Khaznadar <georgesk@ofset.org> Sun, 29 May 2011 20:38:52 +0200

python-whiteboard (0.9.6+git20110528-2) unstable; urgency=low

* updated the name and the address of the author

-- Georges Khaznadar <georgesk@ofset.org> Sun, 29 May 2011 00:30:24 +0200

python-whiteboard (0.9.6+git20110528-1) unstable; urgency=low

* Initial release (Closes: #628434)
* added build-dependencies: quilt, python-all, libqt4-dev
* moved stuff to /usr/share
* written a short manpage

-- Georges Khaznadar <georgesk@ofset.org> Sat, 28 May 2011 23:18:08 +0200

python-whiteboard (0.9.6) unstable; urgency=low

Expand Down Expand Up @@ -178,4 +199,3 @@ python-whiteboard (0.1-1) unstable; urgency=low
* First release.

-- pnegre <pere.negre@gmail.com> Wed, 28 Apr 2010 10:13:19 +0200

2 changes: 1 addition & 1 deletion debian/compat
@@ -1 +1 @@
4
7
18 changes: 11 additions & 7 deletions debian/control
@@ -1,14 +1,18 @@
Source: python-whiteboard
Section: games
Priority: optional
Maintainer: Pere Negre <pere.negre@gmail.com>
Build-Depends-Indep: python (>= 2.1)
Build-Depends: debhelper (>= 4.1.25)
Standards-Version: 3.7.2
Section: python
Priority: extra
Maintainer: Georges Khaznadar <georgesk@ofset.org>
Build-Depends: debhelper (>= 7.0.50~), quilt,
python-all (>=2.6.6-3 ), libqt4-dev
X-Python-Version: >= 2.5
Standards-Version: 3.9.2
Homepage: https://github.com/pnegre/python-whiteboard

Package: python-whiteboard
Architecture: all
Depends: python-bluez (>= 0.14), python-qt4 (>= 4.0), python-numpy (>= 1:1.0), python-cwiid (>= 0.5), python-xlib (>= 0.10), ${python:Depends}
Depends: python-bluez (>= 0.14), python-qt4 (>= 4.0), python-numpy (>= 1:1.0),
python-cwiid (>= 0.5), python-xlib (>= 0.10),
${python:Depends}, ${misc:Depends}
Description: Make your own electronic whiteboard
python whiteboard is a program that lets you build your own
electronic whiteboard. You only need a wii remote and a IR pen
37 changes: 37 additions & 0 deletions debian/copyright
@@ -0,0 +1,37 @@
Format: http://dep.debian.net/deps/dep5
Upstream-Name: python-whiteboard
Source: https://github.com/pnegre/python-whiteboard.git

Files: *
Copyright: 2010-2011 Pere Negre <pere.negre@gmail.com>
License: GPL-2
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
.
see "/usr/share/common-licenses/GPL-2"

Files: debian/*
Copyright: 2011 Georges Khaznadar <georgesk@ofset.org>
License: GPL-2+
This package is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
.
This package is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>
.
On Debian systems, the complete text of the GNU General
Public License version 2 can be found in "/usr/share/common-licenses/GPL-2".
1 change: 1 addition & 0 deletions debian/docs
@@ -0,0 +1 @@
README
113 changes: 113 additions & 0 deletions debian/manpage.xml
@@ -0,0 +1,113 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [

<!--

`xsltproc -''-nonet \
-''-param man.charmap.use.subset "0" \
-''-param make.year.ranges "1" \
-''-param make.single.year.ranges "1" \
/usr/share/xml/docbook/stylesheet/docbook-xsl/manpages/docbook.xsl \
manpage.xml'

A manual page <package>.<section> will be generated. You may view the
manual page with: nroff -man <package>.<section> | less'. A typical entry
in a Makefile or Makefile.am is:

DB2MAN = /usr/share/sgml/docbook/stylesheet/xsl/docbook-xsl/manpages/docbook.xsl
XP = xsltproc -''-nonet -''-param man.charmap.use.subset "0"

manpage.1: manpage.xml
$(XP) $(DB2MAN) $<

The xsltproc binary is found in the xsltproc package. The XSL files are in
docbook-xsl. A description of the parameters you can use can be found in the
docbook-xsl-doc-* packages. Please remember that if you create the nroff
version in one of the debian/rules file targets (such as build), you will need
to include xsltproc and docbook-xsl in your Build-Depends control field.
Alternatively use the xmlto command/package. That will also automatically
pull in xsltproc and docbook-xsl.

Notes for using docbook2x: docbook2x-man does not automatically create the
AUTHOR(S) and COPYRIGHT sections. In this case, please add them manually as
<refsect1> ... </refsect1>.

To disable the automatic creation of the AUTHOR(S) and COPYRIGHT sections
read /usr/share/doc/docbook-xsl/doc/manpages/authors.html. This file can be
found in the docbook-xsl-doc-html package.

Validation can be done using: `xmllint -''-noout -''-valid manpage.xml`

General documentation about man-pages and man-page-formatting:
man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/

-->

<!-- Fill in your name for FIRSTNAME and SURNAME. -->
<!ENTITY dhfirstname "Georges">
<!ENTITY dhsurname "Khaznadar">
<!-- dhusername could also be set to "&dhfirstname; &dhsurname;". -->
<!ENTITY dhusername "Georges Khaznadar">
<!ENTITY dhemail "georgesk@ofset.org">
<!-- SECTION should be 1-8, maybe w/ subsection other parameters are
allowed: see man(7), man(1) and
http://www.tldp.org/HOWTO/Man-Page/q2.html. -->
<!ENTITY dhsection "1">
<!-- TITLE should be something like "User commands" or similar (see
http://www.tldp.org/HOWTO/Man-Page/q2.html). -->
<!ENTITY dhtitle "python-whiteboard User Manual">
<!ENTITY dhucpackage "PYTHON-WHITEBOARD">
<!ENTITY dhpackage "python-whiteboard">
]>

<refentry>
<refentryinfo>
<title>&dhtitle;</title>
<productname>&dhpackage;</productname>
<authorgroup>
<author>
<firstname>&dhfirstname;</firstname>
<surname>&dhsurname;</surname>
<contrib>Wrote this manpage for the Debian system.</contrib>
<address>
<email>&dhemail;</email>
</address>
</author>
</authorgroup>
<copyright>
<year>2011</year>
<holder>&dhusername;</holder>
</copyright>
<legalnotice>
<para>Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU General Public License,
Version 2 or (at your option) any later version published by
the Free Software Foundation.</para>
<para>On Debian systems, the complete text of the GNU General Public
License can be found in
<filename>/usr/share/common-licenses/GPL</filename>.</para>
</legalnotice>
</refentryinfo>
<refmeta>
<refentrytitle>&dhucpackage;</refentrytitle>
<manvolnum>&dhsection;</manvolnum>
</refmeta>
<refnamediv>
<refname>&dhpackage;</refname>
<refpurpose>Make your own electronic whiteboard</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>&dhpackage;</command>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1 id="description">
<title>DESCRIPTION</title>
<para><command>&dhpackage;</command> is a program that lets you
build your own
electronic whiteboard. You only need a wii remote and a IR pen
</para>
</refsect1>
</refentry>

6 changes: 2 additions & 4 deletions debian/menu
@@ -1,4 +1,2 @@
?package(python-whiteboard): needs="X11"\
section="Applications/Education" \
title="python-whiteboard" \
command="/usr/bin/python-whiteboard" \
?package(python-whiteboard):needs="X11" section="Applications/Education"\
title="python-whiteboard" command="/usr/bin/python-whiteboard"
54 changes: 54 additions & 0 deletions debian/python-whiteboard.1
@@ -0,0 +1,54 @@
'\" t
.\" Title: PYTHON-WHITEBOARD
.\" Author: Georges Khaznadar <georgesk@ofset.org>
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 05/28/2011
.\" Manual: python-whiteboard User Manual
.\" Source: python-whiteboard
.\" Language: English
.\"
.TH "PYTHON\-WHITEBOARD" "1" "05/28/2011" "python-whiteboard" "python-whiteboard User Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
python-whiteboard \- Make your own electronic whiteboard
.SH "SYNOPSIS"
.HP \w'\fBpython\-whiteboard\fR\ 'u
\fBpython\-whiteboard\fR
.SH "DESCRIPTION"
.PP
\fBpython\-whiteboard\fR
is a program that lets you build your own electronic whiteboard\&. You only need a wii remote and a IR pen
.SH "AUTHOR"
.PP
\fBGeorges Khaznadar\fR <\&georgesk@ofset\&.org\&>
.RS 4
Wrote this manpage for the Debian system\&.
.RE
.SH "COPYRIGHT"
.br
Copyright \(co 2011 Georges Khaznadar
.br
.PP
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or (at your option) any later version published by the Free Software Foundation\&.
.PP
On Debian systems, the complete text of the GNU General Public License can be found in
/usr/share/common\-licenses/GPL\&.
.sp
1 change: 1 addition & 0 deletions debian/python-whiteboard.manpages
@@ -0,0 +1 @@
debian/python-whiteboard.1

0 comments on commit 9efc2a1

Please sign in to comment.