[GRASSweb-list]markus: web/platforms macgrass.html,NONE,1.1 macosx_grass50compile.html,NONE,1.1 grasshandheld.html,NONE,1.1 menu_side.inc,NONE,1.1 GRASS.MacOSX.binnote.html,NONE,1.1 grass5_on_zaurus.html,NONE,1.1 wingrass.html,NONE,1.1 title.inc,NONE,1.1 m

grass at intevation.de grass at intevation.de
Sun Dec 19 11:50:28 EST 2004


Author: markus

Update of /grassrepository/web/platforms
In directory doto:/tmp/cvs-serv9282

Added Files:
	macgrass.html macosx_grass50compile.html grasshandheld.html 
	menu_side.inc GRASS.MacOSX.binnote.html grass5_on_zaurus.html 
	wingrass.html title.inc macosx_buildnotes.html index.php 
Log Message:
new PHP based pages added

--- NEW FILE: macgrass.html ---
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
           
  <DEFANGED_meta content="text/html; charset=iso-8859-1"
 http-equiv="Content-Type">
           
  <DEFANGED_meta content="Scott Mitchell" name="Author">
           
  <DEFANGED_meta content="GRASS, GIS, Macintosh" name="KeyWords">
           
  <DEFANGED_link href="../sitestyle.css" type="text/css" rel="stylesheet">
  <title>GRASS GIS 5.0 on Macintosh Information</title>
</head>
  <body>
     
<center>   
<h1>   
<hr width="100%" noshade="noshade" size="3">GRASS 5 on Mac OS X</h1>
   <b>N.B.  This document is preliminary, incomplete, and goes out of date
 with alarming frequency.  Please contact Scott Mitchell ("smitch at mac dot com")
 with suggestions or questions about the document.</b><br>
   (DRAFT version - Apr 28, 2004)<br>
   <br>
   </center>
     
<p> </p>
     
<hr width="100%" noshade="noshade" size="3">   
<h1>GRASS GIS on Mac OS X<br>
   </h1>
   GRASS on Mac OS X shares all the functionality enjoyed on other UNIX-
or Linux-based platforms.&nbsp; There are quirks to the operating system
that occasionally pose challenges when new features are added or changed
in the GRASS source code, but these are usually sorted out promptly.&nbsp;
In addition, due to the fact that Mac OS X has evolved quite differently
from other UNIX systems, there is a variety of ways to get GRASS installed
on a Mac.&nbsp;  This page is an attempt to help you navigate through the
options.&nbsp; Some assumptions are made about your familiarity with GRASS,
in that we are not re-explaining things here that are found in other pages
on the GRASS web site.<br>
   <br>
   <br>
     
<h1>Main Issues: &nbsp;UNIX/X11-based or Aqua-based ?<br>
   </h1>
   No matter which method you choose to get GRASS working on your system, 
the following issues may come up. &nbsp;MacOS X has a split heritage - the 
user interface that came from the marriage of Apple and NeXT, and the UNIX 
tradition that came in through FreeBSD. &nbsp;This means that there are multiple
alternatives for developing user interfaces to applications. &nbsp;GRASS comes
from a UNIX and X11 heritage. &nbsp;The tools that are used in the standard
(i.e. shared with other platforms) GRASS user interface are now all readily
available on the Mac, but there are also alternatives. &nbsp;<br>
  <br>
  Therefore, building GRASS requires a decision on whether or not GRASS will
use features that are exclusive to Apple's graphic interface ("Aqua").&nbsp;
This allows more seamless integration in to the Apple environment, but requires
work "outside" of the main GRASS development to make it work.&nbsp; If you
use the <a href="http://www.r-project.org">R statistics package</a>, this
may sound familiar - there have long been projects alongside the main development
stream to enhance R by using capabilities of the Mac environment.&nbsp;
For  GRASS, such work has been concentrated in the efforts of Joshua Lecock's
 <a href="http://openosx.com/grass/">Open OS X port of GRASS</a>, which uses
an Aqua version of the Tcl/Tk interface so that the menuing system has a
consistent look and feel to other Macintosh products.&nbsp; It also provides
a software installation CD, subscription and support options, and various
bundles with other traditonally-UNIX software packages.  A <a
 href="http://grasstep.sourceforge.net">Sourceforge project for porting GRASS to 
Quartz and GNUstep</a> has also been started, and is looking for programmers, 
if you have the skills and interest.<br>
   <br>
   The alternative approach is to stick with the X11 interface that is shared
 amongst other UNIX systems, in which case GRASS will look and behave pretty
 much the same as on other platforms.&nbsp; In the past, this required the
 user to have X11 from another source installed and running properly, but
now (as of OS 10.3 "Panther") Apple includes X11 with the operating system,
combining XFree86 with a window manager that is integrated with the Aqua
graphics system.&nbsp; So if you have this version of the operating system,
the windows that you run GRASS in can now all be part of the normal Mac windowing
system, although if you want the graphical menuing system (which is an optional
way to run GRASS), it will use standard X11-based Tcl/Tk, and requires that
you have that installed separately.&nbsp; If you are still using OS 10.2
("Jaguar"), you can install X11 separately a number of ways (see below).<br>
   <br>
  In recent discussions on the GRASS development mailing list, it has been
 noted that things would be simpler if tcltkgrass, the GRASS menuing system,
 were modified so that it could be used without modification in the Aqua
port  of Tcl/Tk instead of requiring the UNIX version. &nbsp;So this may
be changed  in the near future, but in the meantime the issues above still
apply. &nbsp;It  has also been noted that the NVIZ visualization tool will
continue to require  the UNIX version of Tcl/Tk.<br>
  <br>
  These issues have contributed to the variety of versions you can install,
 whether you choose a binary installation or to compile from source. &nbsp;The
 prerequisites for each option vary slightly.<br>
     
<h1>Prerequisites</h1>
   All platforms require a number of external packages to make GRASS work, 
either at all, or to its full potential.&nbsp; Some of these are provided 
in a base Mac OS X system (the number of which has gone up over time), whereas 
others are easily available as downloaded binaries or source code.&nbsp; The
requirements for compiling the software yourself are more complicated and
are discussed first.&nbsp; If you are going to install pre-compiled binaries 
you can skip to the "Binaries" section of this document.<br>
   <br>
   <span DEFANGED_STYLE="text-decoration: underline;"><span
 DEFANGED_STYLE="font-weight: bold;">Requirements to compile GRASS:</span></span><br>
   <br>
   If you are going to do any compiling of software, you will need the development
 tools, available free from Apple.&nbsp; This package was called Development
 Tools for OS X versions 10.0-10.2, and "Xcode tools" when 10.3 ("Panther")
 was released.&nbsp; It is on a separate install CD in the Panther package
 and either on CD or available for download for earlier versions.<br>
   <br>
   The general prerequisites for all platforms are listed in the 
   <a href="../grass54/source/REQUIREMENTS.html">GRASS requirements page</a>.&nbsp;
   Of these, all of the aboslutely required elements (e.g.
the  compiler/build system, and the zlib libraries) are provided by Apple.&nbsp; 
 As discussed above, the X11 window system is provided by Apple as an optional
 install starting in OS X 10.3.&nbsp; For Mac OS X 10.2 (or earlier), you
can install XFree86 using the <a href="http://fink.sourceforge.net">fink</a>
or <a href="http://darwinports.opendarwin.org">DarwinPorts</a> package manager
 systems, or compile it yourself from source.<br>
   <br>
   The package manager systems are an easy way to find, compile where necessary,
 and install ports of unix software on to a Mac OS X system.&nbsp; If you
have used Cygwin on a Windows machine, or RedHat, Debian, etc. on a Linux
machine, you are probably already aware of their package managers.&nbsp;
On the Mac, you can choose from at least <a
 href="http://fink.sourceforge.net">fink</a> or <a
 href="http://darwinports.opendarwin.org">DarwinPorts</a>.&nbsp; Fink uses
the same tools as Debian Linux (apt-get, dpkg).&nbsp; DarwinPorts is more
similar to the FreeBSD Ports project.&nbsp; The initial author of this document
chose fink because I was already used to Debian, but others have also reported
satisfaction with DarwinPorts.&nbsp; You should read the web pages for those
two projects to learn about the differences between them, and how to install
and use them.<br>
   <br>
   <span DEFANGED_STYLE="font-weight: bold; text-decoration: underline;">Optional
requirements  </span><span DEFANGED_STYLE="text-decoration: underline;">(as listed
in the </span><span
 DEFANGED_STYLE="font-weight: bold; text-decoration: underline;"> <a
 href="../grass54/source/REQUIREMENTS.html">GRASS requirements page</a>)</span><span
 DEFANGED_STYLE="font-weight: bold;"><span DEFANGED_STYLE="text-decoration: underline;">:</span><br>
   <br>
   </span>As of OS X version 10.3, Apple provides suitable versions of FreeType
 2 and OpenGL (if you have the Apple X11 installed).<br>
   <br>
   The rest of the optional requirements can be downloaded as source and
compiled  "manually", or installed with either of the package management
systems (is this true of all the packages in DarwinPorts?).&nbsp; In fink,
the packages you would need are:&nbsp; libtiff libtiff-shlibs libpng3 libpng3-shlibs
libjpeg libjpeg-shlibs tcltk tcltk-dev tcltk-shlibs gd2 gd2-shlibs <span
 DEFANGED_STYLE="font-style: italic;">gdal gdal-dev gdal-shlibs</span> (but see special
 note re: GDAL below) netpbm netpbm-shlibs postgresql postgresql73-dev unixodbc2 
 unixodbc2-dev, and&nbsp; r-base (for the R language link to GRASS - note
 that this installs the X11/UNIX version of R, not the Aqua version).&nbsp;&nbsp;
 <br>
   <br>
   <span DEFANGED_STYLE="font-weight: bold;">GDAL</span> deserves special mention, 
because the version that is generally available either as "released" source 
code, or as a fink package as of this writing is quite far behind the current 
development version, and it is the current versions of GDAL that are used 
in GRASS development.&nbsp; This tool and its use in GRASS is updated quite 
frequently, therefore if you don't have the most recent version of GDAL when 
you are trying to compile GRASS, there's a good chance that r.in.gdal compilation 
will fail, or that the tool will not work as expected.&nbsp; Therefore it 
is recommended that  you install a relatively recent binary version of GDAL 
(e.g. <a href="http://wwwamb.bologna.enea.it/forgrass">http://wwwamb.bologna.enea.it/forgrass</a> 
 )or compile from a recent version of the <a
 href="http://gdal.org">sources available via anonymous
 CVS</a>.&nbsp; The r.in.gdal command is extremely useful for importing a
wide variety of spatial data formats, so it is worthwhile spending the extra
effort to get this working if you will have any data import tasks.<br>
   <br>
  Tcl/Tk is required for the tcltkgrass menu/GUI system, and for the NVIZ 
visualization tool. &nbsp;At this time, GRASS distributed from the GRASS project
sites does not work with the Tcl/Tk that is available for Apple's Aqua window
environment, so you will need the UNIX version of Tcl/Tk to build GRASS from
source. &nbsp;Hopefully, changes will soon be made that would allow tcltkgrass
to use <a href="http://www.maths.mq.edu.au/%7Esteffen/tcltk/TclTkAqua/">Aqua
Tcl/Tk</a>,  but apparently making NVIZ work would be much more complicated
(see mailing  list traffic on this topic). &nbsp;You can install the tcltk
package from  fink, or it can be easily built from source (get source from
<a href="http://sourceforge.net/project/showfiles.php?group_id=10894">the
Tcl/Tk  sourceforge project</a>. &nbsp;<br>
  <br>
  The <a href="http://www.remotesensing.org/proj/">PROJ library</a> also
builds  cleanly from source on the Mac platform.<br>
  <br>
 Some additional notes on configuring GRASS to compile on a Mac are now available 
<a href="macosx_grass50compile.html">here</a> - additional contributions welcome.  William Kyngesburye provides his experiences and instructions for building GRASS <a href="http://webpages.charter.net/kyngchaos/macosx/grassinstall.html">here</a>.  His approach includes downloading and compiling the required prerequisites as well, but should also be useful if you're using a package manager.<br>
  <br>
   <span DEFANGED_STYLE="text-decoration: underline;"><span
 DEFANGED_STYLE="font-weight: bold;">Binary releases of GRASS for Mac OS X</span></span><br>
   <br>
  1) <u>&nbsp;Binary releases from the GRASS site</u> - There are binary
  packages  available from the <a href="../download/index.php">GRASS downloads area</a>
of  this site. &nbsp;When these binary packages are constructed, reasonable
efforts  are made to package everything you need into a single download and
install  process.&nbsp; For example, the GDAL library discussed above is
included.&nbsp;  Some of the other GRASS modules that interface with other
software packages  will require separate installations for normal functionality.&nbsp;
Such external packages include PostgreSQL (for the PostgreSQL database interface),
Unix ODBC (for the ODBC database interface), and Tcl/Tk 8.x (for the graphical
 menu system and the NVIZ visualization tool).&nbsp; In addition, the Tcl/Tk
 is sometimes version-sensitive, therefore your installation version may
need  to match that used by the person that made the binaries. &nbsp;There
are 2 files to download, a large compressed archive with the required files
(a .tar.gz file), and a script file that will manage the installation process.
&nbsp;You need to download both files intact (i.e. don't let your browser
call on Stuffit Expander or any other decompression tool to process the .tar.gz
file), and then go to a Terminal window to run the install script. &nbsp;See
the README file in the download area for further details.&nbsp; <b>Pros/cons</b>
- this method provides the closest experience to those on other platforms.
&nbsp;Therefore instructions that you may see in other web pages or in books
about GRASS will match as closely as possible. &nbsp;On the other hand, this
takes advantage of very little of the "extra features" of the Mac OS - you
need to use the UNIX terminal to install and run GRASS, and you need to have
the extra packages mentioned above for full functionality. &nbsp;If you are
going to do any other UNIX work on your machine, however, these other tools
will be generally useful, and if you are one of the "new Mac users" that
came to Macs from UNIX platforms, this is probably the most familiar route
for you. &nbsp;This option is also most likely to be the quickest to incorporate
the latest developments in the main GRASS code.<br>
   <br>
   Note that the package managers discussed in the above section on installing
 from source code can also be useful for installing these extra software
packages.&nbsp;  In some cases they will allow you to stick with "all-binary"
installations,  not requiring anything to be compiled - fink, for example,
can do this using  the apt-get command or using the "<a
 href="http://finkcommander.sf.net">Fink  Commander</a>" graphical package
management tool.&nbsp; Even if what you are after is not available in a binary
format, the package managers provide an "intermediate" solution, in that
as long as you have the development environment  installed, they can take
care of the downloading and compiling of the sources  and the installation
of the resulting binaries automatically. &nbsp;If you  use Fink Commander,
this is all managed within the Mac GUI, without having  to navigate a UNIX
shell prompt.<br>
   <br>
  2) <u>GRASS from Fink</u> -  it should be noted that <a
 href="http://fink.sourceforge.net/pdb/package.php/grass">GRASS itself is
 available as a package, in the Fink system</a>, although as of this writing
 it is also still at version 5.0.2. &nbsp;It would be wonderful to get that
 updated, and to also have packages that install the development version
5.3  and the experimental 5.7. &nbsp;But all of this requires scarce volunteer
 time.<br>
  <br>
  3) &nbsp;<u>Open OS X</u> - The <a href="http://openosx.com/grass/">Open
 OS X port of GRASS</a> is a binary release with extra functionality, but
its maintenance and documentation is a parallel, separate activity (which
has contributed back some very useful fixes to the main GRASS project).&nbsp;
 As of this writing, it is still using version 5.0.2 of GRASS.<br>
  <br>
  4) &nbsp;<u>Lorenzo Moretti's "one stop" solution</u> - A relatively new
 solution has recently been made available from Lorenzo Moretti, at <a
 href="http://wwwamb.bologna.enea.it/forgrass/">http://wwwamb.bologna.enea.it/forgrass/</a>
 which provides all of the software you need to run GRASS 5.3 and GRASS 5.7
 on any Mac with OS 10.2.8 or higher and Apple's X11 installed. &nbsp;I have
 not had a chance to try this yet, but it looks very promising. &nbsp;I gather
 he has adopted many conventions that will be more familiar to longtime Apple
 users (e.g. the programs are installed under /Applications instead of the
 usual /usr/local/grass5X), and it comes in the form of "one-click" Apple
"packages" (.pkg files) so installation is simple. &nbsp;This is probably
a good option for those wanting to try GRASS that are wary about / inexperienced
with UNIX or other command-prompt driven operating systems.<br>
  <br>
  5) &nbsp;More? &nbsp;This list, and the impressions within it, reflect
the  initial author's personal experience and biases. &nbsp;<a
 href="mailto:weblist at grass.itc.it">Feedback and additional information is
 highly encouraged</a>.<br>
  <br>
   <b>This is still an initial draft document - the rest of this page is
"leftovers"...<br>
  <br>
  &nbsp;is still</b><b><a href="GRASS.MacOSX.binnote.html"> Other info to 
incorporate</a></b> and <a href="macosx_buildnotes.html">even more</a>.<br>
<p><b>   Download source code (to compile GRASS from scratch on Windows):</b>
</p>
     
<ul>
	<li>Get the latest <a href="../download/index.php">GRASS 5 sources.</a></li>
     <li> <a href="macosx_grass50compile.html">Instructions on how to compile</a>
 GRASS 5.0 on Mac OS X.</li>
     
</ul>
     
<hr width="100%" noshade="noshade" size="3">   

<h3>A FAQ section would be good here - Suggestions for FAQ's welcome.</h3>
     

<!-- FOOTER -->
<hr>
<DIV ALIGN=right>&copy; 2003 GRASS Development Team<br>
 <a href="mailto:weblist at grass.itc.it">Comments</a> about this page |
 <a href="../faq/index.html">FAQ</a> |
 <a href="../download/index.php">Download</a> |
 <a href="../community/index.php">Support</a> |
 <a href="../gdp/index.php">Docs</a>  |
 <a href="../devel/index.php">Programming</a> |
 Back <a href=../index.php>HOME</a><br>
 <i>Last change:
 $Date: 2004/12/19 16:50:26 $
 </i></DIV>
       

</body>
</html>

--- NEW FILE: macosx_grass50compile.html ---
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
  <title></title>
</head>
  <body>
   <b></b> 
<p><b>Initial Notes:</b> </p>
 
<p>A comprehensive review of, or set of instructions for, compiling GRASS 
on a Mac is not here yet.  In the meantime, here are some notes put together 
by Scott Mitchell (smitch AT mac dot com).  Suggestions / additions welcome. 
&nbsp;See also <a href="macosx_buildnotes.html">material compiled by others</a>, 
not yet incorporated here. </p>
 
<p>Compiling GRASS under Mac OS X requires the development tools to be installed. 
 This is a separate package if you installed OS X yourself, and depending 
on the software version, it is either on one of the install disks, or you 
need to download it from Apple (it's free).  If OS X came pre-installed on 
your computer, the developer tools may have been installed for you, depending 
on the computer model and when it was purchased.  If not, they may be on a
CD that came with the computer, and if not you also need to download them 
from Apple. </p>
 
<p>Two checks I can think of off the top of my head to see if they are installed 
are to (1) check to see if you have a /Developer directory in your boot drive, 
or (2) at a command line prompt, type the command gcc and press enter - if 
you get a "Command not found" error, or something to that effect, you likely 
don't have the tools installed.  If you get "gcc: no input files", then you've 
got the tools. </p>
 
<p>Beyond having the necessary compilers and libraries provided by the development 
environment, you also need all of the other <a
 href="../grass5/source/REQUIREMENTS.html">prerequisites</a> for GRASS.  If
you are experienced in building Unix/Linux applications, you may elect to
obtain and compile them all yourself.  Otherwise, you will probably want to
use some form of packaging system.  In either case, refer back to the main
<a href="macgrass.html">GRASS on Mac page</a> for more details. </p>
 
<p>Once you have all the prerequisities in place, compiling GRASS is relatively
 straightforward, or at least it's pretty much the same on this platform
as others, except perhaps that some required libraries are in non-standard
locations  from the point of view of other platforms.  For example, if you
have used FINK  to install related tools, those will be located under the
/sw directory.  Some of the required bits are provided by Apple and are typically
under /usr, and if you compiled and installed anything manually, it may be
under /usr/local.  </p>
 
<p>For more compilation advice, until I receive any other great suggestions,
 the best I can offer is to show the procedure I have been using successfully
 on my own machines. </p>
 
<p> I have most of the required extras installed by fink.  These include the
graphics libraries, Postgresql, unixodbc, FFTW, lesstif, and libdl.  Freetype
is provided by Apple's X11 on my Panther machines, and by fink on the Jaguar
one (which also  has XFree86 provided by fink instead of by Apple).  I have
compiled PROJ4 and GDAL myself and installed them in to the default /usr/local
hierarchy, mostly using the instructions and defaults that come with those
packages.  So for  PROJ I just did the typical set of commands to compile
it: </p>
 
<pre>	./configure<br>	make<br>	sudo make install </pre>
  For GDAL, there was a small change, which was necessary at one time to
get  the compile to work for Macs - I don't know if that is still the case,
but  it's safe to keep it this way as far as GRASS compatibility:  
<pre>	./configure --with-python=no </pre>
  and then it gets standard:  
<pre>	make<br>	sudo make install<br></pre>
   
<p>Next, I'm ready to set up the GRASS compile, in the GRASS source directory.
 Note that I'm assuming that you've obtained and extracted the source, and 
have read all the directions that come with it - this document is not duplicating
 any of the other directions on this site, just pointing out parts that may 
be different than on other systems. </p>
 
<p>So first I need to configure the build so that it finds all my extra libraries. 
 Instead of typing in the location for ALL of the libraries that are provided 
by my FINK installation, I use the generic --with-includes= and --with-libs= 
to tell configure to add the /sw/[lib,include] directories to all of its searches
for the requirements.  Some of the other switches used are described below.
</p>
 
<p>So my configure command (copied from my last compile of v5.3-cvs) is:
</p>
 
<pre>./configure  --with-includes="/usr/X11R6/include /sw/include" \<br>	--with-libs="/usr/X11R6/lib /sw/lib" --with-motif --with-glw \<br>	--with-postgres=yes --with-gdal=/usr/local/bin/gdal-config \<br>	--with-proj --with-freetype \<br>	--with-freetype-includes=/usr/X11R6/include/freetype2 --enable-64-bit \<br>	--enable-shared --with-gd \<br>	--with-postgres-includes=/sw/include/postgresql \<br>	--with-postgres-libs=/sw/lib/postgresql/<br>	<br></pre>
   
<p>Notes on the above command: </p>
 
<ul>
   <li>This starts the configure command which will run through a series
of tests, looking for capabilities of your development environment and locations
and versions of the required libraries, etc - it sets up a compilation configuration
which is drawn on by the make program (next step) to do the actual compile.</li>
  <li>This is actually all one command, split in to multiple lines to make
it easier to see and/or copy/paste. &nbsp;The "\" at the end of each line
tells the shell that you enter the command in to that the command will be
continued on the next line. &nbsp;You can either copy and paste each of these
lines as they are shown above, or enter it all as one command line (in which
case, skip the "\" characters).<br>
  </li>
  <li>The --enable-64-bit is because this was on a G5 computer, so if anything 
in the code can take advantage of the 64 bit platform, that turns it on. 
To be honest, I haven't checked to see if this actually does anything yet. 
 If you are doing this on a G4, skip that one.</li>
  <li>The --enable-shared tells GRASS to build shared versions of the GRASS 
 libraries instead of building them in to each binary module, resulting in 
 much smaller files being built.  I THINK this actually now depracated in 
that this is not the default for modern versions of GRASS 5.3 and higher. 
 If you want to do my homework and check that for me, search the mailing list
archives, the relevant post is probably by Paul Kelly or Glynn Clements. 
In any case, it doesn't hurt to leave it in here. </li>
 
</ul>
   
<p>After that, the </p>
 
<pre>make</pre>
  command builds the software.  Check the error log file. If all looks good, 
<pre>sudo make install</pre>
  will put everything in place.   
<p>Congratulations!</p>
   
<p>Please do get back to me using "smitch at mac dot com" with suggestions 
or problems regarding these instructions. </p>
 
<p>Scott </p>
 <br>
 <br>
<b>Extra notes:</b>
<ul>
<li>If you use the alternate build system in grass 5.3 (i.e. use the <pre>--enable-gmake=no</pre> switch to configure), you will get an error when the man pages are built.  This is because OS X uses the BSD version of man and it does not support the same syntax as GNU man (used on Linux).  To get around this, set the environment variable MAN2CAT to <pre>groff -Wall -t -Tlatin1 -mandoc</pre> before the make command.  So do the following instead of just make:
<pre>make MAN2CAT='groff -Wall -t -Tlatin1 -mandoc'</pre>
<br>

</body>
</html>

--- NEW FILE: grasshandheld.html ---
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
   <DEFANGED_meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
   <DEFANGED_META Name="keywords" Content="gis, GIS, GRASS, open source, free
         software, Geographical Information System, PDA, handheld">
   <DEFANGED_meta name="Author" content="Markus Neteler">
   <DEFANGED_link rel="stylesheet" type="text/css" href="sitestyle.css">
   <title>GRASS GIS on Handhelds</title>
</head>
<body>

<!-- HEADER -->
<table width=100%><tr><td width=80>
<A HREF="index.html">
<DEFANGED_IMG src="../images/grass.smlogo.gif" alt="HOME" border="0" align=middle></A>
</td><td><H1>
GRASS GIS on Handhelds
</H1></td></tr></table>
<!-- END OF HEADER -->

<a href="../images/ipaq_grass.jpg"><DEFANGED_IMG SRC="../images/ipaq_grasssmall.png"
border=1 alt="GRASS on iPAQ/Linux"></a><p>
<i>Image: GRASS on iPAQ/Linux
(Photo: Jan Stankovic/MN, ITC-irst)</i><p>

The GRASS Development Team proudly announces that
GRASS is available now for iPAQ/Linux handhelds.<br>
We are grateful to Compaq for providing support to us to prepare the binary
version. It has been reported that the same binary also runs on Sharp/Zaurus
machines 
<p>

<a href="../images/zaurus_grass.jpg"><DEFANGED_IMG SRC="../images/zaurus_grass_small.jpg"
border=1 alt="GRASS on ZAURUS"></a><p>
<i>Image: GRASS on ZAURUS
(Photo: Luis E. Menoyo, U.S. Geological Survey)</i><p>

<p>

<a href="http://mpa.itc.it/radim/qgis/index.html">
<DEFANGED_IMG src="../images/ipaq2.png" alt="GRASS/QGIS on iPAQ"></a><p>
<i>Image: GRASS/QGIS on iPAQ: new pen-based interface</i>

<h2>GRASS on iPAQ</h2>
We have contributed a GRASS package to the <a
href="http://familiar.handhelds.org">Familiar Linux
Distribution</a>. It will become a standard Familiar package in the
upcoming Familiar 0.5.3 release. In the meantime, users of Familiar's
unstable feed can directly install grass with the command "ipkg
install grass" or through one of the graphical package management
tools.
<p>

One note of caution, when you do the ipkg install, specify where you
want GRASS to go, because the default install directory for the iPaq binary
is read-only on the Zaurus.  Also, zlib and libncurses5 are required, so get
those in first.


<ul>
<li>
Download precompiled <a href="grass5/binary/ipaq_linux/">iPAQ/Linux
binaries</a> (experimental)</li>
<li>Compiling locally: In the development branch in CVS (HEAD) you find a
directory "handheld/" containing a script to package sources of GRASS
libraries and a subset of commands into a new tarball. This tarball can be
compiled with another compile script also stored in that directory.
Compilation must take place on iPAQ (you may use the environment provided by
<a href=http://www.handhelds.org/projects/skiffcluster.html>www.handhelds.org</a>.<br>
Note that compilation should be done on <tt>ipaq[1..7].handhelds.org</tt>
</li>
</ul>

GRASS for iPAQ/<a
href="http://www.handhelds.org/platforms.html">Linux handhelds</a> was
tested on iPAQ 3870 with <a href="http://familiar.handhelds.org/">Familiar
Linux</a> v0.5.1 and ICE Xwindow manager that can be found prepared in
Familiar Linux distribution. Familiar Linux installation is well described on
<a href="http://www.handhelds.org">www.handhelds.org</a> pages.
<p>
GRASS/iPAQ should work on any of the existing iPAQ models (31XX, 36XX, 37XX,
or 38XX).

<h2>GRASS on Sharp/Zaurus</h2>

The software also runs on Zaurus. Go here for <a
href=grass5_on_zaurus.html>GRASS/Zaurus installation instructions</a>.

<hr>
Part of the GRASS/iPAQ development was done for the WebFAQ and the <a href=http://www.wilmaproject.org>WILMA wireless project</a>.
<P>
Reference:<br>

J. Stankovic, M. Neteler, and R. Flor, 2004. Mobile wireless GRASS GIS for handheld computers running
GNU/Linux. <i>Transactions in GIS</i>, 8(2):225-233, April 2004.<br>
[ <a href="http://mpa.itc.it/papers/biblio_i04-bib.html#stankovic04mobile">bib</a> | 
  <a href="http://mpa.itc.it/papers/biblio_i04-abstracts.html#stankovic04mobile">Abstract</a> ]


<!-- FOOTER -->
<hr>
<DIV ALIGN=right>&copy; 1999-2002 GRASS Development Team<br>
 <a href="mailto:weblist at grass.itc.it">Comments</a> about this page |
 <a href="../faq/index.html">FAQ</a> |
 <a href="../download/index.php">Download</a> |
 <a href="../community/index.php">Support</a> |
 <a href="../gdp/index.php">Docs</a>  |
 <a href="../devel/index.php">Programming</a> |
 Back <a href=../index.php>HOME</a><br>
 <i>Last change:
 $Date: 2004/12/19 16:50:26 $
 </i></DIV>

</body>
</html>

--- NEW FILE: menu_side.inc ---
<!-- SIDE MENU INCLUDE -->

    <table class="topmenu" bgcolor="#008000" cellspacing="0" cellpadding="0" border="0" width="150">
    <tbody>
     <tr>
     <td><!-- TOP MENU -->
      <table cellspacing="1" cellpadding="3" border="0" width="100%">
      <tbody>
        <tr bgcolor="#cc5e2ca">
        <td nowrap="nowrap">
	<font size="-1">
          <a href="wingrass.html">winGRASS</a>
	  <p>
          <a href="macgrass.html">MacOSX</a>
	  <p>
	  <a href="grasshandheld.html">Handhelds</a>
	  <p>
	  <a href="grass5_on_zaurus.html">Zaurus</a>
        </font>
        </td>
        </tr>
      </tbody> 
      </table><!-- END SIDE MENU -->
     </td>
     </tr>
    </tbody>
    </table> <!-- END menu frame -->


--- NEW FILE: GRASS.MacOSX.binnote.html ---
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<DEFANGED_meta content="MacOSX binary install notes" name="Title">
<DEFANGED_meta content="text/html; charset=macintosh" http-equiv="Content-Type">
<title>MacOSX binary install notes</title>
 <!-- <DEFANGED_STYLE>
  <!--
.MsoNormal
	{font-size:12.0pt;
	font-family:Times;}
.Section1
	{page:Section1;}
.style1 {
	font-size: 12pt;
	font-weight: bold;
}
-->
   --> </DEFANGED_STYLE>
</head>
<body bgcolor="#FFFFFF" class="Normal" lang="EN-US"> 
<div class="Section1"> 
  <p class="style1"><span
 DEFANGED_STYLE="font-family: Helvetica-Bold; color: black;">There were THREE relevant email exchanges in the grass5 mailing list one from Hamish, then the quoted response below from Michael Baron, then a <a href="#addendum">second message from him with a clarification/correction</a>.<br>
  </span></p> 
  <pre class="MsoNormal"><span
 DEFANGED_STYLE="font-size: 11pt; font-family: Helvetica-Bold; color: black;"><b>
Resent-From: </b></span><span
 style="font-size: 11pt; font-family: Helvetica; color: black;">root at grass.itc.it
</span><span
 DEFANGED_STYLE="font-size: 11pt; font-family: Helvetica-Bold; color: black;"><b>From: </b></span><span
 style="font-size: 11pt; font-family: Helvetica; color: black;">Michael Barton &lt;michael.barton at asu.edu&gt;
</span><span
 DEFANGED_STYLE="font-size: 11pt; font-family: Helvetica-Bold; color: black;"><b>Date: </b></span><span
 style="font-size: 11pt; font-family: Helvetica; color: black;">December 11, 2003 11:11:04 EST
</span><span
 DEFANGED_STYLE="font-size: 11pt; font-family: Helvetica-Bold; color: black;"><b>Resent-To: </b></span><span
 style="font-size: 11pt; font-family: Helvetica; color: black;">grass5 at grass.itc.it
</span><span
 DEFANGED_STYLE="font-size: 11pt; font-family: Helvetica-Bold; color: black;"><b>To: </b></span><span
 DEFANGED_STYLE="font-size: 11pt; font-family: Helvetica; color: black;">grass5 at grass.itc.it</span></pre>
  <pre class="MsoNormal"><span
 DEFANGED_STYLE="font-size: 11pt; font-family: Helvetica-Bold; color: black;"><b>Subject: [GRASS5] Mac OSX binary install directions</b></span></pre> 
  <p class="MsoNormal">Hamish and others,</p> 
  <p>I've been messing with and installing GRASS on OSX for awhile now. Here <br>
    are a couple of clarifications based on my experiences.</p>
  <p>&gt;<br>
  &gt; Here a some of my notes which may be useful for your write-up.<br>
  &gt; This is for a binary only install.</p>
  <p>***Basic requirements for installing GRASS 5.3 binaries on OSX***</p>
  <p>X11 (note different versions for OSX 10.2 and 10.3)<br>
    tcltk for X11</p>
  <p>That's it.</p>
  <p>HOWEVER (a big however). You will WANT to have GDAL installed for <br>
    import/export and may want a few other items installed (such as <br>
    PostgreSQL).</p>
  <p>***You can get X11 in a variety of flavors from a variety of sources. I <br>
    use X11 from Apple. Also install the X11 SDK file (almost hidden on the <br>
    X11 install page).</p>
  <p>****tcltk for X11 I have only been able to find in source version (from <br>
    the main tcltk web page) or on FINK. If there is another version out <br>
    there in binary, it would be very good to know where it is.</p>
  <p>See Hamish's notes below for getting and installing FINK. Note: you <br>
    MUST also install the Apple X11 SDK for FINK to work correctly <br>
    (otherwise it doesn't realize you have an existing X11 installation and <br>
    tries to install another one, though it isn't supposed to do this). <br>
    Also look at Hamish's notes for different shell login scripts.</p>
  <p>On OSX 10.2, fink installs and automatically fixes the login script to <br>
    correctly add path names for fink-installed programs like tcltk. If you <br>
    want to also want to have a path set for GRASS installed in <br>
    /usr/loca/bin (the default for binaries), you will need to add this to <br>
    your path. You can do this in Fink Commander preferences or by adding <br>
    this directory to the path line in the file /sw/bin/init.csh. Note you <br>
    will need su privileges to do this.</p>
  <p>On OSX 10.3, it is more complicated as Apple has switched from tcshell <br>
    to bash. First, you need to make the path modification to init.sh <br>
    (instead of init.csh). Second, you will need to add the line &quot;source <br>
    /sw/bin/init.sh&quot; to the file /etc/.bashrc. (I do it this way to make <br>
    sure that the new path is available to all users of a system).</p>
  <p>Using Fink Commander, install tcltk. As Hamish points out, you can also <br>
    install other related programs like R, GIMP, XFIG, etc.</p>
  <p>**** If you install PostgreSQL, I recommend installing it from Marc <br>
    Liyange's page &lt;http://www.entropy.ch/software/macosx/&gt; rather than <br>
    Fink. The fink install has some permission problems. These are fixable, <br>
    but complicate the installation. He also includes a script to <br>
    automatically start PostgreSQL each time you start your computer and <br>
    links to the excellent PHP administrator for PostgreSQL (install Marc's <br>
    PHP first).</p>
  <p>****You can install GDAL via fink, but it is very dated at present. <br>
    Marcus has provided a great set of GDAL binaries with OGR support. I <br>
    don't know where they will be posted however, if Marcus takes down his <br>
    temporary site for them. If you install these, make the link file as <br>
    Hamish suggests below (this is more important for GRASS 5.3, but you <br>
    might as well do it).</p>
  <p>&gt;</p>
  <p>Here are a couple additions to Hamish's excellent directions for <br>
    installing GRASS 5.7 binaries</p>
  <p>***Basic requirements for installing GRASS 5.3 binaries on OSX***</p>
  <p>X11 (note different versions for OSX 10.2 and 10.3)<br>
    tcltk for X11 (required for the tcltk interface)<br>
    GDAL with OGR (GRASS 5.3 won't run without this)<br>
    PROJ4 (GRASS 5.3 won't run without this)</p>
  <p>That's it. Again, you might want to install a series of related <br>
    applications.</p>
  <p>&gt; GRASS 5.7 on OSX 10.3<br>
  &gt;<br>
  &gt;<br>
  &gt; 1) Install Apple's X11 and friends<br>
  &gt; Our new system came with OSX 10.3 preinstalled, and past the point of <br>
  &gt; custom<br>
  &gt; install so I had to download Apple's X11 from their website[1]. After<br>
  &gt; installing that, I headed over to Applications/Installers/Developer <br>
  &gt; Tools<br>
  &gt; and double clicked Developer.mpkg; from the custom install list I<br>
  &gt; choose Devel Tools Software, MacOSX SDK, BSD SDK, and X11 SDK.</p>
  <p>You've got to have X11 SDK install for Fink to work (needed for <br>
    installing tcltk--at least by me).</p>
  <p>&gt;<br>
  &gt; 2) Setup a root password<br>
  &gt; Open Apps/Utilities/Terminal and type 'sudo su' and set a strong <br>
  &gt; password.<br>
  &gt;</p>
  <p>As Hamish notes, this is optional</p>
  <p>&gt; 3) Install R-statistics[2]<br>
  &gt; This is optional, but useful for geostats. Click on CRAN, choose a <br>
  &gt; mirror,<br>
  &gt; click on R Binaries, macosx, and download RAqua.dmg. Double click on <br>
  &gt; that<br>
  &gt; package and install tcltk, libreadline, and finally RAqua. This <br>
  &gt; installs<br>
  &gt; the OSX port of R to Applications/StartR. I made a link to this <br>
  &gt; application<br>
  &gt; so I could start R from the command line by typing &quot;R&quot;:<br>
  &gt; (as root)<br>
  &gt; mkdir /usr/local/bin (if it doesn't already exist)<br>
  &gt; ln -s /Applications/StartR.app/Contents/MacOS/StartR /usr/local/bin/R<br>
  &gt;<br>
  &gt; Next, start R and type:<br>
  &gt; install.packages(&quot;akima&quot;)<br>
  &gt; install.packages(&quot;VR&quot;)<br>
  &gt; install.packages(&quot;GRASS&quot;)<br>
  &gt; install.packages(&quot;RODBC&quot;)<br>
  &gt; install.packages(&quot;grasper&quot;)<br>
  &gt; install.packages(&quot;mgcv&quot;)<br>
  &gt; install.packages(&quot;shapefiles&quot;)<br>
  &gt; .. and any other packages that might look interesting to you<br>
  &gt;<br>
  &gt; The GRASS website has a useful R primer[3].<br>
  &gt;<br>
  &gt;</p>
  <p>See my notes above for additional information on bash shell scripts for <br>
    fink and correct paths using OSX 10.3</p>
  <p>Also note that this is different for OSX 10.2 because it uses tcshell <br>
    (also see above)</p>
  <p>I would change these X startup files AFTER installing FINK because FINK <br>
    changes some of them during its install.</p>
  <p>&gt; 4) Setup X startup files.<br>
  &gt; OSX's Terminal looks for .bash_profile but not .bashrc. Apple's X11 <br>
  &gt; looks for<br>
  &gt; .bashrc but not .bash_profile. Solution (kludge) follows:<br>
  &gt;<br>
  &gt; .bash_profile:<br>
  &gt; . ~/.bashrc # does this need to be a hard path for the GRASS init <br>
  &gt; script?<br>
  &gt;<br>
  &gt; .bashrc:<br>
  &gt; alias rm='rm -i'<br>
  &gt; alias cp='cp -i'<br>
  &gt; alias mv='mv -i'<br>
  &gt; alias ls='ls -FG'<br>
  &gt; alias ll='ls -la'<br>
  &gt; alias la='ls -A'<br>
  &gt; alias dir='/bin/ls'<br>
  &gt; PATH=&quot;$PATH&quot;:/usr/local/bin<br>
  &gt;<br>
  &gt; I also disabled the xterm&amp; in /etc/X11/xinit/xinitrc.<br>
  &gt;<br>
  &gt; 5) Install Fink[4]<br>
  &gt; Download &amp; run the Fink Installer. Double click on &quot;Fink 0.6.2 <br>
  &gt; Installer.pkg&quot;<br>
  &gt; and after that is setup, drag the FinkCommander folder to your desktop.<br>
  &gt; Check this line has been added to all users' .bashrc:<br>
  &gt; . /sw/bin/init.sh<br>
  &gt; I ran 'fink configure' to setup which Fink mirror to talk to, but <br>
  &gt; that's not<br>
  &gt; a strict requirement.<br>
  &gt; May need to log out &amp; back in to take effect.<br>
  &gt;<br>
  &gt; 6) Run FinkCommander<br>
  &gt; Setup to use stable packages, it has already guessed to use the 10.3 <br>
  &gt; branch.<br>
  &gt; This branch is missing some packages as of this writing, but saves <br>
  &gt; time vs.<br>
  &gt; compiles. I installed: wget, gimp, dlcompat-shlibs (needed for Gimp),<br>
  &gt; tcklk (yes, again), and gmt. I would have installed nedit and octave <br>
  &gt; if they<br>
  &gt; were in the stable archive at the time in binary form. Gimp brings <br>
  &gt; down a lot<br>
  &gt; of goodies like the netpbm tools and libpng which will probably be <br>
  &gt; needed<br>
  &gt; later. Someone noted about needing the TclTk from unstable for <br>
  &gt; compile??<br>
  &gt;<br>
  &gt;<br>
  &gt; 7) Install PROJ.4 and GDAL<br>
  &gt; Download[5] and follow Markus's instructions to install PROJ and GDAL.<br>
  &gt; Then as root, make the following two links:<br>
  &gt; ln -s /sw/lib/libgdal.1.1.9.dylib /usr/local/lib/libgdal.1.1.dylib<br>
  &gt; Forget what the second one was, thought it for Proj. What breaks?</p>
  <p>I can answer this one as I posted a note on this a few days ago.</p>
  <p>For PROJ4, you need to<br>
    1. un-gzip the file. It produces a mirror of the /usr directory with <br>
    all the PROJ files in the proper places<br>
    2. manually copy all the files to their corresponding directories in <br>
    /usr. For example, if you un-gzipped PROJ4 into temp, copy all files in <br>
    /temp/usr/lib to /usr/lib. The primary offending file that seems to be <br>
    left out and not installed properly is libproj.dylib. GRASS 5.3 will <br>
    not run if it cannot find this file.</p>
  <p>Important clarification for GDAL. Hamish's link assumes a fink install <br>
    for GDAL (all fink stuff install into /sw). I don't know what version <br>
    fink now has. A few weeks back, it was an older one and not 1.1.9 and <br>
    did NOT include OGR. As Marcus' GDAL binary is currently set up, it has <br>
    an install script to place all of its pieces in the /usr/* directories <br>
    (not in the /sw/* directories). You will need to make the link noted by <br>
    Hamish because the current build of GRASS 5.3 looks for <br>
    libgdal.1.1.dylib. This file does not exist in the newer version <br>
    provided by Marcus (ver. 1.9). Hence, you need to make link to <br>
    /usr/lib/libgdal.1.1.9.dylib. HOWEVER, this link SHOULD be</p>
  <p>ln -s /usr/lib/libgdal.1.1.9.dylib /usr/local/lib/libgdal.1.1.dylib</p>
  <p>because libdgal.1.1.9.dylib is found in /usr/lib and not in /sw/lib</p>
  <p>GRASS 5.3 will not run if it cannot find libgdal.1.1.dylib.</p>
  <p>&gt;<br>
  &gt; These are probably better dealt with by getting /sw/lib added to OSX's<br>
  &gt; ld path, where ever that lives.</p>
  <p>See note above. The best (fink) way to do this is to modify the path <br>
    line in /sw/bin/init.csh (for OSX 10.2) or /sw/bin/init.sh (for OSX <br>
    10.3). Then add the source /sw/bin/init.csh (for 10.2) or source <br>
    /sw/bin/init.sh (for 10.3) to the .cshrc file (for 10.2) or .bashrc <br>
    file (for 10.3).<br>
  </p>
  <p>&gt;<br>
  &gt;<br>
  &gt; 8) Install GRASS<br>
  &gt; Download[5] and follow Markus's instructions. I found it better to use<br>
  &gt; wget instead of Safari to do the download to keep the MD5 hash the same<br>
  &gt; as Safari automatically unpacks the archive.<br>
  &gt; (as root)<br>
  &gt; grass57-20_11_2003-powerpc-apple-darwin6.8-install.sh \<br>
  &gt; grass57-20_11_2003-powerpc-apple-darwin6.8-bin.tar.gz \<br>
  &gt; /usr/local/grass57<br>
  &gt;<br>
  &gt; mkdir ~/grassdata<br>
  &gt; and install the Spearfish, Leics, and Radim's g51test data sets there.<br>
  &gt;<br>
  &gt;<br>
  &gt; 9) Add links to the X11 menu<br>
  &gt; Start X11 (Apps/Utilities), choose Customize.. from the Applications <br>
  &gt; menu.<br>
  &gt; Add Item, Add Item. Double click on blanks &amp; fill in:<br>
  &gt; Name Command<br>
  &gt; GRASS 5.7 xterm -geometry 123x25+5+400 -e grass57<br>
  &gt; The GIMP gimp<br>
  &gt;<br>
  &gt;<br>
  &gt; 10) Enjoy. Everything seems to work, even NVIZ.</p>
  <p>Indeed it does. I have now installed this on 10.2 and 10.3 systems.</p>
  <p>I hope this helps</p>
  <p>&gt;<br>
  &gt;<br>
  &gt; [1] http://www.apple.com/macosx/features/x11/download/<br>
  &gt; [2] http://www.r-project.org/<br>
  &gt; [3] http://grass.ibiblio.org/statsgrass/grass_geostats.html<br>
  &gt; [4] http://fink.sourceforge.net/<br>
  &gt; [5] http://mpa.itc.it/markus/grass57/macosx/ [TEMPORARY]<br>
  &gt;<br>
  &gt;<br>
  &gt;<br>
  &gt;<br>
  &gt; Hamish<br>
  &gt;<br>
    ____________________<br>
    C. Michael Barton, Professor<br>
    Department of Anthropology<br>
    PO Box 872402<br>
    Arizona State University<br>
    Tempe, AZ 85287-2402<br>
    USA</p>
  <p>Phone: 480-965-6262<br>
    Fax: 480-965-7671</p>
  <p>_______________________________________________<br>
    grass5 mailing list<br>
    grass5 at grass.itc.it<br>
    http://grass.itc.it/mailman/listinfo/grass5</p>
  <p class="MsoNormal"><span
 DEFANGED_STYLE="font-size: 11pt; font-family: Helvetica-Bold; color: black;"><b>    </b></span></p>
  <p class="MsoNormal"><br> 
    From:&nbsp;&nbsp; michael.barton at asu.edu<br> 
    Subject: Re: [GRASS5] Mac OSX binary install directions - CORRECTION<br> 
    Date: December 12, 2003 12:43:38 EST<br> 
    To:&nbsp;&nbsp; paul-grass at stjohnspoint.co.uk<br> 
    Cc:&nbsp;&nbsp; grass5 at grass.itc.it<br> 
    <br> 
    I made a mistake in my addendum<a name="addendum"></a> to Hamish's directions for installing GRASS binaries. Thanks to Paul Kelly for pointing this out. Sorry for any confusion.<br> 
    <br> 
    <br> 
    On Friday, December 12, 2003, at 05:21 PM, Paul Kelly wrote:<br> 
    <br> 
    Hello Michael<br> 
    Just a quick correction below:<br> 
    <br> 
    On Thu, 11 Dec 2003, Michael Barton wrote:<br> 
    <br> 
    [...]<br> 
    ***Basic requirements for installing GRASS 5.3 binaries on OSX***<br> 
    <br> 
    I MEANT to say<br> 
    <br> 
    ***Basic requirements for installing GRASS 5.7 binaries on OSX***<br> 
    <br> 
    GRASS 5.3 does not need either GDAL or PROJ4 to run (though you will want GDAL for import/export). Also, as Paul Kelly points out, PROJ4 may be a problem for GRASS 5.3 (though it hasn't been for me so far).<br> 
    <br> 
    <br> 
    <span
 DEFANGED_STYLE="font-size: 11pt; font-family: Helvetica-Bold; color: black;"></span></p> 
</div> 
</body>
</html>
--- NEW FILE: grass5_on_zaurus.html ---
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
   <title>GRASS on Zaurus</title>
   <DEFANGED_meta name="Author" content="Brian J Perrault, MIT  Lincoln Laboratory">
   <DEFANGED_link rel="stylesheet" type="text/css" href="sitestyle.css">
</head>
<body>

<h1>"How-to" step by step: Running GRASS on the Zaurus SL5500</h1>

by Brian J Perrault, MIT  Lincoln Laboratory<p>
<a href="images/zaurus_grass.jpg"><DEFANGED_IMG SRC="images/zaurus_grass_small.jpg"
border=1 alt="GRASS on ZAURUS"></a><p>
<i>Image: GRASS on ZAURUS
(Photo: Luis E. Menoyo, U.S. Geological Survey)</i><p>

Before beginning, it is desirable to have either a SD or CF card for storage
purposes.&nbsp; This will come in handy when the mapsets you are interested
in using won't fit in the internal storage of the Zaurus.&nbsp; Note that
if you are going to use an SD card with the Zaurus, it needs to be formatted
as ext2, to enable symlinking.&nbsp; This can be done in /sbin with "mkfs.ext2"<br>
<br>
There is a list of SD and CF cards which will work with the Zaurus, available
here<br>
<a
 href="http://www.zauruszone.farplanet.net/howtos/managing_sd_cf_howto.shtml">
http://www.zauruszone.farplanet.net/howtos/managing_sd_cf_howto.shtml</a><br>
I have chosen a Sandisk 128mb SD card.&nbsp; They are commercially available
from Microwarehouse.<br>
<br>
In the installation process, ipkg may occassionally complain about "read-only"
errors.&nbsp; Many of the ipkg's available have been setup for iPaq's, not
Zaurus', and as such the default installation directory is often set to part
of the read-only space on the Zaurus.&nbsp; This problem is solved by using
the -d option, followed by the location where you would like the files to
reside.&nbsp; For example, you might try<br>
<br>
ipkg -d /mnt/card install libncurses5.ipk<br>
<br>
instead of <br>
<br>
ipkg install libncurses5.ipk<br>
<br>
Required for Grass on the Zaurus (in installation order): Qpe-terminal (available
here<br>
<a href="http://www.killefiz.de/zaurus/showdetail.php?app=172">http://www.killefiz.de/zaurus/showdetail.php?app=172</a>
)<br>
<br>
Install terminal through the add package interface in QTopia.&nbsp; All of
the rest of the packages should be installed from within Terminal using the
"ipkg install" method.<br>
<br>
Libncurses 5 (available through Ipkg find)<br>
Zlibg (available through Ipkg find)<br>
Xfree86 and Icewm for Zaurus (available here<br>
<a
 href="http://sourceforge.net/project/showfiles.php?group_id=39939&amp;release_id=75364">
http://sourceforge.net/project/showfiles.php?group_id=39939&amp;release_id=75364</a><br>
)<br>
<br>
Grass iPaq binary<br>
<a href="http://grass.itc.it/grass5/binary/ipaq_linux/">http://grass.itc.it/grass5/binary/ipaq_linux/</a><br>
<br>
There have been some reported errors related to "awk: not found" when exiting
Grass from within Qtopia, and as such, it might not be a bad idea to install
Gawk as well, which is also available through ipkg find.<br>
<br>
To run Grass, reboot the Zaurus, when you get to the "wait... 5" line, hit
the "/ ?" key once, which will bring you to a propt to select boot mode.<br>
Hit "a" to enter the Linux Console mode.&nbsp; From within the console, type
"wm" to start x.<br>
<br>
Once you are in x, you can run grass from within a terminal window.<br>
<br>
Note that the "esc" key is mapped to "On/Off/Cancel" and "Ctrl" is mapped
to "Fn".<br>
<br>
That should get you to the point where you can open raster map layers.<br>
<br>
Following is a list of what I'm working with:<br>
&nbsp;<br>
OS and Hardware:<br>
&nbsp;&nbsp;&nbsp;&nbsp; Sharp Zaurus 5500 running Linux Kernel&nbsp; 2.4.6-rmk1-np2-embedix&nbsp;&nbsp;
-<br>
ROM version 2.37<br>
&nbsp;&nbsp;&nbsp;&nbsp; 256Mb CF card<br>
&nbsp;<br>
&nbsp;Installed packages:<br>
&nbsp;&nbsp;&nbsp;&nbsp; ZGCC<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; gcc_bin.zip<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; gcc_include.zip<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; gcc_lib.zip<br>
&nbsp;&nbsp;&nbsp;&nbsp; zlib_1.1.2_arm.ipk<br>
&nbsp;&nbsp;&nbsp;&nbsp; libjpeg62_6b_arm.ipk<br>
&nbsp;&nbsp;&nbsp;&nbsp; libncurses_5_0_arm.ipk<br>
&nbsp;<br>
&nbsp;For X-Windows:<br>
&nbsp;&nbsp;&nbsp;&nbsp; x11zaurus_0.8_arm.ipk<br>
&nbsp;&nbsp;&nbsp;&nbsp; ice_1.0.9-5_arm.ipk<br>
&nbsp;<br>
&nbsp;I have additionaly downloaded for compiling GRASS:<br>
&nbsp;&nbsp;&nbsp;&nbsp; babyGRASS_compile.sh<br>
&nbsp;&nbsp;&nbsp;&nbsp; babyGRASS_packagingsrc.sh<br>
&nbsp;&nbsp;&nbsp;&nbsp; grass5.0.0pre5_src.tar.gz<br>
&nbsp;<br>
&nbsp;Missing items as per the 'REQUIREMENTS' documments in CVS-GRASS are:<br>
&nbsp;&nbsp;&nbsp;&nbsp; flex<br>
&nbsp;&nbsp;&nbsp;&nbsp; bison<br>
<br>
___________________<br>
Brian J Perrault<br>
Group 99<br>
Advanced Space Systems and Concepts<br>
MIT Lincoln Laboratory<br>
<hr>

<!-- FOOTER -->
<hr>
<DIV ALIGN=right>&copy; 1999-2002 GRASS Development Team<br>
<a href="mailto:weblist at grass.itc.it">Comments</a> about this page | <a href="faq/index.html">FAQ</a> | <a href="download.html">Download</a> | <a href="support.html">Support</a> | <a href="gdp/index.html">Docs</a>  | <a href="grassdevel.html">Programming</a> | Back <a href=index.html>HOME</a><br>
<i>Last change:
$Date: 2004/12/19 16:50:26 $
</i></DIV>

</body>
</html>

--- NEW FILE: wingrass.html ---
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
   <DEFANGED_meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
   <DEFANGED_meta name="Author" content="Andreas C. Lange">
   <DEFANGED_meta name="KeyWords" content="GRASS, GIS, Windows, Porting, cygwin, Microsoft">
   <DEFANGED_link rel="stylesheet" type="text/css" href="sitestyle.css">
   <title>GRASS GIS 5.0 port to Windows Information</title>
</head>
<body>

<center>
<h1>

<hr SIZE=3 NOSHADE WIDTH="100%">GRASS
5.0 port to Microsoft Windows</h1></center>

<center><a href="../images/winGRASS_big.png"><DEFANGED_IMG SRC="../images/winGRASS.png" ></a></center>
<p>
<hr SIZE=3 NOSHADE WIDTH="100%">

<H1>winGRASS GIS</H1>

GRASS GIS has been ported to MS Windows (NT, 2000 Professional, XP)

<H2>winGRASS GIS mailing list</H2>

<p> To coordinate ideas and work on GRASS GIS to MS-Windows, this
mailing list has been established. Feel free to subscribe and participate:

<ul>
<li><a href=http://grass.itc.it/mailman/listinfo/wingrass>winGRASS Mailing List (un)subscription page</a>
<li><a href=http://grass.itc.it/pipermail/wingrass/>winGRASS mailing list archives</a>
<li><a href=../searchgrass.php>Search</a> Mailing List
</ul>


<!-- hidden links to make htdig and Google search the list archives (new and old): -->
<a href=http://grass.itc.it/pipermail/wingrass/><font color=white>x</a></font><br>


GRASS GIS 5.0 has been ported 
to MS Windows (NT, 2000 Professional, XP) using the <a href="http://sources.redhat.com/cygwin/">cygwin
tools</a>. The source code is identical to the UNIX version as the GRASS
source code is rather platform independent. If you want to compile yourself,
we recommend to get the latest GRASS sources from our <a href="../devel/cvs.php">CVS-Server</a>.
<p>You are encouraged to use
this experimental version and assist to identify and help fixing the few
bugs still in this version. Following problems are to be addressed
in a future release:
<ul>
<li>
stabilize the native windows graphical
output window to display maps;</li>

<li>
have a native windows menu
user interface </li>
<li>
get NVIZ working
(problem is the limited path support of TclTk for Cygwin).</li>
</ul>

The <b>graphical output screen</b>
(based on XDRIVER) has been the major problem to port GRASS. The system
is now working with the XFree86 Server or the StarNet X-Win Server
as well as the generic Windows driver. For the <b>menu system</b> (only
supported for winGRASS with Xdriver)
currently the tcl/tk based tcltkgrass program is used. The native <b>menu
system</b> (probably based on tcl/tk or python) will take more time.
<p>We are searching for developers
and testers to assist in finalizing the GRASS-Windows port: If you are
(somewhat) experienced, join the <a href="../devel/index.php">development
team</a> to speed up the port. If you have questions or want to discuss
the development, please subscribe to the <b>winGRASS mailing list </b>
(see above). Before reporting bugs to the list, please visit the
bug reporting system and read the manuals and old posts to the mailing
lists. See <a href="../bugtracking/bugreport.html">here</a> for report a bug.

<p>
<b>NOTE 1: GRASS does not cope (yet) with spaces in directory names. Take this
into account when installing GRASS on MS-Windows.</b><br>
<b>NOTE 2: When selecting the root install directory, make sure that
the "Default Text File Type" is set to Unix.</b><br>
<b>NOTE 3: You must install/compile GRASS on an NTFS partition 
(FAT will not work!)</b>

<p>
<b>Download pre-compiled winGRASS
binaries:</b>
<ul>
<li>
Download <a href="../grass54/binary/mswindows_cygwin/">precompiled
	package of the GRASS 5.4 port to Windows</a> We provide
two versions:
<ul>
<li>
winGRASS with Xserver requirement:
wingrass_xserver/</li>

<li>
winGRASS without Xserver requirement:
wingrass_generic/
(probably more limited in functionality)</li>
</ul>

<br>
<b>NOTE:</b> Supported are Windows NT (SP 3 or above), Windows 2000 Professional
and XP.
<li>
<a href="../grass50/binary/windows_cygnus/cygwin_grass50bininstall.html">Instructions
	to install the precompiled winGRASS package.</a> (old)</li>
<li>Download <a href="../grass57/binary/mswindows_cygwin/">precompiled
	package of the GRASS 5.7 port to Windows</a>
<br>
Go <a href="http://geni.ath.cx/grass.html">here</a> for experimental (but newer) winGRASS binary versions.

</ul>


<p><b>Download source code
(to compile GRASS from scratch on Windows):</b>
<ul>
<li>
Get the latest <a href="../download/index.php">GRASS sources.</a></li>

<li>
<a href="../grass50/binary/windows_cygnus/cygwin_grass50compile.html">Instructions
on how to compile</a> GRASS 5.0 with the cygnus tools.</li>
</ul>


<hr SIZE=3 NOSHADE WIDTH="100%">
<h3>FAQ (related to Cygwin)</h3>
<ul>
<li><a href=http://cygwin.com/faq/faq_toc.html>Cygwin FAQ</a>
<li><a href=http://xfree86.cygwin.com/docs/faq/cygwin-xfree-faq.html>Xfree/Cygwin FAQ</a>
</ul>

<!-- FOOTER -->
<hr>
<DIV ALIGN=right>&copy; 1999-2002 GRASS Development Team<br>
 <a href="mailto:weblist at grass.itc.it">Comments</a> about this page |
 <a href="../faq/index.html">FAQ</a> |
 <a href="../download/index.php">Download</a> |
 <a href="../community/index.php">Support</a> |
 <a href="../gdp/index.php">Docs</a>  |
 <a href="../devel/index.php">Programming</a> |
 Back <a href=../index.php>HOME</a><br>
 <i>Last change:
 $Date: 2004/12/19 16:50:26 $
 </i></DIV>
       
</body>
</html>

--- NEW FILE: title.inc ---
<!-- keep indentation -->
                <center><br>
                  <h1>GRASS: Community</h1>
                </center>

--- NEW FILE: macosx_buildnotes.html ---
<html>
<body>
<P>Some preliminary notes on building GRASS for Mac OS X - at the moment, just
some notes collected from helpful volunteers.
<ul><li>Notes from Hamish re: compiling GRASS 5.7 follow, below...
<li>William Kyngesburye has provided a page of < a href="http://webpages.charter.net/kyngchaos/macosx/grassinstall.html">notes re: GRASS5.3 on OS X</a> - June 2004 those notes have been recently updated and provide a comprehensive description to download and install "manually" all of GRASS's prerequisites as well as GRASS itself.  
<pre>

Here a some of my notes which may be useful for your write-up.
This is for a binary only install.


GRASS 5.7 on OSX 10.3


1) Install Apple's X11 and friends
Our new system came with OSX 10.3 preinstalled, and past the point of custom
install so I had to download Apple's X11 from their website[1]. After 
installing that, I headed over to Applications/Installers/Developer Tools
and double clicked Developer.mpkg; from the custom install list I 
choose Devel Tools Software, MacOSX SDK, BSD SDK, and X11 SDK. 

2) Setup a root password
Open Apps/Utilities/Terminal and type 'sudo su' and set a strong password.

3) Install R-statistics[2]
This is optional, but useful for geostats. Click on CRAN, choose a mirror,
click on R Binaries, macosx, and download RAqua.dmg. Double click on that 
package and install tcltk, libreadline, and finally RAqua. This installs 
the OSX port of R to Applications/StartR. I made a link to this application
so I could start R from the command line by typing "R":
(as root)
mkdir /usr/local/bin  (if it doesn't already exist)
ln -s /Applications/StartR.app/Contents/MacOS/StartR /usr/local/bin/R

Next, start R and type:
install.packages("akima")
install.packages("VR")
install.packages("GRASS")
install.packages("RODBC")
install.packages("grasper")
install.packages("mgcv")
install.packages("shapefiles")
.. and any other packages that might look interesting to you

The GRASS website has a useful R primer[3].


4) Setup X startup files.
OSX's Terminal looks for .bash_profile but not .bashrc. Apple's X11 looks for
.bashrc but not .bash_profile. Solution (kludge) follows:

.bash_profile:
. ~/.bashrc    # does this need to be a hard path for the GRASS init script?

.bashrc:
alias rm='rm -i'
alias cp='cp -i'
alias mv='mv -i'
alias ls='ls -FG'
alias ll='ls -la'
alias la='ls -A'
alias dir='/bin/ls'
PATH="$PATH":/usr/local/bin

I also disabled the xterm& in /etc/X11/xinit/xinitrc.

5) Install Fink[4]
Download & run the Fink Installer. Double click on "Fink 0.6.2 Installer.pkg"
and after that is setup, drag the FinkCommander folder to your desktop.
Check this line has been added to all users' .bashrc:
. /sw/bin/init.sh
I ran 'fink configure' to setup which Fink mirror to talk to, but that's not
a strict requirement.
May need to log out & back in to take effect.

6) Run FinkCommander
Setup to use stable packages, it has already guessed to use the 10.3 branch.
This branch is missing some packages as of this writing, but saves time vs.
compiles. I installed: wget, gimp, dlcompat-shlibs (needed for Gimp), 
tcklk (yes, again), and gmt. I would have installed nedit and octave if they
were in the stable archive at the time in binary form. Gimp brings down a lot
of goodies like the netpbm tools and libpng which will probably be needed
later. Someone noted about needing the TclTk from unstable for compile??


7) Install PROJ.4 and GDAL
Download[5] and follow Markus's instructions to install PROJ and GDAL.
Then as root, make the following two links:
ln -s /sw/lib/libgdal.1.1.9.dylib /usr/local/lib/libgdal.1.1.dylib
Forget what the second one was, thought it for Proj. What breaks?

These are probably better dealt with by getting /sw/lib added to OSX's 
ld path, where ever that lives.


8) Install GRASS
Download[5] and follow Markus's instructions. I found it better to use 
wget instead of Safari to do the download to keep the MD5 hash the same
as Safari automatically unpacks the archive.
(as root)
 grass57-20_11_2003-powerpc-apple-darwin6.8-install.sh \
    grass57-20_11_2003-powerpc-apple-darwin6.8-bin.tar.gz \
    /usr/local/grass57

mkdir ~/grassdata
 and install the Spearfish, Leics, and Radim's g51test data sets there.


9) Add links to the X11 menu
Start X11 (Apps/Utilities), choose Customize.. from the Applications menu.
Add Item, Add Item. Double click on blanks & fill in:
Name       Command
GRASS 5.7  xterm -geometry 123x25+5+400 -e grass57
The GIMP   gimp


10) Enjoy. Everything seems to work, even NVIZ.


[1] http://www.apple.com/macosx/features/x11/download/
[2] http://www.r-project.org/
[3] http://grass.ibiblio.org/statsgrass/grass_geostats.html
[4] http://fink.sourceforge.net/
[5] http://mpa.itc.it/markus/grass57/macosx/  [TEMPORARY]

Hamish
</pre>
</body>
</html>

--- NEW FILE: index.php ---
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
  <title>GRASS GIS: Community</title>
  <DEFANGED_meta name="robots" content="index,follow">
  <DEFANGED_meta name="description"
        content="GRASS GIS (Geographic Resources
         Analysis Support System) is an open source, free software
         Geographical Information System (GIS) with raster, topological
         vector, image processing, and visualization functionality">
  <DEFANGED_meta name="keywords"
        content="gis, GIS, GRASS, open source, 
	 free software, Geographical Information System, raster, topology,
         vector, image processing, visualization">
  <DEFANGED_meta name="Author" content="MN/GRASS Development Team">
  <DEFANGED_meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  <DEFANGED_link rel="stylesheet" href="../sitestyle.css" type="text/css">
</head>
<body>
   <!-- TOP LOGO LINE -->  
<table bgcolor="#ffffff" cellspacing="0" cellpadding="0" border="0" width="650">
 <tbody>
 <tr><td>            
   <table cellspacing="1" cellpadding="0" border="0" width="100%" >
   <tbody>
      <tr bgcolor="#ffffff">
       <td nowrap="nowrap"> <DEFANGED_IMG src="../images/grasslogo_vector_small.png" alt="GRASS GIS (Geographic Resources Analysis Support System)" hspace="22">
       </td>
       <td nowrap="nowrap">
          <table cellspacing="0" cellpadding="1" border="0" width="50%">
          <tbody>
            <tr bgcolor="#ffffff">
              <td nowrap="nowrap">
               <?php
                  include("title.inc");
               ?> 
              </td>
            </tr>
          </tbody>
          </table>
       </td>
      </tr>
    </tbody>
    </table>
   </td>
  </tr>
 </tbody> 
</table>

<table cellspacing="0" cellpadding="1" border="0" width="100%">
<tbody>
 <tr>
    <td valign="top">
    <?php
        include("../menu_search.inc");
     ?> 
   </td>
   <td valign="top">
     <?php
       include("../menu_top.inc");
     ?>
   </td>
 </tr>
 <tr>
  <td valign="top">
     <?php
       include("menu_side.inc");
     ?>
   </td>
  <td valign="top"> <!-- MAIN PART -->
      
   <h3>Platform specific notes</h3>

   Please choose platform specific notes from the left menu.

    <!-- END MAIN PART -->
 
  </td>
 </tr>  
 </tbody> 
</table>

<hr>
   <div align="right">&copy; 1999-2004 GRASS Development Team<br>
   <a href="../impressum.html">Imprint</a> |
   <a href="mailto:weblist at grass.itc.it">Comments</a> about this page<br>
   <i>Last change: $Date: 2004/12/19 16:50:26 $ </i><br>
   <i>$Author: markus $</i></div>
		    
</body>
</html>





More information about the grass-web mailing list