for: refresh (#7482)

pages/common/for.md

@@ -1,12 +1,24 @@
 # for
 
-> Shell loop over parameters.
-> More information: <https://man.archlinux.org/man/for.n>.
+> Perform a command several times.
+> More information: <https://www.gnu.org/software/bash/manual/bash.html#Looping-Constructs>.
 
-- Perform a command with different arguments:
+- Execute the given commands for each of the specified items:
 
-`for argument in 1 2 3; do {{command $argument}}; done`
+`for {{variable}} in {{item1 item2 ...}}; do {{echo "Loop is executed"}}; done`
 
-- Perform a command in every directory:
+- Iterate over a given range of numbers:
 
-`for d in *; do (cd $d; {{command}}); done`
+`for {{variable}} in {{{from}}..{{to}}..{{step}}}; do {{echo "Loop is executed"}}; done`
+
+- Iterate over a given list of files:
+
+`for {{variable}} in {{path/to/file1 path/to/file2 ...}}; do {{echo "Loop is executed"}}; done`
+
+- Iterate over a given list of directories:
+
+`for {{variable}} in {{path/to/directory1/ path/to/directory2/ ...}}; do {{echo "Loop is executed"}}; done`
+
+- Perform a given command in every directory:
+
+`for {{variable}} in */; do (cd "${{variable}}" || continue; {{echo "Loop is executed"}}) done`