doc: Explain ‘--’ syntax of ‘guix shell’ before giving examples.

This paragraph is present in the ‘guix environment’ docs.  I presume
it clarifies ‘guix shell’ for newcomers as well.

* doc/guix.texi (Invoking guix shell): Take over an introductory
paragraph from ‘guix environment’ and use it for ‘guix shell’.

Change-Id: I06280516ad3436260114b074c5f325e6984e9c76
This commit is contained in:
Florian Pelz 2024-11-18 15:20:26 +01:00
parent 1bf01c970d
commit d6b8679784
No known key found for this signature in database
GPG key ID: 300888CB39C63817

View file

@ -5933,6 +5933,10 @@ The general syntax is:
guix shell [@var{options}] [@var{package}@dots{}]
@end example
Sometimes an interactive shell session is not desired. An arbitrary
command may be invoked by placing the @code{--} token to separate the
command from the rest of the arguments.
The following example creates an environment containing Python and NumPy,
building or downloading any missing package, and runs the
@command{python3} command in that environment: