Reshaped doc's
[fw/sdcc] / doc / sdccman.html / node15.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
2
3 <!--Converted with LaTeX2HTML 99.1 release (March 30, 1999)
4 original version by:  Nikos Drakos, CBLU, University of Leeds
5 * revised and updated by:  Marcus Hennecke, Ross Moore, Herb Swan
6 * with significant contributions from:
7   Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
8 <HTML>
9 <HEAD>
10 <TITLE>2.5 Additional Information for Windows Users</TITLE>
11 <META NAME="description" CONTENT="2.5 Additional Information for Windows Users">
12 <META NAME="keywords" CONTENT="sdccman">
13 <META NAME="resource-type" CONTENT="document">
14 <META NAME="distribution" CONTENT="global">
15
16 <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
17 <META NAME="Generator" CONTENT="LaTeX2HTML v99.1 release">
18 <META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
19
20 <LINK REL="STYLESHEET" HREF="sdccman.css">
21
22 <LINK REL="next" HREF="node16.html">
23 <LINK REL="previous" HREF="node14.html">
24 <LINK REL="up" HREF="node10.html">
25 <LINK REL="next" HREF="node16.html">
26 </HEAD>
27
28 <BODY >
29 <!--Navigation Panel-->
30 <A NAME="tex2html431"
31  HREF="node16.html">
32 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next_motif.gif"></A> 
33 <A NAME="tex2html425"
34  HREF="node10.html">
35 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up_motif.gif"></A> 
36 <A NAME="tex2html419"
37  HREF="node14.html">
38 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="previous_motif.gif"></A> 
39 <A NAME="tex2html427"
40  HREF="node1.html">
41 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents_motif.gif"></A> 
42 <A NAME="tex2html429"
43  HREF="node61.html">
44 <IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index_motif.gif"></A> 
45 <BR>
46 <B> Next:</B> <A NAME="tex2html432"
47  HREF="node16.html">2.6 SDCC on Other</A>
48 <B> Up:</B> <A NAME="tex2html426"
49  HREF="node10.html">2. Installation</A>
50 <B> Previous:</B> <A NAME="tex2html420"
51  HREF="node14.html">2.4 Install Trouble-shooting</A>
52  &nbsp <B>  <A NAME="tex2html428"
53  HREF="node1.html">Contents</A></B> 
54  &nbsp <B>  <A NAME="tex2html430"
55  HREF="node61.html">Index</A></B> 
56 <BR>
57 <BR>
58 <!--End of Navigation Panel-->
59 <!--Table of Child-Links-->
60 <A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
61
62 <UL>
63 <LI><A NAME="tex2html433"
64  HREF="node15.html#SECTION00035100000000000000">2.5.1 Getting started with Cygwin</A>
65 <LI><A NAME="tex2html434"
66  HREF="node15.html#SECTION00035200000000000000">2.5.2 Running SDCC as Native Compiled Executables</A>
67 </UL>
68 <!--End of Table of Child-Links-->
69 <HR>
70
71 <H2><A NAME="SECTION00035000000000000000">
72 2.5 Additional Information for Windows Users</A>
73 </H2>
74
75 <P>
76  
77 <I>&lt;pending: is this up to date?&gt;</I>
78 <BR>
79 <BR>
80 The standard method of installing on a Unix system involves compiling
81 the source package. This is easily done under Unix, but under Windows
82 it can be a more difficult process. The Cygwin is a large package
83 to download, and the compilation runs considerably slower under Windows
84 due to the overhead of the Cygwin tool set. An alternative is to install
85 a pre-compiled Windows binary package. There are various trade-offs
86 between each of these methods. 
87
88 <P>
89 The Cygwin package allows a Windows user to run a Unix command line
90 interface (bash shell) and also implements a Unix like file system
91 on top of Windows. Included are many of the famous GNU software development
92 tools which can augment the SDCC compiler.This is great if you have
93 some experience with Unix command line tools and file system conventions,
94 if not you may find it easier to start by installing a binary Windows
95 package. The binary packages work with the Windows file system conventions.
96
97 <P>
98
99 <H3><A NAME="SECTION00035100000000000000">
100 2.5.1 Getting started with Cygwin</A>
101 </H3>
102
103 <P>
104 SDCC is typically distributed as a tarred/gzipped file (.tgz). This
105 is a packed file similar to a .zip file. Cygwin includes the tools
106 you will need to unpack the SDCC distribution (tar and gzip). To unpack
107 it, simply follow the instructions under the Linux/Unix install section.
108 Before you do this you need to learn how to start a cygwin shell and
109 some of the basic commands used to move files, change directory, run
110 commands and so on. The change directory command is <I><B>``cd''</B></I>,
111 the move command is <I><B>``mv''</B></I>. To print the current
112 working directory, type <I><B>``pwd''</B></I>. To make a directory,
113 use <I><B>``mkdir''</B></I>.
114
115 <P>
116 There are some basic differences between Unix and Windows file systems
117 you should understand. When you type in directory paths, Unix and
118 the Cygwin bash prompt uses forward slashes '/' between directories
119 while Windows traditionally uses '&#92;' backward slashes.
120 So when you work at the Cygwin bash prompt, you will need to use the
121 forward '/' slashes. Unix does not have a concept of drive letters,
122 such as ``c:``, instead all files systems attach and appear
123 as directories.
124
125 <P>
126
127 <H3><A NAME="SECTION00035200000000000000">
128 2.5.2 Running SDCC as Native Compiled Executables</A>
129 </H3>
130
131 <P>
132 If you use the pre-compiled binaries, the install directories for
133 the libraries and header files may need to be specified on the sdcc
134 command line like this: <I><B>&#34;sdcc -L c:&#92;usr&#92;local&#92;sdcc&#92;lib&#92;small
135 -I c:&#92;usr&#92;local&#92;sdcc&#92;include
136 test.c&#34;</B></I> if you are running outside of a Unix bash shell.
137
138 <P>
139 If you have successfully installed and compiled SDCC with the Cygwin
140 package, it is possible to compile into native .exe files by using
141 the additional makefiles included for this purpose. For example, with
142 the Borland 32-bit compiler you would run <I><B>&#34;make
143 -f Makefile.bcc&#34;</B></I>. A command line version of the Borland
144 32-bit compiler can be downloaded from the Inprise web site.
145
146 <P>
147 <HR>
148 <!--Navigation Panel-->
149 <A NAME="tex2html431"
150  HREF="node16.html">
151 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next_motif.gif"></A> 
152 <A NAME="tex2html425"
153  HREF="node10.html">
154 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up_motif.gif"></A> 
155 <A NAME="tex2html419"
156  HREF="node14.html">
157 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="previous_motif.gif"></A> 
158 <A NAME="tex2html427"
159  HREF="node1.html">
160 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents_motif.gif"></A> 
161 <A NAME="tex2html429"
162  HREF="node61.html">
163 <IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index_motif.gif"></A> 
164 <BR>
165 <B> Next:</B> <A NAME="tex2html432"
166  HREF="node16.html">2.6 SDCC on Other</A>
167 <B> Up:</B> <A NAME="tex2html426"
168  HREF="node10.html">2. Installation</A>
169 <B> Previous:</B> <A NAME="tex2html420"
170  HREF="node14.html">2.4 Install Trouble-shooting</A>
171  &nbsp <B>  <A NAME="tex2html428"
172  HREF="node1.html">Contents</A></B> 
173  &nbsp <B>  <A NAME="tex2html430"
174  HREF="node61.html">Index</A></B> 
175 <!--End of Navigation Panel-->
176 <ADDRESS>
177 <I>Johan Knol</I>
178 <BR><I>2001-07-13</I>
179 </ADDRESS>
180 </BODY>
181 </HTML>