From 8d08cdbc53eac54fa3f39474587a5a9f8c31857e Mon Sep 17 00:00:00 2001
From: Andrei Gherzan <andrei.gherzan@huawei.com>
Date: Tue, 26 Jul 2022 11:32:41 +0200
Subject: [PATCH] docs: Clarify/exemplify getting code-v3.0.1-LTS.tar.gz

Fixes: https://gitlab.eclipse.org/eclipse/oniro-core/meta-openharmony/-/issues/41

Signed-off-by: Andrei Gherzan <andrei.gherzan@huawei.com>
---
 recipes-openharmony/sdk/README.rst | 29 ++++++++++++++++++++++-------
 1 file changed, 22 insertions(+), 7 deletions(-)

diff --git a/recipes-openharmony/sdk/README.rst b/recipes-openharmony/sdk/README.rst
index 0e7aed65..5a32b58b 100644
--- a/recipes-openharmony/sdk/README.rst
+++ b/recipes-openharmony/sdk/README.rst
@@ -62,18 +62,33 @@ Warning! It is recommended to only install OpenHarmony prebuilts to clean
 upstream OpenHarmony source repsitories, as the installation will remove files
 and entire git repositories!
 
+Firstly, you need to download an OpenHarmony archive. As an example, the next
+steps will use OpenHarmony 3.0.1. You are to download this archive from
+https://repo.huaweicloud.com/harmonyos/os/3.0.1/code-v3.0.1-LTS.tar.gz and
+dearchive it:
+
+.. code-block:: console
+
+    $ tar xfz $DOWNLOADS/code-v3.0.1-LTS.tar.gz
+
+Note that the `$DOWNLOADS` variable needs to point to the location where the
+archive resides.
+
 To install the `oniro-openharmony-bundle` to a clean OpenHarmony 3.0.1
-repository, you should do something like this::
+repository, you should do something like this:
+
+.. code-block:: console
 
-    tar xfz $DOWNLOADS/code-v3.0.1-LTS.tar.gz
-    cd code-v3.0.1-LTS/OpenHarmony
-    $DOWNLOADS/oniro-openharmony-bundle-3.0-cortexa7-neon-vfpv4-1.99.99.sh -y -d oniro
-    ./oniro/setup.sh
+    $ cd code-v3.0.1-LTS/OpenHarmony
+    $ $DOWNLOADS/oniro-openharmony-bundle-3.0-cortexa7-neon-vfpv4-1.99.99.sh -y -d oniro
+    $ ./oniro/setup.sh
 
 After this, you can use normal OpenHarmony build system procedures to build as
-usual.  To build image for HiSilicon Hi3516DV300 (taurus) board::
+usual.  To build image for HiSilicon Hi3516DV300 (taurus) board:
+
+.. code-block:: console
 
-    ./build.sh --product-name Hi3516DV300
+    $ ./build.sh --product-name Hi3516DV300
 
 
 Use inside BitBake
-- 
GitLab