~ubuntu-branches/ubuntu/natty/pd-zexy/natty

« back to all changes in this revision

Viewing changes to README.txt

  • Committer: Bazaar Package Importer
  • Author(s): Jonas Smedegaard, IOhannes m zmölnig, Jonas Smedegaard
  • Date: 2010-08-20 12:17:41 UTC
  • mfrom: (2.1.2 sid)
  • Revision ID: james.westby@ubuntu.com-20100820121741-4kxozn8b9rhee9fr
Tags: 2.2.3-1
* New upstream version

[ IOhannes m zmölnig ]
* Adopt package, on behalf of Multimedia Team.
  Closes: #546964
* Simply debian/rules with CDBS, and don't unconditionally strip
  binaries.
  Closes: #437763
* Install into /usr/lib/pd/extra/zexy/. Document usage in REAME.Debian
  and warn about change in NEWS.
* git'ify package. Add Vcs-* stanzas to control file.
* Use dpkg source format 3.0 (quilt). Drop build-dependency on quilt.

[ Jonas Smedegaard ]
* Enable CDBS copyright-check routine.
* Add copyright and licensing header to debian/rules.
* Add myself as uploader.
* Rewrite debian/copyright using rev. 135 of draft DEP5 format.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
==============================================================================
 
2
the zexy external
 
3
==============================================================================
 
4
 
 
5
outline of this file::
 
6
==============================================================================
 
7
 +  general
 
8
 +  installation
 
9
   +  linux
 
10
   +  w32
 
11
   +  irix
 
12
   +  osX
 
13
 +  using
 
14
 +  authors
 
15
 
 
16
 
 
17
 
 
18
general::
 
19
==============================================================================
 
20
the zexy external is a collection of externals for miller.s.puckette's 
 
21
realtime-computermusic-environment called "puredata" (or abbreviated "pd")
 
22
this zexy external will be of no use, if you don't have a running version of 
 
23
pd on your system.
 
24
check out for http://pd.iem.at to learn more about pd and how to get it 
 
25
 
 
26
note: the zexy external is published under the Gnu General Public License 
 
27
that is included (GnuGPL.txt). some parts of the code are taken directly 
 
28
from the pd source-code, they, of course, fall under the license pd is 
 
29
published under.
 
30
 
 
31
 
 
32
 
 
33
installation::
 
34
==============================================================================
 
35
 
 
36
linux :
 
37
------------------------------------------------------------------------------
 
38
 
 
39
short:
 
40
#1> cd src/
 
41
#2> make
 
42
#3> make install
 
43
(this will automatically call autoconf and ./configure if needed (see "long"))
 
44
 
 
45
long:
 
46
#1>  cd src/
 
47
#2>  ./bootstrap.sh
 
48
#3>  ./configure
 
49
#4>  make
 
50
#5>  make install
 
51
 
 
52
this will install the zexy external into /usr/local/lib/pd/externs
 
53
(the path can be changed either via the "--prefix"-flag to "configure"
 
54
or by editing the makefile
 
55
alternatively you can try "make everything" (after ./configure)
 
56
note: if you don't want the parallel-port object [lpt]
 
57
 (e.g.: because you don't have a parallel-port) you can disable it 
 
58
 with "--disable-lpt"
 
59
 
 
60
 
 
61
macOS-X:
 
62
------------------------------------------------------------------------------
 
63
see installation/linux
 
64
 
 
65
there is nothing special in the code, so it should compile out of the box:
 
66
"cd" to zexy/src
 
67
run "./bootstrap.sh; ./configure; make" (for further details please see "1) linux")
 
68
 
 
69
building with a special version of Pd:
 
70
        to build zexy with your special version of Pd, you should specify the path to your Pd ressources
 
71
        (e.g. "./configure --with-pd=/Applications/Pd.app/Contents/Resources")
 
72
fat-binaries
 
73
        if you want to build a multi-arch binary you have to specify this as well
 
74
        (e.g. "./configure --enable-fat-binary=i386,ppc --with-extension=d_fat")
 
75
 
 
76
note on generating dependencies:
 
77
 on older systems the automatic creation of build dependencies
 
78
 might fail with following error:
 
79
    cpp0: invalid option -smart
 
80
 a simple workaround is to not use the "-E" flag for the preprocessor
 
81
 try:
 
82
   make CPP=cc
 
83
 
 
84
 
 
85
win32 :
 
86
------------------------------------------------------------------------------
 
87
 
 
88
#1 extract the zexy-0_x.zip to your pd-path (this file should be located 
 
89
   at <mypdpath>/pd/zexy/)
 
90
#2 execute the "z_install.bat", this should copy all necessary files 
 
91
   to the correct places
 
92
 
 
93
to compile: 
 
94
 + w/ MSVC use makefile.nt or zexy.dsw; 
 
95
 OR
 
96
 + with GCC configure your pd path, eg:
 
97
        #> ./configure --prefix=/c/program/pd; make; make install
 
98
 OR
 
99
 + cross-compilation for windows on linux using mingw (assumes that the 
 
100
   crosscompiler is "i586-mingw32msvc-cc")
 
101
        #> ./configure --host=i586-mingw32msvc --with-extension=dll \
 
102
           --disable-PIC --with-pd=/path/to/win/pd/
 
103
        #> make CFLAGS="-fno-unit-at-a-time"
 
104
     notes: configure tries to set the CFLAGS to "-g -O2" if the compiler
 
105
            accepts this; however, this optimization sometimes generates 
 
106
            binaries that cannot be loaded by pd; it seems that disabling
 
107
            the "unit-at-a-time" optimization (which gets enabled by "-O2")
 
108
            is the cause of this problem. turning it off might help
 
109
 
 
110
irix :
 
111
------------------------------------------------------------------------------
 
112
 
 
113
though i have physical access to both SGI's O2s and indys,
 
114
i haven't tried to compile the zexy externals there for years.
 
115
the configure-script should work here too;
 
116
if not, try "make -f makefile.irix"
 
117
Good luck !
 
118
 
 
119
 
 
120
 
 
121
making pd run with the zexy external::
 
122
==============================================================================
 
123
make sure, that pd will be looking at this location 
 
124
(add "-path <mypath>/pd/externs" either to your .pdrc or each time 
 
125
you execute pd)
 
126
make sure, that you somehow load the zexy external (either add "-lib zexy" 
 
127
(if you advised pd somehow to look at the correct place) 
 
128
or "-lib <myzexypath>/zexy" to your startup-script (.pdrc or whatever) 
 
129
or load it via the object "zexy" at runtime
 
130
 
 
131
 
 
132
 
 
133
authors::
 
134
==============================================================================
 
135
this software is 
 
136
copyleft 1999-2007 by IOhannes m zmoelnig <zmoelnig [at] iem [dot] at>
 
137
with some contributions by winfried ritsch, franz zotter, guenter geiger, 
 
138
miller.s.puckette and surely some others
 
139