Update docs

doc/build.d

@@ -12,7 +12,7 @@ Build
 
 	For Ubuntu:
 		:$ sudo apt-get update
-		:$ sudo apt-get install build-essential git autoconf automake libsdl1.2-dev libasound2-dev libfreetype6-dev zlib1g-dev libexpat1-dev libslang2-dev libncurses5-dev
+		:$ sudo apt-get install build-essential git autoconf automake libsdl2-dev libasound2-dev libfreetype6-dev zlib1g-dev libexpat1-dev libslang2-dev libncurses5-dev
 
 	For Raspbian:
 		:$ sudo apt-get update
@@ -30,14 +30,15 @@ Build
 		:$ cd advancemame
 		:$ sh autogen.sh
 
-	Now you can build and install them using the typical sequence of commands:
+	Now you can build and install using the typical sequence of commands:
 
 		$ ./configure
 		$ make -j3
 		$ sudo make install
 
-	The -j3 option tells make to use four different parallel processes to build.
-	Beside that, the build process may be long, up to 45 minutes on a Raspberry Pi 3.
+	The -j3 option uses three parallel processes, speeding up the build.
+
+	The build process may be long, up to 45 minutes on a Raspberry Pi 3.
 
 	No option is generally required. You can get the complete configure option list with
 	the `./configure --help' command.
@@ -51,8 +52,8 @@ Build
 
 	The configure script automatically detects all the available
 	libraries and the optimization flags. You can use the
-	--with-sdl-prefix option to search for the SDL library in a
-	specific location.
+	--with-sdl-prefix and --with-sdl2-prefix  option to search for the
+	SDL and SDL2 libraries in a specific location.
 
 	The `make install' command installs the binaries and the documentation.
 

doc/install.d

@@ -22,7 +22,7 @@ System Requirements
 
 	In the Linux Console, the Linux Framebuffer is used for the
 	video, the ALSA or OSS library for audio, and the Linux Event
-	or Raw interface for intput controllers.
+	or Raw interface for input controllers.
 
 	The video board programming functionality for Arcade Monitors
 	and CRT TVs, is available only from the Linux console, using
@@ -46,28 +46,34 @@ System Requirements
 
 	If instead you want to use an old CRT Arcade or TV screen, you can
 	configure the Advance programs to generate modelines customized
-	for your video hardware.
+	for your video hardware, following the 'Video Setup' chapter.
 
     HDMI Port
 	To use the programmable modelines with the Raspberry HDMI port, you
 	need a kind of HDMI->VGA or HDMI->SCART converter to connect it to a
 	CRT monitor.
 
+	You don't need any special option in your '/boot/config.txt', just the
+	options needed to start the Raspberry with your video hardware,
+	and be able to enter commands.
+
+	Whatever hdmi_mode you select, the Advance programs will use mode 87
+	group 2, restoring your selected original mode when finished.
+
     DPI Port
 	To use the programmable modelines with the Raspberry DPI port you
 	need a GPIO add-on board like the Gert's VGA 666.
 
-	Unfortunately the Raspberry Pi has strong limitations on the lower
-	range of pixel clocks when using the DPI/GPIO interface, that will
-	affect your ability to control low frequency monitors, like Arcade
-	screens.
+	The Raspberry Pi has strong limitations on the lower range of pixel
+	clocks when using the DPI/GPIO interface, that will affect your
+	ability to control low frequency monitors, like Arcade screens.
 
 	The only allowed pixel clocks suitable for low resolutions
 	are 4.8 MHz, 6.4 MHz, 9.6MHz and 19.2 MHz.
 	You can instead choose any pixel clock greater than 31.25 MHz.
 
-	To overcome this problematic, AdvanceMAME transparently duplicates
-	the horizontal size, until it reaches the 31.25 MHz pixel clock.
+	To overcome this problematic, AdvanceMAME transparently increase
+	the modeline horizontal size, until it reaches the 31.25 MHz pixel clock.
 	Don't be surprised if a modeline that works in AdvanceMAME, doesn't
 	work when setting manually the timings in other ways.