From 1b5748544f06d8bbcab8f1b12ac9ea65a53f154e Mon Sep 17 00:00:00 2001
From: We-unite <3205135446@qq.com>
Date: Fri, 7 Jun 2024 02:10:42 +0800
Subject: Write README.md && ohoshell.sh

ohoshell.sh is used to compile bcsh for Linux kernel of OpenHarmony
---
 README.md   | 36 ++++++++++++++++++++++++++++++++++++
 ohoshell.sh | 42 ++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 78 insertions(+)
 create mode 100644 README.md
 create mode 100644 ohoshell.sh

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d75af6d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,36 @@
+[toc]
+
+# 我与 shell
+
+我是个喜欢用 Linux 命令行的人，**喜欢用命令行来完成一切工作，喜欢这种自己独掌系统一切的感觉**，仿佛自己是这台电脑的创世神~~，虽然现实中我只是废柴一个~~。对于每个学习 Linux 的人来说，bash 绝对是一座绕不过去的山，即使已有了 zsh、fish shell 等更加现代化、更加友好的工具，bash 由于其普适性和强大的功能，依然是大多数生产环境的首选。
+
+但我在学 bash 时遇到了不小的困难，我发现 bash 的语法规定过于奇怪繁杂，完全不像其他编程语言，甚至就连 if 和括号之间都要求必须插入空格，第一次学的时候我在这里犯错，还找了好久。相比之下，我更喜欢 C 语言的语法（也许是我计算机入门学的就是 C 的缘故吧），多简洁明了啊！
+
+# bcsh 由来
+
+在学习 Linux-0.12 的过程中，我第一次了解到，**原来 shell 和我们自己编写的其他程序一样，是一个独立于操作系统之外的用户态程序**，因而是可以替换的、甚至是可以自己编写的。本来这件事遥遥无期，也许一辈子都不会去做，但我偏偏遇到了网络信息技术大赛，看到了开源鸿蒙 Terminal 应用开发这条赛道。嗯……shell 开发怎么不算 Terminal 应用开发呢？（笑。）于是一个计划生根发芽。
+
+我的计划是这样的：**我要自己编写一个 shell，这个 shell 要能够完全替代 bash，而且要比 bash 更加简洁易用**。这个 shell 的名字就叫 bcsh，意为“Better C Shell”。我希望通过这个 shell 的开发，能够更加深入地了解 shell 的工作原理，同时也能够提高自己的编程能力。
+
+我的设计初衷是，在基本命令与功能上，尽可能地贴近 bash，以免影响我自己的使用习惯；同时，在 case、if、循环等语法上，向 C 语言靠拢，让初学者（主要是我自己）更容易上手。当然，我也会在这个过程中，尽可能地保持代码的简洁性和可读性。因而我为它取了"bcsh"这个名字：
+
+- bcsh 看起来像 bash，也可以解释为"Better C shell"，贴合了既类似 bash、语法又像 C 的设计初衷
+- "Better Chen shell"，希望在自己动手的过程中能有所成长
+
+经过几天的设计，我发现编写 shell 并不是件简单的事情，就连普通功能向 bash 靠近都很有难度，bash 对于重定向、设置环境变量、读取配置文件、路径模糊匹配等的支持令人叹为观止；我仅仅是实现了基础的命令解析运行，就已经耗费了不少心力。但，**权且保留 bcsh 这个名字吧，梦想还是要有的，万一实现了呢？**
+
+# 功能清单
+
+## Done
+
+- 最基本命令的解析与执行
+- 管道和重定向、与、或等逻辑的支持
+- 命令行提示信息：用户名、主机名、当前路径、终端提示符
+
+## TODO list
+
+- Ctrl+C、Ctrl+D、Ctrl+Z 等信号的处理
+- 复杂语法的支持：if、case、循环等
+- 设置与显示环境变量
+- 命令历史记录
+- 读取配置文件、运行脚本等
diff --git a/ohoshell.sh b/ohoshell.sh
new file mode 100644
index 0000000..341b5ad
--- /dev/null
+++ b/ohoshell.sh
@@ -0,0 +1,42 @@
+#!/bin/bash
+
+##########################################################################
+# File Name    : ohoshell.sh
+# Encoding     : utf-8
+# Author       : We-unite
+# Email        : weunite1848@gmail.com
+# Created Time : 2024-06-07 02:05:05
+##########################################################################
+
+set -e
+native=~/app/native
+
+if [ $# -ne 1 ]; then
+    echo "Usage: $0 <armv7-a | armv8-a>"
+    exit 1
+fi
+
+arch=$1
+
+case $arch in
+	armv8-a)
+		compiler=$native/llvm/bin/aarch64-unknown-linux-ohos-clang
+		targetPlatform=aarch64-linux-ohos
+		;;
+	armv7-a)
+		compiler=$native/llvm/bin/armv7-unknown-linux-ohos-clang
+		targetPlatform=arm-linux-ohos
+		;;
+	*)
+		echo "Unsupported arch"
+		exit 1
+		;;
+esac
+
+flex -o lex.yy.c lex.l
+bison -o syntax.tab.c -d -v syntax.y -Wcounterexamples
+
+$compiler -o bcsh bcsh.c syntax.tab.c -Wall \
+	--target=$targetPlatform \
+	--sysroot=$native/sysroot \
+	-march=$arch -mfloat-abi=softfp
\ No newline at end of file
-- 
cgit v1.2.3-70-g09d2