Hi Jeremy, On Mon, Jun 17, 2024 at 10:29:17AM GMT, Jeremy Baxter wrote: > --- For readers of the list, this is a continuation of <https://lore.kernel.org/linux-man/CZX4Y18EKIWK.1YLSFJIPJG2YA@xxxxxxxxxxx/> > man/man1/intro.1 | 31 +++++++++++++++++-------------- > 1 file changed, 17 insertions(+), 14 deletions(-) > > diff --git a/man/man1/intro.1 b/man/man1/intro.1 > index decaab161..4d9e81c5a 100644 > --- a/man/man1/intro.1 > +++ b/man/man1/intro.1 > @@ -10,9 +10,9 @@ Section 1 of the manual describes user commands and tools, > for example, file manipulation tools, shells, compilers, > web browsers, file and image viewers and editors, and so on. > .SH NOTES > -Linux is a flavor of UNIX, and as a first approximation > -all user commands under UNIX work precisely the same under > -Linux (and FreeBSD and lots of other UNIX-like systems). > +Linux is a flavor of UNIX, and user commands under UNIX > +work similarly under Linux (and lots of other UNIX-like systems too, > +like FreeBSD). I like the changes in this paragraph, except for the removal of "as a first approximation". Not a big deal, though. > .P > Under Linux, there are GUIs (graphical user interfaces), where you > can point and click and drag, and hopefully get work done without > @@ -20,15 +20,17 @@ first reading lots of documentation. > The traditional UNIX environment > is a CLI (command line interface), where you type commands to > tell the computer what to do. > -That is faster and more powerful, > -but requires finding out what the commands are. > -Below a bare minimum, to get started. > +This is faster and more powerful, > +but requires finding out what the commands are and how to use them. > +Below is a bare minimum guide to get you started. LGTM. > .SS Login > -In order to start working, you probably first have to open a session by > -giving your username and password. > +In order to start working, > +you'll probably first have to open a session. LGTM. > The program > .BR login (1) > -now starts a > +will wait for you to type your username and password, > +and after that, > +it will start a > .I shell > (command interpreter) for you. LGTM. > In case of a graphical login, you get a screen with menus or icons > @@ -36,12 +38,13 @@ and a mouse click will start a shell in a window. > See also > .BR xterm (1). > .SS The shell > -One types commands to the > +One types commands into the > .IR shell , > the command interpreter. LGTM. > -It is not built-in, but is just a program > -and you can change your shell. > -Everybody has their own favorite one. > +It is not built-in, > +but is just another program. I would maybe use a ';'? It is not built-in; it is just another program. > +You can change your shell, > +and everybody has their own favorite one. > The standard one is called > .IR sh . LGTM. > See also > @@ -53,7 +56,7 @@ See also > .BR ksh (1), > .BR zsh (1). > .P > -A session might go like: > +A session might look like this: LGTM. > .P > .in +4n > .EX > -- > 2.45.2 I think I'll apply this patch. Let me meditate it to-night. I CCed Doug, in case he has any comments (it would be great to hear his feedback). Have a lovely night! Alex -- <https://www.alejandro-colomar.es/>
Attachment:
signature.asc
Description: PGP signature
