From 5569db9a314d9dd4b2bb9f5c2a67dc6ddb63a5a0 Mon Sep 17 00:00:00 2001
From: zhipengh <huangzhipeng@huawei.com>
Date: Tue, 20 Sep 2016 21:18:05 +0800
Subject: Parser Release C RC1 docs final clean up

Change-Id: Ib74e8cbaaa6397e9f9f1e9eba35d7d2f8e8d5108
Signed-off-by: zhipengh <huangzhipeng@huawei.com>
(cherry picked from commit c5df8adbaf4eaa0005c372b242652cc6542df7c6)
---
 docs/userguide/featureusage.rst | 102 +++++++++++++++++++++++++++++++++++++---
 1 file changed, 95 insertions(+), 7 deletions(-)

(limited to 'docs/userguide/featureusage.rst')

diff --git a/docs/userguide/featureusage.rst b/docs/userguide/featureusage.rst
index db2557f..c42330c 100644
--- a/docs/userguide/featureusage.rst
+++ b/docs/userguide/featureusage.rst
@@ -2,10 +2,10 @@
 .. http://creativecommons.org/licenses/by/4.0
 .. (c) <optionally add copywriters name>
 
-Installation
+Parser tosca2heat Installation
 ============================
 
-Please follow the below installation steps to install parser.
+Please follow the below installation steps to install tosca2heat submodule in parser.
 
 Step 1: Clone the parser project.
 
@@ -50,7 +50,7 @@ Step 3: Install the tosca-parser sub project.
   components, and install heat-translator before installing tosca-parser, which is sure to use the
   OPNFV version of tosca-parser and heat-translator other than openstack's components.
 
-Execution
+Parser tosca2heat Execution
 ===========================
 
 Step 1: Change directory to where the tosca yaml files are present, example is
@@ -75,9 +75,9 @@ Example:
     heat-translator --template-file=vRNC.yaml \
         --template-type=tosca --output-file=vRNC_hot.yaml
 
-Notes: heat-translator will call class of ToscaTemplate in tosca-parser firstly to validate and parse input yaml file,
-then tranlate the file into hot file, if you only want to validate or check the input file
-and don't want to translate, please use tosaca-parser as following:
+Notes: heat-translator will call class of ToscaTemplate in tosca-parser firstly to validate and
+parse input yaml file, then tranlate the file into hot file, if you only want to validate or
+check the input file and don't want to translate, please use tosaca-parser as following:
 
 .. code-block:: bash
 
@@ -89,8 +89,96 @@ Example:
 
    tosca-parser --template-file=vRNC.yaml
 
-References
+Parser tosca2heat References
 ===========================
 Refer two upstream components:
  https://github.com/openstack/tosca-parser/blob/master/doc/source/usage.rst
  https://github.com/openstack/heat-translator/blob/master/doc/source/usage.rst
+
+
+
+
+Parser yang2tosca Execution
+============================
+
+Step 1: Change directory to where the scripts are present.
+
+.. code-block:: bash
+
+    cd parser/yang2tosca
+
+Step 2: Copy the YANG file which needs to be converted into TOSCA to
+        current (parser/yang2tosca) folder.
+
+Step 3: Run the python script "parser.py" with the YANG file as an input option.
+
+.. code-block:: bash
+
+    python parser.py -n "YANG filename"
+
+Example:
+
+.. code-block:: bash
+
+    python parser.py -n example.yaml
+
+Step 4: Verify the TOSCA YAMl which file has been created with the same name
+        as the YANG file with a “_tosca” suffix.
+
+.. code-block:: bash
+
+    cat "YANG filename_tosca.yaml"
+
+Example:
+
+.. code-block:: bash
+
+    cat example_tosca.yaml
+
+
+
+
+
+Parser policy2tosca Execution
+============================
+
+Step 1: To see a list of commands available.
+
+.. code-block:: bash
+
+    policy2tosca --help
+
+Step 2: To see help for an individual command, include the command name on the command line
+
+.. code-block:: bash
+
+    policy2tosca help <service>
+
+Step 3: To inject/remove policy types/policy definitions provide the TOSCA file as input to
+policy2tosca command line.
+
+.. code-block:: bash
+
+    policy2tosca <service> [arguments]
+
+Example:
+
+.. code-block:: bash
+
+    policy2tosca add-definition --policy_name rule2 --policy_type  tosca.policies.Placement.Geolocation
+--description "test description" --properties region:us-north-1,region:us-north-2,min_inst:2 --targets
+VNF2,VNF4 --metadata "map of strings" --triggers "1,2,3,4" --source example.yaml
+
+
+Step 4: Verify the TOSCA YAMl updated with the injection/removal executed.
+
+.. code-block:: bash
+
+    cat "<source tosca file>"
+
+Example:
+
+.. code-block:: bash
+
+    cat example_tosca.yaml
+
-- 
cgit 1.2.3-korg