From owner-freebsd-doc Sat Apr 8 7:40: 7 2000 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 46EA437B6DF for ; Sat, 8 Apr 2000 07:40:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id HAA42816; Sat, 8 Apr 2000 07:40:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from merlin.prod.itd.earthlink.net (merlin.prod.itd.earthlink.net [207.217.120.156]) by hub.freebsd.org (Postfix) with ESMTP id B8C4C37B8F5 for ; Sat, 8 Apr 2000 07:31:51 -0700 (PDT) (envelope-from eogren@earthlink.net) Received: from rod.darktech.org (ip132.cambridge2.ma.pub-ip.psi.net [38.32.112.132]) by merlin.prod.itd.earthlink.net (8.9.3/8.9.3) with ESMTP id HAA12687 for ; Sat, 8 Apr 2000 07:31:49 -0700 (PDT) Received: by rod.darktech.org (Postfix, from userid 1001) id A10811F3; Sat, 8 Apr 2000 10:33:00 -0400 (EDT) Message-Id: <20000408143300.A10811F3@rod.darktech.org> Date: Sat, 8 Apr 2000 10:33:00 -0400 (EDT) From: eogren@earthlink.net Reply-To: eogren@earthlink.net To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/17862: Handbook missing entry on changing shells Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 17862 >Category: docs >Synopsis: Handbook missing entry about changing shells >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sat Apr 8 07:40:00 PDT 2000 >Closed-Date: >Last-Modified: >Originator: Eric Ogren >Release: FreeBSD 4.0-STABLE i386 >Organization: >Environment: FreeBSD rod.darktech.org 4.0-STABLE FreeBSD 4.0-STABLE #3: Tue Apr 4 21:01:56 EDT 2000 eogren@rod.darktech.org:/usr/src/sys/compile/BLUE i386 >Description: Reported by Mike Kohout on freebsd-doc. Handbook is missing an entry on how to change shells. Mike suggested documenting user utilities and doing it manually; since this is the "Basics" section of the handbook, I chose to document the use of chsh only. >How-To-Repeat: Notice that in section 3.4, there is nothing telling the user how to change the shell. >Fix: Index: chapter.sgml =================================================================== RCS file: /usr/local/doctree/doc/en_US.ISO_8859-1/books/handbook/basics/chapter.sgml,v retrieving revision 1.16 diff -u -r1.16 chapter.sgml --- chapter.sgml 2000/04/06 20:28:27 1.16 +++ chapter.sgml 2000/04/08 14:23:34 @@ -331,6 +331,38 @@ $TERM prints whatever your terminal is set to. echo \$TERM prints $TERM as is. + + + Changing your shell + + The easiest way to change your shell is to use the + chsh. Running chsh will + place you into the editor that is in your EDITOR + environment variable; if it is not set, you will be placed in + vi. Change the "Shell:" line + accordingly. + + You can also give chsh the + option; this will set the shell for you + without having to enter the editor. For example, if you wanted to + change your shell to bash: + &prompt.user; chsh -s /usr/local/bin/bash + would do the trick. Running chsh with no + parameters and editing the shell from there would work also. + + The shell that you wish to use + must be present in the + /etc/shells file. If you have installed a + shell from the ports collection, + then this should have been done for you already. If you installed + the shell by hand, you must do this. + + For example, if you installed bash by hand + and placed it into /usr/local/bin, you would + want to: + &prompt.root; echo "/usr/local/bin/bash" >> /etc/shells + And then rerun chsh. + >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message