From 46f38332aabb28b94734ee7130659781c3d83a66 Mon Sep 17 00:00:00 2001
From: Marcello Lamonaca <marcello@lamonaca.eu>
Date: Mon, 24 Mar 2025 22:25:45 +0100
Subject: [PATCH] c: refine function notes

---
 docs/languages/c/c.md | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/docs/languages/c/c.md b/docs/languages/c/c.md
index f8d7e03..3a21112 100644
--- a/docs/languages/c/c.md
+++ b/docs/languages/c/c.md
@@ -402,15 +402,20 @@ It is possible to declare functions **after** the main only if the *prototype* i
 To return multiple variables those variables can be passed by reference so that their values is adjourned in the main.
 
 ```c
-type function_name(type argument1, ...); // function prototype
+// function prototype (usually in a .h file)
+type function_name(type argument1, ...); 
 
-type functionName (parameters) {
+// function implementation (usually in a .c file)
+type function_name (parameters) {
     return <expression>;
 }
 
-void functionName (parameters) { }
+// function without a return value
+void function_name (parameters) { }
 ```
 
+> **Note**: annotatic a function with `static` makes it visible only inside the file in which is implemented/declared
+
 ### Arguments passed by reference without pointers
 
 Passing arguments by reference causes modifications made inside the function to be propagated to the values outside.  
@@ -421,9 +426,9 @@ type functionName (type &argument1, ...) {
     //code here
     return <expression>;
 }
-```
 
-`functionName (arguments);`
+function_name (argument_1, ...);
+```
 
 ### Arguments passed by reference with pointers
 
@@ -435,9 +440,9 @@ type function_name (type *argument_1, ...) {
     instructions;
     return <expression>;
 }
-```
 
-`function_name (&argument_1, ...);`
+function_name (&argument_1, ...);
+```
 
 ## Arrays