Bug#382690: ssystem: man page out of date
The man page fails to document several keyboard commands. I suggest
the following patch, which also has some spelling and formatting
- In the "body to body" camera mode, pg up/pg dn select body X. How
does the user select body Y?
- Does "demo" mode do anything else?
- Jim Van Zandt
--- debian/ssystem.1-orig 2006-08-12 12:43:18.000000000 -0400
+++ debian/ssystem.1 2006-08-12 13:32:35.000000000 -0400
@@ -2,10 +2,10 @@
.\" $Id: ssystem.1.2 1996/06/30 13:33:54 bousch Exp $
-.TH SSYSTEM 1 "July 1998" "SSYSTEM"
+.TH SSYSTEM 1 "August 2006" "SSYSTEM"
-ssystem \- Solar System Simulator
+ssystem \- solar system simulator
@@ -40,31 +40,31 @@
Aborts program execution after 1000 frames, displaying
Sets sphere SLICES parameter to N
-Sets sphere SLICES parameter to N
+Sets sphere STACKS parameter to N
-These two last options (slices and stacks) have a great performace
+These two last options (slices and stacks) have a great performance
impact (see Performance section)
Hardware acceleration is not required, but highly recommended for
-smooth framerates. I get 48fps (running on Linux) with the "-bench" command
+high frame rates. I get 48fps (running on Linux) with the "-bench" command
line option in my Pentium 233 (overclocked to 266). The Planets' Sphere
-detail (SLICES and STACKS) is the key factor in performance, increse them
+detail (SLICES and STACKS) is the key factor in performance, increase them
if your CPU is powerful enough (I get over 110fps with both set to 2).
Default value for SLICES and STACKS is 12 but you can play with these
-values in the command line (see Command line options section). Depending on
-your system you may start trying with the following values:
+values on the command line (see Command line options section). Depending on
+your system you may start with the following values:
@@ -80,25 +80,50 @@
.SH KEYBOARD BINDINGS:
-Home/End: Selects previous/next body.
-h : Online help
-f : Flat/Smooth shading model.
-t : Texture on/off.
-l : Lighting on/off.
-s : Stars on/off.
-d : Demo mode on/off.
-n : Moves camera near current planet.
-c : Toggle between free and linked to planet camera modes.
-p : Pause
+Select previous/next body.
+Flat/Smooth shading model.
+Real time on/off
+Screenshot (in JPEG format)
+Increase/Decrease star brightness
+Demo mode on/off (step to next body every 10 sec)
+Moves camera near current planet.
+Next camera mode.
+Distant body labels on/off
+Star labels on/off
+Info (HUD) on/off
+Joystick control on/off
+.IP "Page Up/Down"
+Increase/decrease zoom factor (only available in B2B and orbiter
@@ -110,16 +135,24 @@
Page Up/Down: Increase/decrease speed.
-Default camera mode is free. In this mode Arrow keys rotates camera,
-Page Up/Down increase/decrease camera speed.
-Linked mode is a bit different, here arrow keys are useless. You can
-move the camera towards the planet by increasing speed. Once you're near
-the planet program sets camera speed to zero.
+.SS Camera Modes
+There are four camera modes
+This is the default mode. Camera follows the selected body. 'n' is
+very useful in this mode. Arrow keys are useless. You can move the
+camera towards the planet by increasing speed. Once you're near the
+planet program sets camera speed to zero.
+.IP "Body to Body"
+View body X as seen from body Y.
+Camera moves around the select body in a circular orbit (completes an
+orbit in 0.5 local days). Try the zoom key 'z' in this mode.
+.IP "Free Camera"
+You control the camera with arrow keys/joystick/mouse. In this mode
+Arrow keys rotate camera, Page Up/Down increase/decrease camera
Camera speed is limited to 10000 Km/iteration (1 iteration = 1 frame),
which is light speed at 30 frames/sec.
@@ -156,7 +189,7 @@
--Keith Burnett's planet positioning algorithm used with persmission.
+-Keith Burnett's planet positioning algorithm used with permission.
@@ -166,7 +199,7 @@
-And of course, thanks to all of you who help me with suggestions and tips.
-Check ssytem homepage for updates (http://www1.las.es/~amil/ssystem).
+Check ssystem homepage for updates (http://www1.las.es/~amil/ssystem).
Raul Alonso <email@example.com>
@@ -177,5 +210,5 @@
Outer bodies movement is a bit jerky. Although ssystem uses double
precision floating point arithmetic, Mesa uses simple precision arithmetic
-internally (faster and precise enough for most aplications). I'm working
+internally (faster and precise enough for most applications). I'm working
-- System Information:
Debian Release: testing/unstable
APT prefers unstable
APT policy: (990, 'unstable'), (500, 'oldstable'), (500, 'testing'), (500, 'stable')
Architecture: i386 (i686)
Shell: /bin/sh linked to /bin/bash
Kernel: Linux 2.6.17
Locale: LANG=C, LC_CTYPE=C (charmap=ANSI_X3.4-1968)
Versions of packages ssystem depends on:
ii freeglut3 2.4.0-5 OpenGL Utility Toolkit
ii libc6 2.3.6-7 GNU C Library: Shared libraries
ii libjpeg62 6b-12 The Independent JPEG Group's JPEG
ii xlibmesa-gl [libgl 4.3.0.dfsg.1-14 Mesa 3D graphics library [XFree86]
ii xlibmesa-glu [libg 4.3.0.dfsg.1-14sarge1 Mesa OpenGL utility library [XFree
ssystem recommends no packages.
-- no debconf information