clang, clang++, gcc, g++: standardize English page and Indonesian translation (#13751)

* clang, clang++, gcc, g++: standardize English page and add Indonesian translation

This commit adds the short and long-form parameters, enforce imperative mood, and standardizes the contents between `clang` and `gcc` as well as `clang++` and `g++`.

* clang++: Apply suggestions from code review

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>

* clang++: fix URL

* clang, clang++, gcc, g++: fix translation inconsistencies

* Apply suggestions from code review

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>

* Update pages/common/gcc.md

* Update pages.id/common/clang++.md

* Update pages.id/common/clang++.md

* clang++, g++: fix file extension

---------

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>
Co-authored-by: Sebastiaan Speck <shem.speck@gmail.com>

pages/common/clang++.md

@@ -4,26 +4,34 @@
 > Part of LLVM.
 > More information: <https://clang.llvm.org>.
 
-- Compile a source code file into an executable binary:
+- Compile a set of source code files into an executable binary:
 
-`clang++ {{path/to/source.cpp}} -o {{path/to/output_executable}}`
+`clang++ {{path/to/source1.cpp path/to/source2.cpp ...}} {{-o|--output}} {{path/to/output_executable}}`
 
-- Display (almost) all errors and warnings:
+- Activate output of all errors and warnings:
 
-`clang++ {{path/to/source.cpp}} -Wall -o {{path/to/output_executable}}`
+`clang++ {{path/to/source.cpp}} -Wall {{-o|--output}} {{output_executable}}`
 
-- Choose a language standard to compile with:
+- Show common warnings, debug symbols in output, and optimize without affecting debugging:
 
-`clang++ {{path/to/source.cpp}} -std={{c++20}} -o {{path/to/output_executable}}`
+`clang++ {{path/to/source.cpp}} -Wall {{-g|--debug}} -Og {{-o|--output}} {{path/to/output_executable}}`
+
+- Choose a language standard to compile for:
+
+`clang++ {{path/to/source.cpp}} -std={{c++20}} {{-o|--output}} {{path/to/output_executable}}`
 
 - Include libraries located at a different path than the source file:
 
-`clang++ {{path/to/source.cpp}} -o {{path/to/output_executable}} -I{{path/to/header_path}} -L{{path/to/library_path}} -l{{path/to/library_name}}`
+`clang++ {{path/to/source.cpp}} {{-o|--output}} {{path/to/output_executable}} -I{{path/to/header_path}} -L{{path/to/library_path}} -l{{path/to/library_name}}`
 
 - Compile source code into LLVM Intermediate Representation (IR):
 
-`clang++ -S -emit-llvm {{path/to/source.cpp}} -o {{path/to/output.ll}}`
+`clang++ {{-S|--assemble}} -emit-llvm {{path/to/source.cpp}} {{-o|--output}} {{path/to/output.ll}}`
 
 - Optimize the compiled program for performance:
 
-`clang++ {{path/to/source.cpp}} -O{{1|2|3|fast}} -o {{path/to/output_executable}}`
+`clang++ {{path/to/source.cpp}} -O{{1|2|3|fast}} {{-o|--output}} {{path/to/output_executable}}`
+
+- Display version:
+
+`clang++ --version`

pages/common/clang.md

@@ -1,28 +1,37 @@
 # clang
 
-> Compiler for C, C++, and Objective-C source files. Can be used as a drop-in replacement for GCC.
+> Compile C, C++, and Objective-C source files. Can be used as a drop-in replacement for GCC.
+> Part of LLVM.
 > More information: <https://clang.llvm.org/docs/ClangCommandLineReference.html>.
 
-- Compile a source code file into an executable binary:
+- Compile multiple source files into an executable:
 
-`clang {{input_source.c}} -o {{output_executable}}`
+`clang {{path/to/source1.c path/to/source2.c ...}} {{-o|--output}} {{path/to/output_executable}}`
 
 - Activate output of all errors and warnings:
 
-`clang {{input_source.c}} -Wall -o {{output_executable}}`
+`clang {{path/to/source.c}} -Wall {{-o|--output}} {{output_executable}}`
 
-- Include libraries located at a different path than the source file:
+- Show common warnings, debug symbols in output, and optimize without affecting debugging:
 
-`clang {{input_source.c}} -o {{output_executable}} -I{{header_path}} -L{{library_path}} -l{{library_name}}`
+`clang {{path/to/source.c}} -Wall {{-g|--debug}} -Og {{-o|--output}} {{path/to/output_executable}}`
+
+- Include libraries from a different path:
+
+`clang {{path/to/source.c}} {{-o|--output}} {{path/to/output_executable}} -I{{path/to/header}} -L{{path/to/library}} -l{{library_name}}`
 
 - Compile source code into LLVM Intermediate Representation (IR):
 
-`clang -S -emit-llvm {{file.c}} -o {{file.ll}}`
+`clang {{-S|--assemble}} -emit-llvm {{path/to/source.c}} {{-o|--output}} {{path/to/output.ll}}`
 
-- Compile source code without linking:
+- Compile source code into an object file without linking:
 
-`clang -c {{input_source.c}}`
+`clang {{-c|--compile}} {{path/to/source.c}}`
 
 - Optimize the compiled program for performance:
 
-`clang {{path/to/source.c}} -O{{1|2|3|fast}}`
+`clang {{path/to/source.c}} -O{{1|2|3|fast}} {{-o|--output}} {{path/to/output_executable}}`
+
+- Display version:
+
+`clang --version`

pages/common/g++.md

@@ -1,32 +1,36 @@
 # g++
 
-> Compiles C++ source files.
+> Compile C++ source files.
 > Part of GCC (GNU Compiler Collection).
 > More information: <https://gcc.gnu.org>.
 
 - Compile a source code file into an executable binary:
 
-`g++ {{path/to/source.cpp}} -o {{path/to/output_executable}}`
+`g++ {{path/to/source1.cpp path/to/source2.cpp ...}} {{-o|--output}} {{path/to/output_executable}}`
 
-- Display common warnings:
+- Activate output of all errors and warnings:
 
-`g++ {{path/to/source.cpp}} -Wall -o {{path/to/output_executable}}`
+`g++ {{path/to/source.cpp}} -Wall {{-o|--output}} {{output_executable}}`
+
+- Show common warnings, debug symbols in output, and optimize without affecting debugging:
+
+`g++ {{path/to/source.cpp}} -Wall {{-g|--debug}} -Og {{-o|--output}} {{path/to/output_executable}}`
 
 - Choose a language standard to compile for (C++98/C++11/C++14/C++17):
 
-`g++ {{path/to/source.cpp}} -std={{c++98|c++11|c++14|c++17}} -o {{path/to/output_executable}}`
+`g++ {{path/to/source.cpp}} -std={{c++98|c++11|c++14|c++17}} {{-o|--output}} {{path/to/output_executable}}`
 
 - Include libraries located at a different path than the source file:
 
-`g++ {{path/to/source.cpp}} -o {{path/to/output_executable}} -I{{path/to/header}} -L{{path/to/library}} -l{{library_name}}`
+`g++ {{path/to/source.cpp}} {{-o|--output}} {{path/to/output_executable}} -I{{path/to/header}} -L{{path/to/library}} -l{{library_name}}`
 
 - Compile and link multiple source code files into an executable binary:
 
-`g++ -c {{path/to/source1.cpp path/to/source2.cpp ...}} && g++ -o {{path/to/output_executable}} {{path/to/source1.o path/to/source2.o ...}}`
+`g++ {{-c|--compile}} {{path/to/source1.cpp path/to/source2.cpp ...}} && g++ {{-o|--output}} {{path/to/output_executable}} {{path/to/source1.o path/to/source2.o ...}}`
 
 - Optimize the compiled program for performance:
 
-`g++ {{path/to/source.cpp}} -O{{1|2|3|fast}} -o {{path/to/output_executable}}`
+`g++ {{path/to/source.cpp}} -O{{1|2|3|fast}} {{-o|--output}} {{path/to/output_executable}}`
 
 - Display version:
 

pages/common/gcc.md

@@ -1,28 +1,37 @@
 # gcc
 
 > Preprocess and compile C and C++ source files, then assemble and link them together.
+> Part of GCC (GNU Compiler Collection).
 > More information: <https://gcc.gnu.org>.
 
 - Compile multiple source files into an executable:
 
-`gcc {{path/to/source1.c path/to/source2.c ...}} -o {{path/to/output_executable}}`
+`gcc {{path/to/source1.c path/to/source2.c ...}} {{-o|--output}} {{path/to/output_executable}}`
+
+- Activate output of all errors and warnings:
+
+`gcc {{path/to/source.c}} -Wall {{-o|--output}} {{output_executable}}`
 
 - Show common warnings, debug symbols in output, and optimize without affecting debugging:
 
-`gcc {{path/to/source.c}} -Wall -g -Og -o {{path/to/output_executable}}`
+`gcc {{path/to/source.c}} -Wall {{-g|--debug}} -Og {{-o|--output}} {{path/to/output_executable}}`
 
 - Include libraries from a different path:
 
-`gcc {{path/to/source.c}} -o {{path/to/output_executable}} -I{{path/to/header}} -L{{path/to/library}} -l{{library_name}}`
+`gcc {{path/to/source.c}} {{-o|--output}} {{path/to/output_executable}} -I{{path/to/header}} -L{{path/to/library}} -l{{library_name}}`
 
 - Compile source code into Assembler instructions:
 
-`gcc -S {{path/to/source.c}}`
+`gcc {{-S|--assemble}} {{path/to/source.c}}`
 
 - Compile source code into an object file without linking:
 
-`gcc -c {{path/to/source.c}}`
+`gcc {{-c|--compile}} {{path/to/source.c}}`
 
 - Optimize the compiled program for performance:
 
-`gcc {{path/to/source.c}} -O{{1|2|3|fast}} -o {{path/to/output_executable}}`
+`gcc {{path/to/source.c}} -O{{1|2|3|fast}} {{-o|--output}} {{path/to/output_executable}}`
+
+- Display version:
+
+`gcc --version`