Autocompletion of configure.py

doc/wiki/Installation.md

@@ -48,6 +48,12 @@ e.g., `example/test_problem/Hydro/AcousticWave/generate_make.sh`.
    make
    ```
 
+   If the compilation succeeds, you will see the following message
+   <pre>
+   Compiling GAMER --> Successful!
+   </pre>
+   and get an executable `gamer`, which will be automatically copied to `../bin/gamer`.
+
 > [!TIP]
 > To reduce the compilation time, you can perform a parallel
 compilation by `make -j N`, where `N` is the number of compilation
@@ -59,8 +65,42 @@ invoke 4 compilation jobs simultaneously:
 > However, please consult the documentation of your system to avoid
 violating the usage policy.
 
-If the compilation succeeds, you will see the following message
-<pre>
-Compiling GAMER --> Successful!
-</pre>
-and get an executable `gamer`, which will be automatically copied to `../bin/gamer`.
+
+6. [Optional] Autocompletion of `configure.py`
+
+   Since there are too many options in GAMER, we introduce the autocomplete feature of `configure.py`. You can set the feature by the following steps:
+   1. Update the [shebang](https://en.wikipedia.org/wiki/Shebang_(Unix)) of `configure.py` if needed
+
+      For example, replace `#!/usr/bin/python3` with your `python` path.
+      <details>
+      <summary><u><i>top of configure.py</i></u></summary>
+      <pre>
+      #!/usr/bin/python3
+      """
+      User guides of this script are provided in the following link.
+
+      https://github.com/gamer-project/gamer/wiki/Installation
+      """
+      </pre>
+      </details>
+
+   2. Copy the autocomplete shell script to your `/home/usr` (`~`)
+      ```bash
+      cp tool/bash/config_autocomplete.sh ~/
+      ```
+
+   2. Update the `~/.bashrc` to load the autocomplete script
+
+      Please add the following line to `~/.bashrc`:
+      ```bash
+      source ~/config_autocomplete.sh
+      ```
+      NOTE: There are three commands registered in the `config_autocomplete.sh`, `python` `python3` and `./configure.py`.
+            If you would like to register your command, please add the command at the bottom of the script.
+
+   3. Reload `~/.bashrc` to enable the feature
+      ```bash
+      source ~/.bashrc
+      ```
+
+   Now, try to type `./configure.py` and then press `<tab>` multiple times!

doc/wiki/configure.py.md

@@ -57,7 +57,16 @@ Edit the section "source files" in the `Makefile_base` to add new source files.
                       )
    ```
 
-4. [Optional] Add additional checks in `validation()` and warning messages in `warning()` under `Functions`.
+4. [Optional] Add the common prefix/suffix of the simulation options. (Only works for string type)
+   ```python
+   parser.add_argument( "--new_argument", type=str, metavar="STRING", gamer_name="NEW_SIMUALTION_OPTION", prefix="YOUR_PREFIX_", suffix="_YOUR_SUFFIX",
+                        default="STR1", choice=["STR1", "STR2", "STR3"],
+                        help="Your help message.\n"
+                      )
+   ```
+   The simulation option would be concatenated as `YOUR_PREFIX_STR1_YOUR_SUFFIX`.
+
+5. [Optional] Add additional checks in `validation()` and warning messages in `warning()` under `Functions`.
    * `validation()`
 
    ```python

src/Makefile_base

@@ -21,7 +21,7 @@ EXECUTABLE := gamer
 
 # output detailed compilation commands (0/1 = off/on)
 #######################################################################################################
-COMPILE_VERBOSE := 0
+COMPILE_VERBOSE := @@@COMPILE_VERBOSE@@@