FreeCol

Revision: 4432
          http://freecol.svn.sourceforge.net/freecol/?rev=4432&view=rev
Author:   burschik
Date:     2008-10-04 10:18:55 +0000 (Sat, 04 Oct 2008)

Log Message:
-----------
Minor updates.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2008-10-04 09:01:44 UTC (rev 4431)
+++ freecol/trunk/doc/FreeCol.tex	2008-10-04 10:18:55 UTC (rev 4432)
@@ -130,14 +130,12 @@
 available. In practice, however, things are less clear cut.
 
 FreeCol is known to work with Sun's Java 5 and 6 (which you can get
-\href{http://java.sun.com/}{here}, but not with projects based on GNU
-Classpath or OpenJDK, as some font handling classes used by FreeCol
-have not yet been implemented. This is expected to change in the near
-future, however. FreeCol is known to run on recent versions of Windows
-and Linux, and on MacOSX to some extent. If you are using Linux, using
-Java 6 is recommended, as its font rendering is much better. If you
-are using FreeCol on a different platform, we would like to hear about
-it.
+\href{http://java.sun.com/}{here}. FreeCol also works with OpenJDK,
+although some problems and graphics glitches remain. FreeCol is known
+to run on recent versions of Windows and Linux, and on MacOSX to some
+extent. If you are using Linux, using Java 6 is recommended, as its
+font rendering is much better. If you are using FreeCol on a different
+platform, we would like to hear about it.
 
 FreeCol requires at least 128 MB memory and works best with a screen
 resolution of at least 1024x768 pixels. You can still use the game
@@ -714,6 +712,7 @@
 \item\verb$S$: the unit is a sentry (waiting for transport).
 \item\verb$W$: the unit is waiting for orders (skipped).
 \item\verb$0$: the unit has no moves left.
+\item\verb$#$: the unit's state is unknown (some enemy units).
 \end{itemize}
 
 If the unit is a foreign naval unit, the shield will display a number
@@ -746,7 +745,8 @@
 \item\verb$d$: disband the active unit.
 \item\verb$e$: show the Europe panel.
 \item\verb$f$: fortify.
-\item\verb$g$: goto some destination.
+\item\verb$g$: goto some destination tile.
+\item\verb$h$: goto some colony (or Europe if a ship).
 \item\verb$p$: plow the current tile (requires 20 tools).
 \item\verb$r$: build a road on the current tile (requires 20 tools).
 \item\verb$s$: be a sentry (wait for something to happen).


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 4453
          http://freecol.svn.sourceforge.net/freecol/?rev=4453&view=rev
Author:   burschik
Date:     2008-10-11 11:27:58 +0000 (Sat, 11 Oct 2008)

Log Message:
-----------
Fix typos as suggested by Oliver Guth.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2008-10-11 10:54:48 UTC (rev 4452)
+++ freecol/trunk/doc/FreeCol.tex	2008-10-11 11:27:58 UTC (rev 4453)
@@ -652,7 +652,7 @@
 tile contains some of your units, the menu will also enable you to
 select each of these units. If the tile contains a native settlement,
 the menu will also provide you with an item that will bring up some
-information on that settlement. It the tile contains one of your own
+information on that settlement. If the tile contains one of your own
 colonies, the menu will also allow you to open the \hyperlink{colony
 panel}{colony panel}.
 
@@ -788,7 +788,7 @@
 direction by dragging it from the Going to America box to the Going
 to Europe box (or vice versa).
 
-If a ship has docked at the European port can drag and drop units
+If a ship has docked at the European port you can drag and drop units
 between the Docks and Cargo panel. You drag and drop goods between the
 Cargo panel and the Market panel. If you want to buy or sell less than
 100 units of goods, press the shift key while dragging. This will
@@ -907,7 +907,7 @@
 \item Unload the active ship or wagon train
 \item Fill up all partially filled holds of the active ship or
 wagon train
-\item Open the warehouse dialog in able to change the export and
+\item Open the warehouse dialog in order to change the export and
 warning levels for all types of goods (see below)
 \item Rename the colony
 \item Close the dialog


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 4454
          http://freecol.svn.sourceforge.net/freecol/?rev=4454&view=rev
Author:   burschik
Date:     2008-10-11 11:32:02 +0000 (Sat, 11 Oct 2008)

Log Message:
-----------
Clarify missionary/equipment.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2008-10-11 11:27:58 UTC (rev 4453)
+++ freecol/trunk/doc/FreeCol.tex	2008-10-11 11:32:02 UTC (rev 4454)
@@ -1164,7 +1164,10 @@
 colonists blessed as missionaries in the \hyperlink{Home Port}{Home
   Port} or any colony with a \hyperlink{Church}{Church}, are able to
 establish a \Concept{Mission} or to incite the natives against another
-European nation.
+European nation. If a Jesuit Missionary, or an ordinary colonist
+blessed as a missionary is equipped with tools, muskets or horses, he
+loses his missionary status and is no longer able to establish a
+mission.
 
 The presence of a Mission will reduce tension between the natives and
 your colonists. In time, some of the natives may also convert and join


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 4468
          http://freecol.svn.sourceforge.net/freecol/?rev=4468&view=rev
Author:   mpope
Date:     2008-10-14 11:11:27 +0000 (Tue, 14 Oct 2008)

Log Message:
-----------
Clarification of two surprises.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2008-10-14 10:24:28 UTC (rev 4467)
+++ freecol/trunk/doc/FreeCol.tex	2008-10-14 11:11:27 UTC (rev 4468)
@@ -1809,14 +1809,16 @@
 The \hyperlink{Schoolhouse}{Schoolhouse} and its upgrades, the
 \hyperlink{College}{College} and the
 \hyperlink{University}{University}, allow you to train your units
-yourself by placing a skilled unit in one of these buildings. Note
-that the Master Sugar Planter, the Master Cotton Planter, the Master
-Tobacco Planter, the Expert Fur Trapper, the Master Distiller, the
-Master Weaver, the Master Tobacconist, the Master Blacksmith and the
-Master Gunsmith all require at least a \hyperlink{College}{College},
-while the Elder Statesman, the Firebrand Preacher and the Jesuit
-Missionary even require a \hyperlink{University}{University} to teach
-their profession.
+yourself by placing a skilled unit in one of these buildings.  If a
+suitable student exists in the colony it will automatically appear
+below the teacher in the building, as well as continuing to perform
+its current task.  Note that the Master Sugar Planter, the Master
+Cotton Planter, the Master Tobacco Planter, the Expert Fur Trapper,
+the Master Distiller, the Master Weaver, the Master Tobacconist, the
+Master Blacksmith and the Master Gunsmith all require at least a
+\hyperlink{College}{College}, while the Elder Statesman, the Firebrand
+Preacher and the Jesuit Missionary even require a
+\hyperlink{University}{University} to teach their profession.
 
 A Free Colonist can learn any skill or profession in this manner, but
 Petty Criminals and Indentured Servants can not.  However, a Petty
@@ -2178,7 +2180,7 @@
 of Independence}}
 
 As soon as 50\% of your entire population support the Sons of Liberty,
-you can declare the independence of your colonies. Your
+you can declare the independence of your colonies.  Your
 \hyperlink{Monarch}{Monarch} will not be amused and will send the
 \hyperlink{Royal Expeditionary Force}{Royal Expeditionary Force} to
 quell the insurrection. In order to gain independence, you must defeat
@@ -2186,9 +2188,12 @@
 their land forces and by taking back any colonies they might have
 captured. You do not need to destroy the fleet.
 
-In the future, the European enemies of your Monarch may support your
-effort if you generate a sufficient number of Liberty Bells after the
-War of Independence has begun.
+At the declaration, colonies with strong support for the Sons of
+Liberty sometimes promote veteran soldiers at work there to
+\Unit{Colonial Regular} in preparation for the coming war.  In the
+future, the European enemies of your Monarch may support your effort
+if you generate a sufficient number of Liberty Bells after the War of
+Independence has begun.
 
 
 \hypertarget{Known bugs}{\section{Known bugs}}


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 4553
          http://freecol.svn.sourceforge.net/freecol/?rev=4553&view=rev
Author:   burschik
Date:     2008-11-09 13:04:37 +0000 (Sun, 09 Nov 2008)

Log Message:
-----------
Some additions.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2008-11-09 11:52:54 UTC (rev 4552)
+++ freecol/trunk/doc/FreeCol.tex	2008-11-09 13:04:37 UTC (rev 4553)
@@ -126,7 +126,7 @@
 
 FreeCol is written in Java. In order to run, it requires a Java
 Virtual Machine. In theory, FreeCol should run on any platform on
-which a Java Virtual Machine compatible with Sun Java 5 or 6 is
+which a Java Virtual Machine compatible with Sun Java 5 or higher is
 available. In practice, however, things are less clear cut.
 
 FreeCol is known to work with Sun's Java 5 and 6 (which you can get
@@ -710,6 +710,7 @@
 \item\verb$P$: the unit is plowing a tile.
 \item\verb$R$: the unit is building a road.
 \item\verb$S$: the unit is a sentry (waiting for transport).
+\item\verb$T$: the unit is following a trade route.
 \item\verb$W$: the unit is waiting for orders (skipped).
 \item\verb$0$: the unit has no moves left.
 \item\verb$#$: the unit's state is unknown (some enemy units).
@@ -1095,7 +1096,8 @@
 Note that the ships and wagon trains will take the capacity and
 settings of the warehouses in your colonies into account. They will
 not unload cargo that would be wasted and they will only load goods
-that should not be kept in reserve.
+that should not be kept in reserve. This means that they may wait
+for a long time until a sufficient number of goods becomes available.
 
 As soon as a ship or wagon train reaches the last destination of the
 trade route, it will continue at the first destination.
@@ -1207,6 +1209,20 @@
 Rumours always yield positive results.
 
 
+\hypertarget{Exploration}{\subsection{Exploration}}
+
+The original Colonization game awarded exploration points only for the
+discovery of the Pacific Ocean. This is also the default behaviour for
+FreeCol. However, you may choose to play with exploration points, in
+which case you will be awarded exploration points for the discovery of
+a new region of the New World.
+
+A region may be either a large area of land, a mountain range, or a
+river valley. If you discover a region, you will be asked to name it,
+and you will be awarded a number of exploration points depending on
+the size of the region discovered.
+
+
 \hypertarget{Colonies}{\section{Colonies}}
 
 \hypertarget{Picking a suitable site}{\subsection{Picking a suitable site}}
@@ -1456,18 +1472,18 @@
 your colony, and the \hyperlink{Dock}{Docks} enable your colonists to
 go fishing. The effects of these buildings can not be increased by
 workers. In the building box at the top right of the \hyperlink{colony
-panel}{colony panel}, these buildings are shown in parentheses (like
-this: ``(Stockade)'').
+panel}{colony panel}, these buildings are shown in parentheses, like
+this: ``(Stockade)''.
 
-Most buildings do nothing by themselves, but provide workers with a
-place to produce manufactured goods. The \hyperlink{Tobacconist's
-House}{Tobacconist's House}, for example, allows colonists to make
-\hyperlink{Cigars}{Cigars} from \hyperlink{Tobacco}{Tobacco}. Place
-one or more colonists in a building in order to convert raw materials
-to manufactured goods, which can be sold for higher prices. For each
-building, there are expert units that work more effectively than
-\hyperlink{Free Colonist}{Free Colonists}. Other units may work less
-effectively.
+Most buildings do nothing if they are unoccupied, but provide workers
+with a place to produce manufactured goods. The
+\hyperlink{Tobacconist's House}{Tobacconist's House}, for example,
+allows colonists to make \hyperlink{Cigars}{Cigars} from
+\hyperlink{Tobacco}{Tobacco}. Place one or more colonists in a
+building in order to convert raw materials to manufactured goods,
+which can be sold for higher prices. For each building, there are
+expert units that work more effectively than \hyperlink{Free
+  Colonist}{Free Colonists}. Other units may work less effectively.
 
 
 \hypertarget{Building Units and Buildings}{\subsection{Building Units 
@@ -1779,6 +1795,39 @@
 %% \raisebox{-10mm}{\includegraphics{../data/images/units/Unit2.png}} & Expert Fisherman & 1 & 3 & 0 & 1\\
 %% \end{longtable}
 
+\hypertarget{Equipment}{\subsection{Equipment}}
+
+Most units can be equipped with tools, horses, muskets, or a
+bible. This equipment grants them certain abilities, which they do not
+possess without that equipment. Certain units are particularly skilled
+with that equipment, but without it they have no special abilities:
+
+\begin{itemize}
+\item Only a unit equipped with tools is able to build roads, plow
+  fields and cut down forests. Even the Hardy Pioneer is unable to do
+  so without suitable equipment.
+
+\item Only a unit equipped with horses is able to scout Indian
+  settlements and foreign colonies. Even the Seasoned Scout can't do
+  that without being mounted.
+
+\item Only a unit equipped with muskets is a soldier. Veteran Soldiers
+  are more effective than other units when equipped with muskets, but
+  without muskets they have no advantage.
+
+\item Only a unit equipped with a bible is commissioned as a
+  missionary and able to establish a mission in an Indian
+  settlement. Even the Jesuit Missionary is unable to do so without a
+  bible. If a Jesuit Missionary is equipped with tools, muskets or
+  horses, he loses his bible. If that happens, the Jesuit Missionary
+  carries his hat, rather than his bible in his hand.
+\end{itemize}
+
+Of course, units that do not represent people, such as ships, wagon
+trains and treasure trains, can not be equipped. The Indian Convert is
+another unit that can not be equipped.
+
+
 \hypertarget{Skills and Education}{\subsection{Skills and Education}}
 
 In FreeCol, your colonists come from all walks of life. Some are
@@ -2190,12 +2239,41 @@
 
 At the declaration, colonies with strong support for the Sons of
 Liberty sometimes promote veteran soldiers at work there to
-\Unit{Colonial Regular} in preparation for the coming war.  In the
-future, the European enemies of your Monarch may support your effort
-if you generate a sufficient number of Liberty Bells after the War of
-Independence has begun.
+\hyperlink{Colonial Regular}{Colonial Regular} in preparation for the
+coming war.  In the future, the European enemies of your Monarch may
+support your effort if you generate a sufficient number of Liberty
+Bells after the War of Independence has begun.
 
 
+\hypertarget{Changing the Rules}{\section{Changing the Rules}}
+
+We would like to make FreeCol configurable, so that the game engine
+becomes capable of emulating many similar games. For this purpose,
+we have made many of the game's features configurable.
+
+At some point in the future, we will probably add a special rule set
+editor, but at the moment, your only option is to edit the file
+specification.xml directly. This file defines the abilities of units,
+founding fathers, buildings, terrain types, goods and equipment, for
+example.
+
+This is still work in progress, however, and we are particularly
+interested in hearing about problems caused by changes to the rule
+set. Some dialogs might be unable to display more types of goods than
+are currently defined, for example. Or other dialogs might not
+recognize your new Minuteman unit as an armed unit. Please help us
+improve FreeCol by telling us about such problems.
+
+If you have a working rule set that adds a new flavour to the game, we
+will gladly distribute it along with our default rule set. If you have
+ideas that can not currently be implemented, we will probably try to
+remove these limitations.
+
+If you try to modify the rule set, you are strongly encouraged to
+check whether the result is still valid. You can do this by validating
+the result with the command \verb$ant validate$.
+
+
 \hypertarget{Known bugs}{\section{Known bugs}}
 
 FreeCol is still alpha software. In plain English, this means that it


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 4662
          http://freecol.svn.sourceforge.net/freecol/?rev=4662&view=rev
Author:   burschik
Date:     2008-12-03 06:23:03 +0000 (Wed, 03 Dec 2008)

Log Message:
-----------
Add description of Modifiers and Abilities.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2008-12-03 05:43:38 UTC (rev 4661)
+++ freecol/trunk/doc/FreeCol.tex	2008-12-03 06:23:03 UTC (rev 4662)
@@ -2284,6 +2284,423 @@
 the result with the command \verb$ant validate$.
 
 
+\hypertarget{Modifiers and Abilities}{\subsection{Modifiers and Abilities}}
+
+Most of the objects defined by the rule set can be customized via
+modifiers and abilities.  Abilities are boolean values (``true'' or
+``false''). If the value is not explicitly stated, it defaults to
+true. If an ability is not present, it defaults to false. Modifiers
+define a bonus or penalty to be applied to a numeric value, such as
+the number of goods produced by a unit. The modifier may be an
+additive, multiplicative or a percentage modifier. Modifiers default
+to ``identity'', which means they have no effect.
+
+The code also checks that all abilities and modifiers it uses are
+defined by the specification. Therefore, you must define all of them,
+even if you do not use them. You can do this by setting their value to
+the default value, e.g. ``false'' in the case of an ability, or ``0''
+in the case of an additive modifier.
+
+\newcommand{\ability}[1]{\index{#1}\index{Ability!#1}\hypertarget{#1}{\vspace{1em}\noindent\textbf{#1}}}
+\newcommand{\modifier}[1]{\index{#1}\index{Modifier!#1}\hypertarget{#1}{\vspace{1em}\noindent\textbf{#1}}}
+\newcommand{\affectsPlayer}{\\\textit{Affects: Player\\Provided by:
+    Nation, Nation Type, Founding Father}}
+\newcommand{\affectsUnit}{\\\textit{Affects: Unit\\Provided by:
+    Nation, Nation Type, Founding Father, Unit Type, Equipment Type}}
+\newcommand{\affectsBuilding}{\\\textit{Affects: Building\\Provided by:
+    Building Type}}
+\newcommand{\affectsColony}{\\\textit{Affects: Colony\\Provided by:
+    Map}}
+\newcommand{\affectsTile}{\\\textit{Affects: Tile\\Provided by:
+    Tile Type}}
+
+
+\ability{model.ability.addTaxToBells}
+\affectsPlayer
+
+The player adds the current tax rate as a bonus to bells production.
+
+\ability{model.ability.alwaysOfferedPeace}
+\affectsPlayer
+
+The player is always offered peace in negotiations with AI players.
+
+\ability{model.ability.ambushBonus}
+\affectsUnit
+
+The unit is granted an ambush bonus equal to the terrain's defence value.
+
+\ability{model.ability.ambushPenalty}
+\affectsUnit
+
+The unit suffers an ambush penalty equal to the terrain's defence value.
+
+\ability{model.ability.autoProduction}
+\affectsBuilding
+
+The building produces goods even if no units are present.
+
+\ability{model.ability.automaticEquipment}
+\affectsUnit
+
+The unit automatically picks up equipment if attacked.
+
+\ability{model.ability.automaticPromotion}
+\affectsUnit
+
+A unit that can be promoted will always be promoted when successful in
+battle.
+
+\ability{model.ability.betterForeignAffairsReport}
+\affectsPlayer
+
+The player is provided with more information about foreign powers.
+
+\ability{model.ability.bombard}
+\affectsUnit
+
+The unit is able to bombard other units.
+
+\ability{model.ability.bombardShips}
+\affectsBuilding
+
+The building has the ability to bombard enemy ships on adjacent tiles.
+
+\ability{model.ability.bornInColony}
+\affectsUnit
+
+The unit can be born in a colony, provided that enough food is available.
+
+\ability{model.ability.bornInIndianSettlement}
+\affectsUnit
+
+The unit can be born in an Indian settlement, provided that enough food is available.
+
+\ability{model.ability.build}
+\affectsBuilding
+
+The building can build units or equipment.
+
+\ability{model.ability.buildCustomHouse}
+\affectsPlayer
+
+The player can build custom houses.
+
+\ability{model.ability.buildFactory}
+\affectsPlayer
+
+The player can build factories.
+
+\ability{model.ability.canBeCaptured}
+\affectsUnit
+
+The unit can be captured. Land units that can not be captured are
+destroyed, naval units that can not be captured are either sunk or
+damaged.
+
+\ability{model.ability.canBeEquipped}
+\affectsUnit
+
+The unit can be equipped.
+
+\ability{model.ability.canNotRecruitUnit}
+\affectsPlayer
+
+The player can not recruit specified units.
+
+\ability{model.ability.captureEquipment}
+\affectsUnit
+
+The unit can capture equipment from another unit.
+
+\ability{model.ability.captureGoods}
+\affectsUnit
+
+The unit can capture goods from another unit.
+
+\ability{model.ability.captureUnits}
+\affectsUnit
+
+The unit can capture enemy units.
+
+\ability{model.ability.carryGoods}
+\affectsUnit
+
+The unit can transport goods.
+
+\ability{model.ability.carryTreasure}
+\affectsUnit
+
+The unit can transport treasures, not treasure trains.
+
+\ability{model.ability.carryUnits}
+\affectsUnit
+
+The unit can transport other units.
+
+\ability{model.ability.convert}
+\affectsUnit
+
+The unit is a native convert.
+
+\ability{model.ability.dressMissionary}
+\affectsBuilding
+
+The building can commission missionaries.
+
+\ability{model.ability.electFoundingFather}
+\affectsPlayer
+
+The player can elect Founding Fathers.
+
+\ability{model.ability.expertMissionary}
+\affectsUnit
+
+The unit is an expert missionary, but not necessarily commissioned.
+
+\ability{model.ability.expertPioneer}
+\affectsUnit
+
+The unit is an expert pioneer, but not necessarily equipped with tools.
+
+\ability{model.ability.expertScout}
+\affectsUnit
+
+The unit is an expert scout, but not necessarily equipped with horses.
+
+\ability{model.ability.expertSoldier}
+\affectsUnit
+
+The unit is an expert soldier, but not necessarily equipped with muskets.
+
+\ability{model.ability.expertsUseConnections}
+\affectsPlayer
+
+Experts working in factories can produce a small amount of goods even
+if the raw materials are not available in the colony.
+
+\ability{model.ability.export}
+\affectsBuilding
+
+The building can export goods to Europe directly.
+
+\ability{model.ability.foundColony}
+\affectsUnit
+
+The unit can found new colonies.
+
+\ability{model.ability.foundInLostCity}
+\affectsUnit
+
+The unit may be generated as the result of exploring a Lost City Rumour.
+
+\ability{model.ability.hasPort}
+\affectsColony
+
+The colony has access to at least one water tile. This ability can not
+be set by the specification, but it can be used as a required ability.
+
+\ability{model.ability.ignoreEuropeanWars}
+\affectsPlayer
+
+The player will not be affected by the Monarch's declarations of war.
+
+\ability{model.ability.improveTerrain}
+\affectsUnit
+
+The unit is able to improve terrain.
+
+\ability{model.ability.independenceDeclared}
+\affectsPlayer
+
+The player has declared independence.
+
+\ability{model.ability.mercenaryUnit}
+\affectsUnit
+
+The unit may be offered as a mercenary unit.
+
+\ability{model.ability.missionary}
+\affectsUnit
+
+The unit is able to establish missions and incite unrest in native
+settlements.
+
+\ability{model.ability.moveToEurope}
+\affectsTile
+
+Units on the tile are able to move to Europe.
+
+\ability{model.ability.multipleAttacks}
+\affectsUnit
+
+The unit can attack more than once.
+
+\ability{model.ability.native}
+\affectsUnit
+
+The unit is a native unit.
+
+\ability{model.ability.navalUnit}
+\affectsUnit
+
+The unit is a naval unit.
+
+\ability{model.ability.pillageUnprotectedColony}
+\affectsUnit
+
+The unit is able to steal goods from and destroy buildings in an
+unprotected colony.
+
+\ability{model.ability.piracy}
+\affectsUnit
+
+The unit is a privateer.
+
+\ability{model.ability.preventAbandonColony}
+\affectsBuilding
+
+The building prevents the colony from being abandoned.
+
+\ability{model.ability.produceInWater}
+\affectsBuilding
+
+The building enables units to produce on water tiles.
+
+\ability{model.ability.refUnit}
+\affectsUnit
+
+The unit can be part of the Royal Expeditionary Force.
+
+\ability{model.ability.repairUnits}
+\affectsBuilding
+
+The building can repair units.
+
+\ability{model.ability.royalExpeditionaryForce}
+\affectsPlayer
+
+The player is a Royal Expeditionary Force.
+
+\ability{model.ability.rumoursAlwaysPositive}
+\affectsPlayer
+
+The player will always get positive results from exploring Lost City
+Rumours.
+
+\ability{model.ability.scoutForeignColony}
+\affectsUnit
+
+The unit can scout out foreign colonies.
+
+\ability{model.ability.scoutIndianSettlement}
+\affectsUnit
+
+The unit can scout out native settlements.
+
+\ability{model.ability.selectRecruit}
+\affectsPlayer
+
+The player can select a unit to recruit in Europe. This also applies
+to units generated as a result of finding a Fountain of Youth.
+
+\ability{model.ability.teach}
+\affectsBuilding
+
+The building enables experts to teach other units.
+
+\ability{model.ability.tradeWithForeignColonies}
+\affectsPlayer
+
+The player may trade goods in foreign colonies.
+
+\ability{model.ability.undead}
+\affectsUnit
+
+The unit is an undead unit (used only in revenge mode).
+
+
+
+
+
+\modifier{model.modifier.bombardBonus}
+\affectsPlayer
+
+The player's units are granted a bombard bonus when attacking.
+
+\modifier{model.modifier.buildingPriceBonus}
+\affectsPlayer
+
+The player can build or buy buildings at a reduced price.
+
+\modifier{model.modifier.defence}
+\affectsUnit
+
+The unit has a defence bonus or penalty.
+
+\modifier{model.modifier.landPaymentModifier}
+\affectsPlayer
+
+The player can buy Indian land at a reduced price.
+
+\modifier{model.modifier.lineOfSightBonus}
+\affectsUnit
+
+The unit has an increased line of sight.
+
+\modifier{model.modifier.movementBonus}
+\affectsUnit
+
+The unit has an increased movement range.
+
+\modifier{model.modifier.nativeAlarmModifier}
+\affectsPlayer
+
+The player generates less native alarm.
+
+\modifier{model.modifier.nativeConvertBonus}
+\affectsPlayer
+
+The player has a greater chance of converting natives.
+
+\modifier{model.modifier.nativeTreasureModifier}
+\affectsPlayer
+
+The player generates greater treasures when destroying native settlements.
+
+\modifier{model.modifier.offence}
+\affectsUnit
+
+The unit has an offence bonus or penalty.
+
+\modifier{model.modifier.religiousUnrestBonus}
+\affectsPlayer
+
+The player generates greater religious unrest in Europe.
+
+\modifier{model.modifier.sailHighSeas}
+\affectsUnit
+
+The unit's travel time between Europe and the New World is reduced.
+
+\modifier{model.modifier.tradeBonus}
+\affectsPlayer
+
+Prices in the player's market remain stable for longer.
+
+\modifier{model.modifier.treasureTransportFee}
+\affectsPlayer
+
+The player pays a smaller fee for transporting treasures to Europe.
+
+\modifier{model.modifier.warehouseStorage}
+\affectsBuilding
+
+The building increases the capacity of the warehouse.
+
+
+
+
 \hypertarget{Known bugs}{\section{Known bugs}}
 
 FreeCol is still alpha software. In plain English, this means that it


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 4758
          http://freecol.svn.sourceforge.net/freecol/?rev=4758&view=rev
Author:   burschik
Date:     2008-12-26 13:27:03 +0000 (Fri, 26 Dec 2008)

Log Message:
-----------
Update for 0.8.0.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2008-12-26 12:13:39 UTC (rev 4757)
+++ freecol/trunk/doc/FreeCol.tex	2008-12-26 13:27:03 UTC (rev 4758)
@@ -307,9 +307,10 @@
 displays the game objects and how it handles some tasks such as
 auto-saving.
 
-First, we have general \hypertarget{display options}{display options}:
+\hypertarget{display options}{\subsubsection{Display Options}}:
 
 \begin{itemize}
+
 \item The language\index{language} to use. Some languages are spoken in
 more than one country. In this case, you might also be able to select
 a specific country. If the translation you choose is not complete, the
@@ -318,31 +319,72 @@
 version. If you selected Austrian German, for example, missing strings
 would be taken from the default German translation if available, and
 the English language version otherwise.
+
 \item The minimum number of goods to display with a counter. If you
 accept the default setting of seven, for example, six hammers will be
 displayed without a number, and seven hammers will be displayed with
 the number \verb$7$ on top. Note that some panels only show a single
 item with a number next to it or below it anyway.
+
 \item The maximum number of goods to display. If you accept the
 default setting of seven, then no more than seven items will be
 displayed, even if the corresponding counter tells you that these
 seven items represent a far larger amount.
+
+\item Whether to center on the selected tile automatically.
+
 \item Whether to center on the active unit always.
-\item Whether to display the Fog of War.
+
+\item Whether to display the \textit{Fog of War}, which enables you to
+  see which tiles are currently visible to your units..
+
 \item Whether to scroll the map when dragging with the mouse.
+
+\item Whether to display the \hyperlink{compass rose}{compass rose} in
+  the top right hand corner of the map. The compass rose enables you
+  to direct your units with the mouse as well as the keypad. This is
+  particularly useful if you play with a small keyboard, such as a
+  laptop keyboard, which does not have a keypad.
+
+\item Whether to display the map controls, which include the
+  \hyperlink{minimap}{minimap}, the \hyperlink{info panel}{info panel}
+  and the \hyperlink{unit buttons}{unit buttons}.
+
+\item Whether to display the map grid.
+
+\item Whether to display tile names, owners, regions or none of the
+  above.
+
 \item Whether to sort your colonies by name, age, position, size or
 Sons of Liberty membership. Since name, age and position are unique,
 these keys impose a total order, whereas size and Sons of Liberty
 membership do not. In the case of size, the Sons of Liberty membership
 is used as a secondary key, and vice versa.
+
+\item How to animate the movements of your own units.
+
+\item How to animate the movements of enemy units.
+
+\item How to display the minimap:
+
+\begin{itemize}
+\item Whether to attempt smooth rendering.
+
+\item Which background color to use.
+
+\item Which zoom level to use as default.
 \end{itemize}
 
-Next, we have message display options: You can choose whether to group
-messages by type, by source, or not at all. The source of the message
-is a game object, typically a colony or unit, and the type of the
-message is either the default type, which is always displayed, or one
-of the following types, which can be turned off:
+\end{itemize}
 
+\hypertarget{message options}{\subsubsection{Message Options}}
+
+You can choose whether to group messages by type, by source, or not at
+all. The source of the message is a game object, typically a colony or
+unit, and the type of the message is either the default type, which is
+always displayed, or one of the following types, which can be turned
+off:
+
 \begin{itemize}
 \item Warning messages. These are important and should generally not
 be turned off.
@@ -363,16 +405,26 @@
 \item Foreign diplomatic messages about the declaration of wars and
 signing of peace treaties.
 \item Messages about the prices of goods in Europe changing.
+\item Messages about reduced production due to missing goods.
 \item Warnings about the suitability of colony sites. These messages
   are particularly useful for new players. Turn them on if you are
   unsure where to establish your colonies.
 \item Messages about the factors that influence combat. Turn them on
 to learn more about things like the terrain bonus, the ambush bonus,
 or the ``artillery in the open'' penalty.
+\item Tutorial messages. These are still a work in progress and thus
+  rather limited.
 \end{itemize}
 
-Finally, there are the savegame settings:
+\hypertarget{audio options}{\subsubsection{Audio Options}}
 
+FreeCol comes with a limited selection of music and special sound
+effects. The audio options enable you to select the output device,
+which you should probably leave to be automatically detected, as well
+as the volume of the music and special effects.
+
+\hypertarget{savegame options}{\subsubsection{Savegame Options}}
+
 \begin{itemize}
 \item Whether to \hypertarget{show savegame settings}{show savegame
 settings} always, only when starting multi-player games, or
@@ -380,12 +432,45 @@
 server you wish to connect to. If you only play single-player games,
 you can choose the option ``never''.
 \item After how many turns you want the client to create an auto-save
-file. If you select \verb$0$, then the client will never create
-auto-save files.
+  file. If you select \verb$0$, the client will never create auto-save
+  files. If you select \verb$1$, the client will create an auto-save
+  file every turn.
+\item How many generations of auto-save files you wish to retain.
 \end{itemize}
 
+\hypertarget{warehouse options}{\subsubsection{Warehouse Options}}
 
+\begin{itemize}
+\item The number of goods to keep in your warehouse when exporting
+  goods automatically (which requires a \hyperlink{Custom House}
+  {custom house}), or by means of a \hyperlink{Trade Routes}{trade
+    route}.
+\item The minimum number of goods in your warehouse. If you store
+  goods of a certain type in your warehouse and the level drops below
+  this number, you will be warned.
+\item The maximum number of goods in your warehouse. If you store
+  goods of a certain type in your warehouse and the level rises above
+  this number, you will be warned.
+\end{itemize}
 
+
+\hypertarget{keyboard accelerators}{\subsubsection{Keyboard
+    Accelerators}}
+
+Many but not all of the actions available via the game menu or via
+orders buttons are also available as keyboard shortcuts. These
+shortcuts can be configured.
+
+\hypertarget{other options}{\subsubsection{Other Options}}
+
+\begin{itemize}
+\item Whether to load immigrants waiting in Europe onto your ships
+  automatically.
+\item Whether to end the turn automatically after all your units have
+  been moved.
+\end{itemize}
+
+
 \hypertarget{main screen}{\subsection{The main screen}}
 
 The figure \ref{main_screen_fig} represents the main screen.
@@ -407,11 +492,11 @@
 
 \hypertarget{menubar}{\subsubsection{The Menubar}}
 
-The menubar obviously contains the menu. It contains the submenus
-Game, View, Orders, Report and Colopedia, at the left hand of the
-screen, as well as a status area at the right hand of the screen. The
-status area tells you about your score, the amount of gold you
-possess, your current tax rate and the current turn.
+The menubar contains the Game, View, Orders, Report and Colopedia
+submenus at the left hand of the screen, as well as a status area at
+the right hand of the screen. The status area displays your score, the
+amount of gold you possess, your current tax rate and the current
+turn.
 
 The \hypertarget{game menu}{Game Menu} allows you to:
 
@@ -424,36 +509,43 @@
 \item chat with another player
 \item declare independence
 \item end your turn
-\item quit
+\item return to the main menu
+\item view high scores
+\item retire from the game
+\item quit the game entirely
 \end{itemize}
 
 The \hypertarget{view menu}{View Menu} allows you to:
 
 \begin{itemize}
-\item turn the minimap and the info panel on or off
-\item turn the display of tile names on or off
-\item turn the display of tile owners on or off
+\item turn the map controls (minimap and info panel) on or off
 \item turn the map grid on or off
 \item switch between the unit view and the terrain view
+\item display tile names, owner, regions or none of the above
+\item change the zoom level of the main map
 \item switch to the Europe panel
+\item display trade routes
 \end{itemize}
 
 The \hypertarget{orders menu}{Orders Menu} enables you to give orders
 to the currently selected unit:
 
 \begin{itemize}
-\item wait until other units have moved
 \item switch to sentry mode
 \item fortify
 \item go to a destination you select
+\item go to a tile you select
+\item execute goto orders
+\item assign trade route
 \item build a colony
 \item plow the tile the unit is on (requires 20 tools)
 \item build a road on the tile the unit is on (requires 20 tools)
+\item load a carrier if possible
 \item unload all goods and units on board if possible
-\item continue towards a selected destination
+\item wait until other units have moved
 \item skip this turn
 \item switch to a different unit on the same tile
-\item forget current orders
+\item clear current orders
 \item change the unit's name
 \item disband the unit
 \end{itemize}
@@ -523,10 +615,19 @@
 trained, for example. It also tells you which colonies require raw
 materials in order to increase their production of manufactured goods,
 and which colonies produce a surplus of these materials.
+\item The \Report{Exploration Report} provides some information about
+  the regions you have discovered and named. If you did not select the
+  exploration option, then the report will only show you when you
+  discovered the Pacific Ocean, provided you did discover it.
+\item The \Report{History Report} contains a short overview of
+  important events that took place during the game, such as the first
+  meeting with native tribes, the foundation and abandonment of
+  colonies, among other things.
+
 \end{itemize}
 
 The \hypertarget{colopedia menu}{Colopedia Menu} provides access to
-the online game help, which is divided into six sections:
+the online game help, which is divided into eight sections:
 
 \begin{itemize}
 \item The terrain section contains information on all the different
@@ -541,13 +642,19 @@
 \item The Founding Father section can be used to look up information
 on the various Founding Fathers you may elect to the Continental
 Congress.
+\item The nations section tells you which nations are available in the
+  game, which national advantage they currently have, and which one
+  they have by default.
+\item The national advantages section tells you which national
+  advantages are available. Some advantages only apply to European
+  players, others only to native players.
 \end{itemize}
 
 
 \hypertarget{info panel}{\subsubsection{The Info Panel}}
 
 If you are in unit view mode (the default), the info panel in the
-lower right corner of the screen either shows information on the
+lower right corner of the screen either shows information about the
 currently selected unit, or contains a button to end the current turn
 if no unit is selected. If a unit is selected, then the info panel
 shows an image of the unit, as well as its name and the moves it has


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 4760
          http://freecol.svn.sourceforge.net/freecol/?rev=4760&view=rev
Author:   burschik
Date:     2008-12-26 14:20:51 +0000 (Fri, 26 Dec 2008)

Log Message:
-----------
Update for 0.8.0.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2008-12-26 13:27:56 UTC (rev 4759)
+++ freecol/trunk/doc/FreeCol.tex	2008-12-26 14:20:51 UTC (rev 4760)
@@ -247,14 +247,13 @@
 to join a \Concept{multi-player game}, or to start a new multi-player
 game.
 
-If you wish to join a multi-player game, you must enter the
-\Concept{IP address} of a server that is running a FreeCol game as
-well as the port it is running on. The default port is
-$3541$\index{Port 3541}. If you wish to start a multi-player game,
-then the IP address of the server will be that of your computer, but
-you must still select a port to run the server on. Again, the default
-port is $3541$. You must also decide whether you want to run a public
-server or a private server. By default, you start a private game.
+If you start a single-player game, you must decide on the number of
+European players (1--8) and whether to allow additional nations (which
+were not available in the original game) and whether to allow national
+advantages to be selectable (in the original game, national advantages
+were fixed). Of course, if you wish to have more than four European
+players, you must also enable additional nations, since the original
+game only made four European nations available.
 
 If you choose to retrieve a list of running games from the metaserver,
 your computer will attempt to establish a connection to
@@ -263,6 +262,21 @@
 connect to. Please note that the list will frequently be empty, since
 not that many public multi-player games are being run.
 
+If you wish to join a multi-player game, you must enter the
+\Concept{IP address} of a server that is running a FreeCol game as
+well as the port it is running on. The default port is
+$3541$\index{Port 3541}.
+
+If you wish to start a multi-player game, then the IP address of the
+server will be that of your computer, but you must still select a port
+to run the server on. Again, the default port is $3541$. You must also
+decide whether you want to run a public server or a private server. By
+default, you start a private game, which means that the game will not
+be available on the metaserver. Furthermore, you must decide on the
+number of European players (see above), and whether to use national
+advantages. A multi-player game may be more balanced if you do not use
+them, so that all players start with the same units and abilities.
+
 FreeCol is a client-server game. The game server takes care of the
 game logic, and the client provides the graphical user interface. One
 or several clients can connect to the game server via the network. In
@@ -286,28 +300,74 @@
 \hypertarget{Game options}{\subsubsection{Game options}}
 
 If you decide to start a single-player game or a game server, you will
-be able to choose which nation to play and which colour to use. The
-\hypertarget{map generator options}{map generator options} allow you
-to load a map, or to set several parameters that will influence the
+be able to choose which nation to play and which colour to use. If you
+join a multi-player game, you can also choose a nation and colour, but
+another players might already have selected your preferred nation.
+
+The \hypertarget{map generator options}{map generator options} allow
+you to import a map, and to set several parameters that influence the
 size and terrain of a randomly generated map. FreeCol includes several
 hand-made maps, which can be selected by clicking on the map icon.
 
+To import a map, either select one of the maps in the shortcut panel,
+enter the name of a file in the import field, or click on the browser
+button in order to select a file via a file browser. You have the
+choice to import terrain, bonuses, rumors and settlements. At the
+moment, the map editor does not provide all these options, however.
+
+The map generator tab allows you to select the size of the map, as
+well as the amount and the general shape of the land on the map. The
+terrain generator tab allows you to select the number of rivers,
+mountains, lost city rumors, native settlements, forests, and bonus
+tiles on the map, as well as the humidity and temperature of the
+map. The latter settings will influence the terrain.
+
 The game options proper allow you to select several parameters that
 influence game play, such as non-standard rules, victory conditions
-and the difficulty of the game.
+and the difficulty of the game. The initial values tab allows you to
+set the amount of gold available to the players at the start of the
+game. This is zero by default.
 
-If you join a multi-player game, you can also choose a nation and
-colour, but other players might already have selected your preferred
-nation.
+The map tab allows you to select whether to use the \textit{Fog of
+  War}, whether to hide enemy units in settlements and carriers, and
+whether to award exploration points for regions discovered by the
+players. By default, exploration points are only awarded for the
+discovery of the Pacific Ocean.
 
+The colony tab allows you to enable custom houses to ignore
+boycotts. This means that custom houses will be able to export
+boycotted goods. This does not apply to carriers, however, and does
+not prevent further boycotts by the Crown. This feature of the
+original game is considered a bug by the FreeCol team and is therefore
+disabled by default. You can also allow experts to ``have
+connections'', which means that experts working in factory-level
+buildings will be able to produce a small amount of goods even if the
+necessary raw materials are not generally available. This alleged
+feature of the original game is also disabled by default. Finally, you
+have the choice to save production overflow, which means that new
+buildings, for example, will not use up all available hammers, but
+only the exact number required. The remaining hammers will remain
+available for the next building project.
 
+The victory conditions tab allows you to choose among three possible
+victory conditions. The game will be won by the first player to
+achieve independence, the player to eliminate all other European
+players, or the player to eliminate all other human players.
+
+Finally, the difficulty tab enables you to select a difficulty level
+between very easy and very hard. The difficulty level influences
+various prices and probabilites in the game, such as amount of gold
+required to buy Indian land, and the probability of converting
+natives.
+
+
 \hypertarget{Client options}{\subsection{Client options}}
 
 The client options panel allows you to customize how your client
 displays the game objects and how it handles some tasks such as
 auto-saving.
 
-\hypertarget{display options}{\subsubsection{Display Options}}:
+\hypertarget{display options}{\subsubsection{Display Options}}
 
 \begin{itemize}
 


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 4812
          http://freecol.svn.sourceforge.net/freecol/?rev=4812&view=rev
Author:   burschik
Date:     2009-01-04 09:42:20 +0000 (Sun, 04 Jan 2009)

Log Message:
-----------
Switch documentclass to book because of the length of the manual.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2009-01-04 00:10:33 UTC (rev 4811)
+++ freecol/trunk/doc/FreeCol.tex	2009-01-04 09:42:20 UTC (rev 4812)
@@ -9,7 +9,7 @@
 \newcommand{\Wikipedia}[1]{\href{http://en.wikipedia.org/wiki/#1}%
 {\includegraphics[scale=0.6]{images/wikipedia.png}}}
 
-\documentclass[12pt]{article}
+\documentclass[12pt]{book}
 \usepackage[T1]{fontenc}
 \usepackage{longtable}
 \usepackage{graphicx}
@@ -26,7 +26,7 @@
 \newpage
 
 
-\hypertarget{Introduction}{\section{Introduction}}
+\hypertarget{Introduction}{\chapter{Introduction}}
 
 Welcome to FreeCol! If you're interested in development of this
 program, please see the \href{http://freecol.sourceforge.net}{FreeCol
@@ -34,11 +34,8 @@
 the latest version at the
 \href{http://freecol.sourceforge.net}{FreeCol homepage}.
 
+\hypertarget{About FreeCol}{\section{About FreeCol}}
 
-\hypertarget{About}{\section{About}}
-
-\hypertarget{About FreeCol}{\subsection{About FreeCol}}
-
 The FreeCol team aims to create an Open Source version of
 Colonization (released under the
 \href{http://www.gnu.org/licenses/gpl.html}{GPL}). At
@@ -61,7 +58,7 @@
 will have many new features, it will be an implementation of our (and
 our users') image of what Colonization 2 would have been.
 
-\hypertarget{The Original Colonization}{\subsection{The Original Colonization}}
+\hypertarget{The Original Colonization}{\section{The Original Colonization}}
 
 The original Colonization\Wikipedia{Colonization (computer game)} was
 released in 1994 by Microprose. \textbf{Colonization is heavily based
@@ -114,7 +111,7 @@
 providing a strong governmental system.
 
 
-\hypertarget{Installation}{\section{Installation}}
+\hypertarget{Installation}{\chapter{Installation}}
 
 You can download a system independent installer, which should install
 FreeCol and set up the required shortcuts on your desktop. If
@@ -122,7 +119,7 @@
 icon in order to start the game. If this is not the case, then please
 read the following paragraphs.
 
-\hypertarget{System Requirements}{\subsection{System Requirements}}
+\hypertarget{System Requirements}{\section{System Requirements}}
 
 FreeCol is written in Java. In order to run, it requires a Java
 Virtual Machine. In theory, FreeCol should run on any platform on
@@ -142,17 +139,17 @@
 with a smaller screen, but some dialogs will not be completely
 displayed.
 
-\hypertarget{Compiling FreeCol}{\subsection{Compiling FreeCol}}
+\hypertarget{Compiling FreeCol}{\section{Compiling FreeCol}}
 
-In order to compile FreeCol you will need Java and the Ant build
-system, which you can get \href{http://ant.apache.org/}{here}. When
-these are installed, go to the root directory of FreeCol and type
-\verb$ant$ to build a JAR file containing the game. This process
-requires the \verb$native2ascii$\index{native2ascii} task, which is an
-optional ant task. Some Linux distributions place optional tasks in a
-different package, so make sure you have installed all necessary
-packages if you are a Linux user. The game is started using the
-command \verb$java -Xmx128M -jar FreeCol.jar$.
+In order to compile FreeCol you will need Java and
+\href{http://ant.apache.org/}{the Ant build system}. When these are
+installed, go to the root directory of FreeCol and type \verb$ant$ to
+build a JAR file containing the game. This process requires the
+\verb$native2ascii$\index{native2ascii} task, which is an optional ant
+task. Some Linux distributions place optional tasks in a different
+package, so make sure you have installed all necessary packages if you
+are a Linux user. The game is started using the command
+\verb$java -Xmx128M -jar FreeCol.jar$.
 
 If something goes wrong, please open a bug report at the
 \href{http://sourceforge.net/projects/freecol}{SourceForge page of
@@ -162,13 +159,13 @@
 manual, however.
 
 
-\hypertarget{Interface}{\section{Interface}}
+\hypertarget{Interface}{\chapter{Interface}}
 
 This section will provide information about various interface
 elements, as well as the keyboard shortcuts and the different actions
 that can be used in the game.
 
-\hypertarget{Starting the game}{\subsection{Starting the game}}
+\hypertarget{Starting the game}{\section{Starting the game}}
 
 If you installed FreeCol with the system independent installer, or the
 Windows installer, there should be a shortcut on your desktop. Double
@@ -177,7 +174,7 @@
 paragraphs.
 
 
-\hypertarget{Command line options}{\subsubsection{Command line options}}
+\hypertarget{Command line options}{\subsection{Command line options}}
 
 If you are in the directory in which FreeCol is installed, you can
 start the game with the command \verb$java -Xmx128M -jar FreeCol.jar$.
@@ -234,7 +231,7 @@
 \end{itemize}
 
 
-\hypertarget{Game setup}{\subsubsection{Game setup}}
+\hypertarget{Game setup}{\subsection{Game setup}}
 
 If you start FreeCol without command line options, the game will first
 open a dialog that allows you to start a new game, to open a saved
@@ -297,7 +294,7 @@
 permit the clients to connect to the port of the game server.
 
 
-\hypertarget{Game options}{\subsubsection{Game options}}
+\hypertarget{Game options}{\subsection{Game options}}
 
 If you decide to start a single-player game or a game server, you will
 be able to choose which nation to play and which colour to use. If you
@@ -361,13 +358,13 @@
 natives.
 
 
-\hypertarget{Client options}{\subsection{Client options}}
+\hypertarget{Client options}{\section{Client options}}
 
 The client options panel allows you to customize how your client
 displays the game objects and how it handles some tasks such as
 auto-saving.
 
-\hypertarget{display options}{\subsubsection{Display Options}}
+\hypertarget{display options}{\subsection{Display Options}}
 
 \begin{itemize}
 
@@ -437,7 +434,7 @@
 
 \end{itemize}
 
-\hypertarget{message options}{\subsubsection{Message Options}}
+\hypertarget{message options}{\subsection{Message Options}}
 
 You can choose whether to group messages by type, by source, or not at
 all. The source of the message is a game object, typically a colony or
@@ -476,14 +473,14 @@
   rather limited.
 \end{itemize}
 
-\hypertarget{audio options}{\subsubsection{Audio Options}}
+\hypertarget{audio options}{\subsection{Audio Options}}
 
 FreeCol comes with a limited selection of music and special sound
 effects. The audio options enable you to select the output device,
 which you should probably leave to be automatically detected, as well
 as the volume of the music and special effects.
 
-\hypertarget{savegame options}{\subsubsection{Savegame Options}}
+\hypertarget{savegame options}{\subsection{Savegame Options}}
 
 \begin{itemize}
 \item Whether to \hypertarget{show savegame settings}{show savegame
@@ -498,7 +495,7 @@
 \item How many generations of auto-save files you wish to retain.
 \end{itemize}
 
-\hypertarget{warehouse options}{\subsubsection{Warehouse Options}}
+\hypertarget{warehouse options}{\subsection{Warehouse Options}}
 
 \begin{itemize}
 \item The number of goods to keep in your warehouse when exporting
@@ -514,14 +511,14 @@
 \end{itemize}
 
 
-\hypertarget{keyboard accelerators}{\subsubsection{Keyboard
+\hypertarget{keyboard accelerators}{\subsection{Keyboard
     Accelerators}}
 
 Many but not all of the actions available via the game menu or via
 orders buttons are also available as keyboard shortcuts. These
 shortcuts can be configured.
 
-\hypertarget{other options}{\subsubsection{Other Options}}
+\hypertarget{other options}{\subsection{Other Options}}
 
 \begin{itemize}
 \item Whether to load immigrants waiting in Europe onto your ships
@@ -531,7 +528,7 @@
 \end{itemize}
 
 
-\hypertarget{main screen}{\subsection{The main screen}}
+\hypertarget{main screen}{\section{The main screen}}
 
 The figure \ref{main_screen_fig} represents the main screen.
 \begin{figure}[htb]
@@ -550,7 +547,7 @@
 The \hyperlink{Client options}{preferences menu} allows you to disable
 some of these controls if you wish to do so.
 
-\hypertarget{menubar}{\subsubsection{The Menubar}}
+\hypertarget{menubar}{\subsection{The Menubar}}
 
 The menubar contains the Game, View, Orders, Report and Colopedia
 submenus at the left hand of the screen, as well as a status area at
@@ -711,7 +708,7 @@
 \end{itemize}
 
 
-\hypertarget{info panel}{\subsubsection{The Info Panel}}
+\hypertarget{info panel}{\subsection{The Info Panel}}
 
 If you are in unit view mode (the default), the info panel in the
 lower right corner of the screen either shows information about the
@@ -732,7 +729,7 @@
 \verb$Shift-Ctrl-V$, or by using the view menu.
 
 
-\hypertarget{minimap}{\subsubsection{The Minimap}}
+\hypertarget{minimap}{\subsection{The Minimap}}
 
 The minimap in the lower left corner of the screen shows you a more
 abstract view of the map than the main map. Different types of terrain
@@ -744,7 +741,7 @@
 minimap allow you to zoom into and out of the view.
 
 
-\hypertarget{unit buttons}{\subsubsection{The Unit Buttons}}
+\hypertarget{unit buttons}{\subsection{The Unit Buttons}}
 
 The unit buttons displayed between the minimap and the info panel
 allow you to give order to your units. Note that not all buttons are
@@ -757,7 +754,7 @@
 \item skip turn
 \item fortify
 \item clear forest / plow tile (requires 20 tools)
-\item build road
+\item build road (requires 20 tools)
 \item build colony
 \item disband unit
 \end{itemize}
@@ -767,15 +764,15 @@
 shortcuts}{keyboard shortcuts}.
 
 
-\hypertarget{compass rose}{\subsubsection{The Compass Rose}}
+\hypertarget{compass rose}{\subsection{The Compass Rose}}
 
 The compass rose can be displayed in the top right corner and allows
-you to give your units movement order by clicking on the corresponding
+you to give your units movement orders by clicking on the corresponding
 direction. It is primarily intended for users who do not wish to (or
 are unable to) use the keyboard shortcuts.
 
 
-\hypertarget{main map}{\subsubsection{The Main Map}}
+\hypertarget{main map}{\subsection{The Main Map}}
 
 The main map shows you the New World in greater detail. You can see
 the different types of terrain, forested and otherwise, hills,
@@ -948,7 +945,7 @@
 You can customize these settings in the preferences dialog.
 
 
-\hypertarget{europe panel}{\subsection{The Europe Panel}}
+\hypertarget{europe panel}{\section{The Europe Panel}}
 
 The figure \ref{europe_panel_fig} represents the Europe panel.
 \begin{figure}[htb]
@@ -1000,7 +997,7 @@
 sail'' button.
 
 
-\hypertarget{colony panel}{\subsection{The Colony panel}}
+\hypertarget{colony panel}{\section{The Colony panel}}
 
 The figure \ref{colony_panel_fig} represents the Colony panel.
 \begin{figure}[htb]
@@ -1096,7 +1093,7 @@
 \end{itemize}
 
 
-\hypertarget{The Warehouse Dialog}{\subsubsection{The Warehouse Dialog}}
+\hypertarget{The Warehouse Dialog}{\subsection{The Warehouse Dialog}}
 
 The warehouse dialog allows you to set the warning levels for all
 types of goods. If you have turned on the warnings about goods levels,
@@ -1114,7 +1111,7 @@
 colony, the checkbox is disabled.
 
 
-\hypertarget{The New World}{\section{The New World}}
+\hypertarget{The New World}{\chapter{The New World}}
 
 At the beginning of the game, you will start with a naval vessel and
 two colonists. Your first task will be to discover the New World,
@@ -1122,7 +1119,7 @@
 may prove quicker. As soon as you have discovered land, you can
 establish your colonies and produce goods to send home to Europe.
 
-\hypertarget{Terrain Types}{\subsection{Terrain Types}}
+\hypertarget{Terrain Types}{\section{Terrain Types}}
 
 There are many different types of terrain in the New World, each with
 its own peculiar advantages. At the beginning of the game you will
@@ -1163,7 +1160,7 @@
 carrying at least 20 tools. You can equip your units in your colonies
 or in Europe.
 
-\hypertarget{Goods}{\subsection{Goods}}
+\hypertarget{Goods}{\section{Goods}}
 
 The New World produces many goods, which can be traded in Europe. In
 order to this, you must use your ships to transport them to your
@@ -1253,7 +1250,7 @@
 generally demand Trade Goods.
 
 
-\hypertarget{Trade Routes}{\subsubsection{Trade Routes}}
+\hypertarget{Trade Routes}{\subsection{Trade Routes}}
 
 The \hyperlink{orders menu}{orders menu} allows you to assign a Trade
 Route to a ship or wagon train. If you select this order, the trade
@@ -1284,7 +1281,7 @@
 trade route, it will continue at the first destination.
 
 
-\hypertarget{Resources}{\subsection{Special Resources}}
+\hypertarget{Resources}{\section{Special Resources}}
 
 Some types of terrain can also have special resources, which increase
 the production of a particular type of goods. These resources look
@@ -1292,7 +1289,7 @@
 valuable.
 
 
-\hypertarget{Native Settlements}{\subsection{Native Settlements}}
+\hypertarget{Native Settlements}{\section{Native Settlements}}
 
 The New World is by no means an uninhabited country. Various tribes of
 Indians already live there, and make use of the land. When your
@@ -1364,7 +1361,7 @@
 effectively lost to you.
 
 
-\hypertarget{Lost City Rumours}{\subsection{Lost City Rumours}}
+\hypertarget{Lost City Rumours}{\section{Lost City Rumours}}
 
 In the New World, there are also rumours about \Concept{Lost Cities},
 such as El Dorado, or C{\'\i}bola. You may send your colonists to
@@ -1390,7 +1387,7 @@
 Rumours always yield positive results.
 
 
-\hypertarget{Exploration}{\subsection{Exploration}}
+\hypertarget{Exploration}{\section{Exploration}}
 
 The original Colonization game awarded exploration points only for the
 discovery of the Pacific Ocean. This is also the default behaviour for
@@ -1404,15 +1401,15 @@
 the size of the region discovered.
 
 
-\hypertarget{Colonies}{\section{Colonies}}
+\hypertarget{Colonies}{\chapter{Colonies}}
 
-\hypertarget{Picking a suitable site}{\subsection{Picking a suitable site}}
+\hypertarget{Picking a suitable site}{\section{Picking a suitable site}}
 
 Your colonies are your most important assets in the new world.
 Therefore, it is very important to build them in the right
 place. There are several aspects to consider:
 
-\hypertarget{The colony tile}{\subsubsection{The colony tile}}
+\hypertarget{The colony tile}{\subsection{The colony tile}}
 
 Some terrain types are more suitable for establishing a colony than
 others. Colonies can not be built on Arctic tiles, nor on Mountains,
@@ -1446,7 +1443,7 @@
 and Broadleaf Forest into Prairie.
 
 
-\hypertarget{The adjacent tiles}{\subsubsection{The adjacent tiles}}
+\hypertarget{The adjacent tiles}{\subsection{The adjacent tiles}}
 
 In the early stages of the game, you will need to generate cash by
 selling products from the New World in your Home Port. Thus, many of
@@ -1473,7 +1470,7 @@
 colonies as far as possible.
 
 
-\hypertarget{No Reforestation}{\subsubsection{No Reforestation}}
+\hypertarget{No Reforestation}{\subsection{No Reforestation}}
 
 You can order your pioneers to cut down forests by plowing a tile.
 This will increase the food produced on these tiles, and the lumber
@@ -1481,7 +1478,7 @@
 forests later. Once cleared, a tile will never produce lumber again.
 
 
-\hypertarget{Government Efficiency}{\subsubsection{Government Efficiency}}
+\hypertarget{Government Efficiency}{\subsection{Government Efficiency}}
 
 The efficiency of the local governments of your colonies depends on
 the colonists' support for the \hyperlink{Sons of Liberty}{Sons of
@@ -1502,7 +1499,7 @@
 Freedom Bells in the Town Hall.
 
 
-\hypertarget{Colony Buildings}{\subsection{Colony Buildings}}
+\hypertarget{Colony Buildings}{\section{Colony Buildings}}
 
 A newly established colony already includes several buildings, namely
 a town hall, a carpenter's house, a blacksmith's house, a
@@ -1653,7 +1650,7 @@
 \end{itemize}
 
 
-\hypertarget{Using Buildings}{\subsection{{Using Buildings}}}
+\hypertarget{Using Buildings}{\section{{Using Buildings}}}
 
 Some buildings have an immediate effect. The
 \hyperlink{Stockade}{Stockade}, for example, provides protection for
@@ -1674,7 +1671,7 @@
   Colonist}{Free Colonists}. Other units may work less effectively.
 
 
-\hypertarget{Building Units and Buildings}{\subsection{Building Units 
+\hypertarget{Building Units and Buildings}{\section{Building Units 
 and Buildings}}
 
 In order to upgrade buildings, and to construct new buildings and
@@ -1696,7 +1693,7 @@
 
 
 
-\hypertarget{Home Country}{\section{Your Home Country}}
+\hypertarget{Home Country}{\chapter{Your Home Country}}
 
 Your \textbf{Home Country} is a European monarchy, either 
 \Concept{Spain}, \Concept{France}, \Concept{England} or the 
@@ -1706,7 +1703,7 @@
 successful cooperating with the natives. The English generate more
 colonists, and the Dutch are better traders.
 
-\hypertarget{Home Port}{\subsection{Your Home Port}}
+\hypertarget{Home Port}{\section{Your Home Port}}
 
 The \textbf{Home Port} is a port city in your home country, where you
 can trade \hyperlink{Goods}{Goods}, and train, recruit and buy
@@ -1743,7 +1740,7 @@
 respectively.
 
 
-\hypertarget{Monarch}{\subsection{Your Monarch}}
+\hypertarget{Monarch}{\section{Your Monarch}}
 
 Your Home Country is ruled by a \textbf{Monarch} whose actions can
 have a profound influence on your colonies and your relations to other
@@ -1793,7 +1790,7 @@
 
 
 
-\hypertarget{Units}{\section{Units}}
+\hypertarget{Units}{\chapter{Units}}
 
 Several dozen different units are available in FreeCol, but not all
 units are available to all players. Some units are available only to
@@ -1990,7 +1987,7 @@
 %% &&&Broadleaf Forest (4)\\
 %% \end{longtable}
 
-\hypertarget{Equipment}{\subsection{Equipment}}
+\hypertarget{Equipment}{\section{Equipment}}
 
 Most units can be equipped with tools, horses, muskets, or a
 bible. This equipment grants them certain abilities, which they do not
@@ -2023,7 +2020,7 @@
 another unit that can not be equipped.
 
 
-\hypertarget{Skills and Education}{\subsection{Skills and Education}}
+\hypertarget{Skills and Education}{\section{Skills and Education}}
 
 In FreeCol, your colonists come from all walks of life. Some are
 unskilled \hyperlink{Petty Criminal}{Petty Criminals}, who are
@@ -2092,7 +2089,7 @@
 Scout, unless that unit already has another skill.
 
 
-\hypertarget{Combat}{\subsection{Combat}}
+\hypertarget{Combat}{\section{Combat}}
 
 A tile can only be occupied by units of a single Player. If a unit of
 another Player attempts to enter that tile, combat ensues. The combat
@@ -2147,7 +2144,7 @@
 automatically fire at enemy ships on adjacent ocean tiles.
 
 
-\hypertarget{combat bonuses}{\subsubsection{Combat Bonuses and Penalties}}
+\hypertarget{combat bonuses}{\subsection{Combat Bonuses and Penalties}}
 
 Bonuses and penalties for naval units:
 
@@ -2207,7 +2204,7 @@
 
 
 
-\hypertarget{Continental Congress}{\section{The Continental Congress}}
+\hypertarget{Continental Congress}{\chapter{The Continental Congress}}
 
 As the player generates \hyperlink{Liberty Bells}{Liberty Bells},
 \hypertarget{Founding Fathers}{\textbf{Founding Fathers}} are elected
@@ -2400,9 +2397,9 @@
 
 
 
-\hypertarget{The Birth of a Nation}{\section{The Birth of a Nation}}
+\hypertarget{The Birth of a Nation}{\chapter{The Birth of a Nation}}
 
-\hypertarget{Sons of Liberty}{\subsection{Sons of Liberty}}
+\hypertarget{Sons of Liberty}{\section{Sons of Liberty}}
 
 At the beginning of the game, all your colonists will be
 \hypertarget{Tories}{\textbf{Tory Loyalists}}, who support your
@@ -2420,7 +2417,7 @@
 two units as soon as 100\% of the population become Sons of Liberty.
 
 
-\hypertarget{Declaration of Independence}{\subsection{The Declaration
+\hypertarget{Declaration of Independence}{\section{The Declaration
 of Independence}}
 
 As soon as 50\% of your entire population support the Sons of Liberty,
@@ -2440,7 +2437,7 @@
 Bells after the War of Independence has begun.
 
 
-\hypertarget{Changing the Rules}{\section{Changing the Rules}}
+\hypertarget{Changing the Rules}{\chapter{Changing the Rules}}
 
 We would like to make FreeCol configurable, so that the game engine
 becomes capable of emulating many similar games. For this purpose,
@@ -2469,7 +2466,7 @@
 the result with the command \verb$ant validate$.
 
 
-\hypertarget{Modifiers and Abilities}{\subsection{Modifiers and Abilities}}
+\hypertarget{Modifiers and Abilities}{\section{Modifiers and Abilities}}
 
 Most of the objects defined by the rule set can be customized via
 modifiers and abilities.  Abilities are boolean values (``true'' or
@@ -2890,7 +2887,7 @@
 
 
 
-\hypertarget{Known bugs}{\section{Known bugs}}
+\hypertarget{Known bugs}{\chapter{Known bugs}}
 
 FreeCol is still alpha software. In plain English, this means that it
 is full of bugs. Some of these bugs have already been reported, but
@@ -2909,7 +2906,7 @@
 \hyperlink{game menu}{game menu} or by pressing \verb$ctrl-r$.
 
 
-\hypertarget{Copyright Notice}{\section{Copyright Notice}}
+\hypertarget{Copyright Notice}{\chapter{Copyright Notice}}
 
 Copyright \copyright 2008
 \href{http://freecol.sourceforge.net/index.php?section=8}{The FreeCol


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 4813
          http://freecol.svn.sourceforge.net/freecol/?rev=4813&view=rev
Author:   burschik
Date:     2009-01-04 10:00:34 +0000 (Sun, 04 Jan 2009)

Log Message:
-----------
Fix minor problems.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2009-01-04 09:42:20 UTC (rev 4812)
+++ freecol/trunk/doc/FreeCol.tex	2009-01-04 10:00:34 UTC (rev 4813)
@@ -2262,7 +2262,7 @@
 mapping of the area now called the Southwestern US was important to
 further exploration. As soon as Francisco de Coronado joins the
 Continental Congress, all existing colonies become visible on the
-map. \Wikipedia{Francisco_V�zquez_de_Coronado}
+map. \Wikipedia{Francisco_Vazquez_de_Coronado}
 
 \Father{Hernando de Soto} (1496--1542) was the first European to
 explore Florida and the southeastern US.  He also held a prominent
@@ -2502,7 +2502,9 @@
 \ability{model.ability.addTaxToBells}
 \affectsPlayer
 
-The player adds the current tax rate as a bonus to bells production.
+The player adds the current tax rate as a bonus to bells
+production. The bonus is modified every time the tax increases or
+decreases.
 
 \ability{model.ability.alwaysOfferedPeace}
 \affectsPlayer
@@ -2522,7 +2524,8 @@
 \ability{model.ability.autoProduction}
 \affectsBuilding
 
-The building produces goods even if no units are present.
+The building needs no units to produce goods, and will never produce
+more goods than can be stored in the colony.
 
 \ability{model.ability.automaticEquipment}
 \affectsUnit
@@ -2786,7 +2789,8 @@
 \ability{model.ability.teach}
 \affectsBuilding
 
-The building enables experts to teach other units.
+The building enables experts to teach other units. However, the
+building may place limits on the experience level of teachers.
 
 \ability{model.ability.tradeWithForeignColonies}
 \affectsPlayer


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 4834
          http://freecol.svn.sourceforge.net/freecol/?rev=4834&view=rev
Author:   burschik
Date:     2009-01-10 09:18:17 +0000 (Sat, 10 Jan 2009)

Log Message:
-----------
Add national advantages.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2009-01-10 08:28:17 UTC (rev 4833)
+++ freecol/trunk/doc/FreeCol.tex	2009-01-10 09:18:17 UTC (rev 4834)
@@ -299,7 +299,9 @@
 If you decide to start a single-player game or a game server, you will
 be able to choose which nation to play and which colour to use. If you
 join a multi-player game, you can also choose a nation and colour, but
-another players might already have selected your preferred nation.
+another players might already have selected your preferred nation. See
+the chapter on \hyperlink{Home Country}{your Home Country} for further
+information on the national advantages of various European nations.
 
 The \hypertarget{map generator options}{map generator options} allow
 you to import a map, and to set several parameters that influence the
@@ -1695,14 +1697,75 @@
 
 \hypertarget{Home Country}{\chapter{Your Home Country}}
 
-Your \textbf{Home Country} is a European monarchy, either 
-\Concept{Spain}, \Concept{France}, \Concept{England} or the 
-\Concept{Netherlands}\index{Dutch}. Each of these countries has one
-special ability. If you hail from Spain, you will be more successful
-fighting against the natives. If you are French, you will be more
-successful cooperating with the natives. The English generate more
-colonists, and the Dutch are better traders.
+Your \textbf{Home Country} is a European monarchy and colonial
+power. The original game featured four playable nations, namely
+\Concept{Spain}, \Concept{France}, \Concept{England} and the
+\Concept{Netherlands}\index{Dutch}. FreeCol optionally adds
+\Concept{Portugal}, \Concept{Denmark}, \Concept{Sweden} and
+\Concept{Russia}.
 
+Virtually all players agree that the addition of Portugal corrects a
+glaring omission of the original game, but the other three European
+nations are controversial. Sweden, Denmark and Russia all had colonies
+or territories in the Americas, but were either minor colonial powers
+or arrived very late. However, as we wished to make multi-player games
+with up to eight human players possible, we had to add further
+nations. We might well change the selection at some later date, and
+you can change the selection by editing the rules yourself.
+
+Each of these countries may have special abilities and different
+starting units. In the original game, these abilities and units were
+tied to particular nations. FreeCol, however, optionally allows you to
+select your national advantage.
+
+In the future, FreeCol will probably define eight national advantages,
+so that each nation can have a different advantage. At the moment,
+FreeCol only defines the following six advantages, as well as the no
+advantage ``advantage'':
+
+\begin{itemize}
+
+\item No advantage: You start with two Free Colonists and a Caravel,
+  and no special abilities. This is mainly intended for multi-player
+  games, as it removes a potential imbalance between players.
+
+\item The trade advantage: You can buy and sell twice as many goods in
+  Europe before prices change. You start with two Free Colonists and a
+  Merchantman.
+
+\item The cooperation advantage: You generate only half as much native
+  alarm as the other European nations. You start with a Free Colonist,
+  a Hardy Pioneer and a Caravel.
+
+\item The immigration advantage: You need to generate only two thirds
+  as many crosses as the other European nations in order to attract
+  new immigrants. You start with two Free Colonists and a Caravel.
+
+\item The conquest advantage: You capture twice as much treasure and
+  twice as many ``converts'' when destroying native settlements. You
+  start with a Free Colonist, a Veteran Soldier and a Caravel.
+
+\item The naval advantage: All your ships can move one tile further
+  than those of other European nations. You start with two Free
+  Colonists and a Merchantman.
+
+\item The building advantage: Your lumberjacks produce two units of
+  lumber and your carpenters produce two hammers more than those of
+  other European nations. You start with an Expert Lumberjack, a
+  Master Carpenter and a Caravel.
+
+\end{itemize}
+
+In the original game, the Dutch had the trade advantage, the French
+had the cooperation advantage, the English had the immigration
+advantage and the Spanish had the conquest advantage. In FreeCol, this
+is also the default, although you can optionally select different
+advantages. By default, the Portuguese have the naval advantage, the
+Swedish have the building advantage, the Danish have the trade
+advantage and the Russians have the immigration advantage. This is
+likely to change in the future, however.
+
+
 \hypertarget{Home Port}{\section{Your Home Port}}
 
 The \textbf{Home Port} is a port city in your home country, where you


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 4860
          http://freecol.svn.sourceforge.net/freecol/?rev=4860&view=rev
Author:   burschik
Date:     2009-01-13 16:25:16 +0000 (Tue, 13 Jan 2009)

Log Message:
-----------
Indicate that rule set schema will change.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2009-01-13 16:22:17 UTC (rev 4859)
+++ freecol/trunk/doc/FreeCol.tex	2009-01-13 16:25:16 UTC (rev 4860)
@@ -2512,13 +2512,17 @@
 founding fathers, buildings, terrain types, goods and equipment, for
 example.
 
-This is still work in progress, however, and we are particularly
-interested in hearing about problems caused by changes to the rule
-set. Some dialogs might be unable to display more types of goods than
-are currently defined, for example. Or other dialogs might not
-recognize your new Minuteman unit as an armed unit. Please help us
-improve FreeCol by telling us about such problems.
+This is still work in progress, however, and the schema for the rule
+set certain to change again in the future. If you wish to develop your
+own rule set, you will have to monitor FreeCol development closely.
 
+This having been said, we are particularly interested in hearing about
+problems caused by your changes to the rule set. Some dialogs might be
+unable to display more types of goods than are currently defined, for
+example. Or other dialogs might not recognize your new Minuteman unit
+as an armed unit. Please help us improve FreeCol by telling us about
+such problems.
+
 If you have a working rule set that adds a new flavour to the game, we
 will gladly distribute it along with our default rule set. If you have
 ideas that can not currently be implemented, we will probably try to


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 4871
          http://freecol.svn.sourceforge.net/freecol/?rev=4871&view=rev
Author:   stiangre
Date:     2009-01-14 18:09:28 +0000 (Wed, 14 Jan 2009)

Log Message:
-----------
Adding information on where the specification.xml file is located.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2009-01-14 15:49:45 UTC (rev 4870)
+++ freecol/trunk/doc/FreeCol.tex	2009-01-14 18:09:28 UTC (rev 4871)
@@ -2510,7 +2510,7 @@
 editor, but at the moment, your only option is to edit the file
 specification.xml directly. This file defines the abilities of units,
 founding fathers, buildings, terrain types, goods and equipment, for
-example.
+example. You can find this file in the \textit{data/freecol} directory.
 
 This is still work in progress, however, and the schema for the rule
 set certain to change again in the future. If you wish to develop your


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 5396
          http://freecol.svn.sourceforge.net/freecol/?rev=5396&view=rev
Author:   burschik
Date:     2009-05-16 11:56:03 +0000 (Sat, 16 May 2009)

Log Message:
-----------
Subsection about Intel Macs.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2009-05-16 11:24:00 UTC (rev 5395)
+++ freecol/trunk/doc/FreeCol.tex	2009-05-16 11:56:03 UTC (rev 5396)
@@ -179,6 +179,17 @@
 with a smaller screen, but some dialogs will not be completely
 displayed.
 
+\hypertarget{FreeCol on Intel Macs}{\subsection{FreeCol on Intel Macs}}
+
+Some users report that they can not start FreeCol on their 64-bit
+Intel Macs. It seems that these Macs use a 32-bit version of Java 1.5
+by default. In order to solve this problem, you can either edit the
+file "info.plist" to select 1.6+, or you can change the default Java
+version under "/Applications/Utilities/Java/Java Preferences". Just
+drag "1.5 64-bit" or "1.6 64-bit" to the top of the list and FreeCol
+should run without any changes in "info.plist".
+
+
 \hypertarget{Compiling FreeCol}{\section{Compiling FreeCol}}
 
 In order to compile FreeCol you will need Java and


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 5429
          http://freecol.svn.sourceforge.net/freecol/?rev=5429&view=rev
Author:   burschik
Date:     2009-05-24 08:58:37 +0000 (Sun, 24 May 2009)

Log Message:
-----------
Change description of battle resolution.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2009-05-24 08:24:31 UTC (rev 5428)
+++ freecol/trunk/doc/FreeCol.tex	2009-05-24 08:58:37 UTC (rev 5429)
@@ -2227,11 +2227,10 @@
 mechanism of FreeCol is very simple: Each unit has an attack strength
 and a defence strength. Attack bonuses and defence bonuses granted by
 terrain, fortifications or \hyperlink{Founding Fathers}{Founding
-Fathers} are added to the base values of the units. If the attack
-value of the attacker is greater than the defence value of the
-defender, the attacker wins. Otherwise the defender wins. If a tile is
-occupied by more than one unit, the attacker will fight against the
-defender with the strongest defence.
+  Fathers} are added to the base values of the units. A random element
+is then added to the calculations in order to determine the winner of
+the battle. If a tile is occupied by more than one unit, the attacker
+will fight against the defender with the strongest defence.
 
 Most units that win a battle may be \hypertarget{promotion}{promoted},
 and all units that lose a battle will always be captured, demoted,


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 5574
          http://freecol.svn.sourceforge.net/freecol/?rev=5574&view=rev
Author:   burschik
Date:     2009-07-08 05:02:53 +0000 (Wed, 08 Jul 2009)

Log Message:
-----------
Fix dragging and dropping of equipment.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2009-07-06 13:22:13 UTC (rev 5573)
+++ freecol/trunk/doc/FreeCol.tex	2009-07-08 05:02:53 UTC (rev 5574)
@@ -2114,10 +2114,13 @@
 
 \hypertarget{Equipment}{\section{Equipment}}
 
-Most units can be equipped with tools, horses, muskets, or a
-bible. This equipment grants them certain abilities, which they do not
-possess without that equipment. Certain units are particularly skilled
-with that equipment, but without it they have no special abilities:
+Most units can be equipped with tools, horses, muskets, or a bible.
+Most types of equipment are not compatible with each other,
+however. If you equip a unit with tools, for example, then that unit
+will drop any other equipment it is currently using. Equipment grants
+a unit certain abilities, which it does not possess otherwise. Certain
+units are particularly skilled with a certain type of equipment, but
+without it they have no special abilities:
 
 \begin{itemize}
 \item Only a unit equipped with tools is able to build roads, plow
@@ -2148,7 +2151,7 @@
 context menu. If the equipment is produced from a single type of goods
 you can also equip a unit by dragging a sufficient amount of goods
 from a warehouse, the European market, a ship or wagon train and
-dropping it onto the unit.
+dropping it onto the unit while holding down the alt key.
 
 
 \hypertarget{Skills and Education}{\section{Skills and Education}}
@@ -2183,7 +2186,7 @@
 \hyperlink{University}{University}, allow you to train your units
 yourself by placing a skilled unit in one of these buildings.  If a
 suitable student exists in the colony it will automatically appear
-below the teacher in the building, as well as continuing to perform
+next to the teacher in the building, as well as continuing to perform
 its current task.  Note that the Master Sugar Planter, the Master
 Cotton Planter, the Master Tobacco Planter, the Expert Fur Trapper,
 the Master Distiller, the Master Weaver, the Master Tobacconist, the


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 5590
          http://freecol.svn.sourceforge.net/freecol/?rev=5590&view=rev
Author:   mpope
Date:     2009-07-13 09:18:06 +0000 (Mon, 13 Jul 2009)

Log Message:
-----------
Small doc clarification re Minuit.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2009-07-12 22:14:13 UTC (rev 5589)
+++ freecol/trunk/doc/FreeCol.tex	2009-07-13 09:18:06 UTC (rev 5590)
@@ -1367,7 +1367,8 @@
 Naturally, the natives will not be pleased if you take the land away
 from them. As soon as \hyperlink{Peter Minuit}{Peter Minuit} has
 joined the \hyperlink{Continental Congress}{Continental Congress},
-however, the natives no longer demand payment for their land.
+however, the natives no longer demand payment for their land nor
+become immediately displeased if it is taken.
 
 Colonies and armed units near their settlements will alarm the natives
 and poison your relations. If the natives are happy, they will come to


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 5690
          http://freecol.svn.sourceforge.net/freecol/?rev=5690&view=rev
Author:   burschik
Date:     2009-08-02 10:41:58 +0000 (Sun, 02 Aug 2009)

Log Message:
-----------
Add reference to europe panel. (Fixes "bug" #2808160.)

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2009-08-02 10:23:27 UTC (rev 5689)
+++ freecol/trunk/doc/FreeCol.tex	2009-08-02 10:41:58 UTC (rev 5690)
@@ -1865,7 +1865,10 @@
 \hyperlink{Shipyard}{Shipyard} and an \hyperlink{Armory}{Armory},
 respectively.
 
+For further information about the actions available in your Home Port,
+please refer to the section on the \hyperlink{europe panel}{europe panel}.
 
+
 \hypertarget{Monarch}{\section{Your Monarch}}
 
 Your Home Country is ruled by a \textbf{Monarch} whose actions can


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 5741
          http://freecol.svn.sourceforge.net/freecol/?rev=5741&view=rev
Author:   abartels
Date:     2009-08-27 09:36:38 +0000 (Thu, 27 Aug 2009)

Log Message:
-----------
Master Fur Trader needs college, not Expert Fur Trapper

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2009-08-27 08:31:54 UTC (rev 5740)
+++ freecol/trunk/doc/FreeCol.tex	2009-08-27 09:36:38 UTC (rev 5741)
@@ -2199,7 +2199,7 @@
 suitable student exists in the colony it will automatically appear
 next to the teacher in the building, as well as continuing to perform
 its current task.  Note that the Master Sugar Planter, the Master
-Cotton Planter, the Master Tobacco Planter, the Expert Fur Trapper,
+Cotton Planter, the Master Tobacco Planter, the Master Fur Trader,
 the Master Distiller, the Master Weaver, the Master Tobacconist, the
 Master Blacksmith and the Master Gunsmith all require at least a
 \hyperlink{College}{College}, while the Elder Statesman, the Firebrand


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 5743
          http://freecol.svn.sourceforge.net/freecol/?rev=5743&view=rev
Author:   burschik
Date:     2009-08-27 12:47:26 +0000 (Thu, 27 Aug 2009)

Log Message:
-----------
Small amendments.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2009-08-27 12:22:27 UTC (rev 5742)
+++ freecol/trunk/doc/FreeCol.tex	2009-08-27 12:47:26 UTC (rev 5743)
@@ -632,11 +632,14 @@
 \begin{itemize}
 \item turn the map controls (minimap and info panel) on or off
 \item turn the map grid on or off
+\item turn borders on or off
 \item switch between the unit view and the terrain view
-\item display tile names, owner, regions or none of the above
+\item switch between full-screen mode and windowed mode
+\item display tile names, owners, regions or none of the above
 \item change the zoom level of the main map
 \item switch to the Europe panel
 \item display trade routes
+\item center the map on a known settlement
 \end{itemize}
 
 The \hypertarget{orders menu}{Orders Menu} enables you to give orders
@@ -649,7 +652,7 @@
 \item go to a tile you select
 \item execute goto orders
 \item assign trade route
-\item build a colony
+\item build or join a colony
 \item plow the tile the unit is on (requires 20 tools)
 \item build a road on the tile the unit is on (requires 20 tools)
 \item load a carrier if possible
@@ -964,13 +967,13 @@
 \pagebreak[2]
 \begin{itemize}
 \item\verb$a$: assign a trade route.
-\item\verb$b$: build a colony.
+\item\verb$b$: build a colony, or join an existing colony.
 \item\verb$c$: center on the currently selected unit.
 \item\verb$d$: disband the active unit.
 \item\verb$e$: show the Europe panel.
 \item\verb$f$: fortify.
-\item\verb$g$: goto some destination tile.
-\item\verb$h$: goto some colony (or Europe if a ship).
+\item\verb$g$: go to some destination tile.
+\item\verb$h$: go to a settlement (or Europe if a ship).
 \item\verb$l$: load (fill up all holds already in use).
 \item\verb$n$: rename the unit.
 \item\verb$o$: execute goto orders immediately.


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 5790
          http://freecol.svn.sourceforge.net/freecol/?rev=5790&view=rev
Author:   burschik
Date:     2009-09-08 07:29:15 +0000 (Tue, 08 Sep 2009)

Log Message:
-----------
Clarify Lost City Rumours.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2009-09-07 17:59:42 UTC (rev 5789)
+++ freecol/trunk/doc/FreeCol.tex	2009-09-08 07:29:15 UTC (rev 5790)
@@ -1426,20 +1426,22 @@
 \hypertarget{Lost City Rumours}{\section{Lost City Rumours}}
 
 In the New World, there are also rumours about \Concept{Lost Cities},
-such as El Dorado, or C{\'\i}bola. You may send your colonists to
-explore these rumours, and you might indeed discover one of the Seven
-Cities of Gold, and a \hyperlink{Treasure Train}{Treasure Train}.
-Other outcomes, however, are also possible.
+such as El Dorado, or C{\'\i}bola. The natives do not explore these
+sites, but your colonists can and, in fact, must do so if they enter a
+tile with a Lost City Rumour. It is not possible to farm a tile with a
+Lost City Rumour on it.
 
 Mostly, the rumour proves to be nothing but a rumour. Occasionally,
 you might disturb the burial grounds of a native tribe, which will
 cause the tribe to declare war on you. It is also possible that your
-expedition simply vanishes without a trace. On the other hand, you
-might also discover a small tribe and a few trinkets. Your colonist
-might become a \hyperlink{Seasoned Scout}{Seasoned Scout} if he has no
-other skill, or you might discover the sole survivor of a lost
-colony.
+expedition simply vanishes without a trace.
 
+On the other hand, you might also discover a small tribe and a few
+trinkets. Your colonist might become a \hyperlink{Seasoned
+  Scout}{Seasoned Scout} if he has no other skill, you might discover
+the sole survivor of a lost colony, or even one of the Seven Cities of
+Gold, and a \hyperlink{Treasure Train}{Treasure Train}.
+
 Possibly the best outcome is the discovery of the \Concept{Fountain of
 Youth}, which will cause numerous colonists to appear on the docks in
 your \hyperlink{Home Port}{Home Port}.


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 5815
          http://freecol.svn.sourceforge.net/freecol/?rev=5815&view=rev
Author:   burschik
Date:     2009-09-11 08:00:15 +0000 (Fri, 11 Sep 2009)

Log Message:
-----------
Add Treaty of Utrecht.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2009-09-10 22:21:37 UTC (rev 5814)
+++ freecol/trunk/doc/FreeCol.tex	2009-09-11 08:00:15 UTC (rev 5815)
@@ -19,7 +19,7 @@
 
 \begin{document}
 \author{\href{http://freecol.sourceforge.net/index.php?section=8}{The FreeCol Team}}
-\title{FreeCol Documentation\\User Guide for Version v0.8.0}
+\title{FreeCol Documentation\\User Guide for Version v0.9.0}
 \maketitle{}
 
 \tableofcontents
@@ -2570,6 +2570,28 @@
 two units as soon as 100\% of the population become Sons of Liberty.
 
 
+\hypertarget{The Treaty of Utrecht}{\section{The Treaty of Utrecht}}
+
+The colonies of European powers often changed hands as spoils of
+war. In the Treaty of Utrecht \Wikipedia{Treaty of Utrecht}, which
+concluded \Concept{The War of Spanish Succession} \Wikipedia{The War
+  of Spanish Succession}, for example, the French ceded most of their
+North American possessions to the English.
+
+In the game, your Monarch may declare war on a foreign power, and if
+\hyperlink{Benjamin Franklin}{Benjamin Franklin} has not yet joined
+the Continental Congress, that war will also spread to the New
+World. Furthermore, if the Treaty of Utrecht occurs in the game, the
+weakest computer player will cede all its colonies and units to the
+strongest computer player and withdraw from the New World.
+
+In the game, the War of Spanish Succession is triggered as soon as
+50\% of a {\em human} player's population support the declaration of
+independence. If there are less than two computer players still active
+in the New World at this time, then the Treaty of Utrecht event can
+not occur.
+
+
 \hypertarget{Declaration of Independence}{\section{The Declaration
 of Independence}}
 


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 5820
          http://freecol.svn.sourceforge.net/freecol/?rev=5820&view=rev
Author:   nickshanks
Date:     2009-09-11 15:34:13 +0000 (Fri, 11 Sep 2009)

Log Message:
-----------
grammar corrections and Mac clarifications

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2009-09-11 15:33:01 UTC (rev 5819)
+++ freecol/trunk/doc/FreeCol.tex	2009-09-11 15:34:13 UTC (rev 5820)
@@ -67,7 +67,7 @@
 strategy game for the PC in the history of mankind.
 
 In Civilization the object of the game was to build a nation that
-could stand the test of times and that could also do one of the
+could stand the test of time and that could also do one of the
 following: conquer the world or be the first to launch a
 spaceship. In Colonization things are bit different...
 
@@ -115,8 +115,8 @@
 \hypertarget{Liberty and Immigration}{\section{Liberty and Immigration}}
 
 \Concept{Liberty} and Immigration are two very important aspects of
-the game. The more liberty you ``accumulate'', the more will your
-colonists support your policies. In time, they will work harder, thus
+the game. The more liberty you ``accumulate'', the more your colonists
+will support your policies. In time, they will work harder, thus
 gaining a production bonus, and will support independence from the
 home country. Since you can not secede from your home country before
 at least half of the population supports independence, and since
@@ -166,12 +166,12 @@
 which a Java Virtual Machine compatible with Sun Java 5 or higher is
 available. In practice, however, things are less clear cut.
 
-FreeCol is known to work with Sun's Java 5 and 6 (which you can get
-\href{http://java.sun.com/}{here}. FreeCol also works with OpenJDK,
-although some problems and graphics glitches remain. FreeCol is known
-to run on recent versions of Windows and Linux, and on MacOSX to some
-extent. If you are using Linux, using Java 6 is recommended, as its
-font rendering is much better. If you are using FreeCol on a different
+FreeCol is known to work with \href{http://java.sun.com/}{Sun's Java 5
+and 6}. FreeCol also works with OpenJDK, although some problems and
+graphics glitches remain. FreeCol is known to run on recent versions
+of Windows and Linux, and on Mac OS X to some extent.
+If you are using Linux, using Java 6 is recommended, as its font
+rendering is much better. If you are using FreeCol on a different
 platform, we would like to hear about it.
 
 FreeCol requires at least 128 MB memory and works best with a screen
@@ -184,10 +184,11 @@
 Some users report that they can not start FreeCol on their 64-bit
 Intel Macs. It seems that these Macs use a 32-bit version of Java 1.5
 by default. In order to solve this problem, you can either edit the
-file "info.plist" to select 1.6+, or you can change the default Java
-version under "/Applications/Utilities/Java/Java Preferences". Just
-drag "1.5 64-bit" or "1.6 64-bit" to the top of the list and FreeCol
-should run without any changes in "info.plist".
+file "Info.plist" within the application package to select 1.6+,
+or you can change the default Java version under
+"/Applications/Utilities/Java/Java Preferences".
+Just drag "1.5 64-bit" or "1.6 64-bit" to the top of the list and
+FreeCol should run without any changes in "Info.plist".
 
 
 \hypertarget{Compiling FreeCol}{\section{Compiling FreeCol}}


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 6094
          http://freecol.svn.sourceforge.net/freecol/?rev=6094&view=rev
Author:   mpope
Date:     2009-12-20 04:54:05 +0000 (Sun, 20 Dec 2009)

Log Message:
-----------
Document good practice for bug reports.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2009-12-20 02:52:54 UTC (rev 6093)
+++ freecol/trunk/doc/FreeCol.tex	2009-12-20 04:54:05 UTC (rev 6094)
@@ -3159,7 +3159,17 @@
 reconnect to the server by using the reconnect option in the
 \hyperlink{game menu}{game menu} or by pressing \verb$ctrl-r$.
 
+A reconnect is often an indication of a bug.  If you report a
+reconnect problem, more detail is available in the java log file
+(usually called \texttt{FreeCol.log}) which is very helpful to the
+developers if attached to the bug report.  The log file can sometimes
+be large enough to exceed the attachment limit at SourceForge, in
+which case feel free to omit the bulk of the file--- the critical
+information is likely to be near the end (in the form of a
+java exception message), but you should always retain the first few
+lines which contain the FreeCol version and system information.
 
+
 \hypertarget{Copyright Notice}{\chapter{Copyright Notice}}
 
 Copyright \copyright 2008


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 7028
          http://freecol.svn.sourceforge.net/freecol/?rev=7028&view=rev
Author:   mpope
Date:     2010-06-18 11:39:03 +0000 (Fri, 18 Jun 2010)

Log Message:
-----------
Recommend 256M to run FreeCol.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2010-06-18 11:20:40 UTC (rev 7027)
+++ freecol/trunk/doc/FreeCol.tex	2010-06-18 11:39:03 UTC (rev 7028)
@@ -173,7 +173,7 @@
 is recommended, as its font rendering is much better. If you are using
 FreeCol on a different platform, we would like to hear about it.
 
-FreeCol requires at least 128 MB memory and works best with a screen
+FreeCol requires at least 256 MB memory and works best with a screen
 resolution of at least 1024x768 pixels. It should also be possible to
 play the game with a screen resolution of 1024x600 pixels, although
 some panels will look a bit cramped. You can play the game with an
@@ -211,7 +211,7 @@
 task. Some Linux distributions place optional tasks in a different
 package, so make sure you have installed all necessary packages if you
 are a Linux user. The game is started using the command
-\verb$java -Xmx128M -jar FreeCol.jar$.
+\verb$java -Xmx256M -jar FreeCol.jar$.
 
 If something goes wrong, please open a bug report at the
 \href{http://sourceforge.net/projects/freecol}{SourceForge page of
@@ -239,9 +239,9 @@
 \hypertarget{Command line options}{\subsection{Command line options}}
 
 If you are in the directory in which FreeCol is installed, you can
-start the game with the command \verb$java -Xmx128M -jar FreeCol.jar$.
+start the game with the command \verb$java -Xmx256M -jar FreeCol.jar$.
 This will tell the Virtual Machine to load the game and to set the
-maximum heap size to 128 MB. Refer to the manual of your Java Virtual
+maximum heap size to 256 MB. Refer to the manual of your Java Virtual
 Machine for details.
 
 There are many other Java options, but you probably won't need to


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 7073
          http://freecol.svn.sourceforge.net/freecol/?rev=7073&view=rev
Author:   mpope
Date:     2010-06-25 11:16:11 +0000 (Fri, 25 Jun 2010)

Log Message:
-----------
Add omitted documentation for font option.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2010-06-25 10:16:18 UTC (rev 7072)
+++ freecol/trunk/doc/FreeCol.tex	2010-06-25 11:16:11 UTC (rev 7073)
@@ -281,6 +281,8 @@
 port. If you don't know what that means, you will not need the option.
 \item\verb$--server-help$ Display a help screen for the more advanced
 server options.
+\item\verb$--font[[=]FONTSPEC]$ Override the default font with a Java
+font specifier (e.g. Arial-BOLD-12).
 \end{itemize}
 
 There are several other options that you will probably only be


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 7696
          http://freecol.svn.sourceforge.net/freecol/?rev=7696&view=rev
Author:   mpope
Date:     2010-11-17 10:03:47 +0000 (Wed, 17 Nov 2010)

Log Message:
-----------
Document the rules for claiming land to found colonies.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2010-11-17 10:00:49 UTC (rev 7695)
+++ freecol/trunk/doc/FreeCol.tex	2010-11-17 10:03:47 UTC (rev 7696)
@@ -1417,19 +1417,28 @@
 natives. Your choice of \hyperlink{Home Country}{Home Country} may
 influence your strategy --- or vice versa.
 
-Small Native Settlements use the tile they are built on as well as all
-adjacent tiles, just like your \hyperlink{Colonies}{Colonies}
-do. Large Native Settlements also use tiles that are two moves
-away. Your colonists can not use tiles that are already used by
-natives. If they attempt to do so, the natives will demand some gold
-for the land. You must then decide whether to pay their price, take
-the land away from the by force, or to leave the land alone.
-Naturally, the natives will not be pleased if you take the land away
-from them. As soon as \hyperlink{Peter Minuit}{Peter Minuit} has
-joined the \hyperlink{Continental Congress}{Continental Congress},
-however, the natives no longer demand payment for their land nor
-become immediately displeased if it is taken.
+Small Native Settlements use the tile they are built on and all the
+adjacent tiles, just like your \hyperlink{Colonies}{Colonies} do, and
+possibly more nearby tiles. Large Native Settlements also use tiles
+that are two moves away, and possibly more. Your colonists can not use
+tiles that are already used by natives. If they attempt to do so, the
+natives will demand some gold for the land. You must then decide
+whether to pay their price, take the land away from the by force, or
+to leave the land alone.  Naturally, the natives will not be pleased
+if you take the land away from them. As soon as \hyperlink{Peter
+  Minuit}{Peter Minuit} has joined the \hyperlink{Continental
+  Congress}{Continental Congress}, however, the natives no longer
+demand payment for their land nor become immediately displeased if it
+is taken.
 
+A special case exists for the center tile of the colonies you found.
+In the ``classic'' ruleset and/or by default in when playing under the
+``Very Easy'' difficulty level the center tile does not have to be
+paid for.  ``Easy'' difficulty restricts this to only apply to a
+single colony, ``Normal'' to a single colony and requires the tribe
+you are stealing land to have not been contacted, and other levels
+require payment as usual.
+
 Colonies and armed units near their settlements will alarm the natives
 and poison your relations. If the natives are happy, they will come to
 your colonies offering gifts. If they are unhappy, they will come and


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 7870
          http://freecol.svn.sourceforge.net/freecol/?rev=7870&view=rev
Author:   burschik
Date:     2011-01-02 11:44:19 +0000 (Sun, 02 Jan 2011)

Log Message:
-----------
Add a note about different rule sets. Update information about primary and secondary tile production.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2011-01-02 09:34:43 UTC (rev 7869)
+++ freecol/trunk/doc/FreeCol.tex	2011-01-02 11:44:19 UTC (rev 7870)
@@ -19,7 +19,7 @@
 
 \begin{document}
 \author{\href{http://freecol.sourceforge.net/index.php?section=8}{The FreeCol Team}}
-\title{FreeCol Documentation\\User Guide for Version v0.9.0}
+\title{FreeCol Documentation\\User Guide for Version v0.10.0}
 \maketitle{}
 
 \tableofcontents
@@ -112,6 +112,29 @@
 providing a strong governmental system.
 
 
+\hypertarget{About this manual}{\section{About this manual}}
+
+FreeCol is turning into a game engine that allows the implementation
+of many different games based on similar concepts. It is already
+possible to define different rule sets and to select one of them when
+starting a new game. At the moment, FreeCol ships with two rule sets
+accessible to the user: ``Classic'', which attempts to emulate the
+rules of the original game as far as possible, and ``FreeCol'', which
+mainly conforms to the rules of the original game, but differs in a
+few points. The ``FreeCol'' rule set introduces four additional
+European powers with new national advantages, for example.
+
+In this manual, we always talk about the ``Classic'' rule set unless
+we explicitly mention another rule set. Please note that most of the
+features of terrain types, unit types, building types, founding
+fathers and so on could be changed by another rule set. If the manual
+states that a Lumberjack has a movement allowance of three, or that
+the Prairie produces three units of Cotton, then this applies to the
+``Classic'' rule set and the ``FreeCol'' rule set. Another rule set
+might change these values, or might not even include a Lumberjack, the
+Prairie terrain, or Cotton.
+
+
 \hypertarget{Liberty and Immigration}{\section{Liberty and Immigration}}
 
 \Concept{Liberty} and Immigration are two very important aspects of
@@ -1539,6 +1562,18 @@
 
 \hypertarget{The colony tile}{\subsection{The colony tile}}
 
+The tile your colony is built on is special in several ways. It is the
+only tile that produces more than one type of goods at the same time
+and neither requires nor allows the presence of a colonist to do
+so. On the other hand, you can not choose which types of goods to
+produce. The colony tile will always produce some kind of food as its
+primary product, and some raw material other than lumber or silver as
+its secondary product. The production of food can be increased by
+plowing the colony tile, but the secondary production will not benefit
+from artificial tile improvements such as fields and roads. It will,
+however, benefit from natural tile improvements such as rivers and
+resources.
+
 Some terrain types are more suitable for establishing a colony than
 others. Colonies can not be built on Arctic tiles, nor on Mountains,
 because these terrain types produce no Grain. Hills and Deserts are
@@ -1559,18 +1594,28 @@
 
 The New World is also irrigated by minor and major rivers. The
 production of most types of \hyperlink{Goods}{Goods} is increased by
-the presence of rivers and roads, which your
+the presence of rivers as well as roads, which your
 \hyperlink{Pioneer}{Pioneers} can build. All terrain types which
-produce Grain (except the Hills) can also be cleared or plowed by your
-Pioneers. In the case of open land, plowing increases the production
-of Grain and most other types of goods. In the case of forests,
-clearing removes the forest and transforms the tile into open land:
-Boreal Forest is transformed into Tundra, Mixed Forest into Plains,
-Conifer Forest into Grassland, Tropical Forest into Savannah, Wetland
-Forest into Marsh, Rain Forest into Swamp, Scrub Forest into Desert,
-and Broadleaf Forest into Prairie.
+produce Grain (except the Hills) can also be plowed by your Pioneers
+in order increase grain production. If the tile is forested, you must
+first clear the forest and transform the tile into open land:
 
+\vskip5mm
+\begin{tabular}{l @{\hskip5mm$\rightarrow$\hskip5mm} l}
+Forested&Cleared\\
+\hline
+Boreal Forest & Tundra\\
+Mixed Forest & Plains\\
+Conifer Forest & Grassland\\
+Tropical Forest & Savannah\\
+Wetland Forest & Marsh\\
+Rain Forest & Swamp\\
+Scrub Forest & Desert\\
+Broadleaf Forest & Prairie\\
+\end{tabular}
+\vskip5mm
 
+
 \hypertarget{The adjacent tiles}{\subsection{The adjacent tiles}}
 
 In the early stages of the game, you will need to generate cash by
@@ -1790,9 +1835,7 @@
 \hyperlink{Stockade}{Stockade}, for example, provides protection for
 your colony, and the \hyperlink{Dock}{Docks} enable your colonists to
 go fishing. The effects of these buildings can not be increased by
-workers. In the building box at the top right of the \hyperlink{colony
-panel}{colony panel}, these buildings are shown in parentheses, like
-this: ``(Stockade)''.
+workers.
 
 Most buildings do nothing if they are unoccupied, but provide workers
 with a place to produce manufactured goods. The


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 7923
          http://freecol.svn.sourceforge.net/freecol/?rev=7923&view=rev
Author:   burschik
Date:     2011-01-15 09:37:18 +0000 (Sat, 15 Jan 2011)

Log Message:
-----------
Document changed startup panel sequence.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2011-01-15 08:11:42 UTC (rev 7922)
+++ freecol/trunk/doc/FreeCol.tex	2011-01-15 09:37:18 UTC (rev 7923)
@@ -190,11 +190,12 @@
 available. In practice, however, things are less clear cut.
 
 FreeCol is known to work with \href{http://java.sun.com/}{Sun's Java 5
-  and 6}. FreeCol also works with OpenJDK, although some problems and
-graphics glitches remain. FreeCol is known to run on recent versions
-of Windows, Linux, and Mac OS X. If you are using Linux, using Java 6
-is recommended, as its font rendering is much better. If you are using
-FreeCol on a different platform, we would like to hear about it.
+  and 6}. FreeCol also works with OpenJDK, although some minor
+problems and graphics glitches may remain. FreeCol is known to run on
+recent versions of Windows, Linux, and Mac OS X. If you are using
+Linux, using Java 6 is recommended, as its font rendering is much
+better. If you are using FreeCol on a different platform, we would
+like to hear about it.
 
 FreeCol requires at least 256 MB memory and works best with a screen
 resolution of at least 1024x768 pixels. It should also be possible to
@@ -229,12 +230,8 @@
 In order to compile FreeCol you will need Java and
 \href{http://ant.apache.org/}{the Ant build system}. When these are
 installed, go to the root directory of FreeCol and type \verb$ant$ to
-build a JAR file containing the game. This process requires the
-\verb$native2ascii$\index{native2ascii} task, which is an optional ant
-task. Some Linux distributions place optional tasks in a different
-package, so make sure you have installed all necessary packages if you
-are a Linux user. The game is started using the command
-\verb$java -Xmx256M -jar FreeCol.jar$.
+build a JAR file containing the game. The game is started using the
+command \verb$java -Xmx256M -jar FreeCol.jar$.
 
 If something goes wrong, please open a bug report at the
 \href{http://sourceforge.net/projects/freecol}{SourceForge page of
@@ -269,7 +266,7 @@
 
 There are many other Java options, but you probably won't need to
 change the default settings. FreeCol is developed in English, but it
-includes translations into several other languages, some of which are
+includes translations into many other languages, some of which are
 not very complete, however. Java will automatically select the
 translation for your locale, if available, and English otherwise. If
 you should wish to select a different language, or if language
@@ -321,6 +318,9 @@
 
 \hypertarget{Game setup}{\subsection{Game setup}}
 
+
+\hypertarget{Main panel}{\subsubsection{Main panel}}
+
 If you start FreeCol without command line options, the game will first
 open a dialog that allows you to start a new game, to open a saved
 game, to open the map editor, to set various \hyperlink{Client
@@ -332,11 +332,40 @@
 to join a \Concept{multi-player game}, or to start a new multi-player
 game.
 
-If you start a new game, you must also decide whether to use fixed or
-selectable national advantages, or no national advantages at all. In
-the original game, national advantages were always fixed. The Dutch,
-for example, always had a trading advantage.
 
+\hypertarget{New game}{\subsubsection{New game}}
+
+If you start a new single-player or multi-player game, you must also
+decide whether to use fixed or selectable national advantages, or no
+national advantages at all. In the original game, national advantages
+were always fixed. The Dutch, for example, always had a trading
+advantage. You must also decide which rule set to use. At the moment,
+FreeCol comes with two rule sets, namely ``FreeCol'' (the default) and
+``Classic''. In the future, we will probably distribute additional
+rule sets contributed by players. If you join another game, then you
+must accept the settings the game's owner selected.
+
+
+\hypertarget{Difficulty level}{\subsubsection{Difficulty level}}
+
+The next screen allows you to select an appropriate difficulty
+level. The game comes with five pre-defined difficulty levels: ``Very
+Easy'', ``Easy'', ``Normal'' (the default), ``Hard'' and ``Very
+Hard''. The level is defined by about two dozen different settings,
+such as the amount of gold you start the game with. If you select
+``Very Easy'', for example, you will start with 1000 gold, if you
+select ``Easy'', you will start with only 300 gold, and in higher
+levels you will start entirely penniless.
+
+You can also create your own custom difficulty level. Just select the
+difficulty level that is closest to what you want (i.e. select ``Very
+Hard'' if you want a difficulty level that is even harder) and press
+the ``edit'' button to change the settings. Please note that the range
+of all settings is limited.
+
+
+\hypertarget{Select nations}{\subsubsection{Select nations}}
+
 The next screen allows you to select which European and native nations
 will be present in the game, which colour will be used to represent
 them, and whether they will be played by humans or computer
@@ -358,6 +387,12 @@
   Country} for further information on the national advantages of
 various European nations.
 
+This screen also allows you to change various \hyperlink{Game
+  options}{game options}.
+
+
+\hypertarget{Joining a game}{\subsubsection{Joining a game}}
+
 If you choose to retrieve a list of running games from the metaserver,
 your computer will attempt to establish a connection to
 \verb$meta.freecol.org$, port $3540$\index{Port 3540}. You will be
@@ -372,6 +407,10 @@
 choose a nation and colour, but another players might already have
 selected your preferred nation.
 
+
+\hypertarget{Setting up a multi-player game}{\subsubsection{Setting up
+    a multi-player game}}
+
 If you wish to start a multi-player game, then the IP address of the
 server will be that of your computer, but you must still select a port
 to run the server on. Again, the default port is $3541$. You must also
@@ -423,16 +462,16 @@
 map. The latter settings will influence the terrain.
 
 The game options proper allow you to select several parameters that
-influence game play, such as non-standard rules, victory conditions
-and the difficulty of the game. The initial values tab allows you to
-set the amount of gold available to the players at the start of the
-game. This is zero by default.
+influence game play, such as non-standard rules and victory
+conditions.
 
 The map tab allows you to select whether to use the \textit{Fog of
   War}, whether to hide enemy units in settlements and carriers, and
 whether to award exploration points for regions discovered by the
 players. By default, exploration points are only awarded for the
-discovery of the Pacific Ocean.
+discovery of the Pacific Ocean. You can also change the number of
+turns required to sail between Europe and the New World. By default,
+the journey takes three turns.
 
 The colony tab allows you to enable custom houses to
 \hypertarget{ignore boycotts}{ignore boycotts}\index{ignoring
@@ -446,23 +485,20 @@
 experts working in factory-level buildings will be able to produce a
 small amount of goods even if the necessary raw materials are not
 generally available. This alleged feature of the original game is also
-disabled by default. Finally, you have the choice to save production
+disabled by default. You also have the choice to save production
 overflow, which means that new buildings, for example, will not use up
 all available hammers, but only the exact number required. The
-remaining hammers will remain available for the next building project.
+remaining hammers will remain available for the next building
+project. Finally, you may enable or disable manual student
+selection. The original game always selected a random student from
+those available.
 
 The victory conditions tab allows you to choose among three possible
 victory conditions. The game will be won by the first player to
 achieve independence, the player to eliminate all other European
 players, or the player to eliminate all other human players.
 
-Finally, the difficulty tab enables you to select a difficulty level
-between very easy and very hard. The difficulty level influences
-various prices and probabilites in the game, such as amount of gold
-required to buy Indian land, and the probability of converting
-natives.
 
-
 \hypertarget{Client options}{\section{Client options}}
 
 The client options panel allows you to customize how your client


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 7925
          http://freecol.svn.sourceforge.net/freecol/?rev=7925&view=rev
Author:   burschik
Date:     2011-01-15 15:55:46 +0000 (Sat, 15 Jan 2011)

Log Message:
-----------
Some minor corrections.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2011-01-15 10:51:39 UTC (rev 7924)
+++ freecol/trunk/doc/FreeCol.tex	2011-01-15 15:55:46 UTC (rev 7925)
@@ -591,7 +591,7 @@
 colonies. The efficiency of the government influences the production
 of all types of goods.
 \item Messages about the number of goods in your colonies'
-warehouses. 
+warehouses.
 \item Messages about units improving through experience, education or
 promotion after a battle won.
 \item Messages about units being demoted after a battle lost.
@@ -699,7 +699,7 @@
 The \hypertarget{game menu}{Game Menu} allows you to:
 
 \begin{itemize}
-\item start a new game 
+\item start a new game
 \item open a savegame
 \item save the current game
 \item change your preferences
@@ -925,7 +925,7 @@
 center the main map, or on a unit in order to select it (a
 \hyperlink{display options}{display option} allows you to decide
 whether the map should always centre on the selected unit, or
-not). 
+not).
 
 Your colonies as well as those of your opponents are displayed on the
 map. You can see their names as well as their sizes, which are
@@ -1043,6 +1043,10 @@
 the shield is black if the mission was established by a
 \hyperlink{Jesuit Missionary}{Jesuit Missionary}, and grey otherwise.
 
+The preferences menu allows you to select ``modern'' colony labels
+instead of these ``classic'' labels. The modern labels display the
+same information, but in a slightly different way.
+
 The order buttons represent some of the orders you can give to your
 units. You can move your mouse over the buttons to see their
 respective orders. If a unit is unable to perform a certain action,
@@ -1198,7 +1202,7 @@
 Below the buildings panel, the outside colony panel shows you which
 colonists are present on the same tile, but are not working inside the
 colony. Any units shown here are able to defend the colony against
-attacks. 
+attacks.
 
 Below this panels, you can see the colony's warehouse area. You can
 drag and drop goods from the warehouse to the cargo panel and vice
@@ -1359,12 +1363,13 @@
 food in Europe is always expensive, and colonial foodstuffs fetch only
 poor prices.
 
-Food comes in two varieties, \Goods{Grain}, which can be cultivated on
-nearly all land tiles, and \Goods{Fish}, which is produced by
-\hyperlink{Ocean}{ocean} and lake tiles. In order to harvest the
-bounty of the sea, you will need a \hyperlink{Dock}{Dock}, however.
+Food is produced from two basic food stuffs, \Goods{Grain}, which can
+be cultivated on nearly all land tiles, and \Goods{Fish}, which is
+produced by \hyperlink{Ocean}{ocean} and lake tiles. In order to
+harvest the bounty of the sea, you will need a \hyperlink{Dock}{Dock},
+however.
 
-Breeding new \Goods{Horses} also requires food, but the horses you
+Breeding new \Goods{Horses} also requires grain, but the horses you
 already have are content to eat grass and consume no more of your
 precious food. In order to breed horses, you need at least two horses
 in your colony (for obvious reasons). Breeding horses does not require
@@ -1390,16 +1395,20 @@
 \hyperlink{Fur Trader's House}{house}.
 
 Initially, the resource which fetches the highest prices in Europe is
-\Goods{Silver}, which can be mined in \hyperlink{Hills}{Hills} and
-\hyperlink{Mountains}{Mountains}. As prices drop, Silver will become
-less and less useful, however. On the other hand, Hills and Mountains
-also produce \Goods{Ore}, which is not in great demand in Europe, but
-which can be refined to produce \Goods{Tools} in the
-\hyperlink{Blacksmith's House}{Blacksmith's House}. Tools are required
-for clearing forests and plowing fields, as well as for constructing
-advanced buildings and units. Furthermore, \Goods{Muskets} can be
-produced from Tools in the \hyperlink{Armory}{Armory}.
+\Goods{Silver}, which can be mined in the
+\hyperlink{Mountains}{Mountains}. Small amounts of silver can also be
+produced on \hyperlink{Swamp}{Swamp} and \hyperlink{Marsh}{Marsh}
+tiles with a minerals resource.
 
+As prices drop, Silver will become less and less useful, however. On
+the other hand, Hills and Mountains also produce \Goods{Ore}, which is
+not in great demand in Europe, but which can be refined to produce
+\Goods{Tools} in the \hyperlink{Blacksmith's House}{Blacksmith's
+  House}. Tools are required for clearing forests and plowing fields,
+as well as for constructing advanced buildings and units. Furthermore,
+\Goods{Muskets} can be produced from Tools in the
+\hyperlink{Armory}{Armory}.
+
 \Goods{Lumber} also fetches poor prices in Europe, but can be used to
 produce \Goods{Hammers} in the \hyperlink{Carpenter's
 House}{Carpenter's House}. Hammers are required for constructing all
@@ -1459,9 +1468,9 @@
 \hypertarget{Resources}{\section{Special Resources}}
 
 Some types of terrain can also have special resources, which increase
-the production of a particular type of goods. These resources look
-just like the goods they will produce. These tiles are particularly
-valuable.
+the production of a particular type of goods. Most of these resources
+look just like the goods they will produce. These tiles are
+particularly valuable.
 
 
 \hypertarget{Native Settlements}{\section{Native Settlements}}
@@ -1520,9 +1529,9 @@
 some gold, or tell you about nearby lands. If your Scout is not a
 \hyperlink{Seasoned Scout}{Seasoned Scout} already, he may become so.
 
-\hyperlink{Free Colonist}{Free Colonists} and \hyperlink{Indentured 
+\hyperlink{Free Colonist}{Free Colonists} and \hyperlink{Indentured
 Servant}{Indentured Servants} may enter a settlement in order to learn
-the skills of the natives. 
+the skills of the natives.
 
 \hyperlink{Missionary}{Missionaries}, which may be either
 \hyperlink{Jesuit Missionary}{Jesuit Missionaries} or ordinary
@@ -1693,7 +1702,7 @@
   Liberty}. If more than 50\% of the colonists support the Sons of
 Liberty, they all produce one additional unit of goods, and if support
 for the Sons of Liberty increases to 100 \%, they even produce two
-additional units. 
+additional units.
 
 On the other hand, if the number of Tories exceeds a certain number
 which depends on the difficulty of the game (4 colonists by default),
@@ -1865,7 +1874,7 @@
 \end{itemize}
 
 
-\hypertarget{Using Buildings}{\section{{Using Buildings}}}
+\hypertarget{Using Buildings}{\section{Using Buildings}}
 
 Some buildings have an immediate effect. The
 \hyperlink{Stockade}{Stockade}, for example, provides protection for
@@ -1884,7 +1893,7 @@
   Colonist}{Free Colonists}. Other units may work less effectively.
 
 
-\hypertarget{Building Units and Buildings}{\section{Building Units 
+\hypertarget{Building Units and Buildings}{\section{Building Units
 and Buildings}}
 
 In order to upgrade buildings, and to construct new buildings and
@@ -1967,7 +1976,7 @@
   food more than those of other European nations. You start with an
   Expert Farmer, a Free Colonist and a Caravel.
 
-\item The fur trapping advantage: Your fur trappes produce two units
+\item The fur trapping advantage: Your fur trappers produce two units
   of fur and your fur traders produce two coats more than those of
   other European nations. You start with an Expert Fur Trapper, a
   Master Fur Trader and a Caravel.
@@ -2028,7 +2037,7 @@
 
 Your Home Country is ruled by a \textbf{Monarch} whose actions can
 have a profound influence on your colonies and your relations to other
-nations present in the New World. 
+nations present in the New World.
 
 From time to time, the Monarch may decide to raise the
 \Concept{Taxes} you pay on all goods you sell in the Home
@@ -2338,7 +2347,7 @@
 to work outside of the colony for a long time without changing his
 work assignment, he may learn the necessary skill and become an
 expert. This does not work for the more complicated jobs within the
-colony, however. 
+colony, however.
 
 The \hyperlink{Schoolhouse}{Schoolhouse} and its upgrades, the
 \hyperlink{College}{College} and the
@@ -2381,6 +2390,10 @@
 \hyperlink{Bartolome de las Casas}{Bartolom\'e de las Casas} joins
 the \hyperlink{Continental Congress}{Continental Congress}.
 
+However, Indian Converts that join your colonies {\em after}
+Bartolom\'e de las Casas has been elected to the Continental Congress
+will always remain converts and can not be upgraded.
+
 \hyperlink{Scout}{Scouts} can explore the New World and enter Indian
 Settlements in order to speak with the tribal chiefs. A scout entering
 an Indian Settlement may become a \hyperlink{Seasoned Scout}{Seasoned
@@ -2649,12 +2662,12 @@
 Bell production in all your colonies by the value of the current
 \hyperlink{Taxes}{tax rate}. \Wikipedia{Thomas_Paine}
 
-\FFather{Simon Bolivar}{Sim\'on Bol\'{\i}var} (1783--1830) is remembered as a great
-leader in the struggle for South American independence from
-Spain. Bol\'{\i}var freed what is now Venezuela and later became its
-first President. When Sim\'on Bol\'{\i}var joins the Continental
-Congress, the Sons of Liberty membership in all existing colonies is
-increased by 20\%. \Wikipedia{Simon_Bolivar}
+\FFather{Simon Bolivar}{Sim\'on Bol\'{\i}var} (1783--1830) is
+remembered as a great leader in the struggle for South American
+independence from Spain. Bol\'{\i}var freed what is now Venezuela and
+later became its first President. When Sim\'on Bol\'{\i}var joins the
+Continental Congress, the Sons of Liberty membership in all existing
+colonies is increased by 20\%. \Wikipedia{Simon_Bolivar}
 
 \Father{Benjamin Franklin} (1706--1790), a heavy contributor to the
 Declaration of Independence, was one of the voices of the
@@ -2677,14 +2690,14 @@
 a haven to fellow Quakers. The election of William Penn increases
 cross production in all colonies by 50\%. \Wikipedia{William_Penn}
 
-\FFather{Father Jean de Brebeuf}{Father Jean de Br\'ebeuf} (1593--1649) 
+\FFather{Father Jean de Brebeuf}{Father Jean de Br\'ebeuf} (1593--1649)
 befriended the Huron Indians and converted many to Christianity. He
 died at the hands of the Iroquois who had finally defeated their
 enemy, the Hurons. With Jean de Brebeuf a member of the Continental
 Congress, all missionaries function as
 experts. \Wikipedia{Jean_de_Brebeuf}
 
-\FFather{Juan de Sepulveda}{Juan Gin\'es de Sep\'ulveda} (1781--1872) 
+\FFather{Juan de Sepulveda}{Juan Gin\'es de Sep\'ulveda} (1781--1872)
 was a Spanish theologian who spoke out for the conquest of Indian
 lands and forced evangelization of the natives. The election of Juan
 de Sepulveda to the Continental Congress increases the chance that a
@@ -2806,7 +2819,7 @@
 
 \hypertarget{Copyright Notice}{\chapter{Copyright Notice}}
 
-Copyright \copyright 2008
+Copyright \copyright 2002--2011
 \href{http://freecol.sourceforge.net/index.php?section=8}{The FreeCol
 Team}.
 


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 7958
          http://freecol.svn.sourceforge.net/freecol/?rev=7958&view=rev
Author:   burschik
Date:     2011-01-21 15:22:45 +0000 (Fri, 21 Jan 2011)

Log Message:
-----------
Update conquest advantage.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2011-01-21 12:16:38 UTC (rev 7957)
+++ freecol/trunk/doc/FreeCol.tex	2011-01-21 15:22:45 UTC (rev 7958)
@@ -1959,9 +1959,10 @@
   as many crosses as the other European nations in order to attract
   new immigrants. You start with two Free Colonists and a Caravel.
 
-\item The conquest advantage: You capture twice as much treasure and
-  twice as many ``converts'' when destroying native settlements. You
-  start with a Free Colonist, a Veteran Soldier and a Caravel.
+\item The conquest advantage: You have a 50\% advantage when attacking
+  natives and capture twice as many ``converts'' when destroying
+  native settlements. You start with a Free Colonist, a Veteran
+  Soldier and a Caravel.
 
 \item The naval advantage: All your ships can move one tile further
   than those of other European nations. You start with two Free


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 8138
          http://freecol.svn.sourceforge.net/freecol/?rev=8138&view=rev
Author:   burschik
Date:     2011-03-20 14:03:37 +0000 (Sun, 20 Mar 2011)

Log Message:
-----------
Hopefully clarify horse production.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2011-03-20 13:35:16 UTC (rev 8137)
+++ freecol/trunk/doc/FreeCol.tex	2011-03-20 14:03:37 UTC (rev 8138)
@@ -1365,15 +1365,23 @@
 
 Food is produced from two basic food stuffs, \Goods{Grain}, which can
 be cultivated on nearly all land tiles, and \Goods{Fish}, which is
-produced by \hyperlink{Ocean}{ocean} and lake tiles. In order to
-harvest the bounty of the sea, you will need a \hyperlink{Dock}{Dock},
-however.
+produced by \hyperlink{Ocean}{ocean} and lake tiles. To harvest the
+bounty of the sea, you will need a \hyperlink{Dock}{Dock}, however. In
+order to avoid starvation, your colonists store half the food (rounded
+down) the colony produces in the warehouse. As a consequence, you can
+not use the grain and fish it is made from for any other purpose.
 
-Breeding new \Goods{Horses} also requires grain, but the horses you
-already have are content to eat grass and consume no more of your
-precious food. In order to breed horses, you need at least two horses
-in your colony (for obvious reasons). Breeding horses does not require
-\hyperlink{Stables}{Stables}, but Stables do speed things up.
+\Goods{Horses} are special in several ways. Horses will survive by
+grazing in your colonies' \hyperlink{Pasture}{Pastures}, but in order
+to reproduce they require grain, and there have to be at least two of
+them. Horses live in herds, and each herd produces no more than two
+new horses per turn. In the Pasture, a herd consists of fifty horses,
+but in the \hyperlink{Stables}{Stables}, a herd consists of only
+twenty-five horses, effectively doubling the number of horses you can
+breed per turn (provided you have enough food). Remember that horses
+do not eat fish, and that your colonists store half the food produced
+in the warehouse, regardless of how many horses you would like to be
+produced instead.
 
 Four raw materials are typical for the New World. They will initially
 generate a good income, but prices will inevitably drop. These goods
@@ -1809,10 +1817,13 @@
   the New World (symbolized by \hyperlink{Crosses}{Crosses}) causes
   increased emigration from Europe.
 
-\item The \Building{Pasture} surrounding your colony is used to breed
-  horses. It can be upgraded to \Building{Stables}, which potentially
-  double the production of \hyperlink{Horses}{Horses}. Neither the
-  Pasture nor the Stables need colonists to operate.
+\item The \Building{Pasture} surrounding your colony is used to
+  support and breed \hyperlink{Horses}{Horses}. It can be upgraded to
+  \Building{Stables}, which reduces the size of a horse herd from
+  fifty to twenty-five. Since every herd produces no more than two new
+  horses per turn, the stables double the production of horses,
+  provided you have enough grain to feed them. Neither the Pasture nor
+  the Stables need colonists to operate.
 
 \end{itemize}
 


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 8188
          http://freecol.svn.sourceforge.net/freecol/?rev=8188&view=rev
Author:   burschik
Date:     2011-03-26 13:02:35 +0000 (Sat, 26 Mar 2011)

Log Message:
-----------
Various small additions.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2011-03-26 10:48:37 UTC (rev 8187)
+++ freecol/trunk/doc/FreeCol.tex	2011-03-26 13:02:35 UTC (rev 8188)
@@ -271,7 +271,7 @@
 translation for your locale, if available, and English otherwise. If
 you should wish to select a different language, or if language
 selection fails, you can choose a different language from the
-\hyperlink{Client options}{preferences menu}.
+\hyperlink{client options}{preferences menu}.
 
 FreeCol also provides several application-specific command line
 options:
@@ -323,8 +323,8 @@
 
 If you start FreeCol without command line options, the game will first
 open a dialog that allows you to start a new game, to open a saved
-game, to open the map editor, to set various \hyperlink{Client
-  options}{options}, and to quit.
+game, to open the map editor, to set various \hyperlink{client options}
+{options}, and to quit.
 
 If you decide to start a new game, you will be presented with another
 dialog, which enables you to start a single-player game, to retrieve a
@@ -346,7 +346,7 @@
 must accept the settings the game's owner selected.
 
 
-\hypertarget{Difficulty level}{\subsubsection{Difficulty level}}
+\hypertarget{difficulty level}{\subsubsection{Difficulty level}}
 
 The next screen allows you to select an appropriate difficulty
 level. The game comes with five pre-defined difficulty levels: ``Very
@@ -364,7 +364,7 @@
 of all settings is limited.
 
 
-\hypertarget{Select nations}{\subsubsection{Select nations}}
+\hypertarget{select nations}{\subsubsection{Select nations}}
 
 The next screen allows you to select which European and native nations
 will be present in the game, which colour will be used to represent
@@ -387,8 +387,8 @@
   Country} for further information on the national advantages of
 various European nations.
 
-This screen also allows you to change various \hyperlink{Game
-  options}{game options}.
+This screen also allows you to change various \hyperlink{game options}
+{game options}.
 
 
 \hypertarget{Joining a game}{\subsubsection{Joining a game}}
@@ -441,7 +441,7 @@
 permit the clients to connect to the port of the game server.
 
 
-\hypertarget{Game options}{\subsection{Game options}}
+\hypertarget{game generator options}{\subsection{Map Generator Options}}
 
 The \hypertarget{map generator options}{map generator options} allow
 you to import a map, and to set several parameters that influence the
@@ -461,7 +461,10 @@
 tiles on the map, as well as the humidity and temperature of the
 map. The latter settings will influence the terrain.
 
-The game options proper allow you to select several parameters that
+
+\hypertarget{game options}{\subsection{Game Options}}
+
+The game options allow you to select several parameters that
 influence game play, such as non-standard rules and victory
 conditions.
 
@@ -499,7 +502,7 @@
 players, or the player to eliminate all other human players.
 
 
-\hypertarget{Client options}{\section{Client options}}
+\hypertarget{client options}{\section{Client Options}}
 
 The client options panel allows you to customize how your client
 displays the game objects and how it handles some tasks such as
@@ -685,7 +688,7 @@
 panel, the compass rose in the top right corner, and the main map in
 the background. The units, colonies, and so forth can be seen on the
 main map. They are also represented as coloured dots on the minimap.
-The \hyperlink{Client options}{preferences menu} allows you to disable
+The \hyperlink{client options}{preferences menu} allows you to disable
 some of these controls if you wish to do so.
 
 \hypertarget{menubar}{\subsection{The Menubar}}
@@ -762,9 +765,9 @@
 
 The \hypertarget{reports menu}{Reports Menu} provides access to
 various reports on the current state of your colonies. In these
-reports, icons as well as text strings of a greyish-brown colour link
-to the places they refer to. If you click on the name of a colony, for
-example, the \hyperlink{colony panel}{Colony Panel} will be opened.
+reports, icons as well as blue text strings link to the places they
+refer to. If you click on the name of a colony, for example, the
+\hyperlink{colony panel}{Colony Panel} will be opened.
 
 \begin{itemize}
 \item The \Report{Religious Advisor} tells you how many crosses your
@@ -824,6 +827,13 @@
 \item The \Report{Production Report} provides you with an overview of
   the production of up to four different kinds of goods in your
   colonies, as well as the buildings that produce these goods.
+\item The menu item ``Show Difficulty Level'' displays the
+  \hyperlink{difficulty level}{difficulty level} of the current game.
+\item The menu item ``Show Game Options'' displays the \hyperlink{game
+  options}{Game Options} of the current game.
+\item The menu item ``Show Map Generator Options'' displays the
+  \hyperlink{map generator options}{options} that produced the map
+  used by the current game.
 
 \end{itemize}
 
@@ -833,12 +843,18 @@
 \begin{itemize}
 \item The terrain section contains information on all the different
 types of terrain you may encounter in the New World.
-\item The unit section provides details on various types of units,
-your own as well native units and units of the Royal Expeditionary
-Force.
+\item The bonus resources section lists the special resources of the
+  New World. These resources greatly increase the production of
+  certain goods. In some cases, tiles can only produce particular
+  goods if a resource is present.
 \item The goods section gives on overview of all the types of goods in
 the game.
-\item The building section provides information on the various
+\item The unit section provides details on various types of units,
+  your own as well native units and units of the Royal Expeditionary
+  Force. Skilled units are not included.
+\item The skills section lists the various expert units you may
+  recruit or train.
+\item The buildings section provides information on the various
 constructions you may build in your colonies.
 \item The Founding Father section can be used to look up information
 on the various Founding Fathers you may elect to the Continental


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 8200
          http://freecol.svn.sourceforge.net/freecol/?rev=8200&view=rev
Author:   mpope
Date:     2011-03-28 09:16:30 +0000 (Mon, 28 Mar 2011)

Log Message:
-----------
Document Goods Movement messages as a trade route debugger.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2011-03-28 08:55:19 UTC (rev 8199)
+++ freecol/trunk/doc/FreeCol.tex	2011-03-28 09:16:30 UTC (rev 8200)
@@ -1488,6 +1488,10 @@
 As soon as a ship or wagon train reaches the last destination of the
 trade route, it will continue at the first destination.
 
+The behaviour of trade routes can sometimes be confusing.  To see
+exactly what each unit with a trade route is doing, enable the
+\texttt{Goods Movement} message type, but beware that there can be
+many messages of this type.
 
 \hypertarget{Resources}{\section{Special Resources}}
 


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 8201
          http://freecol.svn.sourceforge.net/freecol/?rev=8201&view=rev
Author:   mpope
Date:     2011-03-28 09:17:23 +0000 (Mon, 28 Mar 2011)

Log Message:
-----------
Document the slow java2d animation workaround.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2011-03-28 09:16:30 UTC (rev 8200)
+++ freecol/trunk/doc/FreeCol.tex	2011-03-28 09:17:23 UTC (rev 8201)
@@ -578,6 +578,11 @@
 
 \end{itemize}
 
+Beware that some Java implementations have bugs that cause high CPU
+load and very slow performance if animation is enabled.  If this
+happens, either disable animation or experiment with the
+\texttt{-Dsun.java2d.pmoffscreen=false} Java command line option.
+
 \hypertarget{message options}{\subsection{Message Options}}
 
 You can choose whether to group messages by type, by source, or not at


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 8203
          http://freecol.svn.sourceforge.net/freecol/?rev=8203&view=rev
Author:   mpope
Date:     2011-03-28 10:27:21 +0000 (Mon, 28 Mar 2011)

Log Message:
-----------
Small clarification of Franklin, needed by BR#2886188a

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2011-03-28 09:31:13 UTC (rev 8202)
+++ freecol/trunk/doc/FreeCol.tex	2011-03-28 10:27:21 UTC (rev 8203)
@@ -2110,7 +2110,8 @@
 with this nation, unless \hyperlink{Benjamin Franklin}{Benjamin
 Franklin} has already been elected to the \hyperlink{Continental
 Congress}{Continental Congress}. In this case, the Monarch's wars do
-not affect you anymore.
+not affect you anymore, except that the Monarch may still use the war
+as an excuse to raise your taxes.
 
 If you are already at war with some nation, either due to the
 Monarch's actions, or your own, the crown may offer you some cheap


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 8476
          http://freecol.svn.sourceforge.net/freecol/?rev=8476&view=rev
Author:   burschik
Date:     2011-06-03 07:19:18 +0000 (Fri, 03 Jun 2011)

Log Message:
-----------
Add education report.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2011-06-02 17:59:25 UTC (rev 8475)
+++ freecol/trunk/doc/FreeCol.tex	2011-06-03 07:19:18 UTC (rev 8476)
@@ -838,6 +838,9 @@
 \item The \Report{Production Report} provides you with an overview of
   the production of up to four different kinds of goods in your
   colonies, as well as the buildings that produce these goods.
+\item The \Report{Education Report} shows you the schoolhouses,
+  colleges and universities in your colonies, as well as a list of
+  potential teachers and potential students.
 \item The menu item ``Show Difficulty Level'' displays the
   \hyperlink{difficulty level}{difficulty level} of the current game.
 \item The menu item ``Show Game Options'' displays the \hyperlink{game


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 8484
          http://freecol.svn.sourceforge.net/freecol/?rev=8484&view=rev
Author:   burschik
Date:     2011-06-04 14:07:33 +0000 (Sat, 04 Jun 2011)

Log Message:
-----------
Add section on customizing fonts.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2011-06-04 13:20:52 UTC (rev 8483)
+++ freecol/trunk/doc/FreeCol.tex	2011-06-04 14:07:33 UTC (rev 8484)
@@ -1361,6 +1361,63 @@
 of the build queue, provided that you have enough gold.
 
 
+\hypertarget{customization}{\section{Customization}}
+
+The FreeCol user interface can be customized to a certain degree. In
+the directory where FreeCol is installed, you will find a
+sub-directory called {\tt data}, which contains configuration files
+and multimedia assets. These include the images used to represent
+units, goods, buildings and various other objects that appear in the
+game, sounds to play when certain events occur and so forth. You can
+replace them if you wish.
+
+The sub-directory {\tt data/base/} contains assets that are used for
+the user interface in general, independent of the rules used for a
+particular game. The sub-directory {\tt
+  data/\-base/\-resources/\-fonts} contains several fonts that are
+distributed with FreeCol, including the file {\tt ShadowedBlack.ttf},
+which contains the black letter font used to display headlines and the
+titles of panels. The file {\tt data/\-base/\-resources.properties}
+allows you to configure how the assets are used.
+
+The line
+
+\begin{quote}
+{\tt NormalFont=urn:font:Serif-PLAIN-13}
+\end{quote}
+
+for example, selects the font called ``Serif'' with font style
+``plain'' and font size 13. Instead of ``Serif'', you could use any
+other font that is known to the Java Virtual Machine of your
+system. In general, this includes all fonts installed by the operating
+system (rather than individual applications).
+
+Please note that FreeCol uses a Uniform Resource Identifier (URI) to
+identify the font. For this reason, you must obey the usual quoting
+rules. In particular, you must use the string {\tt \%20} instead of a
+space character in the font name.
+
+In order to use a TrueType font that is not available to the JVM, you
+must copy it to the fonts directory mentioned above and add it to the
+configuration file by adding a line like this:
+
+\begin{quote}
+{\tt MyFavouriteFont=resources/fonts/Chancery.ttf}
+\end{quote}
+
+Then you could say:
+
+\begin{quote}
+{\tt NormalFont=urn:font:Black\%20Chancery-PLAIN-13}
+\end{quote}
+
+Instead of {\tt MyFavouriteFont}, you can any key you like, as long as
+it is not being used for anything else. This line will add your font
+to the list of fonts known to the JVM, and you can then use its name,
+which is, however, likely to differ from the file name. The file {\tt
+  Chancery.ttf}, for example, contains a font called ``Black Chancery''.
+
+
 \hypertarget{The New World}{\chapter{The New World}}
 
 At the beginning of the game, you will start with a naval vessel and


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 8493
          http://freecol.svn.sourceforge.net/freecol/?rev=8493&view=rev
Author:   burschik
Date:     2011-06-06 14:24:43 +0000 (Mon, 06 Jun 2011)

Log Message:
-----------
Update description of horse production.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2011-06-05 13:53:30 UTC (rev 8492)
+++ freecol/trunk/doc/FreeCol.tex	2011-06-06 14:24:43 UTC (rev 8493)
@@ -1496,10 +1496,7 @@
 Food is produced from two basic food stuffs, \Goods{Grain}, which can
 be cultivated on nearly all land tiles, and \Goods{Fish}, which is
 produced by \hyperlink{Ocean}{ocean} and lake tiles. To harvest the
-bounty of the sea, you will need a \hyperlink{Dock}{Dock}, however. In
-order to avoid starvation, your colonists store half the food (rounded
-down) the colony produces in the warehouse. As a consequence, you can
-not use the grain and fish it is made from for any other purpose.
+bounty of the sea, you will need a \hyperlink{Dock}{Dock}, however.
 
 \Goods{Horses} are special in several ways. Horses will survive by
 grazing in your colonies' \hyperlink{Pasture}{Pastures}, but in order
@@ -1508,11 +1505,14 @@
 new horses per turn. In the Pasture, a herd consists of fifty horses,
 but in the \hyperlink{Stables}{Stables}, a herd consists of only
 twenty-five horses, effectively doubling the number of horses you can
-breed per turn (provided you have enough food). Remember that horses
-do not eat fish, and that your colonists store half the food produced
-in the warehouse, regardless of how many horses you would like to be
-produced instead.
+breed per turn (provided you have enough food).
 
+The number of horses you can breed is further limited by the fact that
+horses feed only on grain and not on fish. And Pastures and Stables
+consume no more than half the food surplus available. In other words,
+you can not breed more horses by filling your colonies' warehouses
+with grain.
+
 Four raw materials are typical for the New World. They will initially
 generate a good income, but prices will inevitably drop. These goods
 are \Goods{Sugar}, which is best cultivated on


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 8504
          http://freecol.svn.sourceforge.net/freecol/?rev=8504&view=rev
Author:   mpope
Date:     2011-06-13 02:56:46 +0000 (Mon, 13 Jun 2011)

Log Message:
-----------
Document greyed out units.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2011-06-12 08:39:54 UTC (rev 8503)
+++ freecol/trunk/doc/FreeCol.tex	2011-06-13 02:56:46 UTC (rev 8504)
@@ -994,11 +994,13 @@
 The main map shows you the New World in greater detail. You can see
 the different types of terrain, forested and otherwise, hills,
 mountains, rivers, and, of course, the various units and settlements
-of the native and European players. Left click on a tile in order to
-center the main map, or on a unit in order to select it (a
-\hyperlink{display options}{display option} allows you to decide
-whether the map should always centre on the selected unit, or
-not).
+of the native and European players.  Sometimes units will be all
+grey--- this shows the position of the unit when you could last see
+that tile, but does not guarantee that the unit is still there.  Left
+click on a tile in order to center the main map, or on a unit in order
+to select it (a \hyperlink{display options}{display option} allows you
+to decide whether the map should always centre on the selected unit,
+or not).
 
 Your colonies as well as those of your opponents are displayed on the
 map. You can see their names as well as their sizes, which are


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 8554
          http://freecol.svn.sourceforge.net/freecol/?rev=8554&view=rev
Author:   burschik
Date:     2011-06-23 04:54:48 +0000 (Thu, 23 Jun 2011)

Log Message:
-----------
Fix description of hotkeys with patch from 'Tim'.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2011-06-23 04:53:00 UTC (rev 8553)
+++ freecol/trunk/doc/FreeCol.tex	2011-06-23 04:54:48 UTC (rev 8554)
@@ -14,7 +14,12 @@
 \usepackage{longtable}
 \usepackage{graphicx}
 \usepackage{index}
-\usepackage[colorlinks=true,hyperindex=true]{hyperref}
+\usepackage[
+  colorlinks=true,
+  hyperindex=true,
+  pdftitle={FreeCol Documentation, User Guide for Version v0.10.0},
+  pdfauthor={The FreeCol Team}
+]{hyperref}
 \makeindex
 
 \begin{document}
@@ -995,7 +1000,7 @@
 the different types of terrain, forested and otherwise, hills,
 mountains, rivers, and, of course, the various units and settlements
 of the native and European players.  Sometimes units will be all
-grey--- this shows the position of the unit when you could last see
+grey---this shows the position of the unit when you could last see
 that tile, but does not guarantee that the unit is still there.  Left
 click on a tile in order to center the main map, or on a unit in order
 to select it (a \hyperlink{display options}{display option} allows you
@@ -1076,7 +1081,7 @@
 buttons, in order to give the selected unit a movement order.
 
 In the original Colonization game, a unit always used up all movement
-points when entering a colony. In FreeCol, this is not the case --- a
+points when entering a colony. In FreeCol, this is not the case---a
 unit can enter a colony just like any other tile. If the unit is
 placed in a building, or on a colony tile, or if a carrier is loaded
 or unloaded, however, it will lose all its movement points.
@@ -1133,7 +1138,7 @@
 \begin{itemize}
 \item\verb$a$: assign a trade route.
 \item\verb$b$: build a colony, or join an existing colony.
-\item\verb$c$: center on the currently selected unit.
+\item\verb$c$: clear forest (requires 20 tools)
 \item\verb$d$: disband the active unit.
 \item\verb$e$: show the Europe panel.
 \item\verb$f$: fortify.
@@ -1154,6 +1159,7 @@
 \item\verb$enter$: end the turn.
 \item\verb$plus$ or \verb$equals$: zoom in.
 \item\verb$minus$ or \verb$underscore$: zoom out.
+\item\verb$ctrl-c$: center on the currently selected unit.
 \item\verb$ctrl-d$: display tile names.
 \item\verb$ctrl-f$: find a colony.
 \item\verb$ctrl-g$: display grid.
@@ -1248,7 +1254,7 @@
 surrounding the colony can produce several kinds of goods, however. If
 the unit is not producing the right kind of goods, you can right click
 on the unit to select a different kind of work. If a tile has a red
-border, then it can not be used --- it is either assigned to another
+border, then it can not be used---it is either assigned to another
 colony or settlement, or is occupied by a hostile unit, or is a water
 tile which can not be used until you have built \hyperlink{Dock}{docks}.
 Note that if you drag a unit onto a tile used by the natives you may
@@ -1627,7 +1633,7 @@
 half the alarm among the natives. The \hyperlink{Spain}{Spanish}
 player has the advantage of greater military efficiency against the
 natives. Your choice of \hyperlink{Home Country}{Home Country} may
-influence your strategy --- or vice versa.
+influence your strategy---or vice versa.
 
 Small Native Settlements use the tile they are built on and all the
 adjacent tiles, just like your \hyperlink{Colonies}{Colonies} do, and
@@ -2085,7 +2091,7 @@
 tied to particular nations. FreeCol, however, optionally allows you to
 select your national advantage.
 
-At the moment, FreeCol defines the following six advantages, and also
+At the moment, FreeCol defines the following eight advantages, and also
 allows you to select no advantage at all:
 
 \begin{itemize}
@@ -2299,11 +2305,12 @@
 The more advanced buildings you can construct in the your colonies
 require not only lumber but also \hyperlink{Tools}{Tools}, which are
 produced from \hyperlink{Ore}{Ore}. This is the job the \Unit{Master
-Blacksmith} excels in.  Tools are also used by your \Unit{Pioneer} to
-clear forests and plow fields, but none of your other colonists can
-match the outdoors skills of your \Unit{Hardy Pioneer}. And finally,
-Tools are required for the production of \hyperlink{Muskets}{Muskets},
-a demanding task best left to the \Unit{Master Gunsmith}.
+Blacksmith} excels in. Tools are also used by your \Unit{Pioneer} to
+clear forests, to plow fields and to build roads, but none of your 
+other colonists can match the outdoors skills of your 
+\Unit{Hardy Pioneer}. And finally, Tools are required for the 
+production of \hyperlink{Muskets}{Muskets}, a demanding task best 
+left to the \Unit{Master Gunsmith}.
 
 All your units are able to explore the New World, but the colonist
 most suited to this dangerous endeavour is the \Unit{Scout}, a mounted
@@ -2916,7 +2923,7 @@
 their land forces and by taking back any colonies they might have
 captured. You do not need to destroy the fleet.  However, you do need
 to maintain at least one independent colony that is on the coast and
-accessible from Europe--- if the Royal Expeditionary Force captures
+accessible from Europe---if the Royal Expeditionary Force captures
 all your coastal colonies you have lost.
 
 At the declaration, colonies with strong support for the Sons of
@@ -2960,7 +2967,7 @@
 (usually called \texttt{FreeCol.log}) which is very helpful to the
 developers if attached to the bug report.  The log file can sometimes
 be large enough to exceed the attachment limit at SourceForge, in
-which case feel free to omit the bulk of the file--- the critical
+which case feel free to omit the bulk of the file---the critical
 information is likely to be near the end (in the form of a
 java exception message), but you should always retain the first few
 lines which contain the FreeCol version and system information.


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 8676
          http://freecol.svn.sourceforge.net/freecol/?rev=8676&view=rev
Author:   burschik
Date:     2011-07-14 09:46:48 +0000 (Thu, 14 Jul 2011)

Log Message:
-----------
Fix description of Indian Convert.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2011-07-14 09:28:36 UTC (rev 8675)
+++ freecol/trunk/doc/FreeCol.tex	2011-07-14 09:46:48 UTC (rev 8676)
@@ -2332,12 +2332,13 @@
 accomplished at the job.
 
 The converted natives may join your colonies as \Unit{Indian
-Convert}. They are unskilled at all jobs within the colony, but more
-skilled than your Free Colonists at all outdoor jobs. Indian Converts
-can not be upgraded through \hyperlink{Skills and
-Education}{Education}, but they become Free Colonists as soon as
-\hyperlink{Bartolome de las Casas}{Bartolom{\'e} de las Casas} joins
-the \hyperlink{Continental Congress}{Continental Congress}.
+  Convert}s. They are unskilled at all jobs within the colony, but
+more skilled than your Free Colonists at producing food and New World
+Goods such as sugar, tobacco, cotton and furs. Indian Converts can not
+be upgraded through \hyperlink{Skills and Education}{Education}, but
+they become Free Colonists as soon as \hyperlink{Bartolome de las
+  Casas}{Bartolom{\'e} de las Casas} joins the \hyperlink{Continental
+  Congress}{Continental Congress}.
 
 Many colonists come to the New World in search of religious
 freedom. Thus, they desire a \hyperlink{Church}{Church} in which to


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 8817
          http://freecol.svn.sourceforge.net/freecol/?rev=8817&view=rev
Author:   burschik
Date:     2011-08-06 08:20:23 +0000 (Sat, 06 Aug 2011)

Log Message:
-----------
Add new key bindings and a few other morsels.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2011-08-06 07:57:03 UTC (rev 8816)
+++ freecol/trunk/doc/FreeCol.tex	2011-08-06 08:20:23 UTC (rev 8817)
@@ -1245,21 +1245,23 @@
 or wait outside of the colony.
 
 The select box at the top left of the panel displaying the name of the
-colony can be used to select a different colony. Next to the colony's
-name, the production panel, shows all the goods your colony is
-producing.
+colony can be used to select a different colony. You can also use the
+``left'' and ``right'' keys to ``scroll'' through your colonies. Next
+to the colony's name, the production panel shows all the goods your
+colony is producing.
 
 Below colony name, you can see the area surrounding the colony to the
 left and a scroll pane displaying the buildings of the colony to the
-right. You can drag and drop a unit on a tile or a building. The tiles
-surrounding the colony can produce several kinds of goods, however. If
-the unit is not producing the right kind of goods, you can right click
-on the unit to select a different kind of work. If a tile has a red
-border, then it can not be used---it is either assigned to another
-colony or settlement, or is occupied by a hostile unit, or is a water
-tile which can not be used until you have built \hyperlink{Dock}{docks}.
-Note that if you drag a unit onto a tile used by the natives you may
-be offered the chance to purchase the land.
+right. You can drag and drop a unit on a tile or a building. Buildings
+only ever produce a single type of goods. The tiles surrounding the
+colony can produce several kinds of goods, however. If the unit is not
+producing the right kind of goods, you can right click on the unit to
+select a different kind of work. If a tile has a red border, then it
+can not be used---it is either assigned to another colony or
+settlement, or is occupied by a hostile unit, or is a water tile which
+can not be used until you have built \hyperlink{Dock}{docks}.  Note
+that if you drag a unit onto a tile owned by the natives you may be
+offered the chance to purchase the land.
 
 Below the surrounding area, you can see the population panel, which
 displays the size of your colony, the number and percentage of
@@ -1306,15 +1308,17 @@
 below) in order to change export settings.
 
 At the bottom of the Colony Screen, you will see a row of buttons, not
-all of which are always active. From left to right, these buttons will
-allow you to
+all of which are always active. These buttons will allow you to
 
 \begin{itemize}
 \item Unload the active ship or wagon train
 \item Fill up all partially filled holds of the active ship or
 wagon train
 \item Open the warehouse dialog in order to change the export and
-warning levels for all types of goods (see below)
+  warning levels for all types of goods (see \hyperlink{The Warehouse
+    Dialog}{below})
+\item Select which buildings or units to build (see \hyperlink{The
+  Build Queue Panel}{below}).
 \item Close the dialog
 \end{itemize}
 
@@ -1383,11 +1387,12 @@
 The sub-directory {\tt data/base/} contains assets that are used for
 the user interface in general, independent of the rules used for a
 particular game. The sub-directory {\tt
-  data/\-base/\-resources/\-fonts} contains several fonts that are
-distributed with FreeCol, including the file {\tt ShadowedBlack.ttf},
-which contains the black letter font used to display headlines and the
-titles of panels. The file {\tt data/\-base/\-resources.properties}
-allows you to configure how the assets are used.
+  data/\-base/\-resources/\-fonts} contains several fonts\index{fonts}
+that are distributed with FreeCol, including the file {\tt
+  ShadowedBlack.ttf}, which contains the black letter font used to
+display headlines and the titles of panels. The file {\tt
+  data/\-base/\-resources.properties} allows you to configure how the
+assets are used.
 
 The line
 


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 8862
          http://freecol.svn.sourceforge.net/freecol/?rev=8862&view=rev
Author:   burschik
Date:     2011-08-13 09:57:13 +0000 (Sat, 13 Aug 2011)

Log Message:
-----------
Explain --home-directory option.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2011-08-13 08:45:29 UTC (rev 8861)
+++ freecol/trunk/doc/FreeCol.tex	2011-08-13 09:57:13 UTC (rev 8862)
@@ -309,6 +309,12 @@
 server options.
 \item\verb$--font[[=]FONTSPEC]$ Override the default font with a Java
 font specifier (e.g. Arial-BOLD-12).
+\item\verb$--home-directory DIRECTORY$ Use the given directory instead
+  of your default home directory to load and save games, options and
+  log files. You can use this in order to run the game from a USB
+  stick\index{USB stick}, for example. Please note that specifying a
+  save game file on the command line will override the save game
+  directory.
 \end{itemize}
 
 There are several other options that you will probably only be


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 8924
          http://freecol.svn.sourceforge.net/freecol/?rev=8924&view=rev
Author:   burschik
Date:     2011-09-02 08:37:15 +0000 (Fri, 02 Sep 2011)
Log Message:
-----------
Add a subsection about the differences between rule sets, and generally update the manual.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2011-09-02 07:38:25 UTC (rev 8923)
+++ freecol/trunk/doc/FreeCol.tex	2011-09-02 08:37:15 UTC (rev 8924)
@@ -24,7 +24,7 @@
 
 \begin{document}
 \author{\href{http://freecol.sourceforge.net/index.php?section=8}{The FreeCol Team}}
-\title{FreeCol Documentation\\User Guide for Version v0.10.1}
+\title{FreeCol Documentation\\User Guide for Version v0.10.2}
 \maketitle{}
 
 \tableofcontents
@@ -139,7 +139,62 @@
 might change these values, or might not even include a Lumberjack, the
 Prairie terrain, or Cotton.
 
+\hypertarget{Differences between the rule
+  sets}{\subsection{Differences between the rule sets}}
 
+The following differences between the ``Classic'' rule set and the
+``FreeCol'' rule set exist:
+
+\begin{itemize}
+\item The FreeCol rules introduce four additional nations and four
+  additional national advantages. These additions correct the omission
+  of the Portuguese from the original game, and make multi-player
+  games with up to eight players possible.
+\item Under the Classic rules, the population of a colony with a
+  \hyperlink{Stockade}{stockade} or more advanced fortification can
+  not be reduced below three. Therefore, it is usually impossible to
+  abandon a fortified colony. The FreeCol rule set deliberately
+  ignores this rule of the original game.
+\item While the original game awards
+  \hyperlink{Exploration}{exploration points} only for the discovery
+  of the Pacific Ocean, FreeCol optionally awards exploration points
+  for the discovery of various map regions. The FreeCol rule set
+  enables exploration points by default, whereas the Classic rule set
+  disables them by default.
+\item In the original game, it is impossible to attack units on land
+  with ships or units aboard ships. This makes it possible to create
+  invincible colonies by completely fortifying small islands. FreeCol
+  optionally allows amphibious assaults. The option is on by default
+  in the FreeCol rule set, and off by default in the Classic rule set.
+\item FreeCol optionally makes \hyperlink{Missionary}{missionaries}
+  more useful. Settlements with a mission grant the owner of the
+  mission better prices when trading, and are willing to train more
+  than one of his units. This feature is turned off by default in the
+  Classic rule set and turned on by default in the FreeCol rule set.
+\item In the original game, the \hyperlink{Royal Expeditionary
+  Force}{Royal Expeditionary Force} simply appears out of the blue,
+  and can not be defeated at sea before unloading most of its
+  troops. In FreeCol, you can decide whether the REF must obey the
+  usual sailing rules. By default, the Classic rules emulate the
+  original game, while the FreeCol rules allow a naval defeat of the
+  REF.
+\item In the original game, the \hyperlink{Custom House}{Custom House}
+  ignores all boycotts. This is generally considered a bug rather than
+  a feature. Under the FreeCol rules, custom houses must obey boycotts
+  by default, whereas they ignore boycotts by default under the
+  Classic rules.
+\item It has been claimed that experts can produce a certain amount of
+  goods even if not enough raw materials are available in the original
+  game. Although it is unclear whether this is generally true and is a
+  feature rather than a bug of the original game, the Classic rule set
+  emulates this quirk by default. The FreeCol rule set does not.
+\item In the original game, the least skilled unit is always educated
+  first. FreeCol optionally allows you to select the unit to be
+  trained yourself. This feature is off by default in the Classic
+  rule set and on by default in the FreeCol rule set.
+\end{itemize}
+
+
 \hypertarget{Liberty and Immigration}{\section{Liberty and Immigration}}
 
 \Concept{Liberty} and Immigration are two very important aspects of
@@ -1849,12 +1904,14 @@
 possible.
 
 
-\hypertarget{No Reforestation}{\subsection{No Reforestation}}
+\hypertarget{Reforestation}{\subsection{Reforestation}}
 
 You can order your pioneers to cut down forests by plowing a tile.
 This will increase the food produced on these tiles, and the lumber
-will be delivered to your colonies. However, you can not plant new
-forests later. Once cleared, a tile will never produce lumber again.
+will be delivered to your colonies. Under the usual rules, you can not
+plant new forests later, however. Once cleared, a tile will never
+produce lumber again. The ``Plant forest'' mod distributed with
+FreeCol corrects this issue, however.
 
 
 \hypertarget{Government Efficiency}{\subsection{Government Efficiency}}

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 8933
          http://freecol.svn.sourceforge.net/freecol/?rev=8933&view=rev
Author:   burschik
Date:     2011-09-03 09:08:17 +0000 (Sat, 03 Sep 2011)
Log Message:
-----------
Rewrite "About FreeCol".

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2011-09-02 13:04:22 UTC (rev 8932)
+++ freecol/trunk/doc/FreeCol.tex	2011-09-03 09:08:17 UTC (rev 8933)
@@ -17,7 +17,7 @@
 \usepackage[
   colorlinks=true,
   hyperindex=true,
-  pdftitle={FreeCol Documentation, User Guide for Version v0.10.0},
+  pdftitle={FreeCol Documentation, User Guide for Version v0.10.2},
   pdfauthor={The FreeCol Team}
 ]{hyperref}
 \makeindex
@@ -41,27 +41,22 @@
 
 \hypertarget{About FreeCol}{\section{About FreeCol}}
 
-The FreeCol team aims to create an Open Source version of
-Colonization (released under the
-\href{http://www.gnu.org/licenses/gpl.html}{GPL}). At
-first we'll try to make an exact clone of Colonization. The visuals
-will be brought up to date with more recent standards but will remain
-clean, simple and functional. Certain new 'features' will be
-implemented but the gameplay and the rules will be exactly the same as
-the original game. Examples of modern features are: an isometric map
-and multiplayer support.
+The FreeCol team aims to create an Open Source version of Colonization
+(released under the \href{http://www.gnu.org/licenses/gpl.html}{GPL}).
+However, FreeCol differs from the original game in two regards: it
+supports multiplayer games and uses an isometric map. At some point in
+the future, we might also add support for rectangular tiles similar to
+those used in the original game.
 
-This clone will be developed incrementally and result in
-\textbf{FreeCol 1.0.0 which will be an almost exact Colonization
-clone}. Incremental development basically means that we'll add
-features one at a time. This allows us to have a running program at
-all times and also to release an unfinished but working game once in a
-while.
+FreeCol 1.0 will implement all features and rules of the original game
+that we are aware of. Although we have not reached that goal yet, the
+game has been playable for several years now.
 
-Once FreeCol 1.0.0 is finished we'll start working towards FreeCol
-2.0.0. \textbf{FreeCol 2 will go beyond the original Colonization} and
-will have many new features, it will be an implementation of our (and
-our users') image of what Colonization 2 would have been.
+At the same time, we are adding features and optional rules not found
+in the original game. In particular, units, buildings, terrain types,
+goods and other game objects are far more configurable than they were
+in the original game. In fact, the game already includes two slightly
+different \hyperlink{About this manual}{rule sets}.
 
 
 \hypertarget{The Original Colonization}{\section{The Original Colonization}}
@@ -119,15 +114,15 @@
 
 \hypertarget{About this manual}{\section{About this manual}}
 
-FreeCol is turning into a game engine that allows the implementation
-of many different games based on similar concepts. It is already
-possible to define different rule sets and to select one of them when
-starting a new game. At the moment, FreeCol ships with two rule sets
-accessible to the user: ``Classic'', which attempts to emulate the
-rules of the original game as far as possible, and ``FreeCol'', which
-mainly conforms to the rules of the original game, but differs in a
-few points. The ``FreeCol'' rule set introduces four additional
-European powers with new national advantages, for example.
+FreeCol is slowly turning into a game engine that allows the
+implementation of many different games based on similar concepts. It
+is already possible to define different rule sets and to select one of
+them when starting a new game. At the moment, FreeCol ships with two
+rule sets accessible to the user: ``Classic'', which attempts to
+emulate the rules of the original game as far as possible, and
+``FreeCol'', which mainly conforms to the rules of the original game,
+but differs in a few points. The ``FreeCol'' rule set introduces four
+additional European powers with new national advantages, for example.
 
 In this manual, we always talk about the ``Classic'' rule set unless
 we explicitly mention another rule set. Please note that most of the

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 8934
          http://freecol.svn.sourceforge.net/freecol/?rev=8934&view=rev
Author:   burschik
Date:     2011-09-03 09:47:07 +0000 (Sat, 03 Sep 2011)
Log Message:
-----------
Small fixes.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2011-09-03 09:08:17 UTC (rev 8933)
+++ freecol/trunk/doc/FreeCol.tex	2011-09-03 09:47:07 UTC (rev 8934)
@@ -339,7 +339,7 @@
 \item\verb$--windowed[[=]WIDTHxHEIGHT]$ Run FreeCol in windowed mode
 instead of full screen mode and set the window width and height. You
 will need this if your window manager or Java Virtual Machine do not
-(correctly support) FreeCol's full screen mode. If you use Linux and
+(correctly) support FreeCol's full screen mode. If you use Linux and
 Java 5, for example, you should set the window width to the width of
 your screen, but probably set the window height slightly lower than
 the height of your screen, in order to leave space for the menu bar,
@@ -390,9 +390,9 @@
 \hypertarget{Main panel}{\subsubsection{Main panel}}
 
 If you start FreeCol without command line options, the game will first
-open a dialog that allows you to start a new game, to open a saved
-game, to open the map editor, to set various \hyperlink{client options}
-{options}, and to quit.
+open a dialog that allows you to continue a game already started, to
+start a new game, to open a saved game, to open the map editor, to set
+various \hyperlink{client options} {options}, and to quit.
 
 If you decide to start a new game, you will be presented with another
 dialog, which enables you to start a single-player game, to retrieve a
@@ -509,12 +509,12 @@
 permit the clients to connect to the port of the game server.
 
 
-\hypertarget{game generator options}{\subsection{Map Generator Options}}
+\hypertarget{map generator options}{\subsection{Map Generator Options}}
 
-The \hypertarget{map generator options}{map generator options} allow
-you to import a map, and to set several parameters that influence the
-size and terrain of a randomly generated map. FreeCol includes several
-hand-made maps, which can be selected by clicking on the map icon.
+The map generator options allow you to import a map, and to set
+several parameters that influence the size and terrain of a randomly
+generated map. FreeCol includes several hand-made maps, which can be
+selected by clicking on the map icon.
 
 To import a map, either select one of the maps in the shortcut panel,
 enter the name of a file in the import field, or click on the browser
@@ -550,7 +550,7 @@
 boycotted goods. This does not apply to carriers, however, and does
 not prevent further boycotts by the Crown. This feature of the
 original game is considered a bug by the FreeCol team and is therefore
-disabled by default.
+disabled by default in the FreeCol rule set.
 
 You can also allow experts to ``have connections'', which means that
 experts working in factory-level buildings will be able to produce a

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 8968
          http://freecol.svn.sourceforge.net/freecol/?rev=8968&view=rev
Author:   nickshanks
Date:     2011-09-08 17:22:12 +0000 (Thu, 08 Sep 2011)
Log Message:
-----------
reforestation section text clean-up

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2011-09-08 17:05:24 UTC (rev 8967)
+++ freecol/trunk/doc/FreeCol.tex	2011-09-08 17:22:12 UTC (rev 8968)
@@ -1901,12 +1901,12 @@
 
 \hypertarget{Reforestation}{\subsection{Reforestation}}
 
-You can order your pioneers to cut down forests by plowing a tile.
-This will increase the food produced on these tiles, and the lumber
-will be delivered to your colonies. Under the usual rules, you can not
-plant new forests later, however. Once cleared, a tile will never
-produce lumber again. The ``Plant forest'' mod distributed with
-FreeCol corrects this issue, however.
+You can order your pioneers to cut down forests near to your colonies.
+This will increase the food produced on these tiles, and cause a
+large, one-off amount of lumber to be delivered to your nearest colony.
+Under the usual rules, a tile will never produce lumber again once
+cleared. However, the ``Plant forest'' mod, distributed with FreeCol,
+allows reforestation by your pioneers.
 
 
 \hypertarget{Government Efficiency}{\subsection{Government Efficiency}}

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 8972
          http://freecol.svn.sourceforge.net/freecol/?rev=8972&view=rev
Author:   burschik
Date:     2011-09-10 11:20:27 +0000 (Sat, 10 Sep 2011)
Log Message:
-----------
Comment out paragraphs about font customization that would only work if we used Java 1.6.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2011-09-10 11:13:04 UTC (rev 8971)
+++ freecol/trunk/doc/FreeCol.tex	2011-09-10 11:20:27 UTC (rev 8972)
@@ -1467,25 +1467,25 @@
 rules. In particular, you must use the string {\tt \%20} instead of a
 space character in the font name.
 
-In order to use a TrueType font that is not available to the JVM, you
-must copy it to the fonts directory mentioned above and add it to the
-configuration file by adding a line like this:
+%% In order to use a TrueType font that is not available to the JVM, you
+%% must copy it to the fonts directory mentioned above and add it to the
+%% configuration file by adding a line like this:
 
-\begin{quote}
-{\tt MyFavouriteFont=resources/fonts/Chancery.ttf}
-\end{quote}
+%% \begin{quote}
+%% {\tt MyFavouriteFont=resources/fonts/Chancery.ttf}
+%% \end{quote}
 
-Then you could say:
+%% Then you could say:
 
-\begin{quote}
-{\tt NormalFont=urn:font:Black\%20Chancery-PLAIN-13}
-\end{quote}
+%% \begin{quote}
+%% {\tt NormalFont=urn:font:Black\%20Chancery-PLAIN-13}
+%% \end{quote}
 
-Instead of {\tt MyFavouriteFont}, you can any key you like, as long as
-it is not being used for anything else. This line will add your font
-to the list of fonts known to the JVM, and you can then use its name,
-which is, however, likely to differ from the file name. The file {\tt
-  Chancery.ttf}, for example, contains a font called ``Black Chancery''.
+%% Instead of {\tt MyFavouriteFont}, you can any key you like, as long as
+%% it is not being used for anything else. This line will add your font
+%% to the list of fonts known to the JVM, and you can then use its name,
+%% which is, however, likely to differ from the file name. The file {\tt
+%%   Chancery.ttf}, for example, contains a font called ``Black Chancery''.
 
 
 \hypertarget{The New World}{\chapter{The New World}}

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 9247
          http://freecol.svn.sourceforge.net/freecol/?rev=9247&view=rev
Author:   burschik
Date:     2011-11-26 09:05:12 +0000 (Sat, 26 Nov 2011)
Log Message:
-----------
Update version numbers. Clarify effect of workshop upgrade.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2011-11-26 04:20:11 UTC (rev 9246)
+++ freecol/trunk/doc/FreeCol.tex	2011-11-26 09:05:12 UTC (rev 9247)
@@ -17,14 +17,14 @@
 \usepackage[
   colorlinks=true,
   hyperindex=true,
-  pdftitle={FreeCol Documentation, User Guide for Version v0.10.2},
+  pdftitle={FreeCol Documentation, User Guide for Version v0.10.4},
   pdfauthor={The FreeCol Team}
 ]{hyperref}
 \makeindex
 
 \begin{document}
 \author{\href{http://freecol.sourceforge.net/index.php?section=8}{The FreeCol Team}}
-\title{FreeCol Documentation\\User Guide for Version v0.10.2}
+\title{FreeCol Documentation\\User Guide for Version v0.10.4}
 \maketitle{}
 
 \tableofcontents
@@ -1947,13 +1947,14 @@
 \hyperlink{Continental Congress}{Continental Congress}.
 
 The craftsmen's houses can be upgraded to workshops, which produce
-more manufactured goods. After \hyperlink{Adam Smith}{Adam Smith} has
-joined the \hyperlink{Continental Congress}{Continental Congress},
-workshops can be upgraded to factories, which produce one and a half
-units of manufactured goods from each unit of raw material. While the
-town hall itself can not be upgraded, the production of
-\hyperlink{Liberty Bells}{Liberty Bells} can be boosted by
-constructing a printing press and then a newspaper.
+twice as many manufactured goods. After \hyperlink{Adam Smith}{Adam
+  Smith} has joined the \hyperlink{Continental Congress}{Continental
+  Congress}, workshops can be upgraded to factories, which are more
+efficient and generally produce one and a half units of manufactured
+goods from each unit of raw material. While the town hall itself can
+not be upgraded, the production of \hyperlink{Liberty Bells}{Liberty
+  Bells} can be boosted by constructing a printing press and then a
+newspaper.
 
 The following buildings are all present in every newly established
 colony:

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 9769
          http://freecol.svn.sourceforge.net/freecol/?rev=9769&view=rev
Author:   mpope
Date:     2012-04-25 07:55:31 +0000 (Wed, 25 Apr 2012)
Log Message:
-----------
Document wagon number limit, BR#3520451.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2012-04-24 12:04:42 UTC (rev 9768)
+++ freecol/trunk/doc/FreeCol.tex	2012-04-25 07:55:31 UTC (rev 9769)
@@ -2449,7 +2449,10 @@
 can be used to transport up to 200 units of goods over land and to
 trade with native settlements, and foreign colonies if \hyperlink{Jan
 de Witt}{Jan de Witt} has joined the \hyperlink{Continental
-Congress}{Continental Congress}.
+Congress}{Continental Congress}.  There is a limit on the number of
+wagon trains you can build--- it may not exceed the number of colonies
+you have (plus the ``Settlement limit modifier'' game option which
+defaults to zero).
 
 The \Unit{Treasure Train} is similar to the Wagon Train, but is used
 only to transport treasures. You can find these treasures in

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

Revision: 10402
          http://freecol.svn.sourceforge.net/freecol/?rev=10402&view=rev
Author:   burschik
Date:     2012-12-26 10:48:29 +0000 (Wed, 26 Dec 2012)
Log Message:
-----------
Update game options. Add Intervention Force.

Modified Paths:
--------------
    freecol/trunk/doc/FreeCol.tex

Modified: freecol/trunk/doc/FreeCol.tex
===================================================================
--- freecol/trunk/doc/FreeCol.tex	2012-12-25 23:03:38 UTC (rev 10401)
+++ freecol/trunk/doc/FreeCol.tex	2012-12-26 10:48:29 UTC (rev 10402)
@@ -5,6 +5,7 @@
 \newcommand{\Father}[1]{\index{#1}\index{Founding Fathers!#1}\hypertarget{#1}{\textbf{#1}}}
 \newcommand{\FFather}[2]{\index{#2}\index{Founding Fathers!#2}\hypertarget{#1}{\textbf{#2}}}
 \newcommand{\Report}[1]{\index{#1}\index{Reports!#1}\hypertarget{#1}{\textbf{#1}}}
+\newcommand{\Option}[1]{\index{#1}\index{Options!#1}\hypertarget{#1}{\textbf{#1}}}
 \newcommand{\Concept}[1]{\index{#1}\hypertarget{#1}{\textbf{#1}}}
 \newcommand{\Wikipedia}[1]{\href{http://en.wikipedia.org/wiki/#1}%
 {\includegraphics[scale=0.6]{images/wikipedia.png}}}
@@ -547,40 +548,165 @@
 influence game play, such as non-standard rules and victory
 conditions.
 
-The map tab allows you to select whether to use the \textit{Fog of
-  War}, whether to hide enemy units in settlements and carriers, and
-whether to award exploration points for regions discovered by the
-players. By default, exploration points are only awarded for the
-discovery of the Pacific Ocean. You can also change the number of
-turns required to sail between Europe and the New World. By default,
-the journey takes three turns.
+\hypertarget{map options}{\subsubsection{Map Options}}
 
-The colony tab allows you to enable custom houses to
-\hypertarget{ignore boycotts}{ignore boycotts}\index{ignoring
-  boycotts}. This means that custom houses will be able to export
-boycotted goods. This does not apply to carriers, however, and does
-not prevent further boycotts by the Crown. This feature of the
-original game is considered a bug by the FreeCol team and is therefore
-disabled by default in the FreeCol rule set.
+\begin{itemize}
 
-You can also allow experts to ``have connections'', which means that
-experts working in factory-level buildings will be able to produce a
-small amount of goods even if the necessary raw materials are not
-generally available. This alleged feature of the original game is also
-disabled by default. You also have the choice to save production
-overflow, which means that new buildings, for example, will not use up
-all available hammers, but only the exact number required. The
-remaining hammers will remain available for the next building
-project. Finally, you may enable or disable manual student
-selection. The original game always selected a random student from
-those available.
+\item The option \Option{Turns to Sail} allows you to change the
+  number of turns required to sail between Europe and the New
+  World. By default, the journey takes three turns.
 
-The victory conditions tab allows you to choose among three possible
-victory conditions. The game will be won by the first player to
-achieve independence, the player to eliminate all other European
-players, or the player to eliminate all other human players.
+\item The \Option{Settlement Limit Modifier} allows you to relax the
+  settlement limit, which currently applies only to the number of
+  \hyperlink{Wagon Train}{Wagon Trains} that your colonies can
+  support.
 
+\item The checkbox \Option{Fog of War} allows you to toggle whether
+  the areas of the map your units can not currently see are marked.
 
+\item The checkbox \Option{Exploration Points} allows you to award
+  exploration points for regions discovered by the players. By
+  default, exploration points are only awarded for the discovery of
+  the Pacific Ocean.
+
+\item The checkbox \Option{Amphibious Moves} enables offensive units
+  to attack colonies from a ship. This is necessary in order to
+  prevent the construction of unassaillable strongholds on small
+  islands.
+
+\item The checkbox \Option{Empty Trade Units} enables empty carriers
+  to trade with foreign settlements, in other words to buy foreign
+  goods without selling goods first.
+
+\item The checkbox \Option{Chief Contact} toggles whether all
+  interactions with a settlement, such as sending a unit to learn a
+  skill, automatically contact its chief.
+
+\item The checkbox \Option{Enhanced Missionaries} grants missionaries
+  various abilities, making them more valuable than in the original
+  game.
+
+\item The \Option{Gift Probability} influences the amount of gifts
+  your colonies will receive from the natives.
+
+\item The \Option{Demand Probability} influences the number of demands
+  your colonies will receive from the natives.
+
+\item The checkbox \Option{Continue Recruiting Founding Fathers}
+  allows you to elect \hyperlink{Founding Fathers}{Founding Fathers}
+  after independence has been granted.
+
+\item The checkbox \Option{Teleport REF} enables the \hyperlink{Royal
+  Expeditionary Force}{Royal Expeditionary Force} to arrive directly
+  at its destination, as in the original game. If this option is
+  disabled, the REF must sail to its destination and can be attacked
+  {\it en route}.
+
+\item The option \Option{Starting Positions} allows you to determine
+  whether the various European nations will start at positions similar
+  to those of the original game, at positions closer to their
+  historical landfalls, or at random locations.
+
+\end{itemize}
+
+\hypertarget{colony options}{\subsubsection{Colony Options}}
+
+\begin{itemize}
+
+\item The checkbox \Option{Custom House Ignores Boycott} enables
+  \hyperlink{Custom House}{Custom Houses} to \hypertarget{ignore
+    boycotts}{ignore boycotts}\index{ignoring boycotts} and export
+  boycotted goods regardless. This does not apply to carriers,
+  however, and does not prevent further boycotts by the Crown. This
+  feature of the original game is considered a bug by the FreeCol team
+  and is therefore disabled by default in the FreeCol rule set.
+
+\item The checkbox \Option{Experts Have Connections} enables experts
+  working in factory-level buildings to produce a small amount of
+  goods even if the necessary raw materials are not generally
+  available. This alleged feature of the original game is also
+  disabled by default.
+
+\item The checkbox \Option{Save Production Overflow}, toggles whether
+  the construction of new units or buildings uses up all available
+  hammers, or only the exact number required. In the latter case, the
+  remaining hammers will remain available for the next building
+  project.
+
+\item The checkbox \Option{Allow Student Selection} enables (and
+  obliges) you to explicitly assign students to teachers. The original
+  game always selects a random student from those available.
+
+\item The checkbox \Option{Buildings Require Upkeep} toggles whether
+  you have to pay for the upkeep of all buildings not present in a
+  newly established colony. If you fail to pay the upkeep, you will
+  suffer a production penalty. This feature was apparently considered
+  for the original game, but was removed during play-testing.
+
+\item The option \Option{Natural Disasters} influences the probability
+  of natural disasters devastating your colonies. If this option is
+  set to zero, no natural disasters will occur.
+
+\end{itemize}
+
+
+\hypertarget{victory conditions}{\subsubsection{Victory Conditions}}
+
+Victory conditions allow you to choose how a European player may win
+the game:
+
+\begin{itemize}
+
+\item \Option{First Player to Gain Independence}
+
+\item \Option{All Other European Players Defeated}
+
+\item \Option{All Other Human Players Defeated}
+
+\end{itemize}
+
+Please note that if you start a single-player game and select the
+defeat of all other human players as a victory condition, your game
+will end immediately, since the victory condition already applies.
+
+
+\hypertarget{year options}{\subsubsection{Year Options}}
+
+\begin{itemize}
+
+\item The \Option{Starting Year} determines the year in which the game
+  starts (defaults to 1492).
+
+\item The \Option{Season Year} determines the first year with two
+  turns or seasons per year (defaults to 1600).
+
+\item The \Option{Mandatory Colony Year} determines the first year in
+  which it becomes mandatory for European players to own at least one
+  colony in order to avoid defeat (defaults to 1600).
+
+\item The \Option{Last Game Year} determines the year in which the
+  game ends (defaults to 1850).
+
+\item The \Option{Last Colonial Game Year} determines the year by
+  which European players must have declared independence in order to
+  avoid defeat (defaults to 1800).
+
+\end{itemize}
+
+
+\hypertarget{initial prices}{\subsubsection{Initial Prices}}
+
+The initial price options determine the minimum and maximum initial
+prices for all goods traded in Europe, as well as the difference
+between the buy and sell prices. Unless the initial prices for a type
+of goods are set to the same value, the initial price will be
+randomized at the beginning of the game. The price spread, however,
+remains constant.
+
+You can also set the price of hammers when paying for the completion
+of buildings and buildable units.
+
+
 \hypertarget{client options}{\section{Client Options}}
 
 The client options panel allows you to customize how your client
@@ -3011,9 +3137,10 @@
 At the declaration, colonies with strong support for the Sons of
 Liberty sometimes promote veteran soldiers at work there to
 \hyperlink{Colonial Regular}{Colonial Regular} in preparation for the
-coming war.  In the future, the European enemies of your Monarch may
-support your effort if you generate a sufficient number of Liberty
-Bells after the War of Independence has begun.
+coming war. The European enemies of your Monarch may support your
+effort by dispatching an \Concept{Intervention Force}, provided that
+you generate a sufficient number of Liberty Bells after the War of
+Independence has begun.
 
 If you continue to play after successfully defeating the
 \hyperlink{Royal Expeditionary Force}{Royal Expeditionary Force}, your

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.