Makefile: Build Tcl extensions with `-fPIC'.

[rocl] / elite-describe

diff --git a/elite-describe b/elite-describe
index 1c0c77408e99e85f5e41eb67721709441a6fda6c..8f5cfd4aecdc69217c4137daa47fc1a503710e84 100755 (executable)
--- a/elite-describe
+++ b/elite-describe
@@ -1,11 +1,42 @@
 #! /usr/bin/tclsh
+###
+### Describe a particular world
+###
+### (c) 2003 Mark Wooding
+###
 
-package require "elite" "1.0.0"
+###----- Licensing notice ---------------------------------------------------
+###
+### This program is free software; you can redistribute it and/or modify
+### it under the terms of the GNU General Public License as published by
+### the Free Software Foundation; either version 2 of the License, or
+### (at your option) any later version.
+###
+### This program is distributed in the hope that it will be useful,
+### but WITHOUT ANY WARRANTY; without even the implied warranty of
+### MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+### GNU General Public License for more details.
+###
+### You should have received a copy of the GNU General Public License
+### along with this program; if not, write to the Free Software Foundation,
+### Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+
+package require "elite" "1.0.1"
+
+###--------------------------------------------------------------------------
+### Support functions.
 
 proc describe n {
+  ## Describe the world with seed N.
+
   global economy government
+
+  ## Fetch the necessary information.
   elite-worldinfo p $n
+
+  ## Format most of the data.
   puts "Name: $p(name)"
+  puts "Seed: $p(seed)"
   puts "Position: $p(x), $p(y) LY"
   puts "Economy: $economy($p(economy))"
   puts "Government: $government($p(government))"
@@ -14,6 +45,8 @@ proc describe n {
       [expr {$p(population)/10.0}] $p(inhabitants)]
   puts "Gross productivity: $p(productivity) M Cr"
   puts "Radius: $p(radius) km"
+
+  ## Format the world description, word-wrapping as necessary.
   puts ""
   set ll {}
   set l 0
@@ -26,6 +59,10 @@ proc describe n {
   puts $ll
 }
 
+###--------------------------------------------------------------------------
+### Main program.
+
+## Parse the command line and describe the planets indicated.
 if {[llength $argv] < 1} {
   puts stderr "usage: $argv0 \[-g GALAXY\] PLANET ..."
   exit 1
@@ -55,3 +92,5 @@ for {set i 0} {$i < [llength $argv]} {incr i} {
     }
   }
 }
+
+###----- That's all, folks --------------------------------------------------