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
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML>
<HEAD>
<TITLE>hsc - Installation</TITLE>
<LINK REV="owns" TITLE="Thomas Aglassinger" HREF="mailto:agi@giga.or.at">
<LINK REL="Next" HREF="options.html">
<LINK REL="Copyright" HREF="copy.html">
<LINK REL="Previous" HREF="distrib.html">
<META name="ROBOTS" content="NOINDEX, NOFOLLOW">
</HEAD>
<BODY>
<A HREF="index.html"><IMG SRC="image/main.gif" ALT="Contents" ALIGN="middle" WIDTH="70" HEIGHT="16"></A>
<IMG SRC="image/noindex.gif" ALT="-----" ALIGN="middle" WIDTH="70" HEIGHT="16">
<A HREF="copy.html"><IMG SRC="image/copy.gif" ALT="Copyright" ALIGN="middle" WIDTH="70" HEIGHT="16"></A>
<A HREF="index.html"><IMG SRC="image/back.gif" ALT="Up" ALIGN="middle" WIDTH="70" HEIGHT="16"></A>
<A HREF="distrib.html"><IMG SRC="image/prev.gif" ALT="Previous" ALIGN="middle" WIDTH="70" HEIGHT="16"></A>
<A HREF="options.html"><IMG SRC="image/next.gif" ALT="Next" ALIGN="middle" WIDTH="70" HEIGHT="16"></A>
<HR>
<H1>Installation</H1>
This chapter will explain where all the files coming with the
archive should end up.
<H2>AmigaOS</H2>
Because there is not much to do, there is no installer script. You
will have to perform some simple steps the first time you install
<KBD>hsc</KBD>. If the descriptions below are not sufficient for you to figure
out what to do, you do not want to use this tool anyway.
<H3>Simple Installation</H3>
<P>It's recommended to leave the whole <KBD>hsc</KBD> directory in one piece.
Therefor extract the archive somewhere to your hard disk,
for example to <I>work:hsc</I>.</P>
You now have to add this directory to your workbench search path.
This can be performed adding a line like the one you can find
below to your <I>user-startup</I>
<PRE>Path work:hsc ADD</PRE>
After rebooting, you can open a CLI and type in ``<KBD>hsc
help</KBD>'', and <KBD>hsc</KBD> should come up with a short information
message.
<H3>Minimum Installation</H3>
<P>For a minimum installation, only <I>hsc</I> and <I>hsc.prefs</I>
are required. If you want to utilize the project management capabilities of
<KBD>hsc</KBD>, also <KBD>hscdepp</KBD> and <KBD>hscpitt</KBD> are needed.</P>
<P>Copy the binaries to somewhere in your workbench search path (for
example, to <I>c:</I>) and <I>hsc.prefs</I> anywhere else and set
<A HREF="envvar.html#hscpath"><VAR>HSCPATH</VAR></A> according to this.</P>
<H3>Making It Resident</H3>
<P>All binaries should already have the the pure bit set. If not, you
can do this by entering</P>
<PRE>
protect hsc/hsc add p
protect hsc/hscdepp add p
protect hsc/hscpitt add p
</PRE>
<P>in CLI.</P>
<P>To make the binaries resident on every startup, add the lines</P>
<PRE>
resident hsc
resident hscdepp
resident hscpitt
</PRE>
<P>to the <I>user-startup</I>.</P>
<P><STRONG>Important:</STRONG> For resident programs,
<CODE>PROGDIR:</CODE> is not defined. You will have to take care that
<KBD>hsc</KBD> is able to find <I>hsc.prefs</I> before it tries to scan
<CODE>PROGDIR:</CODE> for it. This can be done by by setting the
environment variable <A HREF="envvar.html#hscpath"><VAR>HSCPATH</VAR></A> or by placing <I>hsc.prefs</I> in the
current directory for every project. Otherwise you will notice an
annoying requester, which will ask you to ``insert volume
PROGDIR: into any drive''.</P>
<H2>RiscOS</H2>
For the RiscOS distribution, you can find a file called
<I>ReadMe</I> in the directory <I>riscos</I> explaining
these details.
<H2>NeXTStep, AmigaOS/ixemul, BeOS, Unixoid Systems</H2>
<P>Maybe you will have to compile the sources yourself. Refer to
the chapter about the <A HREF="source.html">Source Code</A> for
details.</P>
<P>For installation, the first few lines of this <I>Makefile</I> are
interesting for you. They define two symbols you might want to change.
<CODE>INSTALL</CODE> specifies the <KBD>install</KBD> program to be
used. Normally the default should be fine.</P>
<P>An exception of this is when you want to compile for <A
HREF="ports.html#amixemul">AmigaOS/ixemul</A>. In
this case you maybe want to set <CODE>INSTALL=/bin/install</CODE> or
otherwise <I>sys:c/install</I> will be used, which does a
completely different job - it makes a disk bootable.</P>
<P>The default for <CODE>INSTDIR</CODE> will attempt to to copy the
binaries to <I>/usr/bin/</I> and some other data to
<I>/usr/lib/</I>. This will only work if you have write access
to these directories.</P>
If you are normal luser, you can modify this symbol to for instance
<PRE>INSTDIR = $(HOME)/</PRE>
Make sure that you also have created <I>$HOME/bin/</I> and
<I>$HOME/lib/</I> before starting the installation process. Or
maybe you prefer
<PRE>INSTDIR = /usr/local</PRE>
because of philosophical reasons I never really understood. In any
case, a
<PRE>make install</PRE>
should copy all files to the desired locations.
</BODY></HTML>
|
