add Makefile, README, manpagev0.1

1 files changed, 48 insertions, 0 deletions

diff --git a/2ls10.6 b/2ls10.6
new file mode 100644
index 0000000..3c7de23
--- /dev/null
+++ b/2ls10.6
@@ -0,0 +1,48 @@
+.TH 2LS10 1 "05/08/2019" "" "Games"
+.SH NAME
+2ls10 \- small clone of the popular game '2048'.
+.SH SYNOPSIS
+.PP
+2ls10
+.RI [n]
+.PP
+.SH DESCRIPTION
+.PP
+2ls10 is a small clone of the popular game '2048'. 
+.PP
+You start on a square grid (4x4 cells by default). At the beginning, two
+of the cells contain either a '2' or a '4'. The aim of the game is to 
+shift the cells around (left, down, up, right), until you get a cell
+with a '2048'.
+.PP
+The classic `h-j-k-l` keys are used to slide cells left, down, up,
+right, respectively. 
+.PP
+When you shift the cells in one direction, any two adjacent
+cells along that direction that contain the same number are 'merged'
+into a single cell containing twice that number. After each movement,
+a new number (either a 2 or a 4) is placed in one of the empty cells,
+chosen uniformly at random.
+.PP
+The game ends where there are no more moves left (in which case you
+lost), or when there is at least one cell with a '2048' (which counts as
+a win).
+.PP
+It should be clear now why the executable is called `2ls10`. 
+.SH ARGUMENTS
+.TP 5m
+.BI [n]
+An optional integer
+.BI n
+(larger than 1 and smaller than 16) can be passed as first argument to
+set the size of the grid. The default is n=4. Larger grids are normally
+easier to solve. A 4x4 grid is the smallest one where you can get ever a
+2048.
+.SH BUGS
+At difference with the original game, a new ramdom cell is filled even
+if the user attempted to shift the cells in a direction where no shifts 
+are allowed.
+.SH AUTHORS
+2ls10 is written and maintained by Vincenzo "KatolaZ" Nicosia. You can
+use, copy, modify, and redistribute 2ls10 under the terms of the MIT/X11
+license.