Date: Sat, 8 Apr 2000 10:33:00 -0400 (EDT) From: eogren@earthlink.net To: FreeBSD-gnats-submit@freebsd.org Subject: docs/17862: Handbook missing entry on changing shells Message-ID: <20000408143300.A10811F3@rod.darktech.org>
next in thread | raw e-mail | index | archive | help
>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 <mwkohout@hotmail.com> 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</command> prints whatever your terminal is set to.
<command>echo \$TERM</command> prints <envar>$TERM</envar> as
is.</para>
+
+ <sect2 id="changing-shells">
+ <title>Changing your shell</title>
+
+ <para>The easiest way to change your shell is to use the
+ <command>chsh</command>. Running <command>chsh</command> will
+ place you into the editor that is in your <envar>EDITOR</envar>
+ environment variable; if it is not set, you will be placed in
+ <command>vi</command>. Change the "Shell:" line
+ accordingly.</para>
+
+ <para>You can also give <command>chsh</command> the
+ <option>-s</option> 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:</para>
+ <screen>&prompt.user; <userinput>chsh -s /usr/local/bin/bash</userinput></screen>
+ <para>would do the trick. Running <command>chsh</command> with no
+ parameters and editing the shell from there would work also.</para>
+
+ <note><para>The shell that you wish to use
+ <emphasis>must</emphasis> be present in the
+ <filename>/etc/shells</filename> file. If you have installed a
+ shell from the <link linkend="ports">ports collection</link>,
+ then this should have been done for you already. If you installed
+ the shell by hand, you must do this.</para>
+
+ <para>For example, if you installed <command>bash</command> by hand
+ and placed it into <filename>/usr/local/bin</filename>, you would
+ want to:</para>
+ <screen>&prompt.root; <userinput>echo "/usr/local/bin/bash" >> /etc/shells</userinput></screen>
+ <para>And then rerun <command>chsh</command>.</para></note>
+ </sect2>
</sect1>
<sect1 id="editors">
>Release-Note:
>Audit-Trail:
>Unformatted:
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20000408143300.A10811F3>