Merge pull request #185 from codecrafters-io/TropicolX-patch-24

Revise "Multiple completions #wh6"

Author: TropicolX

stage_descriptions/completions-05-wh6.md

@@ -1,11 +1,21 @@
-In this stage, you'll implement tab completion for executables, specifically when multiple executables share a common prefix.
+In this stage, you'll implement tab completion for multiple executables that share a common prefix.
 
-When the user types a command prefix and presses `<TAB>`, your shell should:
+### Handling Multiple Matches
 
-- Identify all executables in the `PATH` that match the prefix.
-- If there are multiple matches,
-  - On the first TAB press, just ring a bell. (`\a` rings the bell)
-  - On the second TAB press, print all the matching executables separated by 2    spaces, on the next line, and follow it with the prompt on a new line.
+When a user types a command prefix and presses `<TAB>`, your shell should find all executables in PATH that match the prefix and do the following:
+
+1. On the first `<TAB>` press, ring the bell (using `\x07`).
+2. On the second `<TAB>` press:
+    - Print all matching executables on a new line. List them in **alphabetical order**, separated by two spaces (<code style="white-space: pre;">  </code>).
+    - Show the prompt again on the next line, keeping the original command prefix.
+ 
+For example:
+
+```bash
+$ xyz_<TAB><TAB>
+xyz_bar  xyz_baz  xyz_quz
+$ xyz_
+```
 
 ### Tests
 
@@ -15,17 +25,19 @@ The tester will execute your program like this:
 ./your_program.sh
 ```
 
-It will then set up a specific `PATH` and place multiple executables starting with a common prefix into different directories in the `PATH`. Finally, it will type the common prefix, and then press the Tab key twice.
+It will then set up a specific `PATH` and place multiple executables starting with a common prefix into different directories in the `PATH`.
+
+Finally, it will type the common prefix, and then press the tab key twice.
 
 ```bash
-$ ./your_program.sh
 $ xyz_<TAB><TAB>
 xyz_bar  xyz_baz  xyz_quz
 $ xyz_
 ```
 
 The tester will verify that:
-
-1. Your shell displays the prompt with the common prefix after receiving the partial command.
-2. Upon the first Tab key press, your shell prints a bell character.
-3. Upon the second Tab key press, your shell prints the list of matching executables separated by 2 spaces, on the next line, and follow it with the prompt on a new line.
+1. The first tab press rings the bell.
+2. The second tab press displays all matching executables in alphabetical order.
+    - The matches are separated by two spaces.
+    - The matches are displayed on a new line.
+3. The prompt reappears with the original input preserved.