From d29375da5cb5783def2026cff4cc77214e7f32fd Mon Sep 17 00:00:00 2001 From: Reinhart Previano Koentjoro Date: Mon, 23 Sep 2024 12:52:44 +0700 Subject: [PATCH] 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 --- pages.id/common/clang++.md | 37 +++++++++++++++++++++++++++++++++++++ pages.id/common/clang.md | 37 +++++++++++++++++++++++++++++++++++++ pages.id/common/g++.md | 34 +++++++++++++++++++++++++--------- pages.id/common/gcc.md | 21 +++++++++++++++------ pages/common/clang++.md | 26 +++++++++++++++++--------- pages/common/clang.md | 29 +++++++++++++++++++---------- pages/common/g++.md | 20 ++++++++++++-------- pages/common/gcc.md | 21 +++++++++++++++------ 8 files changed, 177 insertions(+), 48 deletions(-) create mode 100644 pages.id/common/clang++.md create mode 100644 pages.id/common/clang.md diff --git a/pages.id/common/clang++.md b/pages.id/common/clang++.md new file mode 100644 index 000000000..643e8eb90 --- /dev/null +++ b/pages.id/common/clang++.md @@ -0,0 +1,37 @@ +# clang++ + +> Susun kode C++. +> Part of LLVM. +> Informasi lebih lanjut: . + +- Ubah suatu berkas kode sumber menjadi program: + +`clang++ {{jalan/menuju/sumber1.cpp jalan/menuju/sumber2.cpp ...}} {{-o|--output}} {{jalan/menuju/program}}` + +- Tampilkan pesan peringatan dan galat dalam [o]utput: + +`clang++ {{jalan/menuju/sumber.cpp}} -Wall {{-o|--output}} {{jalan/menuju/program}}` + +- Izinkan peringatan dan simbol debug dalam [o]utput: + +`clang++ {{jalan/menuju/sumber.cpp}} -Wall {{-g|--debug}} -Og {{-o|--output}} {{jalan/menuju/program}}` + +- Pilih standar bahasa untuk dikompilasi: + +`clang++ {{jalan/menuju/sumber.cpp}} -std={{c++20}} {{-o|--output}} {{jalan/menuju/program}}` + +- Sertakan pustaka (library) dari direktori yang berbeda: + +`clang++ {{jalan/menuju/sumber.cpp}} {{-o|--output}} {{jalan/menuju/program}} -I{{jalan/menuju/header}} -L{{jalan/menuju/pustaka}} -l{{nama_pustaka}}` + +- Susun kode sumber menjadi program dalam format LLVM Intermediate Representation (IR): + +`clang++ {{-S|--assemble}} -emit-llvm {{jalan/menuju/sumber.cpp}} {{-o|--output}} {{jalan/menuju/program.ll}}` + +- [O]ptimalkan progam yang disusun agar dapat dijalankan lebih cepat: + +`clang++ {{jalan/menuju/sumber.cpp}} -O{{1|2|3|fast}} {{-o|--output}} {{jalan/menuju/program}}` + +- Tampilkan versi penyusun: + +`clang++ --version` diff --git a/pages.id/common/clang.md b/pages.id/common/clang.md new file mode 100644 index 000000000..311b03cdd --- /dev/null +++ b/pages.id/common/clang.md @@ -0,0 +1,37 @@ +# clang + +> Susun kode sumber C, C++, dan Objective-C. Dapat dipakai sebagai pengganti mutlak (drop-in) bagi GCC. +> Part of LLVM. +> Informasi lebih lanjut: . + +- Ubah suatu berkas kode sumber menjadi program: + +`clang {{jalan/menuju/sumber1.c jalan/menuju/sumber2.c ...}} {{-o|--output}} {{jalan/menuju/program}}` + +- Tampilkan pesan peringatan dan galat dalam [o]utput: + +`clang {{jalan/menuju/sumber.c}} -Wall {{-o|--output}} {{jalan/menuju/program}}` + +- Izinkan peringatan dan simbol debug dalam [o]utput: + +`clang {{jalan/menuju/sumber.c}} -Wall {{-g|--debug}} -Og {{-o|--output}} {{jalan/menuju/program}}` + +- Sertakan pustaka (library) dari direktori yang berbeda: + +`clang {{jalan/menuju/sumber.c}} {{-o|--output}} {{jalan/menuju/program}} -I{{jalan/menuju/header}} -L{{jalan/menuju/pustaka}} -l{{nama_pustaka}}` + +- Susun kode sumber menjadi program dalam format LLVM Intermediate Representation (IR): + +`clang {{-S|--assemble}} -emit-llvm {{jalan/menuju/sumber.c}} {{-o|--output}} {{jalan/menuju/program.ll}}` + +- Susun kode sumber tanpa digabungkan: + +`clang {{-c|--compile}} {{jalan/menuju/sumber.c}}` + +- [O]ptimalkan progam yang disusun agar dapat dijalankan lebih cepat: + +`clang {{jalan/menuju/sumber.c}} -O{{1|2|3|fast}} {{-o|--output}} {{jalan/menuju/program}}` + +- Tampilkan versi penyusun: + +`clang --version` diff --git a/pages.id/common/g++.md b/pages.id/common/g++.md index 066735bed..53c6d88e6 100644 --- a/pages.id/common/g++.md +++ b/pages.id/common/g++.md @@ -1,21 +1,37 @@ # g++ -> Kompilasi sumber kode C++. +> Susun kode sumber C++. > Bagian dari GCC (GNU Compiler Collection). > Informasi lebih lanjut: . -- Mengubah berkas sumber kode menjadi program: +- Ubah suatu berkas kode sumber menjadi program: -`g++ {{jalan/menuju/sumber.cpp}} -o {{jalan/menuju/program}}` +`g++ {{jalan/menuju/sumber1.c jalan/menuju/sumber2.cpp ...}} {{-o|--output}} {{jalan/menuju/program}}` -- Menampilkan (hampir) semua kesalahan dan peringatan: +- Tampilkan pesan peringatan dan galat dalam [o]utput: -`g++ {{jalan/menuju/sumber.cpp}} -Wall -o {{jalan/menuju/program}}` +`g++ {{jalan/menuju/sumber.cpp}} -Wall {{-o|--output}} {{jalan/menuju/program}}` -- Memilih standar bahasa untuk dikompilasi (C++98/C++11/C++14/C++17): +- Izinkan peringatan dan simbol debug dalam [o]utput: -`g++ {{jalan/menuju/sumber.cpp}} -std={{standar_bahasa}} -o {{jalan/menuju/program}}` +`g++ {{jalan/menuju/sumber.cpp}} -Wall {{-g|--debug}} -Og {{-o|--output}} {{jalan/menuju/program}}` -- Menyertakan pustaka di direktori yang berbeda: +- Pilih standar bahasa untuk dikompilasi (C++98/C++11/C++14/C++17): -`g++ {{jalan/menuju/sumber.cpp}} -o {{jalan/menuju/program}} -I{{jalur_header}} -L{{jalur_pustaka}} -l{{nama_pustaka}}` +`g++ {{jalan/menuju/sumber.cpp}} -std={{c++98|c++11|c++14|c++17}} {{-o|--output}} {{jalan/menuju/program}}` + +- Sertakan pustaka (library) dari direktori yang berbeda: + +`g++ {{jalan/menuju/sumber.cpp}} {{-o|--output}} {{jalan/menuju/program}} -I{{jalan/menuju/header}} -L{{jalan/menuju/pustaka}} -l{{nama_pustaka}}` + +- Susun dan gabungkan beberapa berkas kode sumber menjadi suatu berkas program biner: + +`g++ {{-c|--compile}} {{jalan/menuju/sumber1.cpp jalan/menuju/sumber2.cpp ...}} && g++ {{-o|--output}} {{jalan/menuju/program}} {{jalan/menuju/sumber1.o jalan/menuju/sumber2.o ...}}` + +- [O]ptimalkan progam yang disusun agar dapat dijalankan lebih cepat: + +`g++ {{jalan/menuju/sumber.cpp}} -O{{1|2|3|fast}} {{-o|--output}} {{jalan/menuju/program}}` + +- Tampilkan versi penyusun: + +`g++ --version` diff --git a/pages.id/common/gcc.md b/pages.id/common/gcc.md index 920072d06..8d4ec2fad 100644 --- a/pages.id/common/gcc.md +++ b/pages.id/common/gcc.md @@ -1,28 +1,37 @@ # gcc > Praproses dan susun kode sumber C dan C++, lalu rakit dan gabungkan bersama-sama. +> Bagian dari GCC (GNU Compiler Collection). > Informasi lebih lanjut: . - Ubah beberapa sumber kode menjadi program: -`gcc {{jalan/menuju/sumber1.c jalan/menuju/sumber2.c ...}} -o {{jalan/menuju/program}}` +`gcc {{jalan/menuju/sumber1.c jalan/menuju/sumber2.c ...}} {{-o|--output}} {{jalan/menuju/program}}` + +- Tampilkan pesan peringatan dan galat dalam [o]utput: + +`gcc {{jalan/menuju/sumber.c}} -Wall {{-o|--output}} {{jalan/menuju/program}}` - Izinkan peringatan dan simbol debug dalam [o]utput: -`gcc {{jalan/menuju/sumber.c}} -Wall -g -Og -o {{jalan/menuju/program}}` +`gcc {{jalan/menuju/sumber.c}} -Wall {{-g|--debug}} -Og {{-o|--output}} {{jalan/menuju/program}}` - Sertakan pustaka (library) dari direktori yang berbeda: -`gcc {{sumber.c}} -o {{jalan/menuju/program}} -I{{jalan/menuju/header}} -L{{jalan/menuju/pustaka}} -l{{nama_pustaka}}` +`gcc {{jalan/menuju/sumber.c}} {{-o|--output}} {{jalan/menuju/program}} -I{{jalan/menuju/header}} -L{{jalan/menuju/pustaka}} -l{{nama_pustaka}}` - Susun kode sumber ke dalam bahasa tingkat rendah (assembly): -`gcc -S {{jalan/menuju/sumber.c}}` +`gcc {{-S|--assemble}} {{jalan/menuju/sumber.c}}` - Susun kode sumber tanpa digabungkan: -`gcc -c {{jalan/menuju/sumber.c}}` +`gcc {{-c|--compile}} {{jalan/menuju/sumber.c}}` - [O]ptimalkan progam yang disusun agar dapat dijalankan lebih cepat: -`gcc {{path/to/source.c}} -O{{1|2|3|fast}} -o {{path/to/output_executable}}` +`gcc {{jalan/menuju/sumber.c}} -O{{1|2|3|fast}} {{-o|--output}} {{jalan/menuju/program}}` + +- Tampilkan versi penyusun: + +`gcc --version` diff --git a/pages/common/clang++.md b/pages/common/clang++.md index 1f51051ca..c9779924f 100644 --- a/pages/common/clang++.md +++ b/pages/common/clang++.md @@ -4,26 +4,34 @@ > Part of LLVM. > More information: . -- 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` diff --git a/pages/common/clang.md b/pages/common/clang.md index b7d76c6ed..9d3b50b94 100644 --- a/pages/common/clang.md +++ b/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: . -- 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` diff --git a/pages/common/g++.md b/pages/common/g++.md index e175bf75f..6e2ed53dc 100644 --- a/pages/common/g++.md +++ b/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: . - 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: diff --git a/pages/common/gcc.md b/pages/common/gcc.md index 9602560c2..72e11a6e5 100644 --- a/pages/common/gcc.md +++ b/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: . - 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`