Migration to DocBook was completed.

svn path=/head/; revision=4639

ja/handbook/basics/chapter.sgml

@@ -0,0 +1,152 @@
+<!--
+     The FreeBSD Documentation Project
+     The FreeBSD Japanese Documentation Project
+
+     Original revision: 1.8
+     $Id: chapter.sgml,v 1.1.1.1 1999-04-08 15:45:59 kuriyama Exp $
+-->
+
+<chapter id="basics">
+  <title>Unix の基礎知識</title>
+
+  <para><emphasis>訳: &a.jp.nakai;.<!-- <br> -->
+      12 October 1996.</emphasis></para>
+
+  <sect1 id="basics-man">
+    <title>オンラインマニュアル</title>
+
+    <para>FreeBSD についてのもっとも包括的なドキュメントは
+      <emphasis>マニュアルページ</emphasis>の形式になっているものです.
+      FreeBSD システム上のほとんどすべてのプログラムには基本的な
+      操作方法とさまざまな引数を説明しているリファレンスマニュアル
+      がついています. これらのマニュアルは <command>man</command>
+      コマンドで見ることができます. <command>man</command>
+      コマンドの使い方は簡単です :</para>
+
+    <screen>&prompt.user; <userinput>man <replaceable>コマンド名</replaceable></userinput>
+    </screen>
+
+    <para><replaceable>コマンド名</replaceable>
+      のところには知りたいコマンドの名前を入れます. たとえば,
+      <command>ls</command> コマンドについて知りたい場合には
+      次のように入力します:</para>
+
+    <screen>&prompt.user; <userinput>man ls</userinput></screen>
+
+    <para>オンラインマニュアルは 数字のついたセクションに
+      分けられています :</para>
+
+    <orderedlist>
+      <listitem>
+	<para>ユーザコマンド</para>
+      </listitem>
+
+      <listitem>
+	<para>システムコールとエラー番号</para>
+      </listitem>
+
+      <listitem>
+	<para>C のライブラリ関数</para>
+      </listitem>
+
+      <listitem>
+	<para>デバイスドライバ</para>
+      </listitem>
+
+      <listitem>
+	<para>ファイル形式</para>
+      </listitem>
+
+      <listitem>
+	<para>ゲームとほかのお楽しみ</para>
+      </listitem>
+
+      <listitem>
+	<para>そのほかの情報</para>
+      </listitem>
+
+      <listitem>
+	<para>システムの管理と操作のためのコマンド</para>
+      </listitem>
+    </orderedlist>
+
+    <para>場合によっては, 同じことがらでもオンラインマニュアルでは
+      複数のセクションに記載されていることがあります. たとえば,
+      <command>chmod</command> ユーザコマンドと
+      <function>chmod()</function>
+      システムコールがあります. この場合, <command>man</command>
+      コマンドでどちらを参照したいかをセクションで指定することが
+      できます :</para>
+
+    <screen>&prompt.user; <userinput>man 1 chmod</userinput></screen>
+
+    <para>とすればユーザコマンドとしての <command>chmod</command>
+      のマニュアルページが表示されます. オンラインマニュアル上の特定の
+      セクションへの参照は通常, 書かれているドキュメントの
+      括弧の中に示されています. ですから, &man.chmod.1; は
+      <command>chmod</command>
+      ユーザコマンドを, &man.chmod.2;
+      はシステムコールの方を示しています.</para>
+
+    <para>コマンドの名前を知っていて, 単純にその使い方が分かる場合は
+      よいのですが, もしコマンドの名前を思い出せない場合には
+      どうしたらいいのでしょう? <command>man</command> に
+      <option>-k</option> スイッチをつければ,
+      コマンドデスクリプション中のキーワードから検索することができます
+      :</para>
+
+    <screen>&prompt.user; <userinput>man -k mail</userinput></screen>
+
+    <para>このコマンドを使うことで,
+      &ldquo;mail&rdquo;というキーワードを含むコマンドの
+      一覧を参照することができます. 実を言うと
+      <command>apropos</command>
+      コマンドを使うのと機能的には同じです.</para>
+
+    <para>それから, <filename>/usr/bin</filename>
+      にある優れたコマンドすべてを目にしても,
+      それらの大半がどういった働きをするのか
+      まったく見当もつかないときは どうしたらよいでしょう. 単純に,
+
+      <screen>&prompt.user; <userinput>cd /usr/bin; man -f *</userinput></screen>
+
+      あるいは同じ働きをする
+
+      <screen>&prompt.user; <userinput>cd /usr/bin; whatis *</userinput></screen>
+
+      としましょう.</para>
+  </sect1>
+
+  <sect1 id="basics-info">
+    <title>GNU の Info ファイル</title>
+
+    <para>FreeBSD には Free Software Foundation (FSF)
+      によるアプリケーションや
+      ユーティリティがたくさんあります. こうしたプログラムには
+      manページに加えて, &ldquo;info&rdquo; ファイルと呼ばれる
+      ハイパーテキスト形式のドキュメントが付属になっていて,
+      <command>info</command> コマンドや, <command>emacs</command>
+      をインストールしているなら <command>emacs</command> の info
+      モードで見ることができます.</para>
+
+    <para>&man.info.1; コマンドを使うには, 単にこう入力します.</para>
+
+    <screen>&prompt.user; <userinput>info</userinput></screen>
+
+    <para>おおまかなイントロダクションを
+      見るには, <userinput>h</userinput> と入力します.
+      クイックコマンドリファレンスは <userinput>?</userinput>
+      とします.</para>
+  </sect1>
+</chapter>
+
+<!--
+     Local Variables:
+     mode: sgml
+     sgml-declaration: "../chapter.decl"
+     sgml-indent-data: t
+     sgml-omittag: nil
+     sgml-always-quote-attributes: t
+     sgml-parent-document: ("../handbook.sgml" "part" "chapter")
+     End:
+-->