[Skencil-commits] r691 - skencil/branches/skencil-0.6

[scm-commit@wald.intevation.org]

Author: bh
Date: 2006-08-14 00:46:39 +0200 (Mon, 14 Aug 2006)
New Revision: 691

Modified:
   skencil/branches/skencil-0.6/ChangeLog
   skencil/branches/skencil-0.6/INSTALL
Log:
* INSTALL: Some updates and formatting fixes


Modified: skencil/branches/skencil-0.6/ChangeLog
===================================================================
--- skencil/branches/skencil-0.6/ChangeLog	2006-08-13 22:44:28 UTC (rev 690)
+++ skencil/branches/skencil-0.6/ChangeLog	2006-08-13 22:46:39 UTC (rev 691)
@@ -1,5 +1,9 @@
 2006-08-13  Bernhard Herzog  <bh at intevation.de>
 
+	* INSTALL: Some updates and formatting fixes
+
+2006-08-13  Bernhard Herzog  <bh at intevation.de>
+
 	* NEWS: Add changes since 0.6.17
 
 2006-08-13  Bernhard Herzog  <bh at intevation.de>

Modified: skencil/branches/skencil-0.6/INSTALL
===================================================================
--- skencil/branches/skencil-0.6/INSTALL	2006-08-13 22:44:28 UTC (rev 690)
+++ skencil/branches/skencil-0.6/INSTALL	2006-08-13 22:46:39 UTC (rev 691)
@@ -1,6 +1,6 @@
 
 Installing Skencil
-=================
+==================
 
 These installation instructions are divided into two parts. The first
 part describes the third party software you need for Skencil. The second
@@ -13,12 +13,12 @@
 for uptodate notes for your platform and availability of prebuild binaries.
 
 
-Installing the third party software.
-====================================
+Installing the third party software
+===================================
 
 
-1.  Install Tcl/Tk
---------------------------
+1. Install Tcl/Tk
+-----------------
 
 All Tcl/Tk version newer than Tcl 7.6 and Tk 4.2 should work.
 Most GNU/Linux distributions include Tcl/Tk so this step should be easy.
@@ -28,8 +28,8 @@
 Skencil uses only standard Tk features. No additional packages are required.
 
 
-2.  Install Python
---------------------------
+2. Install Python
+-----------------
 
 Python is available from its WWW home page: <http://www.python.org/> or
 via ftp from <ftp://ftp.python.org/pub/python/>. See Python's
@@ -47,8 +47,8 @@
 
 
 
-3.  Install the Python Imaging Library (PIL)
-----------------------------------------------------
+3. Install the Python Imaging Library (PIL)
+-------------------------------------------
 
 This library is available from <http://www.pythonware.com>. See the
 accompanying documentation for installation instructions. The
@@ -88,18 +88,14 @@
 
 
 
-Installing Skencil:
+Installing Skencil
 ==================
 
-Skencil has a configure, build and install script. This script is
-modelled after (but less generic and powerful than) the proposed
-standard for Python packages and applications currently discussed in the
-Python distutils SIG.
+There are two ways to install Skencil.  The recommended one is to use
+setup.py, a script that configures, builds and installs Skencil for you.
+For cases where this script does not work, you can also use the a manual
+way, described as method 2 below.
 
-In case this script does not work for you, you can also use the old
-'pedestrian' method that was required by older versions of Skencil. This
-method is described as method 2 below.
-
 The installation process consists of three steps: configuration,
 compilation and installation. These steps are quite independend from
 each other, so even if the script doesn't work for one step it might
@@ -119,10 +115,15 @@
 may be followed by options, described below. 'setup --help' prints a
 help message.
 
+If you're familiar with Python, you may note that this is similar to the
+setup.py scripts of the Python distutils.  This script is somewhat
+different, though, because it was written before distutils existed.  The
+distutils were already being discussed, however, and this script is
+follows what was being discussed back then, to an extent.
 
 
-Configuration:
---------------
+Configuration
+-------------
 
 Skencil needs to access the Python Imaging Library from C, so it needs to
 know where its headerfiles are. Unfortunately there's no standard place
@@ -144,8 +145,8 @@
 
 
 
-Compilation:
-------------
+Compilation
+-----------
 
 This is simple, if configuration was successful. Just do
 
@@ -154,16 +155,16 @@
 This compiles the C-modules.
 
 
-Installation:
--------------
+Installation
+------------
 
 setup.py installs almost all files under <prefix>/lib/sketch-<version>.
 
 <prefix> defaults to /usr/local and <version> is the current Skencil
 version. 
 
-It also creates two symbolic links (sketch and sk2ps) in <prefix>/bin
-pointng to sketch.py and sk2ps.ps in <prefix>/lib/sketch-<version>.
+It also creates two symbolic links (skencil and sk2ps) in <prefix>/bin
+pointing to skencil.py and sk2ps.ps in <prefix>/lib/sketch-<version>.
 
 To install under /usr/local run
 
@@ -184,17 +185,14 @@
 
 
 
-Method 2: The old, pedestrian Method
-====================================
+Method 2: The old manual Method
+===============================
 
 
 First, change into the subdirectory Pax. You'll find a file Setup.in.
 Copy that file to Setup and edit it. Follow the comments in that file.
+Pax has to be linked against the same versions of Tcl/Tk as Tkinter.
 
-This works just like the Setup file in Python's Modules directory which
-you probably edited to activate Tkinter. Pax has to be linked against
-the same versions of Tcl/Tk as Tkinter.
-
 Now, in Pax, type:
 
      $ make -f Makefile.pre.in boot
@@ -225,7 +223,7 @@
 not really necessary, but sketch should start a bit faster)
 
 
-Starting Skencil:
+Starting Skencil
 ================