Re: [PATCH] intro.1: some improvements

["Michael Kerrisk (man-pages)" <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>]

Hello Stéphane,

I applied most of the patch, but...

On 03/09/2015 09:26 PM, Stéphane Aulery wrote:
> - Add a section Logout and poweroff and change login/logout by open/close session

... not this first piece. See comments below.

> - Add ref. to other common shells dash(1), ksh(1)
> - Add a ref. to stdout(3)
> - Separate cp and mv descriptions
> - Add examples of special cases of cd
> - Add su(1) and shutdown(8) ref. for section Logout and poweroff
> - Move Control-D to section Logout and poweroff
> - Fix some little format errors
> 
> Signed-off-by: Stéphane Aulery <saulery-GANU6spQydw@public.gmane.org>
> ---
>  man1/intro.1 | 59 ++++++++++++++++++++++++++++++++++++++++++++---------------
>  1 file changed, 44 insertions(+), 15 deletions(-)
> 
> diff --git a/man1/intro.1 b/man1/intro.1
> index e9daccf..4b95871 100644
> --- a/man1/intro.1
> +++ b/man1/intro.1
> @@ -60,12 +60,10 @@ That is faster and more powerful,
>  but requires finding out what the commands are.
>  Below a bare minimum, to get started.
>  .SS Login
> -In order to start working, you probably first have to login,
> -that is, give your username and password.
> -See also
> -.BR login (1).
> +In order to start working, you probably first have to open a session by
> +giving, your username and password.
>  The program
> -.I login
> +.BR login (1)
>  now starts a
>  .I shell
>  (command interpreter) for you.
> @@ -73,6 +71,19 @@ In case of a graphical login, you get a screen with menus or icons
>  and a mouse click will start a shell in a window.
>  See also
>  .BR xterm (1).
> +.SS Logout and poweroff
> +When you work is finished,
> +you can press Control-D to close the current session.
> +This does not turn off the machine.
> +Only superusers have access to this command.
> +If you are the single user you can also not log off
> +and becoming a superuser by typing the command
> +.BR su (1).
> +Also you must type yours password.
> +Finally enter the command "shutdown -P +1",
> +which will turn off the computer after one minute.
> +See
> +.BR shutdown (8).

I'm not sure that we really need most of the above piece. I mean, in these 
days of GUI and laptops. Most of us use the GUI or close the lid to 
shutdown/suspend.

Cheers,

Michael


>  .SS The shell
>  One types commands to the
>  .IR shell ,
> @@ -85,12 +96,14 @@ The standard one is called
>  See also
>  .BR ash (1),
>  .BR bash (1),
> +.BR chsh (1),
>  .BR csh (1),
> -.BR zsh (1),
> -.BR chsh (1).
> +.BR dash (1),
> +.BR ksh (1),
> +.BR zsh (1).
> +.LP
> +A session might go like:
>  .LP
> -A session might go like
> -
>  .RS
>  .nf
>  .RB "knuth login: " aeb
> @@ -134,7 +147,7 @@ maja    0501\-1136285
>  $
>  .fi
>  .RE
> -and here typing Control-D ended the session.
> +.LP
>  The
>  .B $
>  here was the command prompt\(emit is the shell's way of indicating
> @@ -171,15 +184,19 @@ The command
>  .I cat
>  will show the contents of a file.
>  (The name is from "concatenate and print": all files given as
> -parameters are concatenated and sent to "standard output", here
> +parameters are concatenated and sent to "standard output"
> +(see
> +.BR stdout (3)),
> +here
>  the terminal screen.)
>  .LP
>  The command
>  .I cp
>  (from "copy") will copy a file.
> -On the other hand, the command
> +.LP
> +The command
>  .I mv
> -(from "move") only renames it.
> +(from "move"), on the other hand, only renames it.
>  .LP
>  The command
>  .I diff
> @@ -223,7 +240,14 @@ prints the current directory.
>  The command
>  .I cd
>  changes the current directory.
> -Try "cd /" and "pwd" and "cd" and "pwd".
> +.LP
> +Try alternatively
> +.I cd
> +and
> +.I pwd
> +commands and explore
> +.I cd
> +usage: "cd", "cd .", "cd ..", "cd /" and "cd ~".
>  .SS Directories
>  The command
>  .I mkdir
> @@ -315,11 +339,16 @@ and use a browser if you find HTML files there.
>  .BR bash (1),
>  .BR chsh (1),
>  .BR csh (1),
> +.BR dash (1),
> +.BR ksh (1),
>  .BR locate (1),
>  .BR login (1),
>  .BR man (1),
> +.BR su (1),
>  .BR xterm (1),
>  .BR zsh(1),
>  .BR wait (2),
> +.BR stdout (3),
>  .BR man-pages (7),
> -.BR standards (7)
> +.BR standards (7),
> +.BR shutdown (8)
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html