summaryrefslogtreecommitdiffstats
path: root/BaseTools/ReadMe.rst
diff options
context:
space:
mode:
authorRebecca Cran <rebecca@bsdio.com>2020-07-08 07:13:15 +0800
committermergify[bot] <37929162+mergify[bot]@users.noreply.github.com>2020-07-21 04:12:32 +0000
commit210b29fa9907622f9eb56d98bad9ff25018c913f (patch)
treea389cc9dbc3e176d98a3932d15723d380ab911f8 /BaseTools/ReadMe.rst
parenta8ae714d4aa20c457e4674c1fb61ffa6b7bfdbeb (diff)
downloadedk2-210b29fa9907622f9eb56d98bad9ff25018c913f.tar.gz
edk2-210b29fa9907622f9eb56d98bad9ff25018c913f.tar.bz2
edk2-210b29fa9907622f9eb56d98bad9ff25018c913f.zip
BaseTools: rename ReadMe.txt to ReadMe.rst
The ReadMe file is now RST, so update the filename extension to match. Signed-off-by: Rebecca Cran <rebecca@bsdio.com> Cc: Bob Feng <bob.c.feng@intel.com> Cc: Liming Gao <liming.gao@intel.com> Reviewed-by: Bob Feng <bob.c.feng@intel.com>
Diffstat (limited to 'BaseTools/ReadMe.rst')
-rw-r--r--BaseTools/ReadMe.rst41
1 files changed, 41 insertions, 0 deletions
diff --git a/BaseTools/ReadMe.rst b/BaseTools/ReadMe.rst
new file mode 100644
index 0000000000..de85ca4be6
--- /dev/null
+++ b/BaseTools/ReadMe.rst
@@ -0,0 +1,41 @@
+This directory contains the EDK II build tools and template files.
+Templates are located in the Conf directory, while the tools executables for
+Microsoft Windows Operating Systems are located in the Bin\\Win32 directory, other
+directory contains tools source.
+
+Build step to generate the binary tools
+---------------------------------------
+
+Windows/Visual Studio Notes
+===========================
+
+To build the BaseTools, you should run the standard vsvars32.bat script
+from your preferred Visual Studio installation or you can run get_vsvars.bat
+to use latest automatically detected version.
+
+In addition to this, you should set the following environment variables::
+
+ * EDK_TOOLS_PATH - Path to the BaseTools sub directory under the edk2 tree
+ * BASE_TOOLS_PATH - The directory where the BaseTools source is located.
+ (It is the same directory where this README.rst is located.)
+
+After this, you can run the toolsetup.bat file, which is in the same
+directory as this file. It should setup the remainder of the environment,
+and build the tools if necessary.
+
+Please also refer to the ``BuildNotes.txt`` file for more information on
+building under Windows.
+
+Unix-like operating systems
+===========================
+
+To build on Unix-like operating systems, you only need to type ``make`` in
+the base directory of the project.
+
+Ubuntu Notes
+============
+
+On Ubuntu, the following command should install all the necessary build
+packages to build all the C BaseTools::
+
+ sudo apt install build-essential uuid-dev