From 71152126bb14411d1aa9b88639532b28ad1188eb Mon Sep 17 00:00:00 2001 From: Murray Stokely Date: Mon, 24 Sep 2001 01:32:07 +0000 Subject: [PATCH] Add more precise markup : - man page entities - - - etc.. PR: docs/30657 Submitted by: Giorgos Keramidas --- .../articles/new-users/article.sgml | 68 ++++++++++--------- 1 file changed, 36 insertions(+), 32 deletions(-) diff --git a/en_US.ISO8859-1/articles/new-users/article.sgml b/en_US.ISO8859-1/articles/new-users/article.sgml index 21fb957862..66789492e2 100644 --- a/en_US.ISO8859-1/articles/new-users/article.sgml +++ b/en_US.ISO8859-1/articles/new-users/article.sgml @@ -1,7 +1,11 @@ - + - + +%man; +]> +
For People New to Both FreeBSD and Unix @@ -93,23 +97,23 @@ The first time you use adduser, it might ask for some - defaults to save. You might want to make the default shell csh - instead of sh, if it suggests sh as the default. Otherwise just + defaults to save. You might want to make the default shell &man.csh.1; + instead of &man.sh.1;, if it suggests sh as the default. Otherwise just press enter to accept each default. These defaults are saved in /etc/adduser.conf, an editable file. - Suppose you create a user jack with + Suppose you create a user jack with full name Jack Benimble. Give jack a password if security (even kids around who might pound on the keyboard) is an issue. When it asks you if you want to invite - jack into other groups, type wheel + jack into other groups, type wheel Login group is ``jack''. Invite jack into other groups: wheel This will make it possible to log in as - jack and use the su + jack and use the &man.su.1; command to become root. Then you won't get scolded any more for logging in as root. @@ -122,7 +126,7 @@ wrong. Once you've done this, use exit to get - back to a login prompt and log in as jack. + back to a login prompt and log in as jack. In general, it's a good idea to do as much work as possible as an ordinary user who doesn't have the power—and risk—of root. @@ -130,9 +134,9 @@ If you already created a user and you want the user to be able to su to root, you can log in as root and edit the file /etc/group, adding jack - to the first line (the group wheel). But first you need to - practice vi, the text editor—or use the - simpler text editor, ee, installed on recent + to the first line (the group wheel). But first you need to + practice &man.vi.1;, the text editor—or use the + simpler text editor, &man.ee.1;, installed on recent version of FreeBSD. To delete a user, use the rmuser @@ -259,7 +263,7 @@ convenient). You can create other aliases by editing .cshrc. You can make these aliases available to all users on the system by putting them in the - system-wide csh configuration file, + system-wide csh configuration file, /etc/csh.cshrc. @@ -293,11 +297,11 @@ man ls will tell you all the ways to use the ls command. Press Enter to move through text, - Ctrlb + CtrlB to go back a page, - Ctrlf + CtrlF to go forward, q or - Ctrlc + CtrlC to quit. @@ -360,7 +364,7 @@ w. Are some of these not working very well? Both - locate and whatis depend + &man.locate.1; and &man.whatis.1; depend on a database that's rebuilt weekly. If your machine isn't going to be left on over the weekend (and running FreeBSD), you might want to run the commands for daily, weekly, and monthly @@ -877,7 +881,7 @@ are kept, rehash, and then put the following lines in .cshrc in each user's home directory or (easier) in /etc/csh.cshrc, the - system-wide csh start-up file: + system-wide csh start-up file: setenv XKEYSYMDB /usr/X11R6/lib/X11/XKeysymDB @@ -909,17 +913,17 @@ setenv XNLSPATH /usr/X11R6/lib/X11/nls files: a series of commands to be run without your intervention. - Two shells come installed with FreeBSD: csh and sh. csh is + Two shells come installed with FreeBSD: csh and sh. csh is good for command-line work, but scripts should be written with - sh (or bash). You can find out what shell you have by typing + sh (or bash). You can find out what shell you have by typing echo $SHELL. - The csh shell is okay, but tcsh does everything csh does and + The csh shell is okay, but tcsh does everything csh does and more. It allows you to recall commands with the arrow keys - and edit them. It has tab-key completion of filenames (csh uses - the escape key), and it lets you switch to the directory you + and edit them. It has tab-key completion of filenames (csh uses + the Esc key), and it lets you switch to the directory you were last in with cd -. It's also much - easier to alter your prompt with tcsh. It makes life a lot + easier to alter your prompt with tcsh. It makes life a lot easier. Here are the three steps for installing a new shell: @@ -929,20 +933,20 @@ setenv XNLSPATH /usr/X11R6/lib/X11/nls Install the shell as a port or a package, just as you would any other port or package. Use rehash and which tcsh - (assuming you're installing tcsh) to make sure it got + (assuming you're installing tcsh) to make sure it got installed. As root, edit /etc/shells, adding a line in the file for the new shell, in this case - /usr/local/bin/tcsh, and save the file. (Some ports may do + /usr/local/bin/tcsh, and save the file. (Some ports may do this for you.) Use the chsh command to change your - shell to tcsh permanently, or type tcsh + shell to tcsh permanently, or type tcsh at the prompt to change your shell without logging in again. @@ -950,27 +954,27 @@ setenv XNLSPATH /usr/X11R6/lib/X11/nls It can be dangerous to change root's shell to something - other than sh or csh on early versions of FreeBSD and many + other than sh or csh on early versions of FreeBSD and many other versions of Unix; you may not have a working shell when the system puts you into single user mode. The solution is to use su -m to become root, which will give - you the tcsh as root, because the shell is part of the + you the tcsh as root, because the shell is part of the environment. You can make this permanent by adding it to your .tcshrc file as an alias with alias su su -m. - When tcsh starts up, it will read the + When tcsh starts up, it will read the /etc/csh.cshrc and - /etc/csh.login files, as does csh. It will + /etc/csh.login files, as does csh. It will also read the .login file in your home directory and the .cshrc file as well, unless you provide a .tcshrc file. This you can do by simply copying .cshrc to .tcshrc. - Now that you've installed tcsh, you can adjust your prompt. - You can find the details in the manual page for tcsh, but here + Now that you've installed tcsh, you can adjust your prompt. + You can find the details in the manual page for tcsh, but here is a line to put in your .tcshrc that will tell you how many commands you have typed, what time it is, and what directory you are in. It also produces a