Add some draft pages

conf.py

@@ -30,7 +30,9 @@ author = '86Box Project'
 # ones.
 extensions = [
 	'sphinx_rtd_theme',
+	'sphinx.ext.autosectionlabel',
 ]
+autosectionlabel_prefix_document = True
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']

index.rst

@@ -31,4 +31,5 @@ Documentation
    :maxdepth: 2
 
    usage/gettingstarted
-   usage/machinespecific
+   settings/index
+   usage/machinespecific

settings/index.rst

@@ -0,0 +1,12 @@
+Settings
+========
+
+The *Settings* window allows you to configure the emulated machine.
+
+If any changes were made to the settings, you will be asked whether or not you want to save the changes upon pressing *OK* or closing the window. Saving changes will hard reset the emulated machine. Press *Cancel* to immediately discard all changes.
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Settings pages
+
+   machine

settings/machine.rst

@@ -0,0 +1,41 @@
+Machine
+=======
+
+Machine type / Machine
+----------------------
+
+Machine/motherboard to emulate. The *Machine type* box lists all available processor classes, while the *Machine* box lists all available machines of the selected processor class.
+
+CPU type / CPU
+--------------
+
+Main processor to emulate. Only processors supported by the selected machine will be listed.
+
+FPU
+---
+
+Math co-processor to emulate. This box will not be enabled if a processor with an integrated math co-processor is selected.
+
+Wait states
+-----------
+
+Number of memory wait states. This box is only enabled and relevant if a 286- or 386-class CPU is selected.
+
+Memory
+------
+
+Amount of RAM to give the emulated machine. The minimum and maximum amounts of RAM will vary depending on the selected machine.
+
+Dynamic Recompiler
+------------------
+
+Enable the dynamic recompiler, which provides faster but less accurate CPU emulation. The recompiler is available as an option for 486-class processors, and is mandatory starting with the Pentium.
+
+Time synchronization
+--------------------
+
+Time synchronization automatically copies your host machine's date and time settings over to the guest machine's hardware real-time clock. Synchronization is performed every time the guest operating system reads the hardware clock, which often happens once on every boot.
+
+* **Disabled:** do not perform time synchronization.
+* **Enabled (local time):** synchronize the time in your host machine's configured timezone. Use this option when running a guest operating system which stores local time in the hardware clock, such as DOS or Windows.
+* **Enabled (UTC):** synchronize the time in Coordinated Universal Time (UTC). Use this option when running a guest operating system which stores UTC time in the hardware clock, such as Linux.

usage/machinespecific.rst

@@ -0,0 +1,61 @@
+Machine-specific notes
+======================
+
+80286
+-----
+
+.. rubric:: IBM AT
+
+* The diagnostics diskette is not Y2K-compliant, and will therefore produce error codes if :ref:`settings/machine:time synchronization` is enabled. These codes can be cleared by disabling time synchronization and then using a tool such as the MS-DOS ``date`` command to set the date to before the year 2000.
+
+Socket 7
+--------
+
+.. _p65up5:
+.. rubric:: ASUS P/I-P65UP5 (C-P55T2D)
+
+* A modular motherboard consisting of a baseboard (P/I-P65UP5) and one of the following CPU cards:
+
+   * **C-P55T2D:** Socket 7 with Intel 430HX northbridge.
+   * **C-P6ND:** Socket 8 with Intel 440FX northbridge.
+   * **C-PKND:** Slot 1 with Intel 440FX northbridge.
+
+* While the northbridge depends on the selected CPU card, the southbridge always remains the Intel PIIX3, as it is located on the base board.
+* The real CPU cards support dual CPUs. As 86Box does not emulate multiprocessing, only a single CPU will be present.
+* Due to a lack of I/O APIC emulation at the moment, 86Box will patch the MultiProcessor Specification tables out of RAM before boot, so that operating systems will not hang or exhibit other erratic behavior due to the missing I/O APIC.
+
+Socket 8
+--------
+
+.. rubric:: ASUS P/I-P65UP5 (C-P6ND)
+
+See: :ref:`p65up5`
+
+Slot 1
+------
+
+.. rubric:: ASUS P/I-P65UP5 (C-PKND)
+
+See: :ref:`p65up5`
+
+.. _atc6310bxii:
+.. rubric:: A-Trend ATC6310BXII
+
+* Equipped with the SMSC Victory66 southbridge instead of the regular Intel PIIX4E.
+
+   * The Victory66 has faster IDE - up to Ultra ATA/66 as opposed to the PIIX4E's Ultra ATA/33 - and a different USB controller.
+   * Drivers for Windows 95, 98, Me and 2000 are available `here <http://www.attro.com/download/driver/IDE/90e66smsc.zip>`_ (TODO: mirror this). Windows XP, Vista and 7 include drivers out of the box.
+
+
+Socket 370
+----------
+
+.. rubric:: A-Trend ATC7020BXII
+
+See: :ref:`atc6310bxii`
+
+.. rubric:: AEWIN AW-O671R
+
+* Equipped with dual Winbond W83977EF Super I/O chips driving four serial (COM1-COM4) and two parallel (LPT1-LPT2) ports.
+
+   * The I/O ports and IRQs used by all these ports can be configured in the BIOS setup.