readme: Convert to Markdown.

2025-03-07 03:53:26 +01:00 · 2024-01-03 12:05:10 +01:00 · 2024-01-03 12:05:10 +01:00 · 158e9e7636
commit 158e9e7636
parent a2f98478c3
18 changed files with 861 additions and 1062 deletions
--- a/README.md
+++ b/README.md
@ -1,4 +1,4 @@
-1. INTRODUCTION
+## INTRODUCTION
 Wine is a program which allows running Microsoft Windows programs
 (including DOS, Windows 3.x, Win32, and Win64 executables) on Unix.
@ -11,76 +11,79 @@ Wine is free software, released under the GNU LGPL; see the file
 LICENSE for the details.
-2. QUICK START
+## QUICK START
 From the top-level directory of the Wine source (which contains this file),
 run:
 ```
 ./configure
 make
 ```
 Then either install Wine:
 ```
 make install
 ```
 Or run Wine directly from the build directory:
 ```
 ./wine notepad
 ```
-Run programs as "wine program".  For more information and problem
+Run programs as `wine program`. For more information and problem
 resolution, read the rest of this file, the Wine man page, and
 especially the wealth of information found at https://www.winehq.org.
-3. REQUIREMENTS
+## REQUIREMENTS
 To compile and run Wine, you must have one of the following:
-  Linux version 2.0.36 or later
+- Linux version 2.0.36 or later
-  FreeBSD 12.4 or later
+- FreeBSD 12.4 or later
-  Solaris x86 9 or later
+- Solaris x86 9 or later
-  NetBSD-current
+- NetBSD-current
-  Mac OS X 10.8 or later
+- Mac OS X 10.8 or later
 As Wine requires kernel-level thread support to run, only the operating
 systems mentioned above are supported.  Other operating systems which
 support kernel threads may be supported in the future.
-FreeBSD info:
+**FreeBSD info**:
  See https://wiki.freebsd.org/Wine for more information.
-Solaris info:
+**Solaris info**:
  You will most likely need to build Wine with the GNU toolchain
  (gcc, gas, etc.). Warning : installing gas does *not* ensure that it
  will be used by gcc. Recompiling gcc after installing gas or
  symlinking cc, as and ld to the gnu tools is said to be necessary.
-NetBSD info:
+**NetBSD info**:
  Make sure you have the USER_LDT, SYSVSHM, SYSVSEM, and SYSVMSG options
  turned on in your kernel.
-Mac OS X info:
+**Mac OS X info**:
  You need Xcode/Xcode Command Line Tools or Apple cctools.  The
  minimum requirements for compiling Wine are clang 3.8 with the
  MacOSX10.10.sdk and mingw-w64 v8.  The MacOSX10.14.sdk and later can
  only build wine64.
-
+**Supported file systems**:
 Supported file systems:
  Wine should run on most file systems. A few compatibility problems
  have also been reported using files accessed through Samba. Also,
  NTFS does not provide all the file system features needed by some
  applications.  Using a native Unix file system is recommended.
-Basic requirements:
+**Basic requirements**:
  You need to have the X11 development include files installed
  (called xorg-dev in Debian and libX11-devel in Red Hat).
-
+  Of course you also need make (most likely GNU make).
  Of course you also need "make" (most likely GNU make).
  You also need flex version 2.5.33 or later and bison.
-Optional support libraries:
+**Optional support libraries**:
  Configure will display notices when optional libraries are not found
  on your system. See https://wiki.winehq.org/Recommended_Packages for
  hints about the packages you should install. On 64-bit platforms,
@ -88,80 +91,80 @@ Optional support libraries:
  libraries.
-4. COMPILATION
+## COMPILATION
 To build Wine, do:
 ```
 ./configure
 make
 ```
 This will build the program "wine" and numerous support libraries/binaries.
 The program "wine" will load and run Windows executables.
 The library "libwine" ("Winelib") can be used to compile and link
 Windows source code under Unix.
-To see compile configuration options, do ./configure --help.
+To see compile configuration options, do `./configure --help`.
 For more information, see https://wiki.winehq.org/Building_Wine
-5. SETUP
+## SETUP
-Once Wine has been built correctly, you can do "make install"; this
+Once Wine has been built correctly, you can do `make install`; this
 will install the wine executable and libraries, the Wine man page, and
 other needed files.
 Don't forget to uninstall any conflicting previous Wine installation
-first.  Try either "dpkg -r wine" or "rpm -e wine" or "make uninstall"
+first.  Try either `dpkg -r wine` or `rpm -e wine` or `make uninstall`
 before installing.
-Once installed, you can run the "winecfg" configuration tool. See the
+Once installed, you can run the `winecfg` configuration tool. See the
 Support area at https://www.winehq.org/ for configuration hints.
-6. RUNNING PROGRAMS
+## RUNNING PROGRAMS
 When invoking Wine, you may specify the entire path to the executable,
 or a filename only.
-For example: to run Notepad:
+For example, to run Notepad:
-    wine notepad            (using the search Path as specified in
+```
-    wine notepad.exe         the registry to locate the file)
+wine notepad            (using the search Path as specified in
 wine notepad.exe         the registry to locate the file)
-    wine c:\\windows\\notepad.exe      (using DOS filename syntax)
+wine c:\\windows\\notepad.exe      (using DOS filename syntax)
-    wine ~/.wine/drive_c/windows/notepad.exe  (using Unix filename syntax)
+wine ~/.wine/drive_c/windows/notepad.exe  (using Unix filename syntax)
-    wine notepad.exe readme.txt          (calling program with parameters)
+wine notepad.exe readme.txt          (calling program with parameters)
 ```
 Wine is not perfect, so some programs may crash. If that happens you
 will get a crash log that you should attach to your report when filing
 a bug.
-7. GETTING MORE INFORMATION
+## GETTING MORE INFORMATION
-WWW:	A great deal of information about Wine is available from WineHQ at
+- **WWW**: A great deal of information about Wine is available from WineHQ at
 	https://www.winehq.org/ : various Wine Guides, application database,
 	bug tracking. This is probably the best starting point.
-FAQ:	The Wine FAQ is located at https://www.winehq.org/FAQ
+- **FAQ**: The Wine FAQ is located at https://www.winehq.org/FAQ
-Wiki:	The Wine Wiki is located at https://wiki.winehq.org
+- **Wiki**: The Wine Wiki is located at https://wiki.winehq.org
-Gitlab: Wine development is hosted at https://gitlab.winehq.org
+- **Gitlab**: Wine development is hosted at https://gitlab.winehq.org
-Mailing lists:
+- **Mailing lists**:
 	There are several mailing lists for Wine users and developers;
 	see https://www.winehq.org/forums for more information.
-Bugs:	Report bugs to Wine Bugzilla at https://bugs.winehq.org
+- **Bugs**: Report bugs to Wine Bugzilla at https://bugs.winehq.org
 	Please search the bugzilla database to check whether your
 	problem is already known or fixed before posting a bug report.
-IRC:	Online help is available at channel #WineHQ on irc.libera.chat.
+- **IRC**: Online help is available at channel `#WineHQ` on irc.libera.chat.
 --
 Alexandre Julliard
 julliard@winehq.org
--- a/documentation/README-de.md
+++ b/documentation/README-de.md
@ -1,4 +1,4 @@
-1. EINFÜHRUNG
+## EINFÜHRUNG
 Wine ist ein Programm, das es ermöglicht, Programme, die für Microsoft
 Windows geschrieben wurden (inklusive DOS-, Windows 3.x-, Win32- und
@ -13,95 +13,100 @@ Wine ist Freie Software, die unter der GNU LGPL veröffentlicht wird;
 Bitte lesen Sie die Details in der Datei LICENSE nach.
-2. SCHNELLSTART
+## SCHNELLSTART
 Rufen Sie aus dem Stammverzeichnis des Wine-Quelltextes (das die Datei README
 enthält) folgende Befehle auf:
 ```
 ./configure
 make
 ```
 Im Anschluss können Sie Wine entweder installieren:
 ```
 make install
 ```
 Oder direkt aus dem Quellverzeichnis ausführen:
 ```
 ./wine notepad
 ```
-Starten Sie Programme mit "wine Programmname". Weitere
+Starten Sie Programme mit `wine Programmname`. Weitere
 Informationen und Problemlösungen entnehmen Sie bitte dem Rest dieser
 Datei, der Man-Page von Wine und insbesondere der Vielzahl an 
 Informationen, die Sie auf https://www.winehq.org finden.
-3. VORAUSSETZUNGEN
+## VORAUSSETZUNGEN
 Um Wine kompilieren und ausführen zu können, benötigen Sie eines der
 folgenden Betriebssysteme:
-  Linux version 2.0.36 oder neuer
+- Linux version 2.0.36 oder neuer
-  FreeBSD 8.0 oder neuer
+- FreeBSD 12.4 oder neuer
-  Solaris x86 9 oder neuer
+- Solaris x86 9 oder neuer
-  NetBSD-current
+- NetBSD-current
-  Mac OS X 10.8 oder neuer
+- Mac OS X 10.8 oder neuer
 Da Wine Thread-Unterstützung auf Kernelebene benötigt, werden nur die oben
 aufgeführten Betriebssysteme unterstützt.
 Andere Betriebssysteme, die Kernel-Threads unterstützen, werden unter
 Umständen in der Zukunft unterstützt.
-FreeBSD-Info:
+**FreeBSD-Info**:
  Wine wird generell nicht korrekt unter FreeBSD vor 8.0 funktionieren. Für
  weitere Informationen überprüfen Sie auch https://wiki.freebsd.org/Wine
-Solaris-Info:
+**Solaris-Info**:
  Höchstwahrscheinlich werden Sie Wine mit der GNU-Toolchain (gcc, gas etc.)
  kompilieren müssen. Warnung: Die Installation von gas stellt *nicht*
  sicher, dass es auch von gcc verwendet wird. Erneutes Kompilieren von gcc,
  nach der Installation von gas, oder das symbolische Verlinken von cc, as und
  ld auf die GNU-Tools ist vermutlich notwendig.
-NetBSD-Info:
+**NetBSD-Info**:
  Stellen Sie sicher, dass Sie die Optionen USER_LDT, SYSVSHM, SYSVSEM und
  SYSVMSG in Ihrem Kernel aktiviert haben.
-Mac OS X Info:
+**Mac OS X Info**:
  Sie benötigen Xcode/Xcode-Kommandozeilentools oder Apple cctools. Die
  Mindestanforderungen um Wine zu kompilieren sind clang 3.8 mit dem
  MacOSX10.10.sdk und mingw-w64 v8. Das MacOSX10.14.sdk oder neuer kann
  nur wine64 erzeugen.
-Unterstützte Dateisysteme:
+**Unterstützte Dateisysteme**:
  Wine sollte auf den meisten Dateisystemen laufen. Kompatibilitätsprobleme
  wurden allerdings beim Dateizugriff über Samba gemeldet.
  Weiterhin bietet NTFS nicht alle Dateisystemfunktionen, die von einigen
  Programmen benötigt werden. Ein natives Unix-Dateisystem ist empfohlen.
-Grundsätzliche Voraussetzungen:
+**Grundsätzliche Voraussetzungen**:
  Sie müssen die Entwicklungsdateien für X11 installiert haben
  (Debian nennt diese xorg-dev, Red Hat libX11-devel).
-
+  Selbstverständlich benötigen Sie auch make (höchstwahrscheinlich GNU make).
  Selbstverständlich benötigen Sie auch "make" (höchstwahrscheinlich GNU make).
  Des Weiteren benötigen Sie flex (Version 2.5.33 oder höher) und bison.
-Optionale Bibliotheken:
+**Optionale Bibliotheken**:
  Der Configure-Aufruf zeigt am Ende optionale Bibliotheken an,
  die von Wine benutzt werden können, aber auf Ihrem System nicht gefunden
  wurden. Tipps zum Installieren fehlender Pakete finden Sie unter:
  https://wiki.winehq.org/Recommended_Packages
  Unter 64-Bit-Plattformen benötigen Sie auch die 32-Bit-Versionen dieser
  Bibliotheken.
-4. KOMPILIEREN
+## KOMPILIEREN
 Um Wine zu kompilieren, führen Sie aus:
 ```
 ./configure
 make
 ```
 Damit werden das Programm "wine" und diverse unterstützende Bibliotheken und
 Binärdateien erstellt. Das Programm "wine" lädt ausführbare Windows-Dateien
@ -109,76 +114,69 @@ und führt diese aus.
 Die Bibliothek "libwine" ("Winelib") kann benutzt werden, um Windows-Quelltexte
 unter Unix zu kompilieren und zu verlinken.
-Mit ./configure --help können Sie sich Konfigurations-Optionen für die
+Mit `./configure --help` können Sie sich Konfigurations-Optionen für die
 Kompilierung anzeigen lassen.
 Weitere Informationen finden Sie unter https://wiki.winehq.org/Building_Wine
-5. SETUP
+## SETUP
-Nachdem Wine korrekt erstellt wurde, können Sie "make install" aufrufen;
+Nachdem Wine korrekt erstellt wurde, können Sie `make install` aufrufen;
 Dadurch werden Wine-Programme und Bibliotheken, die Man-Page und andere nötige
 Dateien installiert.
 Vergessen Sie nicht, zuerst frühere Wine-Installationen zu entfernen, die mit
-der neuen in Konflikt stehen könnten. Versuchen Sie entweder "dpkg -r wine",
+der neuen in Konflikt stehen könnten. Versuchen Sie entweder `dpkg -r wine`,
-"rpm -e wine" oder "make uninstall" vor der Installation auszuführen.
+`rpm -e wine` oder `make uninstall` vor der Installation auszuführen.
-Nach der Installation können Sie das Konfigurationswerkzeug "winecfg" starten.
+Nach der Installation können Sie das Konfigurationswerkzeug `winecfg` starten.
 Hinweise dazu finden Sie im Support-Bereich auf https://www.winehq.org/
-6. AUSFÜHREN VON PROGRAMMEN
+## AUSFÜHREN VON PROGRAMMEN
 Wenn Sie Wine aufrufen, können Sie den vollständigen Pfad zur ausführbaren
 Datei angeben oder nur einen Dateinamen.
 Beispiel: Um Notepad auszuführen:
-    wine notepad            (wobei der Suchpfad, wie in der Registrierung
+```
-    wine notepad.exe         angegeben, benutzt wird)
+wine notepad            (wobei der Suchpfad, wie in der Registrierung
 wine notepad.exe         angegeben, benutzt wird)
-    wine c:\\windows\\notepad.exe         (mit Dateinamen-Syntax von DOS)
+wine c:\\windows\\notepad.exe         (mit Dateinamen-Syntax von DOS)
-    wine ~/.wine/drive_c/windows/notepad.exe            (mit Unix-Syntax)
+wine ~/.wine/drive_c/windows/notepad.exe            (mit Unix-Syntax)
-    wine notepad.exe liesmich.txt         (Programmaufruf mit Parametern)
+wine notepad.exe liesmich.txt         (Programmaufruf mit Parametern)
 ```
 Wine ist nicht perfekt, manche Programme könnten abstürzen.
 In solchen Fällen bekommen Sie einen Log vom Absturz, den Sie beifügen sollten,
 wenn Sie den Fehler melden.
-7. WEITERFÜHRENDE INFORMATIONEN
+## WEITERFÜHRENDE INFORMATIONEN
-WWW:    Eine große Menge an Informationen findet sich im WineHQ unter
+- **WWW**: Eine große Menge an Informationen findet sich im WineHQ unter
        https://www.winehq.org/ : Verschiedene Wine Guides,
        Applikations-Datenbank, Bugtracker.
        Das ist vermutlich der beste Ausgangspunkt.
-FAQ:    Die FAQ zu Wine befindet sich unter https://www.winehq.org/FAQ
+- **FAQ**: Die FAQ zu Wine befindet sich unter https://www.winehq.org/FAQ
-Wiki:   Das Wine-Wiki finden Sie unter https://wiki.winehq.org
+- **Wiki**: Das Wine-Wiki finden Sie unter https://wiki.winehq.org
-Mailing-Listen:
+- **Gitlab**: https://gitlab.winehq.org
 - **Mailing-Listen**:
    Es gibt mehrere Mailing-Listen für Wine-Anwender und -Entwickler;
    Schauen Sie sich dazu bitte https://www.winehq.org/forums an.
-Fehler:	Melden Sie Fehler bitte an Wine-Bugzilla unter https://bugs.winehq.org
+- **Fehler**: Melden Sie Fehler bitte an Wine-Bugzilla unter https://bugs.winehq.org
    Schauen Sie bitte erst in der Bugzilla-Datenbank nach, ob Ihr Problem
    bereits bekannt ist oder sogar behoben wurde, bevor Sie eine Fehlermeldung
    verfassen.
-IRC:    Online-Hilfe ist im IRC-Kanal #WineHQ unter irc.libera.chat verfügbar.
+- **IRC**: Online-Hilfe ist im IRC-Kanal `#WineHQ` unter irc.libera.chat verfügbar.
 Git:    Der aktuelle Wine-Entwicklungsstand ist über Git verfügbar.
        Besuchen Sie https://www.winehq.org/git für weitere Informationen.
 Wenn Sie etwas hinzufügen oder einen Fehler beheben, senden Sie bitte einen
 Patch (vorzugsweise mit git-format-patch) an die Liste wine-devel@winehq.org,
 damit dieser in die nächste Ausgabe aufgenommen werden kann.
 --
 Alexandre Julliard
 julliard@winehq.org
--- a/documentation/README-es.md
+++ b/documentation/README-es.md
@ -1,4 +1,4 @@
-1. INTRODUCCIÓN
+## INTRODUCCIÓN
 Wine es un programa que permite la ejecución de programas de Microsoft Windows
 (incluyendo ejecutables de DOS, Windows 3.x y Win32) sobre Unix. Consiste en un
@ -11,75 +11,73 @@ Wine es software libre, publicado bajo la licencia GNU LGPL; vea el fichero
 LICENSE para los detalles.
-2. INICIO RÁPIDO
+## INICIO RÁPIDO
 Cuando compile desde el código fuente, se recomienda utilizar el Instalador de
 Wine para compilar e instalar Wine. Desde el directorio base del código de Wine
 (el cual contiene este fichero), ejecute:
-./tools/wineinstall
+```
 ./configure
 make
 ```
-Ejecute aplicaciones con "wine programa". Para más información y resolución de
+Ejecute aplicaciones con `wine programa`. Para más información y resolución de
 problemas, continúe leyendo este archivo, la página man de Wine, o más
 específicamente, la numerosa información que puede encontrar en
 https://www.winehq.org.
-3. REQUISITOS
+## REQUISITOS
 Para compilar y ejecutar Wine, deberá tener uno de los siguientes:
-  Linux versión 2.0.36 o superior
+- Linux versión 2.0.36 o superior
-  FreeBSD 8.0 o superior
+- FreeBSD 12.4 o superior
-  Solaris x86 9 o superior
+- Solaris x86 9 o superior
-  NetBSD-current
+- NetBSD-current
-  Mac OS X 10.5 o superior
+- Mac OS X 10.8 o superior
 Ya que Wine requiere soporte de hilos de ejecución a nivel de núcleo para
 ejecutarse, sólo se soportan los sistemas operativos ya mencionados.
 Otros sistemas operativos que soporten hilos de ejecución a nivel de núcleo
 podrían obtener soporte en el futuro.
-Información sobre FreeBSD:
+**Información sobre FreeBSD**:
-  Por lo general Wine no funcionará correctamente en versiones anteriores a
+  Visite https://wiki.freebsd.org/Wine para más información.
  FreeBSD 8.0. Visite https://wiki.freebsd.org/Wine para más información.
-Información sobre Solaris:
+**Información sobre Solaris**:
  Lo más probable es que necesite compilar con el conjunto de herramientas GNU
  (gcc, gas, etc.). Advertencia: instalar gas *no* asegura que sea utilizado
  por gcc. Un comentario ampliamente extendido es que es necesario recompilar
  gcc tras la instalación de gas o enlazar simbólicamente cc, as y ld a las
  herramientas gnu.
-Información de NetBSD:
+**Información de NetBSD**:
  Asegúrese de que tiene las opciones USER_LDT, SYSVSHM, SYSVSEM, y SYSVMSG
  activadas en el núcleo.
-Información de Mac OS X:
+**Información de Mac OS X**:
  Necesitará Xcode 2.4 o posterior para compilar correctamente en x86.
-
+**Sistemas de ficheros soportados**:
 Sistemas de ficheros soportados:
  Wine puede ejecutarse en la mayoría de los sistemas de ficheros. Sin embargo,
  se han reportado unos cuantos problemas de compatibilidad usando archivos
  accedidos a través de Samba. Además, NTFS no proporciona todas las
  funcionalidades necesitadas por algunas aplicaciones. Se recomienda el uso de
  un sistema de ficheros Unix.
-Requisitos básicos:
+**Requisitos básicos**:
  Necesitará tener instalados los archivos include X11 para desarrollo
  (llamados xorg-dev en Debian y libX11-devel en RedHat).
-
+  Además necesitará make (preferiblemente GNU make).
  Además necesitará "make" (preferiblemente GNU make).
  También necesitará flex versión 2.5.33 o posterior y bison.
-Librerías de soporte adicionales:
+**Librerías de soporte adicionales**:
  Configure mostrará advertencias cuando las librerías opcionales no se
  encuentren disponibles en su sistema.
  Visite https://wiki.winehq.org/Recommended_Packages para recomendaciones
  acerca de que paquetes debe instalar.
  En plataformas de 64-bit, si se está compilando Wine 32-bits (es la
  compilación por defecto), debe estar seguro de tener instaladas las librerías
  de desarrollo de 32-bits; visite https://wiki.winehq.org/WineOn64bit para más
@ -87,52 +85,56 @@ Librerías de soporte adicionales:
  y 64-bits), vaya a https://wiki.winehq.org/Wine64 para más detalles.
-4. COMPILACIÓN
+## COMPILACIÓN
 En el caso de que elija no utilizar wineinstall, ejecute los siguientes
 comandos para construir Wine:
 ```
 ./configure
 make
 ```
 Esto construirá el programa "wine" y numerosas librerías/binarios de soporte.
 El programa "wine" cargará y ejecutará ejecutables de Windows.
 La librería "libwine" ("Winelib") puede utilizarse para compilar y enlazar
 código fuente de Windows bajo Unix.
-Para ver las opciones de compilación, haga: ./configure --help.
+Para ver las opciones de compilación, haga: `./configure --help`.
-5. CONFIGURACIÓN
+## CONFIGURACIÓN
-Una vez que Wine se ha compilado correctamente, puede hacer "make install";
+Una vez que Wine se ha compilado correctamente, puede hacer `make install`;
 esto instalará el ejecutable y librerías de wine, el manual de Wine, y el
 resto de ficheros necesarios.
 Recuerde desinstalar antes cualquier instalación anterior de Wine que pueda
-crear conflictos. Realice un "dpkg -r wine" o "rpm -e wine" o "make uninstall"
+crear conflictos. Realice un `dpkg -r wine` o `rpm -e wine` o `make uninstall`
 antes de instalar.
-Una vez instalado, puede ejecutar la herramienta de configuración "winecfg".
+Una vez instalado, puede ejecutar la herramienta de configuración `winecfg`.
 Visite la zona de Soporte en https://www.winehq.org/ para consejos sobre la
 configuración.
-6. EJECUTANDO PROGRAMAS
+## EJECUTANDO PROGRAMAS
 Cuando invoque Wine, puede especificar la ruta completa al ejecutable, o sólo
 el nombre del fichero.
-Por ejemplo: para ejecutar el Solitario:
+Por ejemplo:
-  wine sol                   (usando la ruta de búsqueda indicada en el
+```
-  wine sol.exe                el registro para encontrar el archivo)
+wine notepad                   (usando la ruta de búsqueda indicada en el
 wine notepad.exe                el registro para encontrar el archivo)
-  wine c:\\windows\\sol.exe  (usando la sintaxis de DOS)
+wine c:\\windows\\notepad.exe  (usando la sintaxis de DOS)
-  wine /usr/windows/sol.exe  (usando la sintaxis de Unix)
+wine ~/.wine/drive_c/windows/notepad.exe  (usando la sintaxis de Unix)
-  wine notepad.exe readme.txt (ejecutando el programa con parámetros)
+wine notepad.exe readme.txt (ejecutando el programa con parámetros)
 ```
 Nota: la ruta del fichero también se añadirá a la ruta cuando se proporcione un
      nombre completo en la línea de comandos.
@ -141,34 +143,27 @@ Wine no es perfecto, algunos programas pueden fallar. Si esto le ocurre usted
 recibirá un log de error que debe adjuntar en caso de reportar un fallo.
-7. OBTENIENDO MÁS INFORMACIÓN
+## OBTENIENDO MÁS INFORMACIÓN
-WWW:    Una gran cantidad de información sobre Wine está disponible en WineHQ
+- **WWW**: Una gran cantidad de información sobre Wine está disponible en WineHQ
        en https://www.winehq.org/ : varias guías de Wine, base de datos de
        aplicaciones, registro de bugs. Este es probablemente el mejor punto de
        partida.
-FAQ:    Las preguntas frecuentes de Wine se encuentran en
+- **FAQ**: Las preguntas frecuentes de Wine se encuentran en
        https://www.winehq.org/FAQ
-Listas de correo:
+- **Wiki**: https://wiki.winehq.org
 - **Gitlab**: https://gitlab.winehq.org
 - **Listas de correo**:
        Hay varias listas de correo, tanto para usuarios como desarrolladores;
        Vaya a https://www.winehq.org/forums para más información.
-Bugs:   Reporte fallos en el Bugzilla de Wine, https://bugs.winehq.org
+- **Bugs**: Reporte fallos en el Bugzilla de Wine, https://bugs.winehq.org
        Por favor, antes de enviar un informe de fallo busque en la base de
        datos de bugzilla para comprobar si su problema es un fallo conocido
        o existe una solución.
-IRC:    Se puede obtener ayuda online en el canal #WineHQ de irc.libera.chat.
+- **IRC**: Se puede obtener ayuda online en el canal `#WineHQ` de irc.libera.chat.
 Git:    El árbol actual de desarrollo de Wine está disponible a través de Git.
        Vaya a https://www.winehq.org/git para más información.
 Si añade algo, o corrige algún bug, por favor envíe un parche (en formato
 git-format-patch) a la lista wine-devel@winehq.org para su inclusión
 en la siguiente versión.
 --
 Alexandre Julliard
 julliard@winehq.org
--- a/documentation/README-fi.md
+++ b/documentation/README-fi.md
@ -1,4 +1,4 @@
-1. JOHDANTO
+## JOHDANTO
 Wine on ohjelma, jonka avulla Windows-ohjelmia (mukaan luettuna DOS-,
 Windows 3.x, Win32 ja Win64 -ohjelmat) voi ajaa Unix-järjestelmissä.
@ -11,158 +11,156 @@ Wine on vapaa ohjelma, ja se on julkaistu GNU LGPL:n alaisena; lisätietoja
 lisenssistä on englanniksi tiedostossa LICENSE.
-2. PIKAOPAS
+## PIKAOPAS
 Aja Winen lähdekoodin juurihakemistossa seuraavat komennot:
 ```
 ./configure
 make
 ```
 Sitten joko asenna Wine:
 ```
 make install
 ```
 Tai aja se käännöshakemistosta:
 ```
 ./wine notepad
 ```
-Ohjelmat ajetaan komennolla "wine ohjelma". Lisätietoja sekä apua ongelmien
+Ohjelmat ajetaan komennolla `wine ohjelma`. Lisätietoja sekä apua ongelmien
 ratkaisemiseen on jäljempänä tässä tiedostossa, Winen man-sivuilla sekä
 ennen kaikkea Internetissä osoitteessa https://www.winehq.org/.
-3. JÄRJESTELMÄVAATIMUKSET
+## JÄRJESTELMÄVAATIMUKSET
 Winen kääntämiseen tarvitaan jokin seuraavista:
-  Linuxin versio 2.0.36 tai uudempi
+- Linuxin versio 2.0.36 tai uudempi
-  FreeBSD 12.4 tai uudempi
+- FreeBSD 12.4 tai uudempi
-  Solaris x86 9 tai uudempi
+- Solaris x86 9 tai uudempi
-  NetBSD-current
+- NetBSD-current
-  Mac OS X 10.8 tai uudempi
+- Mac OS X 10.8 tai uudempi
 Wine vaatii kerneliltä tuen säikeille. Tämän takia toistaiseksi vain yllä
 mainittuja käyttöjärjestelmiä tuetaan; tulevaisuudessa saatetaan lisätä tuki
 muillekin käyttöjärjestelmille, joissa on tarvittava tuki säikeille.
-Tietoa FreeBSD:lle:
+**Tietoa FreeBSD:lle**:
  Osoitteessa https://wiki.freebsd.org/Wine on lisätietoa.
-Tietoa Solarikselle:
+**Tietoa Solarikselle**:
  Wine täytyy luultavasti kääntää GNU-työkaluilla (gcc, gas jne.).
  Varoitus: vaikka gas olisi asennettu, ei ole varmaa, että gcc käyttää sitä;
  voi olla tarpeen joko kääntää gcc uudestaan tai luoda symboliset linkit
  ohjelmista "cc", "as" ja "ld" vastaaviin GNU-työkaluihin.
-Tietoa NetBSD:lle:
+**Tietoa NetBSD:lle**:
  USER_LDT, SYSVSHM, SYSVSEM ja SYSVMSG täytyy aktivoida kernelistä.
-Tietoa Mac OS X:lle:
+**Tietoa Mac OS X:lle**:
  Winen kääntämiseen tarvitaan Xcode Command Line Tools tai Apple cctools.
  Vähimmäisversiot ovat clang 3.8, MacOSX10.10.sdk ja mingw-w64 v8.
  MacOSX10.14.sdk ja myöhemmät sopivat vain wine64:n kääntämiseen.
-
+**Tuetut tiedostojärjestelmät**:
 Tuetut tiedostojärjestelmät:
  Wine toimii useimmilla tiedostojärjestelmillä, mutta Samban kanssa on
  ilmoitettu ilmenevän ongelmia. Myöskään NTFS ei tue kaikkia ominaisuuksia,
  joita jotkin ohjelmat vaativat. Natiivin Unix-tiedostojärjestelmän käyttö
  on suotavaa.
-Perusvaatimukset:
+**Perusvaatimukset**:
  Koneella täytyy olla X11:n kehitystiedostot (Debianissa xorg-dev,
  Red Hatissa libX11-devel).
  Luonnollisesti myös make (yleensä GNU make) on tarpeen.
  Lisäksi tarvitaan flex 2.5.33 tai uudempi sekä bison.
-Valinnaisia tukikirjastoja:
+**Valinnaisia tukikirjastoja**:
  configure-skripti näyttää varoituksia, kun valinnaisia kirjastoja puuttuu.
  Osoitteessa https://wiki.winehq.org/Recommended_Packages on tietoa, mitkä
  paketit ovat hyödyksi. 64-bittisissä järjestelmissä täytyy varmistaa, että
  kirjastoista on asennettu 32-bittiset versiot.
-4. KÄÄNTÄMINEN
+## KÄÄNTÄMINEN
 Winen voi kääntää seuraavilla komennoilla:
 ```
 ./configure
 make
 ```
 Tämä kääntää ohjelman "wine" sekä lukuisia tukikirjastoja ja -ohjelmia.
 Ohjelma "wine" lataa ja käynnistää Windows-ohjelmia.
 Kirjastoa "libwine" ("Winelib") voidaan käyttää Windows-lähdekoodin
 kääntämiseen Unixissa.
-Komento './configure --help' näyttää asetuksia ja valintoja, joita
+Komento `./configure --help` näyttää asetuksia ja valintoja, joita
 käännösprosessiin voi lisätä.
 Lisätietoja on osoitteessa https://wiki.winehq.org/Building_Wine
-5. ASENNUS
+## ASENNUS
-Kun Wine on käännetty, komento "make install" asentaa Winen sekä sen man-sivut
+Kun Wine on käännetty, komento `make install` asentaa Winen sekä sen man-sivut
 ja joitakin muita hyödyllisiä tiedostoja.
 Ennen asennusta pitää muistaa poistaa aiemmat Winen versiot. Poistamista
-voi yrittää komennolla "dpkg -r wine", "rpm -e wine" tai "make uninstall".
+voi yrittää komennolla `dpkg -r wine`, `rpm -e wine` tai `make uninstall`.
-Kun Wine on asennettu, voidaan ajaa asetusohjelma "winecfg". Sivustolla
+Kun Wine on asennettu, voidaan ajaa asetusohjelma `winecfg`. Sivustolla
 https://www.winehq.org/ kohdassa Support on englanninkielisiä lisäohjeita.
-6. OHJELMIEN AJAMINEN
+## OHJELMIEN AJAMINEN
 Winelle voi antaa joko ohjelmatiedoston koko polun tai pelkän nimen.
 Esimerkiksi Notepad eli Muistio voitaisiin ajaa näin:
-        wine notepad               (ohjelma yritetään löytää Winen
+```
-        wine notepad.exe            rekisterissä luetelluista paikoista)
+wine notepad               (ohjelma yritetään löytää Winen
 wine notepad.exe            rekisterissä luetelluista paikoista)
-        wine c:\\windows\\notepad.exe  (kokonainen DOS-polku)
+wine c:\\windows\\notepad.exe  (kokonainen DOS-polku)
-        wine ~/.wine/drive_c/windows/notepad.exe  (kokonainen Unix-polku)
+wine ~/.wine/drive_c/windows/notepad.exe  (kokonainen Unix-polku)
-        wine notepad.exe readme.txt  (ajetaan ohjelma parametrin kanssa)
+wine notepad.exe readme.txt  (ajetaan ohjelma parametrin kanssa)
 ```
 Wine ei ole täydellinen, joten on mahdollista, että jotkin ohjelmat kaatuvat.
 Siinä tapauksessa komentoriville tulostuu virheloki, joka on syytä liittää
 mukaan, jos raportoi virheestä.
-7. LISÄTIETOJA
+## LISÄTIETOJA
-WWW:	Winestä on paljon tietoa WineHQ:ssa, https://www.winehq.org/.
+- **WWW**: Winestä on paljon tietoa WineHQ:ssa, https://www.winehq.org/.
 	Oppaita, ohjelmatietokanta sekä Bugzilla vikojen listaamiseen.
 	Täältä kannattaa yleensä aloittaa.
-Kysymyksiä:
+- **Kysymyksiä**:
 	Sivulle https://www.winehq.org/FAQ on koottu kysymyksiä ja vastauksia.
-Wiki:	Wine Wiki on osoitteessa https://wiki.winehq.org/.
+- **Wiki**: Wine Wiki on osoitteessa https://wiki.winehq.org/.
-Gitlab: Winen kehitykseen voi osallistua sivustolla https://gitlab.winehq.org
+- **Gitlab**: Winen kehitykseen voi osallistua sivustolla https://gitlab.winehq.org
-Postituslistat:
+- **Postituslistat**:
 	Winen käyttäjille ja kehittäjille on joitakin postituslistoja,
 	sivulla https://www.winehq.org/forums kerrotaan niistä lisää.
-Virheet:
+- **Virheet**:
 	Ilmoita virheistä Winen Bugzillaan, https://bugs.winehq.org/.
 	Katso kuitenkin ensin Bugzilla-tietokannasta, onko samasta asiasta
 	ilmoitettu jo aiemmin.
-IRC:	Online-apua voi saada kanavalta #WineHQ palvelimella irc.libera.chat.
+- **IRC**: Online-apua voi saada kanavalta `#WineHQ` palvelimella irc.libera.chat.
 --
 Alkuperäisen version tekstistä on kirjoittanut
 Alexandre Julliard
 julliard@winehq.org
 Suomeksi kääntänyt
 Lauri Kenttä
 lauri.kentta@gmail.com
--- a/documentation/README-fr.md
+++ b/documentation/README-fr.md
@ -1,4 +1,4 @@
-1. INTRODUCTION
+## INTRODUCTION
 Wine est un programme qui permet d'exécuter les logiciels écrits pour
 Microsoft Windows (comprenant les exécutables DOS, Windows 3.x, Win32 et
@ -12,30 +12,32 @@ Wine est un logiciel libre, distribué sous GNU LGPL ; lisez le fichier
 LICENSE pour plus de détails.
-2. DÉMARRAGE RAPIDE
+## DÉMARRAGE RAPIDE
 Dans le dossier racine du code source de Wine (qui contient ce fichier),
 lancez :
 ```
 ./configure
 make
 ```
-Pour exécuter un programme, tapez « wine programme ». Pour des informations
+Pour exécuter un programme, tapez `wine programme`. Pour des informations
 complémentaires et la résolutions de problèmes, lisez la suite de ce
 fichier, les pages de manuel de Wine, et surtout les nombreuses
 informations que vous trouverez sur https://www.winehq.org.
-3. CONFIGURATION NÉCESSAIRE
+## CONFIGURATION NÉCESSAIRE
 Pour compiler et exécuter Wine, vous devez disposer d'un des systèmes
 d'exploitation suivants :
-	Linux version 2.0.36 ou ultérieur
+- Linux version 2.0.36 ou ultérieur
-	FreeBSD 8.0 ou ultérieur
+- FreeBSD 12.4 ou ultérieur
-	Solaris x86 9 ou ultérieur
+- Solaris x86 9 ou ultérieur
-	NetBSD-current
+- NetBSD-current
-	Mac OS X 10.5 ou ultérieur
+- Mac OS X 10.8 ou ultérieur
 Étant donné que Wine nécessite une implémentation des « threads »
 (processus légers) au niveau du noyau, seuls les systèmes d'exploitation
@ -43,29 +45,28 @@ mentionnés ci-dessus sont supportés. D'autres systèmes d'exploitation
 implémentant les threads noyau seront peut-être pris en charge dans le
 futur.
-Informations FreeBSD :
+**Informations FreeBSD** :
  Wine ne fonctionnera généralement pas bien avec les versions FreeBSD
  antérieures à 8.0.  Voyez https://wiki.freebsd.org/Wine pour plus
  d'informations.
-Informations Solaris :
+**Informations Solaris** :
  Il est plus que probable que vous deviez construire Wine avec la chaîne
  d'outils GNU (gcc, gas, etc.). Attention : installer gas n'assure pas
  qu'il sera utilisé par gcc.  Recompiler gcc après l'installation de gas
  ou créer un lien symbolique de cc, as et ld vers les outils GNU
  correspondants semble nécessaire.
-Informations NetBSD :
+**Informations NetBSD** :
  Assurez-vous que les options USER_LDT, SYSVSHM, SYSVSEM et SYSVMSG sont
  activées dans votre noyau.
-Informations Mac OS X :
+**Informations Mac OS X** :
  Xcode 2.4 ou ultérieur est nécessaire pour compiler Wine sous x86.
  Le pilote Mac requiert OS X 10.6 ou ultérieur et ne pourra être
  compilé sous 10.5.
-
+**Systèmes de fichiers pris en charge** :
 Systèmes de fichiers pris en charge :
  Wine devrait fonctionner sur la plupart des systèmes de fichiers.
  Certains problèmes de compatibilité ont été rapportés lors de
  l'utilisation de fichiers accédés via Samba. De plus, NTFS ne fournit pas
@ -73,21 +74,18 @@ Systèmes de fichiers pris en charge :
  certains applications. L'utilisation d'un système de fichiers Unix natif
  est recommandée.
-Configuration de base requise :
+**Configuration de base requise** :
  Les fichiers d'en-tête de X11 (appelés xorg-dev sous Debian et
  libX11-devel sous Red Hat) doivent être installés.
  Bien entendu, vous aurez besoin du programme « make » (très probablement
  GNU make).
  flex 2.5.33 ou ultérieur, ainsi que bison, sont également requis.
-Bibliothèques optionnelles :
+**Bibliothèques optionnelles** :
  « configure » affiche des messages quand des bibliothèques optionnelles
  ne sont pas détectées sur votre système.
  Consultez https://wiki.winehq.org/Recommended_Packages (en anglais) pour
  des indications sur les paquets logiciels que vous devriez installer.
  Sur les plates-formes 64 bits, si vous compilez Wine pour le mode 32 bits
  (mode par défaut), les versions 32 bits de ces bibliothèques doivent être
  installées. Voyez https://wiki.winehq.org/WineOn64bit pour les détails.
@ -95,12 +93,14 @@ Bibliothèques optionnelles :
  32/64 bits), consultez https://wiki.winehq.org/Wine64.
-4. COMPILATION
+## COMPILATION
 Pour compiler Wine, lancez :
 ```
 ./configure
 make
 ```
 Cela va construire le programme « wine », ainsi que nombreux binaires et
 bibliothèques de support.
@ -108,83 +108,76 @@ Le programme « wine » charge et exécute les exécutables Windows.
 La bibliothèque « libwine » (alias « Winelib ») peut être utilisée pour
 compiler et lier du code source Windows sous Unix.
-Pour voir les options de compilation, tapez « ./configure --help ».
+Pour voir les options de compilation, tapez `./configure --help`.
 Pour plus d'information consultez https://wiki.winehq.org/Building_Wine
-5. INSTALLATION
+## INSTALLATION
-Une fois Wine construit correctement, « make install » installe
+Une fois Wine construit correctement, `make install` installe
 l'exécutable wine, les bibliothèques associées, les pages de manuel de
 Wine et quelques autres fichiers nécessaires.
 N'oubliez pas de désinstaller toutes les installations précédentes :
-essayez « dpkg -r wine », « rpm -e wine » ou « make uninstall » avant
+essayez `dpkg -r wine`, `rpm -e wine` ou `make uninstall` avant
 d'installer une nouvelle version.
 Une fois l'installation terminée, vous pouvez lancer l'outil de
-configuration « winecfg ». Consultez la section Support de
+configuration `winecfg`. Consultez la section Support de
 https://www.winehq.org/ pour obtenir des astuces de configuration.
-6. EXÉCUTER DES PROGRAMMES
+## EXÉCUTER DES PROGRAMMES
 Au démarrage de Wine, vous pouvez spécifier le chemin entier vers
 l'exécutable ou seulement le nom de fichier.
 Par exemple pour exécuter le bloc-notes :
-    wine notepad               (en utilisant le chemin d'accès spécifié
+```
-    wine notepad.exe            dans la base de registre pour localiser
+wine notepad               (en utilisant le chemin d'accès spécifié
-                                le fichier)
+wine notepad.exe            dans la base de registre pour localiser
                            le fichier)
-    wine c:\\windows\\notepad.exe
+wine c:\\windows\\notepad.exe
-            (en utilisant la syntaxe de fichiers DOS)
+        (en utilisant la syntaxe de fichiers DOS)
-    wine ~/.wine/drive_c/windows/notepad.exe
+wine ~/.wine/drive_c/windows/notepad.exe
-            (en utilisant la syntaxe Unix)
+        (en utilisant la syntaxe Unix)
-    wine notepad.exe lisezmoi.txt
+wine notepad.exe lisezmoi.txt
-            (en appelant le programme avec des paramètres)
+        (en appelant le programme avec des paramètres)
 ```
 Wine n'est pas parfait, et certains programmes peuvent donc planter. Si
 cela se produit, vous obtiendrez un journal du crash qu'il est recommandé
 d'attacher à un éventuel rapport de bogue.
-7. SOURCES D'INFORMATIONS COMPLÉMENTAIRES
+## SOURCES D'INFORMATIONS COMPLÉMENTAIRES
-WWW :	Beaucoup d'informations à propos de Wine sont disponibles sur
+- **WWW** :	Beaucoup d'informations à propos de Wine sont disponibles sur
        WineHQ (https://www.winehq.org) : divers guides, base de données
        d'applications, suivi de bogues. C'est probablement le meilleur
        point de départ.
-FAQ :   La Foire aux Questions de Wine se trouve sur
+- **FAQ** :   La Foire aux Questions de Wine se trouve sur
        https://www.winehq.org/FAQ
-Wiki :  Le wiki Wine est situé sur https://wiki.winehq.org
+- **Wiki** :  Le wiki Wine est situé sur https://wiki.winehq.org
-Listes de diffusion :
+- **Gitlab**: Le développement de Wine est hébergé sur https://gitlab.winehq.org
 - **Listes de diffusion** :
        Il existe plusieurs listes de diffusion pour les utilisateurs et
        les développeurs Wine ; voyez https://www.winehq.org/forums pour de
        plus amples informations.
-Bogues :
+- **Bogues** :
        Signalez les bogues sur le Bugzilla Wine à https://bugs.winehq.org
        Merci de vérifier au préalable dans la base de données de bugzilla
        que le problème n'est pas déjà connu, ou corrigé.
-IRC :   L'aide en ligne est disponible via le canal #WineHQ sur
+- **IRC** :   L'aide en ligne est disponible via le canal `#WineHQ` sur
        irc.libera.chat.
 Git :   L'arbre de développement actuel de Wine est disponible via Git.
        Voyez https://www.winehq.org/git pour plus d'informations.
 Si vous ajoutez quelque chose ou corrigez un bogue, merci d'envoyer un
 correctif (de préférence en utilisant git-format-patch) à la liste de
 diffusion wine-devel@winehq.org pour inclusion dans la version suivante.
 --
 Alexandre Julliard
 julliard@winehq.org
--- a/documentation/README-hu.md
+++ b/documentation/README-hu.md
@ -1,4 +1,4 @@
-1. BEVEZETÉS
+## BEVEZETÉS
 A Wine egy program amivel lehetõség nyílik a Microsoft Windows
 programok futtatására (beleértve a  DOS, Windows 3.x és Win32
@ -12,58 +12,53 @@ Ez a függvénykönyvtár használható a Win32 kód natív Unix futtatható
 A Wine egy szabad szoftver, a GNU LGPL alatt kiadva; nézze meg a
 LICENSE fájlt a részletekért.
-2. GYORS INDÍTÁS
+## GYORS INDÍTÁS
 Ha ön forrásból fordította, ajánlott a Wine telepítõ használata a
 a Wine lefordításához és telepítéséhez.  A Wine forráskód szülõ-
 könyvtárából (ami tartalmazza ezt a fájlt), futtassa:
-./tools/wineinstall
+```
 ./configure
 make
 ```
-A programok futtatása "wine [opciók] program".  A további információkhoz
+A programok futtatása `wine program`.  A további információkhoz
 és a probléma felvilágosításhoz olvassa el ennek a fájlnak a további részét,
 a Wine man oldalát, és különösen gazdag információ található itt:
 https://www.winehq.org.
-3. KÖVETELMÉNYEK
+## KÖVETELMÉNYEK
 A Wine-nak a fordításához és futtatásához önnek szüksége lesz a következõkbõl
 egynek:
-  Linux 2.0.36-os, vagy feletti verzió
+- Linux 2.0.36-os, vagy feletti verzió
-  FreeBSD 5.3, vagy késõbbi
+- FreeBSD 12.4, vagy késõbbi
-  Solaris x86 2.5, vagy késõbbi
+- Solaris x86 9, vagy késõbbi
-  NetBSD-current
+- NetBSD-current
 - Mac OS X 10.8, vagy késõbbi
 Mivel a Wine-nak kükséges kernelszintû futási szál támogatás a futtatáshoz, csak
 a fent említett operációs rendszerek támogatottak.
 Más operációs rendszerek, amik támogatják a kernel futási szálakat, támogatva
 lesznek a jövõben.
-Linux információ:
+**FreeBSD információ**:
  Amig a Linux 2.2.x mûködik, és a Linux 2.0.x is mûködni fog
  (a régebbi 2.0.x verziókban futási szál miatti összeomlások voltak),
  az a legjobb, ha önnek a legfrisebb kernele van, mint például a 2.4.x.
 FreeBSD információ:
  Wine-nak le kell fordulnia a FreeBSD 4.x és FreeBSD 5.x verziókon, de a
  FreeBSD 5.3 elõtti verziókon általában nem fog mûködni.
  Több információ található a FreeBSD ports fában itt:
  <ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/emulators/wine/>.
-Solaris információ:
+**Solaris információ**:
  A Wine fordításához kell a GNU toolchain (gcc, gas, etc.).
  Figyelem : A gas telepítése *nemt* biztosíték, hogy a gcc fogja is
  használni. A gcc újrafordítása a gas telepítése után, vagy a cc
  szimbolikus linkelése, és ld-zése a gnu tools-hoz szükséges.
-NetBSD információ:
+**NetBSD információ**:
  ellenõrizze, hogy a USER_LDT, SYSVSHM, SYSVSEM, és SYSVMSG opciók be vannak-e
  kapcsolva a kernelben.
-
+**Támogatott fájlrendszerek**:
 Támogatott fájlrendszerek:
  A Wine fut a legtöbb fájlrendszeren. Habár a Wine nem fog elindulni, ha
  umsdos-t használunk a /tmp könyvtárban. Néhány kompatibilitási gondot
  is bejelentettek a Sambán keresztül elért fájlok esetében. Az NTFS-t
@ -71,35 +66,34 @@ Támogatott fájlrendszerek:
  szól, hogy a Windows programoknak majdnem mindenhova írási jog kell.
  NTFS fájlok esetén másoljuk át õket egy írható helyre.
-Alap követelmények:
+**Alap követelmények**:
  Önnek fel kell telepítenie az X11 fejlesztõi fájlokat
  (xorg-dev néven van a Debianban és libX11-devel néven a Red Hat-ben).
-Fordítási eszköz követelmények:
+**Fordítási eszköz követelmények**:
  x86 rendszereken gcc >= 2.7.2 szükséges.
  A 2.7.2.3-nál régebbi verziókban problémák lehetnek különféle fájlokkal,
  amik optimalizációval lettek fordítva, gyakran a fejléc fájlok kezelésének
  problémái miatt. A pgcc jelenelg nem mûködik s Wine-sl. A probléma oka
  ismeretlen.
-
+  Természetesen kell a make is (leginkább a GNU make).
  Természetesen kell a "make" is (leginkább a GNU make).
  Kell még a flex 2.5 verzió, vagy késõbbi, és a bison.
-Opciónális támogatási függvénykönyvtárak:
+**Opciónális támogatási függvénykönyvtárak**:
  Ha szeretne CUPS nyomtató támogatást, telepítse fel a cups és a cups-devel
  csomagot.
  Telepítse fel a libxml2 csomagot, ha szeretné hogy mûködjön az msxml
  implementáció.
-4. FORDÍTÁS
+## FORDÍTÁS
 Ha ön nem használja a wineinstall-t, futtassa a következõ parancsokat s
 Wine fordításához:
 ```
 ./configure
 make depend
 make
 ```
 Ez le fogja fordítani a "wine" programot és számos függvénykönyvtárat/binárist.
 A "wine" program be fogja tölteni és futtatni fogja a Windows futtatható
@ -107,102 +101,63 @@ A "wine" program be fogja tölteni és futtatni fogja a Windows futtatható
 A "libwine" függvénykönyvtár ("Winelib") használható a Windows forráskód Unix
 alatt történõ fordításához és linkeléséhez.
-A fordítási konfigurációs opciók megtekinétéséhez nézze használja a ./configure --help
+A fordítási konfigurációs opciók megtekinétéséhez nézze használja a `./configure --help`
 parancsot.
-Új kiadásra frissítéskor patch fájl használatával elõször váltos a kiadás legfelsõ
+## TELEPÍTÉS
 könyvtárszintjére (ahol a README fájl megtalálható).
 Azután használja a "make clean" parancsot, és foltozza meg a kiadást ezzel:
-    gunzip -c patch-fájl | patch -p1
+Ha a Wine egyszer helyesen lefordult, használhatja a `make install`
 ahol a "patch-fájl" a javítófolt fájl fájlneve (valami ilyesmi:
 Wine-yymmdd.diff.gz). Újrafuttathatja a "./configure", és azután
 a "make depend && make" parancsokat.
 5. TELEPÍTÉS
 Ha a Wine egyszer helyesen lefordult, használhatja a "make install"
 parancsot; ez telepíteni fogja a wine futtatható fájlt, a Wine man
 oldalát, és néhány egyéb szükséges fájlt.
 Elõször ne felejtse eltávolítani bármely elõzõ Wine telepítést.
-Próbálja ki a "dpkg -r wine", és az "rpm -e wine", vagy a "make uninstall"
+Próbálja ki a `dpkg -r wine`, és az `rpm -e wine`, vagy a `make uninstall`
 parancsot telepítés elõtt.
 Látogassa meg a támogatási oldalt itt: https://www.winehq.org/ a konfigurációs
 tippekhez.
-Függvénykönyvtár betöltési hibák esetén
+## PROGRAMOK FUTTATÁSA
 (pl. "Error while loading shared libraries: libntdll.so"), ellenõrizze az
 függvénykönyvtár útvonalt, hogy benne van-e az /etc/ld.so.conf és futtassa az
 ldconfig-ot root-ként.
 6. PROGRAMOK FUTTATÁSA
 Ha segítségül hívja a Wine-t, megadhatja a teljes útvonalát a futtatható
 állománynak, vagy csak a fájlnevet.
-Például: a Pasziánsz indítása:
+Például:
-	wine sol		   (a konfigfájlban megadott keresési útvonal
+```
-	wine sol.exe		    használatával keressük meg a fájlt)
+wine notepad		   (a konfigfájlban megadott keresési útvonal
 wine notepad.exe		    használatával keressük meg a fájlt)
-	wine c:\\windows\\sol.exe  (a DOS fájlnév szintaxis használatával)
+wine c:\\windows\\notepad.exe  (a DOS fájlnév szintaxis használatával)
-	wine /usr/windows/sol.exe  (a Unix-os fájlnév szintaxis használatával)
+wine ~/.wine/drive_c/windows/notepad.exe  (a Unix-os fájlnév szintaxis használatával)
-        wine sol.exe /paraméter1 -paraméter2 paraméter3
+wine notepad.exe readme.txt          (program hívása paraméterekkel)
-				   (program hívása paraméterekkel)
+```
 Felhívás: a fájl eléséi útja is hozzá lesz adva a path-hez, ha a teljes név
          meg lett adva a parancssorban.
-A Wine még nem teljes, így néhány program összeomlik. Ha helyesen beállítja a
+## TÖBB INFORMÁCIÓ BESZERZÉSE
 winedbg-ot a documentation/debugger.sgml-nek megfelelõen, ön be lesz léptetve
 egy hibakeresõbe, ahol utánajárhat, és kijavíthatja a problémát.
 A további infomációhoz, hogy hogy kell ezt megcsinálni, kérem olvassa el a
 documentation/debugging.sgml fájlt.
-Jobb ha biztonságba helyezi a fontos fájlokat, mielõtt hozzáférést a Wine-nak,
+- **WWW**: A Wine-ról hatalmas mennyiségû információ érhetõ el a WineHQ-n ezen
 vagy használjon egy speciális Wine másolatot belõlük, mert néhány esetben a
 felhasználók fájlsérülést jeleztek. NE futtassa az Explorer-t, például,
 ha önnek nincs helyes biztonsági mentése, mert néha átnevez/tönkretesz
 néhány könyvtárat. Nem csak más MS alkalmazás mint példéul a Messenger biztonásgos,
 de valahogy az Explorer futtatása is. Ez a bizonyos sérülés (!$!$!$!$.pfr)
 részlegesen javítható ennek a használatával:
 http://home.nexgo.de/andi.mohr/download/decorrupt_explorer
 7. TÖBB INFORMÁCIÓ BESZERZÉSE
 WWW:	A Wine-ról hatalmas mennyiségû információ érhetõ el a WineHQ-n ezen
 	a címen: https://www.winehq.org/ : különbözõ Wine útmutatók,
 	alkalmazás adatbázis, és hibakövetés.
 	Ez talán a legjobb kiindulási pont.
-GYIK:	A Wine GYIK itt található: https://www.winehq.org/FAQ
+- **GYIK**: A Wine GYIK itt található: https://www.winehq.org/FAQ
-Usenet:	Társaloghat a Wine-hoz kapcsolódó témákban, és segítséget kérhet itt:
+- **Wiki**: https://wiki.winehq.org
 	comp.emulators.ms-windows.wine.
-Hibák:	Wine hibabejelentés a Bugzilla-n keresztül itt: https://bugs.winehq.org
+- **Gitlab**: https://gitlab.winehq.org
 - **Levelezõlisták**:
 	Elérhetõ néhány levelezõlista a Wine fejlesztõk számára; nézze meg a
 	https://www.winehq.org/forums címet a további információhoz.
 - **Hibák**: Wine hibabejelentés a Bugzilla-n keresztül itt: https://bugs.winehq.org
 	Kérem hibabejelentés küldése elõtt ellenõrizze, hogy az ön problémája
 	már megtalálható-e az adatbázisban.  Küldhet hibabejelentéseket a
 	comp.emulators.ms-windows.wine címre is.
-IRC:	Azonnali segítség elérhetõ a #WineHQ csatornán a irc.libera.chat-en.
+- **IRC**: Azonnali segítség elérhetõ a `#WineHQ` csatornán a irc.libera.chat-en.
 Git:	A jelenlegi Wine fejlesztõi fa elérhetõ Git-en keresztül.
 	Látogasson el ide a további információhoz: https://www.winehq.org/git
 Levelezõlisták:
 	Elérhetõ néhány levelezõlista a Wine fejlesztõk számára; nézze meg a
 	https://www.winehq.org/forums címet a további információhoz.
 Ha valamit hozzáad, vagy hibát javít, kérem küldjön javítófoltot ('diff -u'
 formátumban) a wine-devel@winehq.org levelezõlista címre, hogy beletehessük a
 következõ kiadásba.
 --
 Alexandre Julliard
 julliard@winehq.org
--- a/documentation/README-it.md
+++ b/documentation/README-it.md
@ -1,4 +1,4 @@
-1. INTRODUZIONE
+## INTRODUZIONE
 Wine è un programma che permette di eseguire programmi sviluppati per
 Microsoft Windows (compresi eseguibili DOS, Windows 3.x, Win32, and
@ -12,73 +12,70 @@ Wine è un software libero, rilasciato sotto la GNU LGPL; leggere il file
 LICENSE per maggiori dettagli.
-2. QUICK START
+## QUICK START
 Compilando da sorgente, si raccomanda di usare l'Installer di Wine per
 compilare ed installare Wine. Dalla cartella principale del sorgente di
 Wine, eseguire:
-./tools/wineinstall
+```
 ./configure
 make
 ```
-Eseguire i programmi com "wine programma". Per maggiori informazioni e
+Eseguire i programmi com `wine programma`. Per maggiori informazioni e
 risoluzioni di problemi, leggere il resto di questo file, la pagina man
 di Wine, ed in modo particolare la notevole quantità di informazioni che
 si trova all'indirizzo https://www.winehq.org.
-3. REQUISITI
+## REQUISITI
 Per compilare ed eseguire Wine, è necessario avere uno dei seguenti sistemi:
-  Linux versione 2.0.36 o successiva
+- Linux versione 2.0.36 o successiva
-  FreeBSD 8.0 o successiva
+- FreeBSD 12.4 o successiva
-  Solaris x86 9 o successiva
+- Solaris x86 9 o successiva
-  NetBSD-current
+- NetBSD-current
-  Mac OS X 10.5 o successiva
+- Mac OS X 10.8 o successiva
 Poiché Wine richiede il supporto dei thread a livello kernel per funzionare,
 solo i sistemi operativi sopra mentionati sono supportati. Altri sistemi
 che forniscono kernel threads potrebbero essere supportati in futuro.
-Informazioni per FreeBSD:
+**Informazioni per FreeBSD**:
  In generale Wine non funzionerà correttamente con versioni precedenti
  a FreeBSD 8.0.
  Leggere https://wiki.freebsd.org/Wine per maggiori informazioni.
-Informazioni per Solaris:
+**Informazioni per Solaris**:
  Sarà molto probabilmente necessario compilare Wine con i tool GNU
  (gcc, gas, etc). Attenzione: installare gas *non* assicura che
  sia usato da gcc. Sembra che sia necessario ricompilare gcc dopo
  l'installazione di gas o il symlink di cc, as e ld per i tool GNU.
-Informazioni per NetBSD:
+**Informazioni per NetBSD**:
  Assicurarsi che le opzioni USER_LDT, SYSVSHM, SYSVSEM, e SYSVMSG siano
  abilitate nel kernel.
-Informazioni per Mac OS X:
+**Informazioni per Mac OS X**:
  È richiesto Xcode 2.4 o superiore per compilare correttamente su x86.
-
+**File system supportati**:
 File system supportati:
  Wine dovrebbe funzionare sulla maggior parte dei file system. Qualche
  problema di compatibilità è stato riportato usando file acceduti
  tramite Samba. Inoltre, NTFS non fornisce tutte le funzionalità di
  file system necessarie per alcune applicazioni. Si raccomanda di usare
  un file system nativo di Unix.
-Requisiti basilari:
+**Requisiti basilari**:
  Devono essere installati i file include di sviluppo di X11
  (chiamato xorg-dev in Debian e libX11-devel in Red Hat).
-
+  Ovviamente necessario anche make (possibilmente GNU make).
  Ovviamente necessario anche "make" (possibilmente GNU make).
  È richiesto anche flex versione 2.5.33 o superiore e bison.
-Librerie opzionali di supporto:
+**Librerie opzionali di supporto**:
  Configure notificherà a video quando le librerie opzionali non sono
  trovate sul sistema. Leggere https://wiki.winehq.org/Recommended_Packages
  per suggerimenti sui pacchetti da installare.
  Su piattaforme a 64-bit, per compilare Wine a 32-bit (predefinito),
  assicurarsi di installare la versione a 32-bit di queste librerie;
  leggere https://wiki.winehq.org/WineOn64bit per i dettagli. Per avere
@ -86,13 +83,15 @@ Librerie opzionali di supporto:
  leggere https://wiki.winehq.org/Wine64 per maggiori informazioni.
-4. COMPILAZIONE
+## COMPILAZIONE
 Nel caso in cui si scegliesse di non utilizzare wineinstall, eseguire
 i seguenti comandi per compilare Wine:
 ```
 ./configure
 make
 ```
 Questa sequenza compilerà il programma "wine" e numerose librerie e
 binari di supporto.
@ -101,73 +100,66 @@ La libreria "libwine" ("Winelib") può essere usata per compilare e
 linkare codice sorgente Windows sotto Unix.
 Per vedere le opzioni di configurazione della compilazione, eseguire
-./configure -help.
+`./configure -help`.
-5. SETUP
+## SETUP
 Una volta che Wine è stato compilato correttamente, puoi eseguire
-"make install"; questo installerà l'eseguibile wine, le librerie, la
+`make install`; questo installerà l'eseguibile wine, le librerie, la
 pagina man di Wine, e altri file necessari.
 Non dimenticarti di disinstallare qualsiasi precedente installazione
-di Wine in conflitto. Prova sia "dpkg -r wine" o "rpm -e wine" o
+di Wine in conflitto. Prova sia `dpkg -r wine` o `rpm -e wine` o
-"make uninstall" prima di installare.
+`make uninstall` prima di installare.
-Una volta installato, esegui lo strumento di configurazione "winecfg".
+Una volta installato, esegui lo strumento di configurazione `winecfg`.
 Leggi l'area Support su https://www.winehq.org/ per suggerimenti sulla
 configurazione.
-6. ESEGUIRE PROGRAMMI
+## ESEGUIRE PROGRAMMI
 Quando si esegue Wine, si può specificare l'intero percorso
 dell'eseguibile o solo il nome del file.
 Per esempio, per eseguire Blocco Note:
-    wine notepad            (usando il percorso di ricerca come specificato
+```
-    wine notepad.exe         nel registro per trovare il file)
+wine notepad            (usando il percorso di ricerca come specificato
 wine notepad.exe         nel registro per trovare il file)
-    wine c:\\windows\\notepad.exe      (usando la sintassi DOS)
+wine c:\\windows\\notepad.exe      (usando la sintassi DOS)
-    wine ~/.wine/drive_c/windows/notepad.exe  (usando la sintassi Unix)
+wine ~/.wine/drive_c/windows/notepad.exe  (usando la sintassi Unix)
-    wine notepad.exe readme.txt     (chiamando il programma con dei parametri)
+wine notepad.exe readme.txt     (chiamando il programma con dei parametri)
 ```
 Wine non è perfetto, quindi alcuni programmi potrebbero andare in crash.
 Se ciò accadesse, sarà creato un log del crash da aggiungere al rapporto
 di segnalazione del problema.
-7. PER OTTENERE PIÙ INFORMAZIONI
+## PER OTTENERE PIÙ INFORMAZIONI
-WWW:	Un gran quantitativo di informazioni su Wine è disponibile al
+- **WWW**: Un gran quantitativo di informazioni su Wine è disponibile al
 	WineHQ, https://www.winehq.org/: varie guide su Wine, database
 	delle applicazioni, rintracciamento di bug. Questo è probabilmente
 	il miglior punto di partenza.
-FAQ:	Le FAQ di Wine si trovano all'indirizzo https://www.winehq.org/FAQ
+- **FAQ**: Le FAQ di Wine si trovano all'indirizzo https://www.winehq.org/FAQ
-Wiki:	Il Wiki di Wine si trova all'indirizzo https://wiki.winehq.org
+- **Wiki**: Il Wiki di Wine si trova all'indirizzo https://wiki.winehq.org
-Mailing list:
+- **Gitlab**: https://gitlab.winehq.org
 - **Mailing list**:
 	Esistono diverse mailing list per utenti e sviluppatori di Wine;
 	visitare https://www.winehq.org/forums per ulteriori informazioni.
-Bugs:	Segnalare i bug su Wine Bugzilla all'indirizzo https://bugs.winehq.org
+- **Bugs**: Segnalare i bug su Wine Bugzilla all'indirizzo https://bugs.winehq.org
 	Si prega di controllare il database di Bugzilla per verificare che
 	il problema non sia già conosciuto o risolto prima di creare un
 	rapporto su di esso.
-IRC:	Aiuto online disponibile nel canale #WineHQ su irc.libera.chat.
+- **IRC**: Aiuto online disponibile nel canale `#WineHQ` su irc.libera.chat.
 Git:	L'albero attuale di sviluppo di Wine è disponibile attraverso Git.
 	Vedere https://www.winehq.org/git per maggiori informazioni.
 Se aggiungi qualcosa, o correggi un bug, si prega di mandare una patch
 (preferibilmente usando git-format-patch) alla mailing list
 wine-devel@winehq.org per l'inclusione nel prossimo rilascio.
 --
 Alexandre Julliard
 julliard@winehq.org
--- a/documentation/README-ja.md
+++ b/documentation/README-ja.md
@ -1,4 +1,4 @@
-1. はじめに
+## はじめに
 Wineは（DOS、Windows 3.x、Win32 や Win64 実行可能ファイルを含む）Microsoft
 WindowsプログラムをUnix上で実行できるようにするプログラムです。
@ -11,167 +11,164 @@ Wineはフリーソフトウェアで、GNU LGPLのもとでリリースされ
 詳細についてはLICENSEというファイルを参照してください。
-2. クイックスタート
+## クイックスタート
 Wineソースのトップレベルディレクトリ（このファイル[訳注:README.jaではなく
 READMEというファイル]を含むディレクトリ）から、以下を実行してください:
 ```
 ./configure
 make
 ```
 それから次のいずれか、Wineをインストールするか:
 ```
 make install
 ```
 または、Wineをビルドディレクトリから直接実行してください:
 ```
 ./wine notepad
 ```
-"wine program"のようにプログラムを実行してください。更なる情報や
+`wine program`のようにプログラムを実行してください。更なる情報や
 問題解決については、このファイルの残りの部分、Wineのmanページや、
-特にhttps://www.winehq.orgで見つかる豊富な情報を読んでください。
+特に<https://www.winehq.org>で見つかる豊富な情報を読んでください。
-3. 要件
+## 要件
 Wineをコンパイルし実行するには、以下のうち一つを持っていなければなりません:
-  Linux バージョン2.0.36以上
+- Linux バージョン2.0.36以上
-  FreeBSD 8.0以降
+- FreeBSD 12.4以降
-  Solaris x86 9以降
+- Solaris x86 9以降
-  NetBSD-current
+- NetBSD-current
-  Mac OS X 10.8以降
+- Mac OS X 10.8以降
 動作するためにWineにはカーネルレベルのスレッドのサポートが必要なので、
 以上で触れたオペレーティングシステムだけがサポートされます。
 カーネルスレッドをサポートする他のオペレーティングシステムは
 将来サポートされるかもしれません。
-FreeBSD情報:
+**FreeBSD情報**:
-  Wineは一般的にFreeBSD 8.0より前のバージョン上で正しく動作しないでしょう。
+  詳細については<https://wiki.freebsd.org/Wine>を参照してください。
  詳細については https://wiki.freebsd.org/Wine を参照してください。
-Solaris情報:
+**Solaris情報**:
  GNUツールチェーン（gcc、gasなど）でWineをビルドする必要がある可能性が
  最も高いでしょう。警告 : gccがgasを使うことが、gasをインストールすることに
  よって保証されるわけでは*ありません*。gasのインストール後にgccを
  再コンパイルするか、cc、asやldをgnuツールにシンボリックリンクすることが
  必要だと言われています。
-NetBSD情報:
+**NetBSD情報**:
  USER_LDT、SYSVSHM、SYSVSEMやSYSVMSGオプションがカーネルで有効になっている
  かどうかを確認してください。
-Mac OS X情報:
+**Mac OS X情報**:
  Xcode/Xcode Command Line ToolsまたはApple cctoolsが必要です。Wineを
  コンパイルするための最小要件はclang 3.8とMacOSX10.10.sdkおよびmingw-w64
  v8の組み合わせです。MacOSX10.14.sdkまたはそれ以降はwine64だけをビルドでき
  ます。
-
+**サポートされたファイルシステム**:
 サポートされたファイルシステム:
  Wineはほとんどのファイルシステム上で動作するはずです。Sambaを通して
  アクセスしたファイルを使っていくつかの互換性問題が報告されています。同様に、
  NTFSはいくつかのアプリケーションで必要なファイルシステム機能すべてを提供し
  ていません。ネイティブなUnixファイルシステムを使うことが推奨されます。
-基本的な要件:
+**基本的な要件**:
  X11開発includeファイルをインストールする必要があります。
  （Debianではxorg-devでRed HatではlibX11-develと呼ばれます。[訳注: 最近の
    ディストリビューションでは別のパッケージで置き換えられています]）
-
+  もちろんmakeも必要です（大概はGNU make）。
  もちろん"make"も必要です（大概はGNU make）。
  flexバージョン2.5.33以降とbisonも必要です。
-オプションのサポートライブラリ:
+**オプションのサポートライブラリ**:
  configureはオプションのライブラリがシステム上に見つからなかったときに通知を
  表示します。インストールすべきパッケージについてのヒントについては
-  https://wiki.winehq.org/Recommended_Packagesを参照してください。64ビットプ
+  <https://wiki.winehq.org/Recommended_Packages>を参照してください。64ビットプ
  ラットフォームでは、これらライブラリの32ビットバージョンをインストールした
  ことをよく確認してください。
-4. コンパイル
+## コンパイル
 Wineをビルドするには以下のコマンドを実行してください:
 ```
 ./configure
 make
 ```
 これによって"wine"というプログラムと多数のサポートライブラリやバイナリが
 ビルドされます。"wine"というプログラムはWindows実行可能ファイルを読み込み
 実行します。"libwine" ("Winelib") というライブラリはUnixのもとでWindowsの
 ソースコードをコンパイルしリンクするのに使えます。
-コンパイル設定オプションを見るには、./configure --helpを行なってください。
+コンパイル設定オプションを見るには、`./configure --help`を行なってください。
-更なる情報はhttps://wiki.winehq.org/Building_Wineを参照してください。
+更なる情報は<https://wiki.winehq.org/Building_Wine>を参照してください。
-5. 設定
+## 設定
-いったんWineが正しくビルドされると、"make install"を行なえます。
+いったんWineが正しくビルドされると、`make install`を行なえます。
 これによりwine実行可能ファイルとライブラリ、Wine manページやいくつかの必要な
 ファイルがインストールされます。
 まず、衝突するあらゆる前のWineインストールをアンインストールするのを
-忘れないでください。インストール前に"dpkg -r wine"または"rpm -e wine"
+忘れないでください。インストール前に`dpkg -r wine`または`rpm -e wine`
-または"make uninstall"を試してください。
+または`make uninstall`を試してください。
-いったんインストールされると、"winecfg"設定ツールを実行できます。
+いったんインストールされると、`winecfg`設定ツールを実行できます。
-設定のヒントについてはhttps://www.winehq.org/におけるサポート領域を
+設定のヒントについては<https://www.winehq.org/>におけるサポート領域を
 参照してください。
-6. プログラムの実行
+## プログラムの実行
 Wineを起動するとき、実行可能ファイルのパス全体またはファイル名のみを
 指定できます。
 例えば、メモ帳を実行するには:
-    wine notepad            （レジストリで指定された、ファイルを検索
+```
-    wine notepad.exe          するための検索パスを使う）
+wine notepad            （レジストリで指定された、ファイルを検索
 wine notepad.exe          するための検索パスを使う）
-    wine c:\\windows\\notepad.exe  （DOSファイル名の文法を使う）
+wine c:\\windows\\notepad.exe  （DOSファイル名の文法を使う）
-    wine ~/.wine/drive_c/windows/notepad.exe  （Unixファイル名の文法を使う）
+wine ~/.wine/drive_c/windows/notepad.exe  （Unixファイル名の文法を使う）
-    wine notepad.exe readme.txt    （パラメータを付けてプログラムを呼ぶ）
+wine notepad.exe readme.txt    （パラメータを付けてプログラムを呼ぶ）
 ```
 Wineは完璧ではないので、いくつかのプログラムはクラッシュするかもしれません。
 そのような場合はクラッシュログを得られるでしょう。クラッシュログはバグを報告
 するときにレポートに添付するべきです。
-7. 更なる情報の取得
+## 更なる情報の取得
-WWW:	Wineについてのたくさんの情報がhttps://www.winehq.org/にある
+- **WWW**: Wineについてのたくさんの情報が<https://www.winehq.org/>にある
        WineHQから入手できます。多様なWineガイド、アプリケーションデータベース、
 	バグ追跡。これはおそらく最良の出発点です。
-FAQ:	Wine FAQはhttps://www.winehq.org/FAQにあります
+- **FAQ**: Wine FAQは<https://www.winehq.org/FAQ>にあります
-Wiki:	Wine Wikiはhttps://wiki.winehq.orgにあります
+- **Wiki**: Wine Wikiは<https://wiki.winehq.org>にあります
-メーリングリスト:
+- **Gitlab**: <https://gitlab.winehq.org>
 - **メーリングリスト**:
 	Wineユーザと開発者のためのいくつかのメーリングリストがあります。
-	詳細についてはhttps://www.winehq.org/forumsを参照してください。
+	詳細については<https://www.winehq.org/forums>を参照してください。
-バグ:	https://bugs.winehq.orgにあるWine Bugzillaでバグを報告してください。
+- **バグ**: <https://bugs.winehq.org>にあるWine Bugzillaでバグを報告してください。
        バグ報告を投稿する前に問題が既知や修正済みかどうかを調べるために
 	bugzillaデータベースを検索してください。
-IRC:	irc.libera.chat上のチャンネル#WineHQでオンラインヘルプを利用できます。
+- **IRC**: irc.libera.chat上のチャンネル`#WineHQ`でオンラインヘルプを利用できます。
 Git:	現在のWine開発ツリーはGitを通して入手できます。
 	詳細についてはhttps://www.winehq.org/gitに行ってください。
 何かを追加するか、バグを修正するならば、次のリリースに含めるためにパッチ
 （git-format-patchをなるべく使用）をwine-devel@winehq.orgのリストに送って
 ください。
 --
 Alexandre Julliard
 julliard@winehq.org
--- a/documentation/README-ko.md
+++ b/documentation/README-ko.md
@ -1,4 +1,4 @@
-1. 소개
+## 소개
 Wine은 Microsoft Windows 프로그램(DOS, Windows 3.x, Win32 및 Win64 실행
 파일 포함)을 유닉스 상에서 실행할 수 있게 해 주는 프로그램입니다.  Wine은
@ -11,166 +11,156 @@ Wine은 자유 소프트웨어이며 GNU LGPL 하에 배포됩니다.  자세한
 LICENSE 파일을 참조하십시오.
-2. 간편 설치 및 실행
+## 간편 설치 및 실행
 Wine 소스의 최상위 디렉토리에서 다음 명령을 실행합니다.
 ```
 ./configure
 make
 ```
 그런 다음 Wine을 설치하거나
 ```
 make install
 ```
 또는 빌드 디렉터리에서 직접 Wine을 실행합니다.
 ```
 ./wine noetepad
 ```
-프로그램을 실행할 때는 "wine 프로그램명" 처럼 합니다.  더 자세한 정보 및
+프로그램을 실행할 때는 `wine 프로그램명` 처럼 합니다.  더 자세한 정보 및
 문제 해결 방법은 이 파일의 나머지 부분과 Wine 맨페이지를 참조하십시오.
 특히 https://www.winehq.org 사이트에 방대한 정보가 집약되어 있습니다.
-3. 빌드에 필요한 조건
+## 빌드에 필요한 조건
 Wine을 컴파일하고 실행하려면 다음 중 하나가 필요합니다.
-  리눅스 2.0.36 또는 그 이후
+- 리눅스 2.0.36 또는 그 이후
-  FreeBSD 8.0 또는 그 이후
+- FreeBSD 12.4 또는 그 이후
-  Solaris x86 9 또는 그 이후
+- Solaris x86 9 또는 그 이후
-  NetBSD-current
+- NetBSD-current
-  Mac OS X 10.8 또는 그 이후
+- Mac OS X 10.8 또는 그 이후
 Wine을 실행하려면 커널 차원의 스레드 지원이 필요하기 때문에 위에서 언급한
 운영 체제만 지원합니다.  커널 스레드를 지원하는 다른 운영 체제는 향후
 지원될 수 있습니다.
-FreeBSD 정보:
+**FreeBSD 정보**:
  Wine은 일반적으로 FreeBSD 8.0 이전 버전에서는 제대로 동작하지 않습니다.
  더 자세한 정보는 https://wiki.freebsd.org/Wine 페이지를 참조하십시오.
-Solaris 정보:
+**Solaris 정보**:
  거의 대부분의 경우 Wine을 빌드하려면 GNU 툴체인(gcc, gas 등)을 사용해야
  합니다.  경고: gas를 단순히 설치하기만 하면 gcc에서 사용되지 않을 수도
  있습니다.  gas를 설치한 다음 gcc를 재컴파일하거나 cc, as, ld 명령을 GNU
  바이너리로 심볼릭 링크할 필요가 있다고 합니다.
-NetBSD 정보:
+**NetBSD 정보**:
  USER_LDT, SYSVSHM, SYSVSEM, SYSVMSG 옵션이 커널에 포함되어야 합니다.
-Mac OS X 정보:
+**Mac OS X 정보**:
  Xcode/Xcode 명령 줄 도구 또는 Apple cctools가 필요합니다.  Wine을
  컴파일하려면 최소한 MacOSX10.10.sdk 포함 clang 3.8 및 mingw-w64 v8 이
  필요합니다.  MacOSX10.14.sdk 이상에서는 wine64만 빌드할 수 있습니다.
-
+**지원되는 파일 시스템**:
 지원되는 파일 시스템:
  Wine은 대부분의 파일 시스템에서 문제없이 실행됩니다.  Samba를 이용해서
  파일을 액세스하는 경우 몇 가지 호환성 문제가 보고되기도 했습니다.  또한,
  NTFS는 일부 프로그램에서 필요로 하는 파일 시스템 기능 전부를 제공하지는
  않습니다.  기본 Unix 파일 시스템을 사용하는 것이 좋습니다.
-
+**기본 요구 사항**:
 기본 요구 사항:
  X11 개발용 헤더 파일이 설치되어 있어야 합니다 (데비안에서는 xorg-dev,
  레드햇에서는 libX11-devel이란 패키지명으로 되어 있습니다).
-
+  당연히 make 프로그램도 필요합니다 (대부분 GNU make 사용).
  당연히 "make" 프로그램도 필요합니다 (대부분 GNU make 사용).
  flex 버전 2.5 이상과 bison이 필요합니다.
-
+**선택적 지원 라이브러리**:
-선택적 지원 라이브러리:
+  configure는 빌드 시스템에서 찾을 수 없는 선택적 라이브러리를 표시해
  "configure"는 빌드 시스템에서 찾을 수 없는 선택적 라이브러리를 표시해
  줍니다.  https://wiki.winehq.org/Recommended_Packages 에서 설치해야 하는
  패키지에 대한 힌트를 얻을 수 있습니다.  64비트 플랫폼에서는 이러한
  라이브러리의 32비트 버전을 설치해야 합니다.
-4. 컴파일하기
+## 컴파일하기
 Wine을 빌드하려면 다음 명령을 실행합니다.
 ```
 ./configure
 make
 ```
 이렇게 하면 "wine" 프로그램과 다수의 라이브러리/바이너리가 빌드됩니다.
 "wine" 프로그램은 Windows 실행 파일을 로드하고 실행하는 데 사용됩니다.
 "libwine" 라이브러리("Winelib")는 Windows 소스 코드를 유닉스 상에서
 컴파일하고 링크하는 용도로 사용할 수 있습니다.
-컴파일 설정 옵션을 보려면 ./configure --help 명령을 사용합니다.
+컴파일 설정 옵션을 보려면 `./configure --help` 명령을 사용합니다.
 자세한 내용은 https://wiki.winehq.org/Building_Wine 을 참조하십시오.
-5. 설정
+## 설정
-Wine을 정상적으로 빌드한 다음에는 "make install" 명령으로 실행 파일과
+Wine을 정상적으로 빌드한 다음에는 `make install` 명령으로 실행 파일과
 라이브러리, Wine 맨페이지, 기타 필요한 파일을 시스템에 설치할 수 있습니다.
 설치하기 전 이전 버전의 Wine을 제거해야 한다는 점을 잊지 마시기 바랍니다.
-"dpkg -r wine" 또는 "rpm -e wine" 또는 "make uninstall" 등의 명령으로 이전
+`dpkg -r wine` 또는 `rpm -e wine` 또는 `make uninstall` 등의 명령으로 이전
 버전을 제거할 수 있습니다.
-설치가 끝나면 "winecfg" 설정 도구를 실행할 수 있습니다.  설정 관련 힌트는
+설치가 끝나면 `winecfg` 설정 도구를 실행할 수 있습니다.  설정 관련 힌트는
 https://www.winehq.org/ 의 Support 페이지를 참조하십시오
-6. 프로그램 실행
+## 프로그램 실행
 Wine을 실행할 때 실행 파일의 전체 경로를 지정할 수도 있고 파일명만 지정할
 수도 있습니다.
 예를 들어 메모장을 실행하려면:
-	wine notepad                     (파일을 찾기 위해 레지스트리에
+```
-	wine notepad.exe                  지정된 검색 경로를 이용)
+wine notepad                     (파일을 찾기 위해 레지스트리에
 wine notepad.exe                  지정된 검색 경로를 이용)
-	wine c:\\windows\\notepad.exe                 (DOS 파일명 사용)
+wine c:\\windows\\notepad.exe                 (DOS 파일명 사용)
-	wine ~/.wine/drive_c/windows/notepad.exe   (유닉스 파일명 사용)
+wine ~/.wine/drive_c/windows/notepad.exe   (유닉스 파일명 사용)
-        wine notepad.exe readme.txt      (프로그램에 매개변수를 넘겨줌)
+wine notepad.exe readme.txt      (프로그램에 매개변수를 넘겨줌)
 ```
 Wine은 아직 완성 단계에 도달하지 못했기 때문에 프로그램이 제대로 실행되지
 않을 수 있습니다.  프로그램이 죽었을 경우 버그 보고서에 첨부해야 하는 충돌
 로그가 생성됩니다.
-7. 더 자세한 정보
+## 더 자세한 정보
-WWW:    여러 종류의 Wine 가이드, 애플리케이션 데이터베이스, 버그 추적 등
+- **WWW**: 여러 종류의 Wine 가이드, 애플리케이션 데이터베이스, 버그 추적 등
        Wine에 대한 많은 정보를 https://www.winehq.org/ 에 있는 WineHQ
        사이트에서 얻을 수 있습니다.  정보를 찾을 때 대개 이 사이트가
        최고의 출발점이 됩니다.
-FAQ:    Wine FAQ는 https://www.winehq.org/FAQ 에 있습니다.
+- **FAQ**: Wine FAQ는 https://www.winehq.org/FAQ 에 있습니다.
-위키:	Wine 위키는 https://wiki.winehq.org 에 있습니다.
+- **위키**: Wine 위키는 https://wiki.winehq.org 에 있습니다.
-메일링 리스트:
+- **Gitlab**: https://gitlab.winehq.org
 - **메일링 리스트**:
        Wine 사용자와 개발자를 위해 메일링 리스트가 운영되고 있습니다.  더
        자세한 정보는 https://www.winehq.org/forums 를 참조하기 바랍니다.
-Bugs:   https://bugs.winehq.org 의 Wine Bugzilla에 버그를 보고하십시오.
+- **Bugs**: https://bugs.winehq.org 의 Wine Bugzilla에 버그를 보고하십시오.
        버그 보고서를 제출하기 전에 같은 문제가 이미 제출된 적이 있는지
        Bugzilla 데이터베이스를 검색해 보시기 바랍니다.
-IRC:	irc.libera.chat 의 #WineHQ 채널에서 도움을 받을 수 있습니다.
+- **IRC**: irc.libera.chat 의 `#WineHQ` 채널에서 도움을 받을 수 있습니다.
 GIT:    Wine 개발 트리는 현재 GIT로 관리되고 있습니다.  더 자세한 정보는
 	https://www.winehq.org/git 를 참조하기 바랍니다.
 추가할 내용이나 수정할 버그가 있다면 다음번 릴리스에 포함될 수 있도록
 wine-devel@winehq.org 메일링 리스트로 (가급적이면 git-format-patch를
 사용해서 만든) 패치를 보내 주시기 바랍니다.
 --
 Alexandre Julliard
 julliard@winehq.org
 Translated into Korean by
 Bang Jun-Young
 junyoung@mogua.com
--- a/documentation/README-nl.md
+++ b/documentation/README-nl.md
@ -1,4 +1,4 @@
-1. INTRODUCTIE
+## INTRODUCTIE
 Wine is een programma wat het mogelijk maakt om Microsoft Windows
 programma's (waaronder uitvoerbare DOS, Windows 3.x, Win32 en Win64
@ -13,80 +13,83 @@ Wine is vrije software, uitgebracht onder de GNU LGPL. Zie het
 LICENCE bestand voor meer informatie.
-2. SNEL AAN DE SLAG
+## SNEL AAN DE SLAG
 Voer in de hoofdmap van de Wine broncode (waar het README bestand staat),
 het volgende uit:
 ```
 ./configure
 make
 ```
 Installeer daarna Wine met:
 ```
 make install
 ```
 Of voer Wine uit in de map waarin die gebouwd is:
 ```
 ./wine notepad
 ```
-Programma's kunnen uitgevoerd worden met "wine programma". Lees voor meer
+Programma's kunnen uitgevoerd worden met `wine programma`. Lees voor meer
 informatie en het oplossingen van problemen de rest van dit bestand, de
 man pagina's van Wine en vooral de overvloed aan informatie op
 https://winehq.org .
-3. BENODIGDHEDEN
+## BENODIGDHEDEN
 Om Wine te kunnen compileren en uit te voeren, is één van het volgende
 besturingssystemen nodig:
-  Linux versie 2.0.36 of nieuwer
+- Linux versie 2.0.36 of nieuwer
-  FreeBSD 8.0 of nieuwer
+- FreeBSD 12.4 of nieuwer
-  Solaris x86 9 of nieuwer
+- Solaris x86 9 of nieuwer
-  NetBSD-current
+- NetBSD-current
-  Mac OS X 10.8 of nieuwer
+- Mac OS X 10.8 of nieuwer
 Omdat Wine threadondersteuning op kernelniveau vereist, worden alleen de
 bovenstaande besturingssystemen ondersteund. Andere besturingssystemen
 die threadondersteuning op kernelniveau hebben, kunnen mogelijk in de
 toekomst ook ondersteund worden.
-FreeBSD informatie:
+**FreeBSD informatie**:
-  Over het algemeen werkt Wine niet goed op versies die ouder zijn dan
+  Zie https://wiki.freebsd.org/Wine voor meer informatie.
  FreeBSD 8.0. Zie https://wiki.freebsd.org/Wine voor meer informatie.
-Solaris informatie:
+**Solaris informatie**:
  Hoogst waarschijnlijk moet Wine gebouwd worden met de GNU toolchain
  (gcc, gas, enz.). Waarschuwing: het installeren van gas houdt *niet*
  in dat het gebruikt wordt door gcc. Hercompileren van gcc nadat gas
  is geïnstalleerd of symbolische verwijzingen maken voor cc, as en
  ld naar de gnu-tools is waarschijnlijk noodzakelijk.
-NetBSD informatie:
+**NetBSD informatie**:
  Zorg er voor dat de volgende opties aan staan in de kernel: USER_LDT,
  SYSVSHM, SYSVSEM, en SYSVMSG.
-Mac OS X informatie:
+**Mac OS X informatie**:
  Xcode/Xcode Command Line Tools of Apple cctools zijn nodig. De minimale
  vereisten om Wine te kunnen compileren zijn clang 3.8 met MacOSX10.10.sdk
  en mingw-w64 v8. MacOSX10.14.sdk en nieuwer kunnen alleen wine64 bouwen.
-Ondersteunde bestandssystemen:
+**Ondersteunde bestandssystemen**:
  Wine zou op de meeste bestandssystemen uitgevoerd moeten kunnen worden.
  Er zijn enkele compatibiliteitsproblemen bekend met bestanden die via
  Samba worden benaderd. Ook heeft NTFS niet alle bestandssysteemopties die
  nodig zijn met sommige programma's. Een oorspronkelijk Unix
  bestandssysteem wordt aangeraden.
-Basis benodigdheden:
+**Basis benodigdheden**:
  De X11-ontwikkel-bestanden moeten geïnstalleerd zijn. (Voor Debian is dat
  pakket xorg-dev in RedHat is dit libX11-devel).
-
+  Natuurlijk is ook make nodig. (Hoogst waarschijnlijk GNU make.)
  Natuurlijk is ook "make" nodig. (Hoogst waarschijnlijk GNU make.)
  Ook zijn bison en flex versie 2.5.33 of nieuwer nodig.
-Optionele bibliotheken:
+**Optionele bibliotheken**:
  Tijdens het uitvoeren van ./configure wordt er aangegeven of de optionele
  bibliotheken zijn gevonden op het systeem. Bekijk
  https://wiki.winehq.org/Building_Wine voor meer informatie over welke
@ -94,12 +97,14 @@ Optionele bibliotheken:
  moeten ook de 32-bit versies van deze pakketten geïnstalleerd worden.
-4. COMPILEREN
+## COMPILEREN
 Om Wine te bouwen, voer het volgende uit:
 ```
 ./configure
 make
 ```
 Hiermee wordt het programma "wine" en talrijke ondersteunende bibliotheken
 en uitvoerbare bestanden gemaakt. Het programma "wine" laadt en voert de
@ -107,75 +112,68 @@ uitvoerbare Windows bestanden uit.
 De bibliotheek "libwine" ("Winelib") kan worden gebruikt om Windows
 broncode te compileren en te linken in Unix.
-Voor alle opties tijdens het compileren, voer ./configure --help uit.
+Voor alle opties tijdens het compileren, voer `./configure --help` uit.
 Voor meer informatie bekijk: https://wiki.winehq.org/Building_Wine
-5. SETUP
+## SETUP
 Wanneer Wine goed in elkaar is gezet, kan Wine geïnstalleerd worden met
-"make install". Deze opdracht installeert het uitvoerbare wine bestand,
+`make install`. Deze opdracht installeert het uitvoerbare wine bestand,
 de bibliotheken, de Wine man pagina's en alle andere benodigde bestanden.
 Vergeet niet om eerst elke tegenstrijdige Wine installatie te verwijderen.
-Dit kan voor de installatie met "dpkg -r wine", "rpm -e wine" of met
+Dit kan voor de installatie met `dpkg -r wine`, `rpm -e wine` of met
-"make uninstall"
+`make uninstall`
-Eenmaal geïnstalleerd, kan het configuratie programma "winecfg" worden
+Eenmaal geïnstalleerd, kan het configuratie programma `winecfg` worden
 uitgevoerd. Bekijk de Support pagina op https://www.winehq.org/ voor
 configuratiehints.
-6. PROGRAMMA'S UITVOEREN
+## PROGRAMMA'S UITVOEREN
 Bij het gebruiken van Wine kan het gehele pad naar het uitvoerbare bestand
 worden gebruikt of alleen de bestandsnaam.
 Voorbeeld: het Kladblok (Notepad) uitvoeren:
-    wine notepad           (gebruikt het zoek-pad, zoals in het register is
+```
-    wine notepad.exe        opgegeven, om het bestand te vinden)
+wine notepad           (gebruikt het zoek-pad, zoals in het register is
 wine notepad.exe        opgegeven, om het bestand te vinden)
-    wine c:\\windows\\notepad.exe    (met een DOS bestandsnaam constructie)
+wine c:\\windows\\notepad.exe    (met een DOS bestandsnaam constructie)
-    wine ~/.wine/drive_c/windows/notepad.exe         (een Unix constructie)
+wine ~/.wine/drive_c/windows/notepad.exe         (een Unix constructie)
-    wine notepad.exe readme.txt              (een programma met parameters)
+wine notepad.exe readme.txt              (een programma met parameters)
 ```
 Wine is niet perfect. Dus sommige programma's kunnen crashen. Als dat
 gebeurd komt er een logboek van de crash. Deze kan bijgevoegd worden als de
 fout wordt gerapporteerd.
-7. MEER INFORMATIE
+## MEER INFORMATIE
-WWW:    Een grote verscheidenheid aan informatie voor Wine is beschikbaar
+- **WWW**: Een grote verscheidenheid aan informatie voor Wine is beschikbaar
        gemaakt door WineHQ op https://www.winehq.org/ : verschillende
        handleidingen, programma database, bug tracking. Dit is
        waarschijnlijk de beste plek om te beginnen.
-FAQ:    Veel vragen over Wine zijn te vinden op https://www.winehq.org/FAQ
+- **FAQ**: Veel vragen over Wine zijn te vinden op https://www.winehq.org/FAQ
-Wiki:   De Wine-Wiki staat op https://wiki.winehq.org
+- **Wiki**: De Wine-Wiki staat op https://wiki.winehq.org
-Mail-lijsten:
+- **Gitlab**: https://gitlab.winehq.org
 - **Mail-lijsten**:
        Er zijn meerdere mail-lijsten voor gebruikers en ontwikkelaars van
        Wine. Bekijk https://www.winehq.org/forums voor meer informatie.
-Fouten: Op https://bugs.winehq.org kunnen fouten gemeld worden aan de Wine
+- **Fouten**: Op https://bugs.winehq.org kunnen fouten gemeld worden aan de Wine
        Bugzilla. Doorzoek eerst de database van bugzilla om te kijken of
        de fout al bekend of gerepareerd is voordat de fout gemeld wordt.
-IRC:    Online hulp is beschikbaar in kanaal #WineHQ op irc.libera.chat
+- **IRC**: Online hulp is beschikbaar in kanaal `#WineHQ` op irc.libera.chat
 Git:    De huidige ontwikkeling van Wine is beschikbaar op Git. Bezoek
        https://www.winehq.org/git voor meer informatie.
 Om iets toe te voegen aan de volgende uitgave van Wine of om een fout op te
 lossen, stuur een patch (de voorkeur heeft een git-format-patch) naar de
 wine-devel@winehq.org lijst.
 --
 Alexandre Julliard
 julliard@winehq.org
--- a/documentation/README-no.md
+++ b/documentation/README-no.md
@ -1,4 +1,4 @@
-1. INTRODUKSJON
+## INTRODUKSJON
 Wine er et program som gjør det mulig å kjøre Windows-programmer
 (inkludert DOS, Windows 3.x, Win32 og Win64) i Unix. Det består av en
@ -11,71 +11,70 @@ Wine er fri programvare, utgitt under vilkårene i GNU LGPL; se
 filen «LICENSE» for detaljer.
-2. KOM I GANG
+## KOM I GANG
 Det anbefales å bruke Wines installasjonsprogram for å bygge og
 installere Wine når det bygges fra kildekode. Kjør følgende i
 rotkatalogen til Wine-kildekoden
-./tools/wineinstall
+```
 ./configure
 make
 ```
-Kjør programmer som «wine program». Se resten av denne filen,
+Kjør programmer som `wine program`. Se resten av denne filen,
 Wines man-side og https://www.winehq.org/ for mer informasjon og
 problemløsing.
-3. SYSTEMKRAV
+## SYSTEMKRAV
 Følgende kreves for å bygge og kjøre Wine:
-  Linux versjon 2.0.36 eller nyere
+- Linux versjon 2.0.36 eller nyere
-  FreeBSD 8.0 eller nyere
+- FreeBSD 12.4 eller nyere
-  Solaris x86 9 eller nyere
+- Solaris x86 9 eller nyere
-  NetBSD-current
+- NetBSD-current
-  Mac OS X 10.8 eller nyere
+- Mac OS X 10.8 eller nyere
 Wine krever støtte for tråder på kjernenivå, og derfor er det bare
 operativsystemene ovenfor som støttes. Andre operativsystemer som
 støtter kjernetråder støttes kanskje i framtiden.
-Informasjon for FreeBSD:
+**Informasjon for FreeBSD**:
  Wine vil som regel ikke virke på FreeBSD-versjoner eldre enn 8.0.
  Se <https://wiki.freebsd.org/Wine> for mer informasjon.
-Informsjon for Solaris:
+**Informsjon for Solaris**:
  Wine må antakelig bygges med GNU-verktøyene (gcc, gas etc.).
  Advarsel: selv om gas installeres er det ikke sikkert det brukes av
  gcc. Det sies at gcc må bygges på nytt, eller at symbolske
  koblinger for «cc», «as» og «ld» må legges til GNU-verktøyene.
-Informasjon for NetBSD:
+**Informasjon for NetBSD**:
  USER_LDT, SYSVSHM, SYSVSEM og SYSVMSG må være aktivert i kjernen.
-Informasjon for Mac OS X:
+**Informasjon for Mac OS X**:
  Du må ha Xcode/Xcode Command Line Tools eller Apple cctools.
  Minimumskravet for å bygge Wine er clang 3.8 med MacOSX10.10.sdk og
  mingw-w64 v8. MacOSX10.14.sdk eller nyere kan bare bygge wine64.
-
+**Støttede filsystemer**:
 Støttede filsystemer:
  Wine kan kjøre på de fleste filsystemer. Det har imidlertid vært
  rapportert om problemer med filtilgang gjennom Samba. Vi anbefaler
  ikke bruk av NTFS, siden dette ikke støtter funksjoner som noen
  programmer trenger. Det anbefales å bruke et ekte Unix-filsystem.
-Basiskrav:
+**Basiskrav**:
  Inkluderingsfilene for X11 må være installert (kalt «xorg-dev» i
  Debian og «libX11-devel» i RedHat).
  Du må selvfølgelig også ha «make», sannsynligvis «GNU make».
  flex 2.5.33 eller nyere og bison er også nødvendig.
-Valgfrie støttebiblioteker:
+**Valgfrie støttebiblioteker**:
  configure-skriptet viser meldinger når valgfrie biblioteker ikke blir
  funnet. Se https://wiki.winehq.org/Recommended_Packages for info om
  hvilke pakker du bør installere.
  På 64 bit-systemer trenger du 32 bit-versjoner av disse bibliotekene
  hvis du skal bygge Wine som et 32 bit-program (standard);
  se https://wiki.winehq.org/WineOn64bit for flere detaljer.
@ -83,88 +82,76 @@ Valgfrie støttebiblioteker:
  med blandet 32 bit og 64 bit) kan du lese mer på
  https://wiki.winehq.org/Wine64
-4. BYGGING
+## BYGGING
 Kjør følgende kommandoer for å bygge Wine hvis du ikke bruker wineinstall:
 ```
 ./configure
 make
 ```
 Dette bygger programmet «wine» og diverse støttebiblioteker/programfiler.
 Programfilen «wine» laster og kjører Windows-programmer.
 Biblioteket «libwine» («Winelib») kan brukes til å bygge og koble
 Windows-kildekode i Unix.
-Kjør «./configure --help» for å se valg for bygging.
+Kjør `./configure --help` for å se valg for bygging.
-5. INSTALLASJON
+## INSTALLASJON
-Når Wine er bygget kan du kjøre «make install» for å installere det;
+Når Wine er bygget kan du kjøre `make install` for å installere det;
 dette installerer også man-siden og noen andre nødvendigheter.
 Ikke glem å avinstallere tidligere Wine-versjoner først. Prøv enten
-«dpkg -r wine», «rpm -e wine» eller «make uninstall» før installsjonen.
+`dpkg -r wine`, `rpm -e wine` eller `make uninstall` før installsjonen.
-Når Wine er installert kan du bruke oppsettsverktøyet «winecfg».
+Når Wine er installert kan du bruke oppsettsverktøyet `winecfg`.
 Se støtteområdet på https://www.winehq.org/ for hint om oppsett.
-6. KJØRING AV PROGRAMMER
+## KJØRING AV PROGRAMMER
 Når du bruker Wine kan du oppgi hele stien til programfilen, eller bare
 et filnavn.
 Eksempel: for å kjøre Notisblokk:
-        wine notepad                   (ved å bruke søkestien oppgitt i
+```
-        wine notepad.exe                Wine-registeret for å finne filen)
+wine notepad                   (ved å bruke søkestien oppgitt i
 wine notepad.exe                Wine-registeret for å finne filen)
-        wine c:\\windows\\notepad.exe  (bruk av DOS-filbaner)
+wine c:\\windows\\notepad.exe  (bruk av DOS-filbaner)
        wine ~/.wine/drive_c/windows/notepad.exe  (bruk av Unix-filbaner)
        wine notepad.exe readme.txt  (kjøre programmer med parametere)
 wine ~/.wine/drive_c/windows/notepad.exe  (bruk av Unix-filbaner)
 wine notepad.exe readme.txt  (kjøre programmer med parametere)
 ```
 Wine er ikke helt ferdig ennå, så det er mulig at noen programmer klikker.
 Hvis dette skjer vil Wine lage en krasjlogg som du bør vedlegge til rapporten
 når du rapporterer en feil.
-7. MER INFORMASJON
+## MER INFORMASJON
-Internett: En god del informasjon om Wine finnes hos WineHQ på
+- **Internett**: En god del informasjon om Wine finnes hos WineHQ på
           https://www.winehq.org/ : diverse veiledere, en programdatabase
           og feilsporing. Dette er antakelig det beste stedet å begynnne.
-Svar:      Wines spørsmål og svar finnes på https://www.winehq.org/FAQ
+- **Svar**: Wines spørsmål og svar finnes på https://www.winehq.org/FAQ
-Wiki:      Wines Wiki er tilgjengelig på https://wiki.winehq.org
+- **Wiki**: Wines Wiki er tilgjengelig på https://wiki.winehq.org
-E-postlister:
+- **Gitlab**: https://gitlab.winehq.org
 - **E-postlister**:
           Det finnes flere e-postlister for Wine-utviklere og -brukere;
           besøk https://www.winehq.org/forums for mer informasjon.
-Feil:      Rapporter feil til Wines Bugzilla på https://bugs.winehq.org
+- **Feil**: Rapporter feil til Wines Bugzilla på https://bugs.winehq.org
           Søk i Bugzilla-databasen og se om probelmet allerede er funnet
           før du sender en feilrapport.
-IRC:       Nødhjelp er tilgjengelig på kanalen #WineHQ på
+- **IRC**: Nødhjelp er tilgjengelig på kanalen `#WineHQ` på
           irc.libera.chat.
 Git:       Wines oppdaterte utvikler-versjon er tilgjengelig gjennom GIT.
           Gå til https://www.winehq.org/git for mer informasjon.
 Hvis du legger til noe eller fikser en feil er det fint som du sender
 en oppdateringsfil (helst laget med git format-patch) til listen
 wine-devel@winehq.org, slik at endringen kan tas med i neste Wine-utgivelse.
 --
 Den originale versjonen ble skrevet av
 Alexandre Julliard
 julliard@winehq.org
 Oversettelse til norsk (bokmål) av
 Alexander N. Sørnes
 alex@thehandofagony.com
--- a/documentation/README-pt.md
+++ b/documentation/README-pt.md
@ -1,4 +1,4 @@
-1. INTRODUÇÃO
+## INTRODUÇÃO
 Wine é um programa que permite correr programas Microsoft Windows
 (incluindo DOS, Windows 3.x e Win32 executáveis) em Unix.
@ -10,58 +10,52 @@ pode ser usada para "porting" Win32 código para executáveis do nativo Unix .
 Wine é software grátis,autorizado segundo a GNU LGPL; ver o ficheiro
 LICENÇA para os detalhes.
-2.ARRANQUE RÁPIDO
+## ARRANQUE RÁPIDO
 Sempre que se compila da source, é recomendado que se use o Wine
 Installer para construir e instalar o Wine. Desde a primeira directoria
 do Wine source (que contém este ficheiro),corre:
-./tools/wineinstall
+```
 ./configure
 make
 ```
-Corre os programas conforme as "wine [options] program". Para mais
+Corre os programas conforme as `wine program`. Para mais
 informações e resoçução de problemas. Lê o resto deste ficheiro, a Wine
 man page, e especialmente a abundância de informação  encontrada em
 https://www.winehq.org.
-3.REQUERIMENTOS
+## REQUERIMENTOS
 Para compilar e correr o Wine, deves ter o seguinte:
-		Linux version 2.0.36 ou superior
+- Linux version 2.0.36 ou superior
-		FreeBSD 5.3 ou seguinte
+- FreeBSD 12.4 ou seguinte
-		Solaris x86 2.5 ou seguinte
+- Solaris x86 9 ou seguinte
-		NetBSD-current
+- NetBSD-current
 - Mac OS X 10.8 ou seguinte
 Como o Wine requer sequências kernel-level para poder correr, apenas
 os sistemas operativos acima mencionados são suportados.
 Outros sistemas operativos que suportam sequências kernel, talvez
 venham a ser suportados no futuro.
-Linux info:
+**FreeBSD info**:
 Enquanto o Linux 2.2.x irá sobretudo trabalhar e Linux 2.0.x poderá
 irá contudo trabalhar (versões 2.0.x antigas tem mal funcionamento
 relacionados a tarefas), será muito melhor teres um kernel atualizado
 como 2.4.x.
 FreeBSD info:
 Wine deverá construir no FreeBSD 4.x e FreeBSD 5.x, mas versões anteriores
 a FreeBSD 5.3 geralmente não trabalham corretamente.
 Mais informações encontra-se em:
 ftp://ftp.freebsd.org/pub/FreeBSD/ports/ports/emulators/wine/
-
+**Solaris info**:
 Solaris info:
 Tu irás provavelmente ter que construir o Wine com as ferramentas GNU
 (gcc, gas, etc.). Aviso: ao instalar gas *não* assegura que será usado
 pelo gcc. Recompilar o gcc depois de instalar o gas ou symking cc, as e
 ld para as ferramentas gnu é dito que é necessário.
-NetBSD info:
+**NetBSD info**:
 Certifica-te que tens as opções USER_LDT, SYSVSHM, SYSVSEM, e SYSVMSG
 ligadas ao teu kernel.
-File systems info:
+**File systems info**:
 O Wine deverá correr na maioria dos file systems. Contudo, o Wine falha
 no aranque se umsdos é usado para a directoria /tmp. Alguns problemas de
 compatibilidades foram relatados estando a usar ficheiros acessados
@ -71,95 +65,71 @@ NTFS. Como os programas de Windows precisam de acesso write em quase tudo.
 No caso de NTFS files, copia por cima para uma localização em que se
 possa escrever.
-Requisitos básicos:
+**Requisitos básicos**:
 Tu precisas de ter instalados os fucheiros de include do X11 development
 (chamados xorg-dev em Debian e libX11-devel no RedHat).
-Requisitos para as ferramentas de construção:
+**Requisitos para as ferramentas de construção**:
 Em sistemas x86 o gcc >= 2.7.2 é requerido.
 Versões anteriores à 2.7.2.3 poderão ter problemas quando certos
 ficheiros são compilados com optimização, frequentemente devido a
 problemas relacionados com as gestôes dos cabeçalhos dos ficheiros.
 Actualmente o pgcc não trabalha com o Wine. A causa deste problema é
 desconhecida.
-
+Claro que também precisas fazer make (geralmente como o GNU make).
 Claro que também precisas fazer "make" (geralmente como o GNU make).
 Tu também necessitas do flex versao 2.5 ou superior e o bison.
 Se estiveres a usar RedHat ou Debian, instala os pacotes do flex e do bison.
-Bibliotecas de suporte opcionais:
+**Bibliotecas de suporte opcionais**:
 Se desejares suporte de impressão do CUPS, por favor instala os pacotes
 cups e cups-devel.
-4.COMPILAÇÃO
+## COMPILAÇÃO
 No caso de escolheres não usar wineinstall, corre os seguintes comandos
 para contruir o Wine:
 ```
 ./configure
 make depend
 make
 ```
 Isto irá contruir o programa "wine" e numerosos suportes livraris/binarios.
 O programa "wine" irá carregar e correr executaveis do Windows.
 A livraria "libwine" ("winelib") pode ser usada para compilar e ligar
 Windows source code sob o Unix.
-Para ver as opções de compilação da configuração, faz ./configure -help.
+Para ver as opções de compilação da configuração, faz `./configure -help`.
-Para fazeres o upgrade de uma nova versão atravez de um ficheiro patch,
+## SETUP
 primeiro cd para a directoria top da distribuição (a que contem este
 ficheiro README). A seguir faz um "make clean", e faz o patch da
 distribuição com:
-	gunzip -c patch-file | patch -p1
+Uma vez o Wine contruido correctamente, tu podes entao fazer o `make
-
+install`; isto irá instalar o wine executavel, o Wine man page, e alguns
 onde "patch-file" é o nome do ficheiro patch ( qualquer coisa como
 Wine.yymmdd.diff.gz). Tu podes entao correr fazendo "./configure", e
 depois corre "make depend && make"
 5.SETUP
 Uma vez o Wine contruido correctamente, tu podes entao fazer o "make
 install"; isto irá instalar o wine executavel, o Wine man page, e alguns
 outros ficheiros necessários.
 Não esquecer de primeiro desinstalar qualquer previo conflito relativo a
 instalação do Wine.
-Tenta outro "dpkg -r wine" ou "rpm -e wine" ou "make uninstall" antes de
+Tenta outro `dpkg -r wine` ou `rpm -e wine` ou `make uninstall` antes de
 installar.
 Ver https://www.winehq.org/support/ para informação sobre a
 configuraçao.
-No caso da livraria carregar erros (e.g. "Error while loading shared
+## CORRER PROGRAMAS
 libraries: libntdll.so"), tem a certeza de adicionar o caminho da
 livraria para /etc/ld.so.conf e correr ldconfig como root.
 Para verificar a correcção do ambiente, tu precisas para que o Wine
 corra com sucesso, tu podes correr "./tools/winecheck | less".
 Tu irás obter uma percentagem do resultado indicando "Wine configuration
 correctness".
 Como este programa é alpha, ainda não correu um verdadeiro e exaustivo
 teste, onde, então deve ser levado apenas como um primeiro passo de
 verificação.
 Ver wine.confman page, como se muda apenas para o suporte em modo texto
 se desejado.
 6.CORRER PROGRAMAS
 Quando e invoca o Wine, tens que especificar o caminho (patch) complecto
 do executavel, ou apenas o nome do ficheiro.
-Por exemplo:  para correr o Solitário:
+Por exemplo:
 	wine sol			(usando o searchpatch para lozalizar o ficheiro)
 	wine sol.exe
-	wine c:\\windows\\sol.exe	(usando um nome de ficheiro DOS)
+```
 wine notepad			(usando o searchpatch para lozalizar o ficheiro)
 wine notepad.exe
-	wine /usr/windows/sol.exe	(usando um nome de ficheiro Unix)
+wine c:\\windows\\notepad.exe	(usando um nome de ficheiro DOS)
 wine ~/.wine/drive_c/windows/notepad.exe  (usando um nome de ficheiro Unix)
 ```
 Nota: o caminho do ficheiro também irá ser adicionado ao caminho(patch)
 quando um nome complecto é fornecido na linha de comando.
@ -182,28 +152,21 @@ maneira. Este caso particular de corrupeçao (!$!$!$!$.pfr) podem ao
 menos parcialmente podem ser corrigidos usando
 http://home.nexgo.de/andi.mohr/download/decorrupt_explorer
-7.ARRANJAR MAIS INFORMAÇÃO
+## ARRANJAR MAIS INFORMAÇÃO
-www:	Uma grande quantidade de informação acerca do Wine está disponivel
+- **www**: Uma grande quantidade de informação acerca do Wine está disponivel
        pelo WineHQ em https://www.winehq.org/ : varios guias Wine, base de
        dados de aplicações, localizaçao de erros. Isto é provavelmente o
        melhor ponto de começo.
-FAQ:	A Wine FAQ está localizada em https://www.winehq.org/FAQ
+- **FAQ**: A Wine FAQ está localizada em https://www.winehq.org/FAQ
-Usenet:	Tu podes discutor tópicos relacionados de Wine e obter ajuda em
+- **Wiki**: https://wiki.winehq.org
 	comp.emulators.ms-windows.wine.
-IRC:	Ajuda online está disponivel em #WineHQ on irc.libera.chat.
+- **Gitlab**: https://gitlab.winehq.org
-
+- **Mailing Lists**:
 Git:	O currente desenvolvimento do Wine está disponivel por Git.
 	Vai a https://www.winehq.org/git para mais informação.
 Mailing Lists:
 	Há algumas mailing list para responsaveis pelo desenvolvimento Wine; ver em
 	https://www.winehq.org/forums para mais informação.
-Se tu acrescentaste algo,ou corrigiste um bug, por favor envia um patch
+- **IRC** Ajuda online está disponivel em `#WineHQ` on irc.libera.chat.
 (em 'diff -u' format) para wine-devel@winehq.org lista para inclusão
 no próximo lançamento.
--- a/documentation/README-pt_br.md
+++ b/documentation/README-pt_br.md
@ -1,4 +1,4 @@
-1. INTRODUÇÃO
+## INTRODUÇÃO
 Wine é um programa que permite executar programas Microsoft Windows
 (incluindo executáveis DOS, Windows 3.x, Win32 e Win64) no Unix.
@ -12,74 +12,72 @@ Wine é software livre, liberado segundo a GNU LGPL; veja o arquivo
 LICENSE para detalhes.
-2. INÍCIO RÁPIDO
+## INÍCIO RÁPIDO
 Sempre que se compilam os fontes, é recomendado usar o Wine Installer
 para construir e instalar o Wine. Estando no diretório de mais alto
 nível do código fonte do Wine, execute:
-./tools/wineinstall
+```
 ./configure
 make
 ```
-Execute programas conforme "wine programa". Para maiores informações
+Execute programas conforme `wine programa`. Para maiores informações
 e resolução de problemas, leia o restante deste arquivo, a página
 "man" do Wine (man wine), e especialmente a abundância de informação
 encontrada em https://www.winehq.org.
-3. REQUERIMENTOS
+## REQUERIMENTOS
 Para compilar e executar o Wine, você deve ter o seguinte:
-		Linux versão 2.0.36 ou posterior
+- Linux versão 2.0.36 ou posterior
-		FreeBSD 8.0 ou posterior
+- FreeBSD 12.4 ou posterior
-		Solaris x86 9 ou posterior
+- Solaris x86 9 ou posterior
-		NetBSD-atual
+- NetBSD-atual
-		Mac OS X 10.5 ou posterior
+- Mac OS X 10.8 ou posterior
 Como o Wine requer suporte a tarefas no nível de kernel para executar,
 somente os sistemas operacionais acima mencionados são suportados.
 Outros sistemas operacionais que suportarem tarefas do kernel poderão
 ter suporte no futuro.
-Informações para o FreeBSD:
+**Informações para o FreeBSD**:
  O Wine em geral não deve funcionar corretamente em versões antes da 8.0.
  Veja https://wiki.freebsd.org/Wine para mais informações.
-Informações para o Solaris:
+**Informações para o Solaris**:
  Você provavelmente necessitará construir o Wine com as ferramentas GNU
  (gcc, gas, etc.). Aviso: instalar gas NÃO assegura que será usado pelo
  gcc. Recompilar o gcc depois de instalar o gas ou criar uma ligação ao
  cc, as e ld para as ferramentas gnu é dito ser necessário.
-Informações para o NetBSD:
+**Informações para o NetBSD**:
  Certifique-se de ter as opções USER_LDT, SYSVSHM, SYSVSEM, e SYSVMSG
  ligadas no kernel.
-Informações para Mac OS X:
+**Informações para Mac OS X**:
  Será necessário o Xcode 2.4 ou superior para compilar corretamente no x86.
  O driver gráfico Mac requer OS X 10.6 ou superior e não será usado no 10.5.
-
+**Sistemas de arquivo suportados**:
 Sistemas de arquivo suportados:
  O Wine deve rodar na maioria dos sistemas de arquivos. Alguns problemas de
  compatibilidade foram reportados quando usado via Samba. Além disso, o NTFS
  não provê todas as funcionalidades necessárias para alguns aplicativos.
  Usar uma partição nativa Unix é recomendado.
-Requisitos básicos:
+**Requisitos básicos**:
  Você necessita ter instalados os arquivos de inclusão para desenvolvimento
  do X11 (chamados de xorg-dev no Debian e libX11-devel no RedHat).
-
+  Obviamente você também irá precisar do make (comumente o GNU make).
  Obviamente você também irá precisar do "make" (comumente o GNU make).
  Também será necessário o flex versão 2.5.33 ou superior e o bison.
-Bibliotecas de suporte opcionais:
+**Bibliotecas de suporte opcionais**:
  O script configure irá mostrar diversas mensagens quando bibliotecas
  opcionais não forem encontradas no seu sistema.
  Veja https://wiki.winehq.org/Recommended_Packages para dicas sobre
  pacotes que você pode instalar.
  Em plataformas de 64 bits, se compilar Wine como 32 bits (padrão), você
  precisa assegurar que as versões 32 bits das bibliotecas estão instaladas,
  veja https://wiki.winehq.org/WineOn64bit para mais detalhes.
@ -87,97 +85,83 @@ Bibliotecas de suporte opcionais:
  32 e 64 bits) veja https://wiki.winehq.org/Wine64 para mais detalhes.
-4. COMPILAÇÃO
+## COMPILAÇÃO
 No caso de escolher não usar o wineinstall, execute os comandos a seguir
 para construir o Wine:
 ```
 ./configure
 make
 ```
 Isto construirá o programa "wine" e vários binários/bibliotecas de suporte.
 O programa "wine" carregará e executará executáveis do Windows.
 A biblioteca "libwine" ("Winelib") pode ser usada para compilar e ligar
 código-fonte do Windows sob o Unix.
-Para ver as opções de compilação da configuração, rode ./configure --help.
+Para ver as opções de compilação da configuração, rode `./configure --help`.
-5. CONFIGURAÇÃO
+## CONFIGURAÇÃO
 Uma vez que o Wine esteja construído corretamente, você pode executar
-"make install"; assim irá instalar o executável do wine, as páginas
+`make install`; assim irá instalar o executável do wine, as páginas
 "man" do Wine, e outros arquivos necessários.
 Não esqueça de desinstalar primeiramente qualquer instalação prévia do
-Wine que possa ser conflitante. Tente tanto "dpkg -r wine", "rpm -e wine"
+Wine que possa ser conflitante. Tente tanto `dpkg -r wine`, `rpm -e wine`
-ou "make uninstall" antes de instalar.
+ou `make uninstall` antes de instalar.
-Depois de instalado, pode-se executar o programa de configuração "winecfg".
+Depois de instalado, pode-se executar o programa de configuração `winecfg`.
 Veja a área de suporte em https://www.winehq.org/ para dicas de configuração.
-6. EXECUTANDO PROGRAMAS
+## EXECUTANDO PROGRAMAS
 Ao invocar o Wine, você pode especificar o caminho completo do executável,
 ou somente um nome de arquivo.
 Por exemplo, para executar o bloco de notas:
-	wine notepad                    (usando o caminho de pesquisa como
+```
-	wine notepad.exe                 especificado no registro para
+wine notepad                    (usando o caminho de pesquisa como
-	                                 encontrar o arquivo)
+wine notepad.exe                 especificado no registro para
                                 encontrar o arquivo)
-	wine c:\\windows\\notepad.exe   (usando um nome de arquivo DOS)
+wine c:\\windows\\notepad.exe   (usando um nome de arquivo DOS)
-	wine ~/.wine/drive_c/windows/notepad.exe   (usando um nome de arquivo Unix)
+wine ~/.wine/drive_c/windows/notepad.exe   (usando um nome de arquivo Unix)
-	wine notepad.exe leiame.txt     (chamando o programa com parâmetros)
+wine notepad.exe leiame.txt     (chamando o programa com parâmetros)
 ```
 O Wine não é perfeito, então alguns programas podem travar. Se isso
 acontecer você verá um registro do travamento (crash log) que você
 poderá anexar ao bug que for criar.
-7. OBTENDO MAIS INFORMAÇÃO
+## OBTENDO MAIS INFORMAÇÃO
-WWW:	Uma grande quantidade de informação sobre o Wine está disponível
+- **WWW**: Uma grande quantidade de informação sobre o Wine está disponível
 	no WineHQ em https://www.winehq.org/ : vários guias do Wine, base
 	de dados de aplicações, rastreamento de erros. Este é provavelmente
 	o melhor ponto para começar.
-FAQ:	O FAQ (perguntas frequentes) do Wine está em https://www.winehq.org/FAQ
+- **FAQ**: O FAQ (perguntas frequentes) do Wine está em https://www.winehq.org/FAQ
-Wiki:	O wiki do Wine está disponível em https://wiki.winehq.org
+- **Wiki**: O wiki do Wine está disponível em https://wiki.winehq.org
-Listas de discussão:
+- **Gitlab**: https://gitlab.winehq.org
 - **Listas de discussão**:
 	Há diversas listas de mensagens para usuários e colaboradores no
 	desenvolvimento do Wine; veja https://www.winehq.org/forums para
 	mais informação.
-Bugs:	Relate erros ao Bugzilla do Wine em https://bugs.winehq.org
+- **Bugs**: Relate erros ao Bugzilla do Wine em https://bugs.winehq.org
 	Por favor, pesquise a base de dados do bugzilla para verificar
 	se seu problema já foi encontrado ou resolvido antes de enviar
 	um relatório do erro.
-IRC:	A ajuda online está disponível em #WineHQ em irc.libera.chat.
+- **IRC**: A ajuda online está disponível em `#WineHQ` em irc.libera.chat.
 Git:	A árvore de desenvolvimento atual do Wine está disponível por Git.
 	Visite https://www.winehq.org/git para mais informação.
 Se você alterar algo ou reparar um erro, envie, por favor, um patch
 (preferencialmente usando git-format-patch) à lista wine-devel@winehq.org
 para inclusão na próxima distribuição.
 --
 Arquivo original escrito por:
 Alexandre Julliard
 julliard@winehq.org
 --
 Tradução para Português do Brasil:
 Marcelo Duarte
 wine-devel@bol.com.br
 Bruno Jesus
 00cpxxx@gmail.com
--- a/documentation/README-ru.md
+++ b/documentation/README-ru.md
@ -1,4 +1,4 @@
-1. ВВЕДЕНИЕ
+## ВВЕДЕНИЕ
 Wine - это программа, которая позволяет запускать программы Microsoft
 Windows (включая исполняемые файлы формата DOS, Windows 3.x, Win32 и
@ -11,79 +11,81 @@ Wine - свободное программное обеспечение, опу
 GNU LGPL, файл LICENSE содержит информацию по лицензии.
-2. БЫСТРЫЙ СТАРТ
+## БЫСТРЫЙ СТАРТ
 В каталоге, содержащем исходный код Wine, выполните:
 ```
 ./configure
 make
 ```
-Запустите программу с помощью команды «wine имя_программы». Источники
+Запустите программу с помощью команды `wine имя_программы`. Источники
 дополнительной информации перечислены в конце этого файла. Ознакомьтесь с
 руководством по Wine, а также с сайтом https://www.winehq.org.
-3. ТРЕБОВАНИЯ
+## ТРЕБОВАНИЯ
 Компиляция и запуск Wine поддерживается в следующих операционных системах:
-  Linux версии 2.0.36 или более новой
+- Linux версии 2.0.36 или более новой
-  FreeBSD 8.0 или более новой
+- FreeBSD 12.4 или более новой
-  Solaris x86 9 или более новой
+- Solaris x86 9 или более новой
-  NetBSD-текущей версии
+- NetBSD-текущей версии
-  Mac OS X 10.8 или более новой
+- Mac OS X 10.8 или более новой
 Так как Wine требует для запуска поддержку потоков на уровне ядра,
 поддерживаются только операционные системы, перечисленные выше. Другие
 операционные системы с поддержкой многопоточности на уровне ядра
 возможно будут поддерживаться Wine в будущем.
-FreeBSD:
+**FreeBSD**:
  Wine не будет работать как следует на версиях ниже, чем FreeBSD 8.0.
  Посетите <https://wiki.freebsd.org/Wine> для дополнительной информации.
-Solaris:
+**Solaris**:
  Лучше всего компоновать Wine инструментами GNU
  (gcc, gas, и т.д.). Внимание: установка gas *НЕ* гарантирует
  что gcc будет его использовать. Необходимо перекомпилировать gcc после
  установки gas или создать ссылку на cc, как и на ld в инструментах gnu.
-NetBSD:
+**NetBSD**:
  Убедитесь что, параметры USER_LDT, SYSVSHM, SYSVSEM и SYSVMSG
  включены в вашем ядре.
-Mac OS X:
+**Mac OS X**:
  Вам потребуется Xcode/Xcode Command Line Tools или Apple cctools.
  Минимальные требования для компиляции это clang 3.8 c MacOSX10.10.sdk и
  mingw-w64 v8. MacOSX10.14.sdk и новее может использоваться только для
  сборки wine64.
-Поддерживаемые файловые системы:
+**Поддерживаемые файловые системы**:
  Wine должен работать на большинстве файловых систем. При использовании файлов
  через Samba возможны некоторые проблемы с совместимостью. NTFS не обладает
  необходимой функциональностью для запуска некоторых приложений.
  Рекомендуется использовать родные файловые системы Unix.
-Базовые требования:
+**Базовые требования**:
  У вас должны быть установлены заголовочные файлы X11
  (xorg-dev в Debian и libX11-devel в Red Hat).
  Разумеется, вам необходим «make» (лучше всего использовать GNU make).
  Вам также понадобятся flex версии 2.5.33 или более новой и bison.
-Дополнительные библиотеки:
+**Дополнительные библиотеки**:
  Конфигурационный скрипт выведет список дополнительных библиотек, которые не были
  найдены в вашей системе. Ознакомьтесь с перечнем необходимых пакетов по адресу
  https://wiki.winehq.org/Recommended_Packages. При работе на 64-битных платформах
  убедитесь, что у вас установлены 32-битные версии этих библиотек.
-4. КОМПИЛЯЦИЯ
+## КОМПИЛЯЦИЯ
 Для компиляции, выполните:
 ```
 ./configure
 make
 ```
 В результате вы получите программу «wine», библиотеки и бинарные файлы,
 необходимые для работы Wine.
@ -91,78 +93,64 @@ make
 Библиотека «libwine» («Winelib») может быть использована для компилирования и
 компоновки исходного кода Windows под Unix.
-Для вывода конфигурационных настроек введите ./configure --help.
+Для вывода конфигурационных настроек введите `./configure --help`.
 За дополнительной информацией обратитесь к https://wiki.winehq.org/Building_Wine
-5. УСТАНОВКА
+## УСТАНОВКА
-Если компоновка Wine завершилась успешно, выполните «make install». Это
+Если компоновка Wine завершилась успешно, выполните `make install`. Это
 установит исполняемые файлы wine, руководство Wine и некоторые
 необходимые файлы.
 Сначала не забудьте удалить любые конфликтующие версии Wine установленные ранее.
-Попробуйте «dpkg -r wine», «rpm -e wine» или «make uninstall» до установки.
+Попробуйте `dpkg -r wine`, `rpm -e wine` или `make uninstall` до установки.
-После установки запустите конфигурационную программу «winecfg». Посетите
+После установки запустите конфигурационную программу `winecfg`. Посетите
 Службу поддержки на https://www.winehq.org/, если возникнут вопросы по конфигурации.
-6. ЗАПУСК ПРОГРАММ
+## ЗАПУСК ПРОГРАММ
 Вы можете указывать путь до файла или только имя файла.
 Например: запуск Блокнота:
-	wine notepad		   (используя пути, сохранённые
+```
-	wine notepad.exe	    в реестре, для нахождения файла)
+wine notepad		   (используя пути, сохранённые
 wine notepad.exe	    в реестре, для нахождения файла)
-	wine c:\\windows\\notepad.exe  (используя синтаксис DOS)
+wine c:\\windows\\notepad.exe  (используя синтаксис DOS)
-	wine ~/.wine/drive_c/windows/notepad.exe  (используя синтаксис Unix)
+wine ~/.wine/drive_c/windows/notepad.exe  (используя синтаксис Unix)
-        wine notepad.exe /parameter1 -parameter2 parameter3
+wine notepad.exe readme.txt		   (вызов программы с параметрами)
-				   (вызов программы с параметрами)
+```
 Wine не идеален, поэтом некоторые программы могут завершаться с ошибкой.
 Полученный в результате ошибке текстовый лог необходимо приложить к отчету
 об ошибке.
-7. ПОЛУЧЕНИЕ ДОПОЛНИТЕЛЬНОЙ ИНФОРМАЦИИ
+## ПОЛУЧЕНИЕ ДОПОЛНИТЕЛЬНОЙ ИНФОРМАЦИИ
-WWW:	 Много информации о Wine доступно в WineHQ на
+- **WWW**: Много информации о Wine доступно в WineHQ на
 	 https://www.winehq.org/: различные руководства Wine, база данных приложений,
 	 база данных ошибок. Вероятно лучше всего начать с этого сайта.
-FAQ:	 Wine FAQ расположен на https://www.winehq.org/FAQ
+- **FAQ**: Wine FAQ расположен на https://www.winehq.org/FAQ
-Wiki:	 Wine Wiki расположен на https://wiki.winehq.org
+- **Wiki**: Wine Wiki расположен на https://wiki.winehq.org
-Рассылки:
+- **Gitlab**: https://gitlab.winehq.org
 - **Рассылки**:
 	 Имеется несколько рассылок для пользователей и разработчиков Wine,
 	 обратитесь по адресу https://www.winehq.org/forums за дополнительной информацией.
-Ошибки:	 Сообщайте об ошибках в Wine Bugzilla по адресу https://bugs.winehq.org
+- **Ошибки**: Сообщайте об ошибках в Wine Bugzilla по адресу https://bugs.winehq.org
 	 Прежде чем отправлять сообщение об ошибке проверьте, может эта ошибка
 	 уже известна или исправлена в последней версии Wine.
-IRC:	 Онлайн помощь доступна на канале #WineHQ на irc.libera.chat.
+- **IRC**: Онлайн помощь доступна на канале `#WineHQ` на irc.libera.chat.
 Git:	 Текущие разработки Wine доступны через Git.
 	 Смотрите https://www.winehq.org/site/git для дополнительной информации.
 Если вы что-то добавили или исправили ошибку, пожалуйста отправьте патч
 (предпочтительно сгенерированный с помощью git-format-patch) на wine-devel@winehq.org
 для его включения в следующий релиз.
 --
 Alexandre Julliard
 julliard@winehq.org
 Перевели на русский язык
 Владимир Панкратов
 scriptkid@mail.ru
 Виталий Липатов
 lav@etersoft.ru
--- a/documentation/README-sv.md
+++ b/documentation/README-sv.md
@ -1,4 +1,4 @@
-1. INLEDNING
+## INLEDNING
 Wine är ett program som gör det möjligt att köra Windows-program
 (inkluderat DOS, Windows 3.x, Win32 och Win64) i Unix. Det består av en
@ -11,165 +11,154 @@ Wine är fri programvara, utgett under villkoren i GNU LGPL; se
 filen LICENSE för detaljer.
-2. KOM IGÅNG
+## KOM IGÅNG
 Kör följande kommandon i rotkatalogen för Wines källkod:
 ```
 ./configure
 make
 ```
 Efteråt antingen installera Wine:
 ```
 make install
 ```
 Eller kör Wine direkt från dess rotkatalog:
 ```
 ./wine notepad
 ```
-Kör program med "wine [val] program". Se resten av denna fil,
+Kör program med `wine program`. Se resten av denna fil,
 Wines man-sidor samt sist men inte minst https://www.winehq.org/ för mer
 information och tips om hur problem kan lösas.
-3. SYSTEMKRAV
+## SYSTEMKRAV
 För att kompilera och köra Wine krävs ett av följande:
-  Linux version 2.0.36 eller senare
+- Linux version 2.0.36 eller senare
-  FreeBSD 8.0 eller senare
+- FreeBSD 12.4 eller senare
-  Solaris x86 9 eller senare
+- Solaris x86 9 eller senare
-  NetBSD-current
+- NetBSD-current
-  Mac OS X 10.5 eller senare
+- Mac OS X 10.8 eller senare
 Wine kräver stöd för trådar på kernelnivå, och därför är det bara
 operativsystemen ovan som stöds. Andra operativsystem som
 stöder kerneltrådar kommer eventuellt att stödjas i framtiden.
-Information för FreeBSD:
+**Information för FreeBSD**:
  Wine kommer i regel inte att fungera på FreeBSD-versioner äldre än 8.0.
  Se https://wiki.freebsd.org/Wine för mer information.
-Information för Solaris:
+**Information för Solaris**:
  Wine måste antagligen byggas med GNU toolchain (gcc, gas etc.).
  Varning: även om gas installeras så är det inte säkert att det används av
  gcc. Det sägs att det är nödvändigt att antingen bygga gcc på nytt, eller
  skapa symboliska länkar från "cc", "as" och "ld" till GNU toolchain.
-Information för NetBSD:
+**Information för NetBSD**:
  USER_LDT, SYSVSHM, SYSVSEM och SYSVMSG måste vara aktiverade i kerneln.
-Information för Mac OS X:
+**Information för Mac OS X**:
  Du behöver Xcode 2.4 eller senare för att korrekt kunna bygga Wine på x86.
  Mac-drivrutinen kräver OS X 10.6 eller senare och kommer inte att byggas på 10.5.
-
+**Stödda filsystem**:
 Stödda filsystem:
  Wine kan köra på de flesta filsystem, men det har rapporterats problem vad
  gäller kompatibilitet då samba används för att ansluta till filer. NTFS
  tillhandahåller inte heller alla filsystemsfunktioner som behövs av alla
  program. Det rekommenderas att använda ett riktigt Unix-filsystem.
-Grundläggande krav:
+**Grundläggande krav**:
  Utvecklingsfilerna för X11 måste vara installerade (de kallas xorg-dev i
  Debian och libX11-devel i Red Hat).
-
+  Du måste givetvis också ha make (mest troligt GNU make).
  Du måste givetvis också ha "make" (mest troligt "GNU make").
  Det är också nödvändigt att ha flex 2.5.33 eller senare samt bison.
-Valfria stödbibliotek:
+**Valfria stödbibliotek**:
  configure-skriptet visar varningar när valfria bibliotek inte hittats.
  Se https://wiki.winehq.org/Recommended_Packages för information om vilka
  paket du bör installera. På 64-bitars system måste du säkerställa att du
  installerar 32-bitars versionerna av dessa bibliotek.
-4. KOMPILERING
+## KOMPILERING
 Kör följande kommandon för att bygga Wine:
 ```
 ./configure
 make
 ```
 Detta bygger programmet "wine" och diverse stödbibliotek/programfiler.
 Programfilen "wine" laddar och kör Windows-program.
 Biblioteket "libwine" ("Winelib") kan användas till att bygga och länka
 Windows-källkod i Unix.
-Kör './configure --help' för att se inställningar och val vid kompilering.
+Kör `./configure --help` för att se inställningar och val vid kompilering.
 För mer information se https://wiki.winehq.org/Building_Wine
-5. INSTALLATION
+## INSTALLATION
-När Wine är byggt kan du köra "make install" för att installera det;
+När Wine är byggt kan du köra `make install` för att installera det;
 detta installerar också man-sidorna och några fler nödvändiga filer.
 Glöm inte att först avinstallera gamla Wine-versioner. Pröva antingen
-"dpkg -r wine", "rpm -e wine" eller "make uninstall" före installationen.
+`dpkg -r wine`, `rpm -e wine` eller `make uninstall` före installationen.
-När Wine är installerat kan du använda inställningsprogrammet "winecfg".
+När Wine är installerat kan du använda inställningsprogrammet `winecfg`.
 Se hjälpavdelningen på https://www.winehq.org/ för tips om inställningar.
-6. KÖRNING AV PROGRAM
+## KÖRNING AV PROGRAM
 När du använder Wine kan du uppge hela sökvägen till programfilen, eller
 enbart ett filnamn.
 Exempel: för att köra Notepad:
-        wine notepad               (använder sökvägen angiven i Wines
+```
-        wine notepad.exe            konfigurationsfil för att finna filen)
+wine notepad               (använder sökvägen angiven i Wines
 wine notepad.exe            konfigurationsfil för att finna filen)
-        wine c:\\windows\\notepad.exe  (användning av DOS-filnamnssyntax)
+wine c:\\windows\\notepad.exe  (användning av DOS-filnamnssyntax)
-        wine ~/.wine/drive_c/windows/notepad.exe  (användning av Unix-filvägar)
+wine ~/.wine/drive_c/windows/notepad.exe  (användning av Unix-filvägar)
-        wine notepad.exe readme.txt  (köra program med parametrar)
+wine notepad.exe readme.txt  (köra program med parametrar)
 ```
 Wine är inte perfekt, så det är möjligt att vissa program kraschar.
 I så fall får du en kraschlogg som du bör bifoga till din rapport då du
 rapporterar ett fel.
-7. MER INFORMATION
+## MER INFORMATION
-Internet:  Mycket information om Wine finns samlat på WineHQ på
+- **Internet**: Mycket information om Wine finns samlat på WineHQ på
           https://www.winehq.org/ : diverse guider, en programdatabas samt
           felspårning. Detta är antagligen det bästa stället att börja.
-Frågor:    Frågor och svar om Wine finns samlade på https://www.winehq.org/FAQ
+- **Frågor**: Frågor och svar om Wine finns samlade på https://www.winehq.org/FAQ
-Wiki:      Wines Wiki finns på https://wiki.winehq.org
+- **Wiki**: Wines Wiki finns på https://wiki.winehq.org
-E-postlistor:
+- **Gitlab**: https://gitlab.winehq.org
 - **E-postlistor**:
           Det finns flera e-postlistor för Wine-användare och -utvecklare; se
           https://www.winehq.org/forums för mer information.
-Fel:       Rapportera fel till Wines Bugzilla på https://bugs.winehq.org
+- **Fel**: Rapportera fel till Wines Bugzilla på https://bugs.winehq.org
           Sök i Bugzilla-databasen för att se om problemet redan finns
           rapporterat innan du sänder en felrapport.
-IRC:       Hjälp finns tillgänglig online på kanalen #WineHQ på
+- **IRC**: Hjälp finns tillgänglig online på kanalen `#WineHQ` på
           irc.libera.chat.
 Git:       Wines nuvarande utvecklingsversion finns tillgänglig genom Git.
           Gå till https://www.winehq.org/git för mer information.
 Om du lägger till något eller fixar ett fel, är det bra om du sänder
 en patch (förslagsvis med git-format-patch) till listan wine-devel@winehq.org
 för inkludering i nästa utgåva av Wine.
 --
 Originalet till denna fil skrevs av
 Alexandre Julliard
 julliard@winehq.org
 Översatt till svenska av
 Anders Jonsson
 anders.jonsson@norsjonet.se
 och
 Lauri Kenttä
 lauri.kentta@gmail.com
--- a/documentation/README-tr.md
+++ b/documentation/README-tr.md
@ -1,4 +1,4 @@
-1. GİRİŞ
+## GİRİŞ
 Wine Microsoft Windows uygulamalarını (DOS, Windows 3.x ve Win32
 uygulamaları dahil) Unix uyumlu sistemler üzerinde çalıştırmanıza izin
@ -11,29 +11,32 @@ kitaplıktan oluşur. Kitaplık ayrıca Win32 kodlarını doğal Unix
 Wine, GNU LGPL altında dağıtılan özgür bir yazılımdır; ayrıntılar için
 LICENSE dosyasına bakabilirsiniz.
-2. HIZLI BAŞLANGIÇ
+## HIZLI BAŞLANGIÇ
 Eğer kaynaktan derlemek istiyorsanız, Wine'yi derlemek ve kurmak için Wine
 Kur'u kullanmanız önerilir. Wine kaynak kodu içerisinde en üst dizine
 (README dosyasını içerir) geçiniz ve şu komutu veriniz:
-./tools/wineinstall
+```
 ./configure
 make
 ```
-Programları "wine [seçenekler] program" şeklinde çalıştırabilirsiniz.
+Programları `wine program` şeklinde çalıştırabilirsiniz.
 Daha ayrıntılı bilgi ve sorun çözümü için, bu dosyanın geri kalanını,
 Wine kullanım kılavuzunu ve özellikle https://www.winehq.org sitesindeki
 zengin bilgi arşivini tarayabilirsiniz.
-3. GEREKSİNİMLER
+## GEREKSİNİMLER
 Wine'ı derlemek ve çalıştırmak için, aşağıdakilerden en az birine sahip
 olmanız gerekir:
-  Linux 2.0.36 veya sonrası
+- Linux 2.0.36 veya sonrası
-  FreeBSD 8.0 veya sonrası
+- FreeBSD 12.4 veya sonrası
-  Solaris x86 9 veya sonrası
+- Solaris x86 9 veya sonrası
-  NetBSD-current
+- NetBSD-current
-  macOS 10.6 veya sonrası
+- macOS 10.8 veya sonrası
 Wine çalışmak için çekirdek düzeyinde iş parçacığı desteğine ihtiyaç
 duyduğundan sadece yukarıda söz edilen işletim sistemleri
@ -41,45 +44,41 @@ desteklenmektedir.
 Çekirdek düzeyinde iş parçacıklarını destekleyen diğer işletim sistemleri
 de gelecekte desteklenebilir.
-FreeBSD hakkında bilgi:
+**FreeBSD hakkında bilgi**:
  Wine, FreeBSD 8.0'dan önceki sürümlerde genellikle düzgün çalışmaz.
  Ayrıntılı bilgi için https://wiki.freebsd.org/Wine adresini ziyaret
  ediniz.
-Solaris hakkında bilgi:
+**Solaris hakkında bilgi**:
  Wine'ı derlemek için muhtemelen GNU araçlarına (gcc, gas, vb.) ihtiyaç
  duyacaksınız. Uyarı: gas kurmuş olmak onun gcc tarafından kullanılacağını
  temin etmez. gas kurduktan sonra yeniden gcc derlemeniz veya cc, as ve ld
  sembolik bağlantılarını gnu araçlarına ayarlamanız gerekmektedir.
-NetBSD hakkında bilgi:
+**NetBSD hakkında bilgi**:
  USER_LDT, SYSVSHM, SYSVSEM ve SYSVMSG seçeneklerinin çekirdeğinizde etkin
  olduğundan emin olunuz.
-macOS hakkında bilgi:
+**macOS hakkında bilgi**:
  x86 üzerinde düzgün bir derleme yapabilmeniz için Xcode 2.4 veya daha yeni
  bir sürüm gereklidir.
  Mac sürücüsü için 10.6 veya daha üzeri gereklidir, sürücü 10.5'te derlenmez.
-Desteklenen dosya sistemleri:
+**Desteklenen dosya sistemleri**:
  Wine birçok dosya sisteminde çalışabilir. Bununla beraber, Samba üzerinden
  yapılan dosya erişimlerinde de birkaç uyumluluk sorunu bildirilmiştir.
  Ayrıca, NTFS bazı uygulamalar için gereken bütün dosya sistemi özelliklerini
  sağlamamaktadır. Unix için geliştirilen dosya sistemlerini kullanmanız önerilir.
-Temel gereksinimler:
+**Temel gereksinimler**:
  X11 geliştirme dosyalarının kurulu olması gereklidir.
  (Debian'da xorg-dev, Red Hat'da libX11-devel adlı paketler).
-
+  make komutuna kesinlikle ihtiyacınız vardır. (çoğunlukla GNU make)
  "make" komutuna kesinlikle ihtiyacınız vardır. (çoğunlukla GNU make)
  Ayrıca, flex 2.5.33 ve bison araçları da gereklidir.
-Seçeneğe bağlı destek kitaplıkları:
+**Seçeneğe bağlı destek kitaplıkları**:
  Yapılandırılırken, eğer seçeneğe bağlı paketler bulunamadıysa, bildirim
  alacaksınız. Yüklemeniz gereken paketler hakkında ipuçları için,
  https://wiki.winehq.org/Recommended_Packages adresini ziyaret ediniz.
  64 bit üzerinde, eğer Wine'yi 32 bit (varsayılan) olarak derleyecekseniz,
  bazı kitaplıklarin 32 bit sürümlerinin yüklü olduğundan emin olunuz;
  ayrıntılar için https://wiki.winehq.org/WineOn64bit adresini ziyaret
@ -87,91 +86,83 @@ Seçeneğe bağlı destek kitaplıkları:
  isterseniz, bilgi için https://wiki.winehq.org/Wine64 adresini ziyaret
  ediniz.
-4. DERLEME
+## DERLEME
 Eğer wineinstall kullanmamayı seçtiyseniz, Wine'yi derlemek için aşağıdaki
 komutları çalıştırınız:
 ```
 ./configure
 make
 ```
 Bu, "wine" programını ve destek kitaplıklarını/ikili dosyalarını
 derleyecektir.  "wine" programı Windows uygulamalarını yükleyecek ve
 çalıştıracaktır.  "libwine" ("Winelib") kitaplığı Windows programlarının
 kaynak kodunu Unix altında derlemek ve bağlamak için kullanılabilir.
-Derleme yapılandırma seçeneklerini görmek için ./configure --help komutunu giriniz.
+Derleme yapılandırma seçeneklerini görmek için `./configure --help` komutunu giriniz.
-5. KURULUM
+## KURULUM
-Wine düzgün bir şekilde derlendiğinde, "make install" komutunu
+Wine düzgün bir şekilde derlendiğinde, `make install` komutunu
 verebilirsiniz; bu komut Wine çalıştırılabilir dosyalarını, kullanım
 kılavuzunu ve gerekli birkaç dosyayı kuracaktır.
 Önce, çakışan eski bir Wine kurulumunu kaldırmayı unutmayınız. Kurmadan
-önce "dpkg -r wine" veya "rpm -e wine" veya "pisi rm wine" ya da "make
+önce `dpkg -r wine` veya `rpm -e wine` veya `pisi rm wine` ya da `make
-uninstall" komutlarından birini deneyiniz.
+uninstall` komutlarından birini deneyiniz.
-Yüklemeden sonra, "winecfg" yapılandıma aracını
+Yüklemeden sonra, `winecfg` yapılandıma aracını
 çalıştırabilirsiniz. Yapılandırma ipuçları için https://www.winehq.org/
 adresinde Destek bölümüne bakınız.
-6. UYGULAMALARIN ÇALIŞTIRILMASI
+## UYGULAMALARIN ÇALIŞTIRILMASI
 Wine'yi çağırırken çalışabilir dosyanın tam yolunu verebilir veya sadece
 bir dosya adı belirtebilirsiniz.
 Örneğin: Not Defteri'ni çalıştırmak için:
-	wine notepad		   (dosyaları konumlandırmak için config
+```
-	wine notepad.exe	    dosyasındaki Path arama yolunu kullanarak)
+wine notepad		   (dosyaları konumlandırmak için config
 wine notepad.exe	    dosyasındaki Path arama yolunu kullanarak)
-	wine c:\\windows\\notepad.exe  (DOS dosya adı sözdizimi ile)
+wine c:\\windows\\notepad.exe  (DOS dosya adı sözdizimi ile)
-	wine ~/.wine/drive_c/windows/notepad.exe (Unix dosya adı sözdizimi ile)
+wine ~/.wine/drive_c/windows/notepad.exe (Unix dosya adı sözdizimi ile)
-        wine notepad.exe readme.txt
+wine notepad.exe readme.txt
-				   (programı parametre vererek çağırma)
+			   (programı parametre vererek çağırma)
 ```
 Wine tamamen bitmiş değildir; bu nedenle bazı programlar çökebilir. Bir
 sorun oluştuğunda, bir çökme günlük dosyası alacaksınız, bu dosyayı hata
 bildirirken eklemelisiniz.
-7. DAHA FAZLA BİLGİYE ERİŞİM
+## DAHA FAZLA BİLGİYE ERİŞİM
-WWW:	Wine hakkında geniş bilgiyi WineHQ sitesine https://www.winehq.org/
+- **WWW**: Wine hakkında geniş bilgiyi WineHQ sitesine https://www.winehq.org/
 	adresinden ulaşarak edinebilirsiniz: çeşitli Wine kılavuzları,
 	uygulama veritabanı, hata izleme gibi. Burası muhtemelen en iyi
 	başlangıç noktasıdır.
-SSS:	Wine hakkında sıkça sorulan sorulara buradan ulaşabilirsiniz:
+- **SSS** Wine hakkında sıkça sorulan sorulara buradan ulaşabilirsiniz:
              https://www.winehq.org/FAQ
-Hatalar:
+- **Wiki**: https://wiki.winehq.org
 - **Gitlab**: https://gitlab.winehq.org
 - **E-posta listeleri**:
 	Wine geliştiricileri için birtakım e-posta listeleri bulunmaktadır.
 	Daha fazla bilgi için https://www.winehq.org/forums adresine gidiniz.
 - **Hatalar**:
 	Karşılaştığınız hataları https://bugs.winehq.org adresinden Wine
 	Bugzilla ile bildirebilirsiniz. Lütfen bir hata bildirmeden önce
 	hatanın önceden girilip girilmediğini öğrenmek için Bugzilla'da
 	arama yapınız.
-IRC:	irc.libera.chat sunucusundan #WineHQ kanalı ile çevrimiçi yardım
+- **IRC**: irc.libera.chat sunucusundan `#WineHQ` kanalı ile çevrimiçi yardım
 	alabilirsiniz.
 Git:	Geçerli Wine geliştirme ağacına Git üzerinden erişim sağlanabilir.
 	Daha fazla bilgi için https://www.winehq.org/git adresine gidiniz.
 E-posta listeleri:
 	Wine geliştiricileri için birtakım e-posta listeleri bulunmaktadır.
 	Daha fazla bilgi için https://www.winehq.org/forums adresine gidiniz.
 Eğer bir şey eklemek veya hata düzeltmek istiyorsanız, lütfen sonraki
 sürümde yer alabilmesii için wine-devel@winehq.org e-posta listesine bir
 yama ('diff -u' biçiminde) gönderiniz.
 --
 Alexandre Julliard
 julliard@winehq.org
 --
 Türkçe çeviri:
 Can Taşan
 betax34@hotmail.com
--- a/documentation/README-uk.md
+++ b/documentation/README-uk.md
@ -1,4 +1,4 @@
-1. ВСТУП
+## ВСТУП
 Wine - це програма, яка дозволяє запускати програми Microsoft
 Windows (включаючи DOS, Windows 3.x, Win32 та Win64) на Unix. Вона
@ -11,164 +11,149 @@ Wine - вільне програмне забезпечення, опублік
 GNU LGPL; дивіться файл LICENSE за детальною інформацією.
-2. ШВИДКИЙ СТАРТ
+## ШВИДКИЙ СТАРТ
 Кожен раз, коли ви компілюєте вихідний код, рекомендується використовувати
 Wine Installer для компонування і встановлення Wine. У каталозі, що містить
 вихідний код Wine (у ній знаходиться цей файл), введіть:
-./tools/wineinstall
+```
 ./configure
 make
 ```
-Запустіть програму як "wine program". Додаткові джерела інформації
+Запустіть програму як `wine program`. Додаткові джерела інформації
 перераховані в кінці цього файлу. Ознайомтеся з посібником з Wine,
 а також з сайтом https://www.winehq.org.
-3. ВИМОГИ
+## ВИМОГИ
 Компіляція і запуск Wine підтримується в наступних операційних системах:
-  Linux версії 2.0.36 чи новіший
+- Linux версії 2.0.36 чи новіший
-  FreeBSD 6.3 чи новіший
+- FreeBSD 12.4 чи новіший
-  Solaris x86 9 чи новіший
+- Solaris x86 9 чи новіший
-  NetBSD-поточна версія
+- NetBSD-поточна версія
-  Mac OS X 10.5 чи новіший
+- Mac OS X 10.8 чи новіший
 Оскільки Wine вимагає для запуску підтримку потоків на рівні ядра, підтримуються
 тільки операційні системи, перераховані вище. Інші операційні системи,
 з підтримкою багатопоковості ядром, можуть підтримуватися Wine в майбутньому.
-Linux:
+**FreeBSD**:
  Linux 2.2.x повинен працювати; Linux 2.0.x може працювати
  (старіші версії 2.0.x викликають збій системи),
  Найкраще використовувати поточну версію ядра: 2.4.x чи 2.6.x.
 FreeBSD:
  Wine не буде працювати як слід на версіях нижче, ніж FreeBSD 6.3
  чи 7.0. Для FreeBSD 6.3 є патч, що дозволяє Wine запускатися.
  Відвідайте https://wiki.freebsd.org/Wine для додаткової інформації.
-Solaris:
+**Solaris**:
  Найкраще збирати Wine інструментами GNU (gcc, gas, тощо). Увага:
  встановлення gas *НЕ* гарантує що gcc буде його використовувати.
  Необхідно перекомпілювати gcc після установки gas або створити
  посилання на cc, як і на ld в інструментах gnu.
-NetBSD:
+**NetBSD**:
  Переконайтеся, що параметри USER_LDT, SYSVSHM, SYSVSEM і SYSVMSG
  у вашому ядрі включені.
-Mac OS X:
+**Mac OS X**:
  Вам потрібен Xcode 2.4 або більш новий для компіляції x86.
-
+**Підтримувані файлові системи**:
 Підтримувані файлові системи:
  Wine повинен працювати на більшості файлових систем. При використанні
  файлів через Samba можливі деякі проблеми з сумісністю. NTFS не має
  необхідної функціональності, потрібної для роботи деяких додатків.
  Рекомендується використовувати файлові системи Linux, такі як ext3.
-Базові вимоги:
+**Базові вимоги**:
  У вас повинні бути встановлені файли заголовків X11
  (xorg-dev в Debian та libX11-devel в Red Hat).
-
+  Звісно, вам потрібен make (краще всього використовувати GNU make).
  Звісно, вам потрібен "make" (краще всього використовувати GNU make).
  Вам також знадобляться flex (версії 2.5.33 або новіший) та bison.
-Додаткові бібліотеки підтримки:
+**Додаткові бібліотеки підтримки**:
  Конфігураційний скрипт виведе список додаткових бібліотек, які не були
  знайдені у вашій системі. Ознайомтеся з переліком потрібних пакетів за
  адресою https://wiki.winehq.org/Recommended_Packages.
  На 64-бітних платформах ви повинні переконатися, що у вас встановлені
  32-бітні версії цих бібліотек; за більш детальною інформацією зверніться
  до https://wiki.winehq.org/WineOn64bit. Якщо вам потрібен 64-бітний Wine
  (чи змішаний 32-бітний та 64-бітний встановлювач Wine), дивіться
  https://wiki.winehq.org/Wine64 за більш детальною інформацією.
-4. ЗБИРАННЯ
+## ЗБИРАННЯ
 Якщо ви не хочете використовувати wineinstall, введіть наступні команди
 для збирання Wine:
 ```
 ./configure
 make
 ```
 Це збере програму "wine" та інші необхідні бібліотеки та бінарні файли.
 Програма "wine" буде завантажувати, і виконувати програми Windows.
 Бібліотека "libwine" ("Winelib") може бути використана для компілювання
 й компонування вихідного коду Windows під Unix.
-Для виведення конфігураційних налаштувань виконайте ./configure --help.
+Для виведення конфігураційних налаштувань виконайте `./configure --help`.
-5. ВСТАНОВЛЕННЯ
+## ВСТАНОВЛЕННЯ
-Після того як Wine буде успішно зібрано, виконайте "make install"; це
+Після того як Wine буде успішно зібрано, виконайте `make install`; це
 встановить виконувані файли Wine та бібліотеки, керівництво Wine та
 інші необхідні файли.
 Спочатку не забудьте видалити будь-які конфліктуючі раніше встановлені
-версії Wine. Спробуйте "dpkg -r wine" або "rpm -e wine" чи "make uninstall"
+версії Wine. Спробуйте `dpkg -r wine` або `rpm -e wine` чи `make uninstall`
 перед встановленням.
-Після встановлення запустіть конфігураційну програму "winecfg". Відвідайте Службу
+Після встановлення запустіть конфігураційну програму `winecfg`. Відвідайте Службу
 підтримки на https://www.winehq.org/, якщо виникнуть питання щодо конфігурування.
-6. ЗАПУСК ПРОГРАМ
+## ЗАПУСК ПРОГРАМ
 Для виклику Wine ви можете вказати повний шлях до виконуваного файлу,
 або лише ім'я файлу.
 Наприклад: щоб запустити Блокнот(Notepad):
-    wine notepad            (використавши шлях пошуку файлу,
+```
-    wine notepad.exe         збережений в реєстрі)
+wine notepad            (використавши шлях пошуку файлу,
 wine notepad.exe         збережений в реєстрі)
-    wine c:\\windows\\notepad.exe      (використавши синтаксис DOS)
+wine c:\\windows\\notepad.exe      (використавши синтаксис DOS)
-    wine ~/.wine/drive_c/windows/notepad.exe  (використавши синтаксис Unix)
+wine ~/.wine/drive_c/windows/notepad.exe  (використавши синтаксис Unix)
-    wine notepad.exe readme.txt          (виклик програми з параметрами)
+wine notepad.exe readme.txt          (виклик програми з параметрами)
 ```
 Wine знаходиться в процесі розробки, тому деякі програми можуть не
 працювати. Якщо станеться помилка, ви отримаєте лог збою, який
 треба прикріпити до звіту про помилку при його заповненні.
-7. ОТРИМАННЯ ДОДАТКОВОЇ ІНФОРМАЦІЇ
+## ОТРИМАННЯ ДОДАТКОВОЇ ІНФОРМАЦІЇ
-WWW:    Багато інформації про Wine є в WineHQ на
+- **WWW**: Багато інформації про Wine є в WineHQ на
        https://www.winehq.org/: різні керівництва Wine, база даних додатків,
        база даних помилок. Ймовірно найкраще почати з цього сайту.
-FAQ:	Wine FAQ розташований на https://www.winehq.org/FAQ
+- **FAQ** Wine FAQ розташований на https://www.winehq.org/FAQ
-Wiki:	Wine Wiki розташована на https://wiki.winehq.org
+- **Wiki** Wine Wiki розташована на https://wiki.winehq.org
-Списки розсилання:
+- **Gitlab**: https://gitlab.winehq.org
 - **Списки розсилання**:
 	Є кілька розсилок для користувачів і розробників Wine;
        дивіться https://www.winehq.org/forums для додаткової інформації.
-Помилки(баги):
+- **Помилки(баги)**:
 	Повідомляйте про помилки у Wine Bugzilla на https://bugs.winehq.org
 	Перш ніж відправляти повідомлення про помилку перевірте в базі, чи
 	ця помилка вже виявлена.
-IRC:	Онлайн допомога доступна на каналі #WineHQ на irc.libera.chat.
+- **IRC**: Онлайн допомога доступна на каналі `#WineHQ` на irc.libera.chat.
 Git:	Поточне дерево розробки Wine доступне через Git.
 	Дивіться https://www.winehq.org/git за детальною інформацією.
 Якщо ви щось додали або виправили помилку, надішліть патч (найкраще
 використавши git-format-patch) на wine-devel@winehq.org для його
 включення в наступний реліз.
 --
 Alexandre Julliard
 julliard@winehq.org
 Переклав на українську мову
 Ігор Палійчук
 mansonigor@gmail.com
--- a/documentation/README-zh_cn.md
+++ b/documentation/README-zh_cn.md
@ -1,4 +1,4 @@
-1. 简介
+## 简介
 Wine 是能够使 Microsoft Windows 程序（包括 DOS、Windows 3.x、Win32
 以及 Win64 可执行程序）在 Unix 上运行的应用程序。
@ -11,148 +11,141 @@ Wine 是自由软件，在 GNU LGPL 协议下发布；请查看 LICENSE 文件
 详情。
-2. 快速开始
+## 快速开始
 当您从源代码编译时，我们建议您使用 Wine Installer 来构建、安装 Wine。
 从 Wine 源代码的顶层目录开始（即包含本文件的目录[译注：指顶层的 README
 文件]），运行：
-./tools/wineinstall
+```
 ./configure
 make
 ```
-运行程序时，请使用“wine [程序名]”的语法。如需了解更多信息或解决遇到的
+运行程序时，请使用`wine [程序名]`的语法。如需了解更多信息或解决遇到的
 问题，您可以继续阅读本文件的剩余部分，或阅读 Wine 的手册页。
 需特别指出的是，您可以在网站：https://www.winehq.org 上找到十分丰富
 的信息。
-3. 系统需求
+## 系统需求
 要想成功编译并运行 Wine，您必须使用以下列出的操作系统之一：
-  Linux 2.0.36 或更新版本
+- Linux 2.0.36 或更新版本
-  FreeBSD 8.0 或更新版本
+- FreeBSD 12.4 或更新版本
-  Solaris x86 9 或更新版本
+- Solaris x86 9 或更新版本
-  NetBSD-current
+- NetBSD-current
-  Mac OS X 10.8 或更新版本
+- Mac OS X 10.8 或更新版本
 鉴于运行 Wine 需要内核级别的线程支持，仅以上提及的操作系统能被支持。
 其它拥有内核线程的操作系统可能在未来得到支持。
-FreeBSD 信息：
+**FreeBSD 信息**：
  Wine 通常不会在早于 FreeBSD 8.0 的系统上正常工作。
  请查看 https://wiki.freebsd.org/Wine 以了解更多信息。
-Solaris 信息：
+**Solaris 信息**：
  您大部分情况下可能需要使用 GNU 工具链（gcc、gas 等）来构建 Wine。
  警告：安装 gas *不能* 确保它被 gcc 所使用。您可能需要在安装 gas
  之后重编译 gcc，或是将 cc、as 和 ld 符号链接至 GNU 版的对应工具。
-NetBSD 信息：
+**NetBSD 信息**：
  请确保您在内核中启用了 USER_LDT、SYSVSHM、SYSVSEM 和 SYSVMSG 选项。
-Mac OS X 信息:
+**Mac OS X 信息**:
  您需要 Xcode/Xcode Command Line Tools 或者 Apple cctools。
  编译 Wine 的最低要求是 clang 3.8 以及 MacOSX10.10.sdk 和 mingw-w64 v8。
  MacOSX10.14.sdk 或者更新版本只能编译 wine64。
-
+**支持的文件系统**：
 支持的文件系统：
  Wine 应当能在大多数文件系统上工作。有一些被报告的兼容性问题，
  主要与使用 Samba 访问文件有关。另外，NTFS 不能提供一些应用所
  需要的某些文件系统的特定功能。综上所述，建议您使用原生的 Unix
  文件系统。
-基本要求：
+**基本要求**：
  您需要安装 X11 开发用头文件（在 Debian 中可能被称为 xorg-dev
  ，在 Red Hat 中可能被称为 libX11-devel）。
  当然您同样需要“make”工具（一般应当为 GNU make）。
  您也需要 flex 的 2.5.33 版或更新版本，以及 bison 工具。
-可选的支持库：
+**可选的支持库**：
  当可选的函数库无法在您的系统中找到时，configure 会显示对应的提示信息。
  请查看 https://wiki.winehq.org/Recommended_Packages 以了解您应当安装的
  软件包的信息。
  在 64 位平台上，如果以 32 位的方式编译 Wine（这是默认情况），您必须确保
  对应函数库的 32 位版本已被安装；请查看 https://wiki.winehq.org/WineOn64bit
  以了解详情。如果您想安装一个真正的 64 位 Wine（或者一个混合 32 位 Wine 和
  64 位 Wine 的版本），请参阅 https://wiki.winehq.org/Wine64 以了解具体内容。
-4. 编译
+## 编译
 如果您选择不使用 wineinstall 工具，请运行下列的命令以构建 Wine：
 ```
 ./configure
 make
 ```
 这样将会构建“wine”程序和大量的支持库/二进制文件。
 “wine”程序可以加载并运行 Windows 可执行文件。
 “libwine”（“Winelib”）函数库可被用来在 Unix 下编译并链接 Windows
 程序的源码。
-如需查看编译配置选项，请使用“./configure --help”。
+如需查看编译配置选项，请使用`./configure --help`。
-5. 安装
+## 安装
-一旦 Wine 已被正确构建，您可以进行“make install”；该操作将安装 wine
+一旦 Wine 已被正确构建，您可以进行`make install`；该操作将安装 wine
 可执行文件、函数库、Wine 手册页以及其它需要使用的文件。
 不要忘记事先卸载先前任何安装过的、会引起冲突的 Wine 软件集。
-请在安装前尝试“dpkg -r wine”、“rpm -e wine”或“make uninstall”。
+请在安装前尝试`dpkg -r wine`、`rpm -e wine`或`make uninstall`。
-一旦安装完成，您可以运行“winecfg”配置工具。请参考 https://www.winehq.org/
+一旦安装完成，您可以运行`winecfg`配置工具。请参考 https://www.winehq.org/
 网站中的支持页面以了解配置技巧。
-6. 运行程序
+## 运行程序
 当您调用 Wine 时，您可以指定指向可执行文件的整个路径，或是仅指定文件名
 信息。
 例如，如需运行 Notepad：
-    wine notepad            (使用注册表中指定的搜索路径来
+```
-    wine notepad.exe         定位文件)
+wine notepad            (使用注册表中指定的搜索路径来
 wine notepad.exe         定位文件)
-    wine c:\\windows\\notepad.exe      (使用 DOS 文件名语法)
+wine c:\\windows\\notepad.exe      (使用 DOS 文件名语法)
-    wine ~/.wine/drive_c/windows/notepad.exe  (使用 Unix 文件名语法)
+wine ~/.wine/drive_c/windows/notepad.exe  (使用 Unix 文件名语法)
-    wine notepad.exe readme.txt          (带参数调用程序)
+wine notepad.exe readme.txt          (带参数调用程序)
 ```
 Wine 不是十全十美的，所以某些程序可能会崩溃。如果这样的情况发生，
 您将会得到一份崩溃日志。您应当在提交程序漏洞时附上这份日志。
-7. 获取更多信息
+## 获取更多信息
-WWW:	有关 Wine 的很多信息可以在 WineHQ 网站：https://www.winehq.org/
+- **WWW**: 有关 Wine 的很多信息可以在 WineHQ 网站：https://www.winehq.org/
 	上面找到。包括：各类 Wine 相关的向导、应用程序数据库（AppDB）、
 	漏洞跟踪系统等等。这个网站可能是您最佳的起始之处。
-FAQ:	Wine 常见问题位于 https://www.winehq.org/FAQ
+- **FAQ**: Wine 常见问题位于 https://www.winehq.org/FAQ
-维基：	Wine 维基位于 https://wiki.winehq.org
+- **维基**： Wine 维基位于 https://wiki.winehq.org
-邮件列表：
+- **Gitlab**: https://gitlab.winehq.org
 - **邮件列表**：
 	存在数个服务于 Wine 用户和开发者的邮件列表；
 	请查看 https://www.winehq.org/forums 以了解更多信息。
-Bugs:	请向位于 https://bugs.winehq.org 的 Wine Bugzilla 提交 bug。
+- **Bugs**: 请向位于 https://bugs.winehq.org 的 Wine Bugzilla 提交 bug。
 	请在提交漏洞报告前先在 bugzilla 数据库中进行搜索，检查
 	先前是否已有类似的已知问题以避免重复，并跟踪这些问题的修复情况。
-IRC:	您可以在 irc.libera.chat 的 #WineHQ 频道获取到在线帮助。
+- **IRC**: 您可以在 irc.libera.chat 的 `#WineHQ` 频道获取到在线帮助。
 Git:	当前 Wine 的开发树可经由 Git 获取。
 	请前往 https://www.winehq.org/git 以了解更多信息。
 如果您在代码中添加了某些内容，或是修复了某个 bug，请向
 wine-devel@winehq.org 这个邮件列表发送对应的补丁（建议使用
 git-format-patch 生成补丁），以便我们将其加入下一个版本中。
 --
 Alexandre Julliard
 julliard@winehq.org