From 2e9c630ab19ed91b006a424f2304be87e6d39312 Mon Sep 17 00:00:00 2001 From: Matthias Kolja Miehl Date: Mon, 21 Dec 2015 23:52:29 +0000 Subject: Readme: fix markdown syntax, typos, and format --- README.md | 45 +++++++++++++++++++++++---------------------- 1 file changed, 23 insertions(+), 22 deletions(-) diff --git a/README.md b/README.md index 50e02bbc..4b04836f 100644 --- a/README.md +++ b/README.md @@ -17,15 +17,15 @@ called 'TrueCrypt' or 'VeraCrypt' Contents ======== -I. Windows - Requirements for Building VeraCrypt for Windows - Instructions for Building VeraCrypt for Windows - Instructions for Signing and Packaging VeraCrypt for Windows - -II. Linux and Mac OS X - Requirements for Building VeraCrypt for Linux and Mac OS X - Instructions for Building VeraCrypt for Linux and Mac OS X - Mac OS X specifics +I. Windows + Requirements for Building VeraCrypt for Windows + Instructions for Building VeraCrypt for Windows + Instructions for Signing and Packaging VeraCrypt for Windows + +II. Linux and Mac OS X + Requirements for Building VeraCrypt for Linux and Mac OS X + Instructions for Building VeraCrypt for Linux and Mac OS X + Mac OS X specifics III. FreeBSD and OpenSolaris @@ -59,11 +59,12 @@ some cases (e.g. playback of HD DVD content) also the 32-bit editions, do not allow the VeraCrypt driver to run without an appropriate digital signature. Therefore, all .sys files in official VeraCrypt binary packages are digitally signed with the digital certificate of the IDRIX, which was -issued by Thawt certification authority. At the end of each official .exe and +issued by Thawte certification authority. At the end of each official .exe and .sys file, there are embedded digital signatures and all related certificates (i.e. all certificates in the relevant certification chain, such as the certification authority certificates, CA-MS cross-certificate, and the -IDRIX certificate). Keep this in mind if you compile VeraCrypt +IDRIX certificate). +Keep this in mind if you compile VeraCrypt and compare your binaries with the official binaries. If your binaries are unsigned, the sizes of the official binaries will usually be approximately 10 KB greater than sizes of your binaries (there may be further differences @@ -100,8 +101,8 @@ Instructions for Building VeraCrypt for Windows: 7) If successful, there should be newly built VeraCrypt binaries in the 'Release' folder. -Instructions for Signing VeraCrypt for Windows: ------------------------------------------------- +Instructions for Signing and Packaging VeraCrypt for Windows: +------------------------------------------------------------- The folder "Signing" contains a batch file (sign.bat) that will sign all VeraCrypt components using a code signing certificate present on the @@ -143,7 +144,7 @@ Instructions for Building VeraCrypt for Linux and Mac OS X: command to configure the wxWidgets static library for VeraCrypt and to build it: - $ make WXSTATIC=1 WX_ROOT=/usr/src/wxWidgets wxbuild + $ make WXSTATIC=1 WX_ROOT=/usr/src/wxWidgets wxbuild The variable WX_ROOT must point to the location of the source code of the wxWidgets library. Output files will be placed in the './wxrelease/' @@ -151,11 +152,11 @@ Instructions for Building VeraCrypt for Linux and Mac OS X: 3) To build VeraCrypt, run the following command: - $ make + $ make or if you have no wxWidgets shared library installed: - $ make WXSTATIC=1 + $ make WXSTATIC=1 4) If successful, the VeraCrypt executable should be located in the directory 'Main'. @@ -165,8 +166,8 @@ interface (through the switch --text) is built. On Linux, a console-only executable, which requires no GUI library, can be built using the 'NOGUI' parameter: - $ make NOGUI=1 WXSTATIC=1 WX_ROOT=/usr/src/wxWidgets wxbuild - $ make NOGUI=1 WXSTATIC=1 + $ make NOGUI=1 WXSTATIC=1 WX_ROOT=/usr/src/wxWidgets wxbuild + $ make NOGUI=1 WXSTATIC=1 On MacOSX, building a console-only executable is not supported. @@ -174,7 +175,7 @@ Mac OS X specifics: ----------------------------------------------------------- Under MacOSX, the SDK for OSX 10.7 is used by default. To use another version -of the SDK (e.i. 10.6), you can export the environment variable VC_OSX_TARGET : +of the SDK (i.e. 10.6), you can export the environment variable VC_OSX_TARGET: $ export VC_OSX_TARGET=10.6 @@ -193,7 +194,7 @@ https://osxfuse.github.io/ (MacFUSE compatibility layer must selected) The script build_veracrypt_macosx.sh available under "src/Build" performs the full build of VeraCrypt including the creation of the installer pkg. It expects to find the wxWidgets 3.0.2 sources at the same level as where you put -VeraCrypt sources (e.i. if "src" path is "/Users/joe/Projects/VeraCrypt/src" +VeraCrypt sources (i.e. if "src" path is "/Users/joe/Projects/VeraCrypt/src" then wxWidgets should be at "/Users/joe/Projects/wxWidgets-wxWidgets-3.0.2") The build process uses Code Signing certificates whose ID is specified in @@ -219,8 +220,8 @@ IV. Third-Party Developers (Contributors) If you intend to implement a feature, please contact us first to make sure: 1) That the feature has not been implemented (we may have already implemented - it, but haven't released the code yet). -2) That the feature is acceptable. + it, but haven't released the code yet). +2) That the feature is acceptable. 3) Whether we need help of third-party developers with implementing the feature. Information on how to contact us can be found at: -- cgit v1.2.3