<!--
     The FreeBSD Documentation Project

     $FreeBSD$
-->


<chapter id="basics">
  <title>Unix b&aacute;sico</title>

  <sect1 id="basics-man">
    <title>El manual en l&iacute;nea</title>
    
    <para>La documentaci&oacute;n m&aacute;s completa en FreeBSD est&aacute;a
    en forma de <emphasis>p&aacute;ginas man</emphasis>. Pr&aacute;cticamente
    todos los programas del sistema incluyen un peque&ntilde;o manual de
    referencia explicando las operaciones b&aacute;sicas y los diferentes
    argumentos del programa. Estos manuales pueden verse con el comando
    <command>man</command>. El uso del comando <command>man</command> es
    simple:</para>

    <informalexample>
            <screen>&prompt.user; <userinput>man <replaceable>command</replaceable></userinput>
            </screen>
          </informalexample>

    <para><replaceable>command</replaceable> es el nombre del comando del que 
    queremos aprender. Por ejemplo, para saber m&aacute;s sobre el comando
    <command>ls</command> teclea:</para>
          <informalexample>
            <screen>&prompt.user; <userinput>man ls</userinput></screen>
          </informalexample>

    <para>El manual en l&iacute;nea est&aacute; dividido en secciones 
    numeradas:</para>

    <orderedlist>

      <listitem>
        <para>Comandos de usuario</para>
      </listitem>

      <listitem>
        <para>Llamadas de sistema y n&uacute;meros de error</para>
      </listitem>

      <listitem>
        <para>Funciones en las librer&iacute;as de C</para>
      </listitem>

      <listitem>
        <para>Drivers de dispositivos</para>
      </listitem>

      <listitem>
        <para>Formatos de fichero</para>
      </listitem>

      <listitem>
        <para>Juegos y otras diversiones</para>
      </listitem>

      <listitem>
        <para>Informaci&oacute;n varia</para>
      </listitem>

      <listitem>
        <para>Mantenimiento del sistema y comandos de sistema</para>
      </listitem>

    </orderedlist>

    <para>En algunos casos, el mismo concepto aparece en m&aacute;s de una
    secci&oacute;n del manual en l&iacute;nea. Por ejemplo, hay un comando
    de usuario <command>chmod</command> y una llamada de sistema
    <function>chmod()</function>. En este caso, puedes espicificar al comando
    <command>man</command> cual de ellos quieres ver, especificando la
    secci&oacute;n:</para>

          <informalexample>
            <screen>&prompt.user; <userinput>man 1 chmod</userinput></screen>
          </informalexample>

    <para>Esto mostrar&aacute; la informaci&oacute;n del comando de usuario
    <command>chmod</command>. Las referencias a secciones particulares del
    manual en l&iacute;nea tradicionalmente se incluyen entre par&eacute;ntesis
    en la documentaci&oacute;n escrita, de manera que <citerefentry>
    <refentrytitle>chmod</refentrytitle><manvolnum>1</manvolnum></citerefentry>
    se refiere al comando de usuario <command>chmod</command> y <citerefentry>
    <refentrytitle>chmod</refentrytitle><manvolnum>2</manvolnum>
    </citerefentry> se refiere a la llamada de sistema.</para>

    <para>Esto es correcto si sabes el nombre del comando y simplemente
    quieres saber como usarlo, pero &iquest;qu&eacute; pasa si no recuerdas 
    el nombre del comando?. Puedes usar <command>man</command> para buscar
    palabras en las <emphasis>descripciones</emphasis> de los comandos usando
    el par&aacute;metro <option>-k</option>:</para>

          <informalexample>
            <screen>&prompt.user; <userinput>man -k mail</userinput></screen>
          </informalexample>

    <para>Con este comando obtendr&aacute;s una lista de todos los comandos
    que contienen en su descripci&oacute;n la palabra &ldquo;mail&rdquo;.
    Actualmente, este comando realiza la misma funci&oacute;n que el comando
    <command>apropos</command>.</para>

    <para>&iquest;Quieres saber que hacen todos los comandos existentes en
    <filename>/usr/bin</filename>?. Simplemente haz:

              <informalexample>
            <screen>&prompt.user; <userinput>cd /usr/bin; man -f *</userinput></screen>
          </informalexample>  

          o

          <informalexample>
            <screen>&prompt.user; <userinput>cd /usr/bin; whatis *</userinput></screen>
          </informalexample>ya que realizan la misma funci&oacute;n .</para>

  </sect1>

  <sect1 id="basics-info">
    <title>Fichero GNU Info</title>

    <para>FreeBSD incluye muchas aplicaciones y utilidades producidas por la
    Free Software Foundation (FSF). Como complemento a las p&aacute;ginas man,
    estos programas incluyen unos documentos hipertexto m&aacute;s extensos
    llamados ficheros &ldquo;info&rdquo; los cuales pueden visualizarse con el
    comando <command>info</command>, o, si tienes instalado 
    <command>emacs</command>, con el modo info de <command>emacs</command>.
    </para>

    <para>Para usar el comando <citerefentry><refentrytitle>info</refentrytitle><manvolnum>1</manvolnum></citerefentry>, simplemente teclea:</para>

      <informalexample>
        <screen>&prompt.user; <userinput>info</userinput></screen>
      </informalexample>

    <para>Para una breve descripci&oacute;n, teclea <userinput>h</userinput>.
    Para una referencia r&aacute;pida de comandos, teclea
    <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:
-->
