File: INSTALL.html

package info (click to toggle)
libgo-perl 0.12-1
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 7,400 kB
  • ctags: 847
  • sloc: perl: 13,095; sh: 21; makefile: 6
file content (605 lines) | stat: -rw-r--r-- 17,184 bytes parent folder | download | duplicates (8)
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
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
    "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="generator" content="AsciiDoc 8.1.0" />
<style type="text/css">
/* Debug borders */
p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
/*
  border: 1px solid red;
*/
}

body {
  margin: 1em 5% 1em 5%;
}

a {
  color: blue;
  text-decoration: underline;
}
a:visited {
  color: fuchsia;
}

em {
  font-style: italic;
}

strong {
  font-weight: bold;
}

tt {
  color: navy;
}

h1, h2, h3, h4, h5, h6 {
  color: #527bbd;
  font-family: sans-serif;
  margin-top: 1.2em;
  margin-bottom: 0.5em;
  line-height: 1.3;
}

h1 {
  border-bottom: 2px solid silver;
}
h2 {
  border-bottom: 2px solid silver;
  padding-top: 0.5em;
}

div.sectionbody {
  font-family: serif;
  margin-left: 0;
}

hr {
  border: 1px solid silver;
}

p {
  margin-top: 0.5em;
  margin-bottom: 0.5em;
}

pre {
  padding: 0;
  margin: 0;
}

span#author {
  color: #527bbd;
  font-family: sans-serif;
  font-weight: bold;
  font-size: 1.1em;
}
span#email {
}
span#revision {
  font-family: sans-serif;
}

div#footer {
  font-family: sans-serif;
  font-size: small;
  border-top: 2px solid silver;
  padding-top: 0.5em;
  margin-top: 4.0em;
}
div#footer-text {
  float: left;
  padding-bottom: 0.5em;
}
div#footer-badges {
  float: right;
  padding-bottom: 0.5em;
}

div#preamble,
div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
div.admonitionblock {
  margin-right: 10%;
  margin-top: 1.5em;
  margin-bottom: 1.5em;
}
div.admonitionblock {
  margin-top: 2.5em;
  margin-bottom: 2.5em;
}

div.content { /* Block element content. */
  padding: 0;
}

/* Block element titles. */
div.title, caption.title {
  font-family: sans-serif;
  font-weight: bold;
  text-align: left;
  margin-top: 1.0em;
  margin-bottom: 0.5em;
}
div.title + * {
  margin-top: 0;
}

td div.title:first-child {
  margin-top: 0.0em;
}
div.content div.title:first-child {
  margin-top: 0.0em;
}
div.content + div.title {
  margin-top: 0.0em;
}

div.sidebarblock > div.content {
  background: #ffffee;
  border: 1px solid silver;
  padding: 0.5em;
}

div.listingblock {
  margin-right: 0%;
}
div.listingblock > div.content {
  border: 1px solid silver;
  background: #f4f4f4;
  padding: 0.5em;
}

div.quoteblock > div.content {
  padding-left: 2.0em;
}

div.attribution {
  text-align: right;
}
div.verseblock + div.attribution {
  text-align: left;
}

div.admonitionblock .icon {
  vertical-align: top;
  font-size: 1.1em;
  font-weight: bold;
  text-decoration: underline;
  color: #527bbd;
  padding-right: 0.5em;
}
div.admonitionblock td.content {
  padding-left: 0.5em;
  border-left: 2px solid silver;
}

div.exampleblock > div.content {
  border-left: 2px solid silver;
  padding: 0.5em;
}

div.verseblock div.content {
  white-space: pre;
}

div.imageblock div.content { padding-left: 0; }
div.imageblock img { border: 1px solid silver; }
span.image img { border-style: none; }

dl {
  margin-top: 0.8em;
  margin-bottom: 0.8em;
}
dt {
  margin-top: 0.5em;
  margin-bottom: 0;
  font-style: italic;
}
dd > *:first-child {
  margin-top: 0;
}

ul, ol {
    list-style-position: outside;
}
ol.olist2 {
  list-style-type: lower-alpha;
}

div.tableblock > table {
  border: 3px solid #527bbd;
}
thead {
  font-family: sans-serif;
  font-weight: bold;
}
tfoot {
  font-weight: bold;
}

div.hlist {
  margin-top: 0.8em;
  margin-bottom: 0.8em;
}
td.hlist1 {
  vertical-align: top;
  font-style: italic;
  padding-right: 0.8em;
}
td.hlist2 {
  vertical-align: top;
}

@media print {
  div#footer-badges { display: none; }
}

div#toctitle {
  color: #527bbd;
  font-family: sans-serif;
  font-size: 1.1em;
  font-weight: bold;
  margin-top: 1.0em;
  margin-bottom: 0.1em;
}

div.toclevel1, div.toclevel2 {
  margin-top: 0;
  margin-bottom: 0;
}
div.toclevel2 {
  margin-left: 2em;
}
/* Workarounds for IE6's broken and incomplete CSS2. */

div.sidebar-content {
  background: #ffffee;
  border: 1px solid silver;
  padding: 0.5em;
}
div.sidebar-title, div.image-title {
  font-family: sans-serif;
  font-weight: bold;
  margin-top: 0.0em;
  margin-bottom: 0.5em;
}

div.listingblock div.content {
  border: 1px solid silver;
  background: #f4f4f4;
  padding: 0.5em;
}

div.quoteblock-content {
  padding-left: 2.0em;
}

div.exampleblock-content {
  border-left: 2px solid silver;
  padding-left: 0.5em;
}

/* IE6 sets dynamically generated links as visited. */
div#toc a:visited { color: blue; }
</style>
<title>INSTALL</title>
</head>
<body>
<div id="header">
<h1>INSTALL</h1>
</div>
<div id="preamble">
<div class="sectionbody">
<p>If you have never installed a perl module before, you may want to seek
help from a friendly nearby perl programmer or sys admin. The
instructions below aren't guaranteed to work on all systems. These
instructions are for Linux/Unix and Mac OS X. Other users have
installed successfully on PCs before; we are unable to provide
installation instruction, but the protocols below may work.</p>
<p>You will of course need perl in order to run this; perl5.8 is required
(version 5.6.x should also work, but go-perl is no longer tested with
this setup)</p>
<p>There's a lot of instructions here. There are a number of different
ways to set up go-perl; the best way for you depends on your
experience of perl and how your system is set up. These ways are
described as different protocols below. Hopefully you should only need
to follow one protocol to get going!</p>
</div>
</div>
<h2>Protocol I - set up via CPAN installer</h2>
<div class="sectionbody">
<p>If you are already familiar with installing CPAN modules, go-perl is
no different from any other. If you aren't, you may wish to experiment
now.</p>
<p>Try typing the following:</p>
<div class="listingblock">
<div class="content">
<pre><tt>perl -MCPAN -e shell
install GO::Parser</tt></pre>
</div></div>
<p>The following may also work:</p>
<div class="listingblock">
<div class="content">
<pre><tt>cpan GO::Parser</tt></pre>
</div></div>
<p>If this is the first time using the CPAN installer, you will be asked
a barrage of questions. You are best to answer with the defaults - you
can always change this later.</p>
<p>If you do NOT have access to the system-wide perl directories on your
system (these will typically be in /Library or /usr/local), then you
should either get some help setting up CPAN for use with your system,
OR you should follow an alternate protocol below. (You may wish to
modify the value of PREFIX to ~ in the CPAN setup, as detailed in
protocol III)</p>
<p>If you are on OS X you may need to do this:</p>
<div class="listingblock">
<div class="content">
<pre><tt>sudo cpan GO::Parser</tt></pre>
</div></div>
<p>Providing you do have write-access to these directories, the above
commands should hopefully go smoothly. When installing go-perl, you
may be asked if you wish to also install Data::Stag and IO::String -
you should answer <em>yes</em></p>
<p>After this, you should be ready to use go-perl! The scripts should be
in your path and the libraries should be in the standard place. You
may wish to start by trying "map2slim" or "go2obo_xml"</p>
<p>There are certain applications that require additional third-party
modules. All these are available from CPAN, and can be installed in
the above manner. For example, if you try and use the
go-filter-subset.pl script to generate a PNG image of an ontology
subgraph, the system will complain you do not have the module
"GraphViz" installed. To install this, simply type:</p>
<div class="listingblock">
<div class="content">
<pre><tt>perl -MCPAN -e shell
install GraphViz</tt></pre>
</div></div>
<p>Depending on what you use go-perl for, you may not ever need to
install other CPAN modules</p>
</div>
<h2>Protocol II - Manual installation</h2>
<div class="sectionbody">
<p>these are step-by-step manual installation instructions. These should
be followed if protocol I does not work for you</p>
<h3>Installing required modules</h3>
<p>go-perl requires the Data::Stag module in order to run. You can
download this module from here:</p>
<p>http://search.cpan.org/~cmungall/Data-Stag/</p>
<p>(version 0.07 or higher is required; these docs assume you have
downloaded 0.08)</p>
<p>Data::Stag in turn requires the following module:</p>
<p>http://search.cpan.org/~gaas/IO-String/</p>
<p>After downloading, type the following instructions to install IO-String:</p>
<div class="listingblock">
<div class="content">
<pre><tt>cd ~
tar -zxvf IO-String-1.06
cd IO-String-1.06
perl Makefile.PL
make test</tt></pre>
</div></div>
<p>If you have permission to install system-wide, you should then type:</p>
<div class="listingblock">
<div class="content">
<pre><tt>make install</tt></pre>
</div></div>
<p>On Mac OS X, you may need to type</p>
<div class="listingblock">
<div class="content">
<pre><tt>sudo make install</tt></pre>
</div></div>
<p>If you do not have permission to install perl modules in the default
directory on your system, you need to follow protocol III</p>
<p>Once you have installed IO::String, you can install Data::Stag - the
directions are the same:</p>
<div class="listingblock">
<div class="content">
<pre><tt>cd ~
tar -zxvf Data-Stag-0.08.tar.gz
cd Data-Stag-0.08
perl Makefile.PL
make test
make install</tt></pre>
</div></div>
<p>Once you have installed Data::Stag, you are now ready to install
go-perl</p>
<div class="admonitionblock">
<table><tr>
<td class="icon">
<div class="title">Note</div>
</td>
<td class="content">There are certain applications that require additional
third-party modules (all available from CPAN); if you run into
problems running any of these applications, see the section
"Additional Modules" below</td>
</tr></table>
</div>
<h3>Installing go-perl</h3>
<p>If you are reading this, then presumably you have unpacked the
distribution - either the go-perl distribution, or the go-dev
distribution that contains go-perl.</p>
<p>To install the modules system wide, type this:</p>
<div class="listingblock">
<div class="content">
<pre><tt>cd go-perl-0.02
perl Makefile.PL
make test
make install</tt></pre>
</div></div>
<p>The first command may tell you that you have certain optional modules
missing - these may not be required. If you do require them, see
"Additional Modules" below</p>
<p>If the system complains when you type "make install" you may not have
sufficient permissions. In this case you need to use the modules from
your home directory</p>
<h3>Additional Modules</h3>
<p>You may need additional modules for running certain scripts in certain
modes. You can obtain all these from this website:</p>
<p>http://www.cpan.org/</p>
</div>
<h2>Protocol III - installing modules in your home directory</h2>
<div class="sectionbody">
<p>If you do not have sufficient permission to install system-wide, there
is a third method you can try, which is to install IO::String,
Data::Stag and go-perl in your home directory. To do this, you need to
set the PREFIX variable when installing.</p>
<p>First download Data::Stag and IO::String from CPAN, as detailed in
protocol II.</p>
<p>Then try this:</p>
<div class="listingblock">
<div class="content">
<pre><tt>setenv PERL5LIB "${PERL5LIB}:$HOME/lib/perl5/site_perl/5.8.0/
cd ~
tar -zxvf IO-String-1.06
cd IO-String-1.06
perl Makefile.PL PREFIX=~
make test
make install
cd ~
tar -zxvf Data-Stag-0.08.tar.gz
cd Data-Stag-0.08
perl Makefile.PL PREFIX=~
make test
make install
make install
cd
cd go-perl-0.02
perl Makefile.PL PREFIX=~
make test
make install</tt></pre>
</div></div>
<p>If this works, then place this in your startup file:</p>
<div class="listingblock">
<div class="content">
<pre><tt>setenv PERL5LIB "${PERL5LIB}:$HOME/lib/perl5/site_perl/5.8.0/
setenv PATH "${PATH}:$HOME/bin"</tt></pre>
</div></div>
<p>You may need to modify the above, depending on your
setup. Instructions for this are outwith the scope of this
document. Try consulting online sources, such as:</p>
<p>http://www.perl.com/pub/a/2002/04/10/mod_perl.html</p>
</div>
<h2>Additional Modules</h2>
<div class="sectionbody">
<p>Certain applications (for example, those involving XML parsing) will
require additional modules from CPAN. If you are going on to install
go-db-perl and/or AmiGO you will probably need a few extra modules.</p>
<p>If this is the case, you are strongly advised to use the CPAN
auto-installer. Once you have set this up, installing perl modules
will be <strong>much</strong> easier.</p>
</div>
<h2>To use this, type:</h2>
<div class="sectionbody">
</div>
<h2>perl -MCPAN -e shell</h2>
<div class="sectionbody">
<p>Then follow the setup instructions</p>
<p>Then type:</p>
<div class="listingblock">
<div class="content">
<pre><tt>install &lt;&lt;Module name here&gt;&gt;
quit</tt></pre>
</div></div>
<p>You can use the CPAN installer to install go-perl itself; just type</p>
<div class="listingblock">
<div class="content">
<pre><tt>perl -MCPAN -e shell
install go-perl</tt></pre>
</div></div>
<p>This is the easiest way of keeping up to date with go-perl releases</p>
</div>
<h2>Using go-perl as part of go-dev</h2>
<div class="sectionbody">
<p>go-perl is part of the wider go-dev distribution, although it can be
used independently. go-dev also includes go-db-perl (for GO MySQL DB
access) and an xml library (for converting to other XML based formats
such as OWL), the AmiGO web application and the schema for the GO
MySQL db</p>
<p>If you are using all of go-dev, you may need to alter the instructions
above (for example, your go-perl library may be unpacked in
~/go-dev/go-perl). You may also need to set GO_ROOT:</p>
<h3>The GO_ROOT environment variable</h3>
<p>If you are using go-perl as part of the wider go-dev distribution,
there are some applications that require you to specify the location
of go-dev using the GO_ROOT env var</p>
<p>bash shells:</p>
<div class="listingblock">
<div class="content">
<pre><tt>export GO_ROOT=$HOME/go-dev</tt></pre>
</div></div>
<p>other shells:</p>
<div class="listingblock">
<div class="content">
<pre><tt>setenv GO_ROOT $HOME/go-dev</tt></pre>
</div></div>
<p>It is a good idea to put this in your startup file</p>
</div>
<h2>Installing from CVS</h2>
<div class="sectionbody">
<p>You can get the latest bleeding-edge version of go-perl from the
go-dev cvs tree. See http://www.godatabase.org/dev for details</p>
<p>Once you have checked out go-dev/go-perl, do the usual thing (if
you're installing from cvs it's assumed you're a bleeding edge user
and know how to do this):</p>
<p>cd <sub>/cvs/go-dev/go-perl
perl Makefile.PL
make test
setenv GO_ROOT </sub>/cvs/go-dev
setenv PERL5LIB "$PERL5LIB:~/cvs/go-dev/go-perl"</p>
<p>The assumption is that if you are using cvs you want to use the
working copy; if you want to install from cvs, instead do the
following steps:</p>
<p>cd go-dev/go-perl
perl Makefile.PL
make GO/xsl
make test
make install</p>
<p>The "make GO/xsl" stage is not strictly necessary; if you omit it you
will get warnings. You can ignore these, but if you ever want to use
the XSL you will need to check out go-dev/xml and set the GO_ROOT
environment variaable as above.</p>
<p>Note that none of this is necessary if you install from CPAN - the
installation of the XSL is taken care of automatically</p>
</div>
<h2>Documentation</h2>
<div class="sectionbody">
<p>For full documentation, see the doc/ directory, or look online</p>
<p>http://www.godatabase.org/dev</p>
</div>
<h2>Mailing List</h2>
<div class="sectionbody">
<p>http://lists.sourceforge.net/lists/listinfo/gmod-ontol-sw-dev</p>
</div>
<h2>Installing Documentation Locally</h2>
<div class="sectionbody">
<p>it's unlikely you'll need to do this: you can always browse the pod
documentation online at:</p>
<p>http://www.godatabase.org/dev/pod</p>
<p>The documentation can be installed in a web-viewable directory; this
is best done in a directory that is visible as $BASE_URL/dev/pod</p>
<p>Just type</p>
<div class="listingblock">
<div class="content">
<pre><tt>cd go-perl
perl Makefile.PL
make pod
cp -pR pod/* $HTTP_DOCUMENT_ROOT/dev/pod</tt></pre>
</div></div>
<p>substituting HTTP_DOCUMENT_ROOT with the root path of the WWW
documents on your webserver</p>
<p>You can now browse the documentation:
http://www.yourhost.com/dev/pod</p>
<p>(You may also wish to copy the whole go-dev distribution under the
/dev/ directory)</p>
</div>
<div id="footer">
<div id="footer-text">
Last updated 01-Aug-2007 09:00:44 PDT
</div>
</div>
</body>
</html>