From 5aa7f1ad704b48eb3843de3f071cd9ad179f3df2 Mon Sep 17 00:00:00 2001
From: NunoSempere <nuno.sempere@protonmail.com>
Date: Sat, 29 Apr 2023 18:56:11 -0400
Subject: [PATCH] tweak: change name to mumble.

---
 lisp                   | Bin 3052 -> 0 bytes
 makefile               |   7 ++-
 notes/gbd-tutorial.txt | 130 +++++++++++++++++++++++++++++++++++++++++
 notes/typedef.txt      |  11 ++++
 src/lisp.c             |   6 --
 src/mumble.c           |  20 +++++++
 6 files changed, 166 insertions(+), 8 deletions(-)
 delete mode 100755 lisp
 create mode 100644 notes/gbd-tutorial.txt
 create mode 100644 notes/typedef.txt
 delete mode 100644 src/lisp.c
 create mode 100644 src/mumble.c

diff --git a/lisp b/lisp
deleted file mode 100755
index 37a4ec9b04e6429b55cdf5dcd1532dbcad4376d6..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 3052
zcmbtW-D@0G6hFJ0P2xu<(MDKkFzZ8c`;bX0Y1lqQW<pYLU>}M$wP4!GB-u0zo82%o
zi%CUPR>dJkgD<|OZ}}5^QL7QeH+`sxRun(5N|fRUgko9GxpPjuS?f!CVdr<x@0{N~
z=YGtcePOb6DxFG!v@|>pWH}i}Q^^xxw^N(U6(I`_^ub{uI*UI?dkB-BV2+0t?BKWz
zBK6O)|6D533HEcGAcyJNDBr)$;ckM8oq_;)?I%6eD!j_hYF<zeOpGLAT^cFU&G5K0
ztP|WqAGIz0Oy)%0p=xDrbY!TyFj%eB8moh=#nHjh5j(8gk8$LGfl@zc(BE?{huipT
z%;z-U3B4VTR>`^)nBU4Id|7(|ip)2dKgRqRVxId4!1Hhx^IjPFLF6s_l^U!xq7ay#
z4;$WMrB*R*G$YWFo_BG%USq8XG!V^x6cf<CcQMjApt@;|Z`Ww5v<JD)S?#7c(n!l2
zyqqoa6%3xnmo{whG`6%N^Hdk*lja!lx2y4wo`-K9|8*+<?1GBFQ_UZ4oIX=p&%T$=
zgIYiIzJ{?Y2(5=c#OI%z6u&dA;vdyZyS<o1#n11lxN$>mWZzApDE|2RWvuHR%Kym@
z0L8mcmo~<pL)JYz6@TtdPsM+^XWaPjX|*x9fb>(PW4BauxBL2|Xs8cvWuk%OU-b;U
zNMn@Z-%Igt6Y)=OtM41t+)1gEUpIbH&5ydDIq%N6=iLjgx3jot_YAyD;W{6t#n&KN
zg+9%qed$R^t@fsl+~3u`iD`(}?`Esj8lsqqE}D+!3EShzDe>lh{NMN!MtqqDJZ1I1
znVzz8Z)7H|{6@#5Rd_u+VGY09sjOnN>j}%LSw+_xcCEs=l^?fq<5usu)vfDUKzRY{
zH1pEB(weFD?8y|a`zu$Xbn8=EmmR$Z+NUi_4$wOBCEzX|y@pS1AH9jaB^vVQZ*gqm
zRJmHM=bx<y)rCjMPSFEfDFJ=%sT-vo0)6fY`_m4={yPw*68m1w0-R;MkCEPcYIIhq
zZKoXq=+;kwO~!i|C7#U#Aoth-@=gppDz8RhFZhuU_FNc(9n{IN=fh|O?DCSg82HO&
zu=N#T>x;u)3Cd)8eh~O;iA(wvApJ@$DhDe#_*yMoTTU<vz+UphC2jf3m3go)*0F$~
zT=kRQN)^p;DU5>1pSzPOwQFXOpgooQLB3V;4b$h_5Xt@vMdy(AQ1r6T5eIH_V1}`S
zQTDHjHu*#^=cb<tIVUXJKYwCJ*r5X}dO3#?6C)fbe#tNR8v3a(emQsBOvt$-^8t=U
z0I8p*Nk6$qos5GP;C~Gba5aJbr@m13t>oKCdih4?IvnlIae-2&NW>N#KnLli{ygjR
z9Pot*8RdNvn!cB2{d=t6WBm~cWR$!@(>-bG`?8L9_3_1YNCFw#^(T-w>o2grU|wv-
z813~>+@=2XUFzRrz3hK`{dx48P3o6*p!<&IFYkx^ca#5gbmq(^df_f%hjNQv?mqc%
zx5a_tm%MTgo9H+5L+5Ow;0Y<#3rKz$hxV5^8DFtp$%2TGQS?H;ZD@rf6#ZqB#6Hz(
GwtoPgVJFl8

diff --git a/makefile b/makefile
index 0b24ede..653d8cf 100644
--- a/makefile
+++ b/makefile
@@ -8,15 +8,18 @@
 ## C compiler
 CC=tcc # much faster compilation than gcc
 
+## Debugging options
+DEBUG=-g#-g
+
 ## Main file
-SRC=./src/lisp.c
+SRC=./src/mumble.c
 
 ## Formatter
 STYLE_BLUEPRINT=webkit
 FORMATTER=clang-format -i -style=$(STYLE_BLUEPRINT)
 
 build: $(SRC)
-	$(CC) $(SRC) -o lisp
+	$(CC) $(SRC) -o mumble $(DEBUG) 
 
 format: $(SRC)
 	$(FORMATTER) $(SRC)
diff --git a/notes/gbd-tutorial.txt b/notes/gbd-tutorial.txt
new file mode 100644
index 0000000..d08b133
--- /dev/null
+++ b/notes/gbd-tutorial.txt
@@ -0,0 +1,130 @@
+From: <https://www.thegeekstuff.com/2010/03/debug-c-program-using-gdb/>
+
+In this article, let us discuss how to debug a c program using gdb debugger in 6 simple steps.  
+
+### Write a sample C program with errors for debugging purpose
+
+To learn C program debugging, let us create the following C program that calculates and prints the factorial of a number. However this C program contains some errors in it for our debugging purpose.
+
+$ vim factorial.c
+# include <stdio.h>
+
+int main()
+{
+	int i, num, j;
+	printf ("Enter the number: ");
+	scanf ("%d", &num );
+
+	for (i=1; i<num; i++)
+		j=j\*i;    
+
+	printf("The factorial of %d is %d\\n",num,j);
+}
+
+$ cc factorial.c
+
+$ ./a.out
+Enter the number: 3
+The factorial of 3 is 12548672
+
+Let us debug it while reviewing the most useful commands in gdb.
+
+### Step 1. Compile the C program with debugging option -g
+
+Compile your C program with -g option. This allows the compiler to collect the debugging information.
+
+$ cc -g factorial.c
+
+Note: The above command creates a.out file which will be used for debugging as shown below.
+
+### Step 2. Launch gdb
+
+Launch the C debugger (gdb) as shown below.
+
+$ gdb a.out
+
+### Step 3. Set up a break point inside C program
+
+Syntax:
+
+break line\_number
+
+Other formats:
+
+*   break \[file\_name\]:line\_number
+*   break \[file\_name\]:func\_name
+
+Places break point in the C program, where you suspect errors. While executing the program, the debugger will stop at the break point, and gives you the prompt to debug.
+
+So before starting up the program, let us place the following break point in our program.
+
+break 10
+Breakpoint 1 at 0x804846f: file factorial.c, line 10.
+
+### Step 4. Execute the C program in gdb debugger
+
+run \[args\]
+
+You can start running the program using the run command in the gdb debugger. You can also give command line arguments to the program via run args. The example program we used here does not requires any command line arguments so let us give run, and start the program execution.
+
+run
+Starting program: /home/sathiyamoorthy/Debugging/c/a.out
+
+Once you executed the C program, it would execute until the first break point, and give you the prompt for debugging.
+
+Breakpoint 1, main () at factorial.c:10
+10			j=j\*i;
+
+You can use various gdb commands to debug the C program as explained in the sections below.
+
+### Step 5. Printing the variable values inside gdb debugger
+
+Syntax: print {variable}
+
+Examples:
+print i
+print j
+print num
+
+(gdb) p i
+$1 = 1
+(gdb) p j
+$2 = 3042592
+(gdb) p num
+$3 = 3
+(gdb)
+
+As you see above, in the factorial.c, we have not initialized the variable j. So, it gets garbage value resulting in a big numbers as factorial values.
+
+Fix this issue by initializing variable j with 1, compile the C program and execute it again.
+
+Even after this fix there seems to be some problem in the factorial.c program, as it still gives wrong factorial value.
+
+So, place the break point in 10th line, and continue as explained in the next section.
+
+### Step 6. Continue, stepping over and in – gdb commands
+
+There are three kind of gdb operations you can choose when the program stops at a break point. They are continuing until the next break point, stepping in, or stepping over the next program lines.
+
+*   c or continue: Debugger will continue executing until the next break point.
+*   n or next: Debugger will execute the next line as single instruction.
+*   s or step: Same as next, but does not treats function as a single instruction, instead goes into the function and executes it line by line.
+
+By continuing or stepping through you could have found that the issue is because we have not used the <= in the ‘for loop’ condition checking. So changing that from < to <= will solve the issue.
+
+### gdb command shortcuts
+
+Use following shortcuts for most of the frequent gdb operations.
+
+*   l – list
+*   p – print
+*   c – continue
+*   s – step
+*   ENTER: pressing enter key would execute the previously executed command again.
+
+### Miscellaneous gdb commands
+
+*   **l command:** Use gdb command l or list to print the source code in the debug mode. Use l line-number to view a specific line number (or) l function to view a specific function.
+*   **bt: backtrack** – Print backtrace of all stack frames, or innermost COUNT frames.
+*   **help** – View help for a particular gdb topic — help TOPICNAME.
+*   **quit** – Exit from the gdb debugger.
diff --git a/notes/typedef.txt b/notes/typedef.txt
new file mode 100644
index 0000000..9e4873a
--- /dev/null
+++ b/notes/typedef.txt
@@ -0,0 +1,11 @@
+typedef struct {
+  float x;
+  float y;
+} point;
+
+point p;
+p.x = 0.1;
+p.y = 10.0;
+
+float length = sqrt(p.x * p.x + p.y * p.y);
+
diff --git a/src/lisp.c b/src/lisp.c
deleted file mode 100644
index 6310cd9..0000000
--- a/src/lisp.c
+++ /dev/null
@@ -1,6 +0,0 @@
-#include <stdio.h>
-
-int main(int argc, char** argv){
-  puts("Hello world!");
-	return 0;
-}
diff --git a/src/mumble.c b/src/mumble.c
new file mode 100644
index 0000000..c162f6e
--- /dev/null
+++ b/src/mumble.c
@@ -0,0 +1,20 @@
+#include <stdio.h>
+
+static char input[2048];
+
+int main(int argc, char** argv)
+{
+    puts("Mumble version 0.0.1\n");
+    puts("Press Ctrl+C to exit\n");
+    int loop = 1;
+    while (loop) {
+        fputs("mumble>", stdout);
+        void* catcher = fgets(input, 2048, stdin);
+        if (catcher == NULL) {
+            loop = 0;
+        } else {
+            printf("You said: %s", input);
+        }
+    }
+    return 0;
+}