[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#382690: marked as done (ssystem: man page out of date)



Your message dated Mon, 18 Sep 2006 09:02:08 -0700
with message-id <E1GPLZQ-0003p7-BY@spohr.debian.org>
and subject line Bug#382690: fixed in ssystem 1.6-17
has caused the attached Bug report to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what I am
talking about this indicates a serious mail system misconfiguration
somewhere.  Please contact me immediately.)

Debian bug tracking system administrator
(administrator, Debian Bugs database)

--- Begin Message ---
Package: ssystem
Version: 1.6-16
Severity: normal


The man page fails to document several keyboard commands.  I suggest
the following patch, which also has some spelling and formatting
improvements.

TODO: 

 - 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"
 
 .SH NAME
-ssystem \- Solar System Simulator
+ssystem \- solar system simulator
 
 .SH SYNOPSIS
 .B ssystem
@@ -40,31 +40,31 @@
 .TP 10
 .BI \-bench
 Aborts program execution after 1000 frames, displaying
-framerate.
+frame rate.
 .TP
 .B \-slices 
 Sets sphere SLICES parameter to N
 .TP
 .B \-stacks 
-Sets sphere SLICES parameter to N
+Sets sphere STACKS parameter to N
 
 .PP
-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)
 .PP
 
 .SH PERFORMANCE
 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).
 
 .PP
 
 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:
 
 					SLICES		STACKS
 
@@ -80,25 +80,50 @@
 
 
 .SH KEYBOARD BINDINGS:
-Home/End: Selects previous/next body.
-.PP
-h : Online help
-.PP
-f : Flat/Smooth shading model.
-.PP
-t : Texture on/off.
-.PP
-l : Lighting on/off.
-.PP
-s : Stars on/off.
-.PP
-d : Demo mode on/off.
-.PP
-n : Moves camera near current planet.
-.PP
-c : Toggle between free and linked to planet camera modes.
-.PP
-p : Pause
+.IP "Home/End"
+Select previous/next body.
+.IP h
+Online help
+.IP a
+Atmosphere on/off
+.IP t
+Texture on/off
+.IP l
+Lighting on/off.
+.IP f
+Flat/Smooth shading model.
+.IP r
+Real time on/off
+.IP s
+Stars on/off.
+.IP S
+Screenshot (in JPEG format)
+.IP "m/M"
+Increase/Decrease star brightness
+.IP d
+Demo mode on/off (step to next body every 10 sec)
+.IP n
+Moves camera near current planet.
+.IP c
+Next camera mode.
+.IP o/O
+Wider/Narrower FOV
+.IP p
+Pause
+.IP b
+Distant body labels on/off
+.IP B
+Star labels on/off
+.IP i
+Info (HUD) on/off
+.IP j
+Joystick control on/off
+.IP "Page Up/Down"
+Increase/decrease speed
+.IP "z/Z"
+Increase/decrease zoom factor (only available in B2B and orbiter
+camera modes)
+
 .PP
 .PP
 
@@ -110,16 +135,24 @@
 .PP
 Page Up/Down: Increase/decrease speed.
 
-Camera movement:
-.PP
-Default camera mode is free. In this mode Arrow keys rotates camera, 
-.PP 
-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
+.IP Linked
+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.
+.IP Orbiter
+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
+speed.
 
+.PP
 Camera speed is limited to 10000 Km/iteration (1 iteration = 1 frame), 
 which is light speed at 30 frames/sec.
 
@@ -156,7 +189,7 @@
 .PP 
 http://iraf.noao.edu/~ecdowney/xephem.html
 
--Keith Burnett's planet positioning algorithm used with persmission.
+-Keith Burnett's planet positioning algorithm used with permission.
 .PP 
 http://www.xylem.demon.co.uk/kepler/
 
@@ -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).
 
 .SH AUTHOR
 Raul Alonso <amil@las.es>
@@ -177,5 +210,5 @@
 .SH BUGS
 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
 on it.


-- 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


--- End Message ---
--- Begin Message ---
Source: ssystem
Source-Version: 1.6-17

We believe that the bug you reported is fixed in the latest version of
ssystem, which is due to be installed in the Debian FTP archive:

ssystem_1.6-17.diff.gz
  to pool/main/s/ssystem/ssystem_1.6-17.diff.gz
ssystem_1.6-17.dsc
  to pool/main/s/ssystem/ssystem_1.6-17.dsc
ssystem_1.6-17_amd64.deb
  to pool/main/s/ssystem/ssystem_1.6-17_amd64.deb



A summary of the changes between this version and the previous one is
attached.

Thank you for reporting the bug, which will now be closed.  If you
have further comments please address them to 382690@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Michael Ablassmeier <abi@debian.org> (supplier of updated ssystem package)

(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster@debian.org)


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Format: 1.7
Date: Mon, 18 Sep 2006 17:45:52 +0200
Source: ssystem
Binary: ssystem
Architecture: source amd64
Version: 1.6-17
Distribution: unstable
Urgency: low
Maintainer: Debian QA Group <packages@qa.debian.org>
Changed-By: Michael Ablassmeier <abi@debian.org>
Description: 
 ssystem    - 3D solar system simulator
Closes: 377429 382690
Changes: 
 ssystem (1.6-17) unstable; urgency=low
 .
   * QA upload.
   * Add Patch for debian/ssystem.1 by James R. Van Zandt
     (Closes: #382690)
   * Add .desktop File, thanks Barry deFreese (Closes: #377429)
   * Conforms with latest Standards Version 3.7.2
Files: 
 d6e88cca372d7ac1c5a27a74c0e6376d 621 science optional ssystem_1.6-17.dsc
 ad702fa7be83ac380f9c1e55cf41e0df 8405 science optional ssystem_1.6-17.diff.gz
 5197aa349464fa3547af43d5c67c1320 1083952 science optional ssystem_1.6-17_amd64.deb

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.5 (GNU/Linux)

iD8DBQFFDsFjEFV7g4B8rCURAmV7AKDl+FyAPhcZnu4wtcxIOb2D5KS5WgCgpm0D
0oasQBMufKRfvm3IBWg39Zg=
=Xxq+
-----END PGP SIGNATURE-----


--- End Message ---

Reply to: