Re: [PATCH v2] intro.1: Improve wording in initial introduction

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Mon, Jun 17, 2024 at 11:39:12AM GMT, Jeremy Baxter wrote:
> ---

Hi Jeremy,

Patch applied; thanks.  I'll release 6.9.1 later today with it.

Have a lovely day,
Alex

>  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..91ebbc448 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).
>  .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.
>  .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.
>  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.
>  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.
> -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;
> +it is just another program.
> +You can change your shell,
> +and everybody has their own favorite one.
>  The standard one is called
>  .IR sh .
>  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:
>  .P
>  .in +4n
>  .EX
> -- 
> 2.45.2
> 
> 

-- 
<https://www.alejandro-colomar.es/>

Attachment: signature.asc
Description: PGP signature


[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux