widelands-dev team mailing list archive

[GunChleoc <fios@xxxxxxxxxxxxxxxxxxx>]

GunChleoc has proposed merging lp:~widelands-dev/widelands/man-page into lp:widelands.

Commit message:
Updated man page.

Requested reviews:
  Widelands Developers (widelands-dev)
Related bugs:
  Bug #536587 in widelands: "manpage (needs update)"
  https://bugs.launchpad.net/widelands/+bug/536587

For more details, see:
https://code.launchpad.net/~widelands-dev/widelands/man-page/+merge/295232

I proofread and updated the texts.

I also removed most of the options from the man page - while we're in alpha, these are subject to change, and we shouldn't spend too much time trying to keep them in sync.
-- 
Your team Widelands Developers is requested to review the proposed merge of lp:~widelands-dev/widelands/man-page into lp:widelands.

=== modified file 'debian/widelands.6'
--- debian/widelands.6	2016-01-22 07:20:01 +0000
+++ debian/widelands.6	2016-05-19 16:18:36 +0000
@@ -1,6 +1,6 @@
-.TH WIDELANDS "6" "February 2005" "widelands build-9" "User Commands"
+.TH WIDELANDS "6" "February 2014" "widelands build-18" "User Commands"
 .SH NAME
-widelands \- fantasy real-time strategy game
+widelands \- A real-time build-up strategy game
 .SH SYNOPSIS
 .B widelands
 \fI<option0>=<value0> \fR... \fI<optionN>=<valueN>\fR
@@ -8,29 +8,17 @@
 .SH "DESCRIPTION"
 
 In this game, you start out on a small piece of land with nothing more than
-a few of useful resources. Using those, you can build yourself an empire
+a few useful resources. Using those, you can build yourself an empire
 with many thousands of inhabitants. On your way towards this goal, you will
-have to build up an economic infrastructure, explore the lands around you
-and face enemies who are trying to rule the world just like you do.
+have to build up an economic infrastructure, explore the land around you
+and face enemies who are trying to rule the world just like you are.
      
 .SH OPTIONS
 .HP
 \fB\-\-\fR<config\-entry\-name>=value overwrites a config file setting
 .TP
-\fB\-\-record\fR
-Record all events to the given filename for later playback
-.TP
-\fB\-\-playback\fR
-Playback given filename (see \fB\-\-record\fR)
-.TP
-\fB\-\-coredump\fR
-Generates a core dump on segfaults instead of using the SDL
-.TP
-\fB\-\-ggz\fR
-Starts game as GGZ Gaming Zone client (don't use it yet!)
-.TP
 \fB\-\-help\fR
-Show a short help text
+Show the full list of options
 .TP
 \fB\-\-version\fR
 Show version
@@ -39,9 +27,9 @@
 
 In Widelands, you are the regent of a small tribe. You start out with
 nothing but your headquarters, a kind of castle in which all your resources
-are stored. In the course of the game, you will build an ever growing
+are stored. During the course of the game, you will build an ever growing
 settlement. Every member of your tribe will do his or her part to produce
-more resources - wood, food, iron, gold and more - to further this growth.
+more resources - logs, food, iron, gold and more - to further this growth.
 But you are not alone in the world, and you will meet other tribes sooner or
 later. Some of them may be friendly and trade with you. However, if you want
 to rule the world, you will have to train soldiers and fight.
@@ -61,31 +49,34 @@
 attack one of their barracks, and your soldiers will march to fight.
 You're really a ruler: You delegate in times of war and in times of peace!
 
-Widelands offers single-player mode with different campaigns; the campaigns
-all tell the story of a tribe and it's struggle in the Widelands universe!
+Widelands offers a single-player mode with campaigns; the campaigns
+all tell the story of a tribe and its struggle in the Widelands universe!
 However, settling really starts when you unite with friends over the
 Internet or LAN to build up new empires together - or to crush each other in
 the dusts of war.
-Widelands also offers an Artifical Intelligent to challenge.
+Widelands also offers an artificial intelligence to challenge.
 
-In the end, Widelands will be extensible, so that you can create your own
-type of tribe with their own sets of buildings. You can create new worlds to
-play in, and you could even create new types of worlds (who says you can't
-build a settlement on the moon?). 
+Widelands is extensible, so you can create your own type of tribe with their
+own sets of buildings. You can create new worlds to play in, and you could
+even create new types of worlds (who says you can't build a settlement on
+the moon?).
 
 .SH "MORE INFORMATION"
 For more information and support you can find the website, the wiki,
-and the forum for quesions or general support at:
+and the forum for questions or general support at:
 .IP
 http://wl.widelands.org/
 .PP
-You can also find the bug and translations trackers at:
+You can also find the bug tracker at:
 .IP
 https://launchpad.net/widelands
 .PP
-
+If you wish to help with translating, visit:
+.IP
+https://wl.widelands.org/wiki/TranslatingWidelands/
+.PP
 
 .SH AUTHORS
 
-A few dozen of people participated to this project. See the AUTHORS file for
-more information.
+Many people have contributed to the development of Widelands throughout
+the years. See the in-game authors list for more information.