Update command-line-interface.md explanation of `(@main)`. (#59573)
Explain in simple terms the usage of `(@main)` and note that the return
value must be an `Int32` or `nothing`, in the docs.
Related to: https://github.com/JuliaLang/julia/pull/58984
---------
Co-authored-by: Neven Sajko <4944410+nsajko@users.noreply.github.com>
Co-authored-by: Lilith Orion Hafner <lilithhafner@gmail.com>