%% $Header: /cvsroot/lcdp/lpic/general-linux-2/slides/gl2.108.1.slides.tex,v 1.2 2003/10/22 05:38:14 geoffr Exp $

\input{gl2.slide-header.tex}
%\overlaysfalse

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\begin{document} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

%----10->|-----20->|-----30->|-----40->|-----50->|-----60->|-----70->|-----80->
\begin{slide} %================================================================
\begin{center} \LARGE \textsf{-- General Linux 2 -- \\
 }
\LARGE \textsf{Use and manage local system documentation [4] } \\[2mm]
\large  \textsf{(Linux Professional Institute Certification)}\\[1mm]

\normalsize\end{center}

\footnote{Copyright \copyright\ 2003 Geoffrey Robertson. Permission is granted to make and distribute verbatim copies or modified versions of this document provided that this copyright notice and this permission notice are preserved on all copies under the terms of the GNU General Public License as published by the Free Software Foundation---either version 2 of the License or (at your option) any later version.}
 
\scriptsize
\begin{verbatim}  
   .~.    
   /V\     by: geoffrey robertson        
  // \\        geoffrey@zip.com.au
  @._.@ 
%% $Id: gl2.108.1.slides.tex,v 1.2 2003/10/22 05:38:14 geoffr Exp $ 
\end{verbatim}          
\normalsize       
\vfill \end{slide} %-----------------------------------------------------------
%----10->|-----20->|-----30->|-----40->|-----50->|-----60->|-----70->|-----80->

%==============================================================================
%==============================================================================
\begin{slide} %ghr 
\slideheading{Documentation}
\begin{description}
  \item[2.108.1] {\bf\underline{Use and Manage Local System Documentation [4]}}
  \item[2.108.2] Find Linux Documentation on the Internet [3]
  \item[2.108.5] Notify Users on System Related Issues [1]
\end{description}
\vfill \end{slide} %-----------------------------------------------------------
 
%==============================================================================
%==============================================================================
\begin{slide} %ghr
\slideheading{Use and Manage Local System Documentation}
\slidesubheading{Objective}
 
Candidates should be able to use and administer the man facility and the material in /usr/share/doc/. 

This objective includes finding relevant man pages, searching man page sections, finding commands and man pages related to them, and configuring access to man sources and the man system. 

It also includes using system documentation stored in /usr/share/doc/ and determining what documentation to keep in /usr/share/doc/. 

\vfill \end{slide} %-----------------------------------------------------------
 
%==============================================================================
\begin{slide} %ghr
\Slideheading{Use and Manage Local System Documentation}
\slidesubheading{Key files, terms, and utilities}
\begin{alltt}
MANPATH  
man
apropos
whatis
\end{alltt}
\vfill \end{slide} %-----------------------------------------------------------
 
%==============================================================================
\begin{slide} %ghr
\Slideheading{Use and Manage Local System Documentation}
\slidesubheading{Resources}
\begin{alltt}

\end{alltt}
\vfill \end{slide} %-----------------------------------------------------------
 
%==============================================================================
%==============================================================================
\begin{slide}{}
\slideheading{Using \texttt{whatis}}
\slidesubheading{display manual page descriptions}

\overlay{1}
\texttt{whatis} searches the manual page names and displays the manual
page descrip tions of any name matched.

\overlay{2}
\begin{alltt}
\cmd{whatis nmap}
nmap   (1)  - Network exploration tool 
              and security scanner
\end{alltt} 

\overlay{3}
(in Debian Woody but not RH9.0)
\begin{alltt}
-r, --regex    Interpret each name as 
               a regular expression. 
\cmd{whatis -r ^ifc}
ifconfig (8)   - configure a network interface 
\end{alltt}
\vfill \end{slide} %-----------------------------------------------------------


 
%==============================================================================
%==============================================================================
\begin{slide}{}
\slideheading{Using \texttt{apropos}}
\slidesubheading{search the manual page names and descriptions}

Each manual page has a short description available within it.
\texttt{apropos} searches the descriptions for instances of keyword.

\overlay{1}
\begin{alltt}
\cmd{apropos nmap}
MapWindow (3tk)      - map or unmap a window
mmap (2)             - map or unmap files or d
munmap (2)           - map or unmap files or devi
nmap (1)             - Network exploration tool and
k_MapWindow (3tk)   - map or unmap a window
...
\end{alltt}


\vfill \end{slide} %-----------------------------------------------------------

%==============================================================================
%==============================================================================
\begin{slide}{}
\slideheading{Using \texttt{man}}

\begin{alltt}
\cmd{man man}
man(1)                                                                  man(1)

NAME
       man - format and display the on-line manual pages
       manpath - determine user��s search path for man pages

SYNOPSIS
       man  [-acdfFhkKtwW]  [--path]  [-m system] [-p string] [-C config_file]
       [-M pathlist] [-P pager] [-S section_list] [section] name ...

DESCRIPTION
       man formats and displays the on-line manual pages.
\end{alltt}
\vfill \end{slide} %-----------------------------------------------------------

%==============================================================================
%==============================================================================
\begin{slide}{}
\slideheading{Using \texttt{man}}
\slidesubheading{options}

\begin{description}
\item[-k] Equivalent to \texttt{apropos}
\item[-f] Equivalent to \texttt{whatis}
\item[-K] Search for the specified string in *all* man pages.
  Warning: this is probably very slow!  It helps to specify a section.
  (Just to give a rough idea, on my machine this takes about a minute
  per 500 man pages.)
\end{description}
\vfill \end{slide} %-----------------------------------------------------------

%==============================================================================
%==============================================================================
\begin{slide}{}
\slideheading{The Manual Section Numbers}
\slidesubheading{}

\begin{enumerate}
\item Executable programs or shell commands
\item System calls (functions provided by the kernel)
\item Library calls (functions within system libraries)
\item Special files (usually found in /dev)
\item File formats and conventions eg /etc/passwd
\item Games
\item Miscellaneous (including macro packages and conven tions), e.g.
  man(7), groff(7)
\item System administration commands (usually only for root)
\item Kernel routines [Non standard]
\end{enumerate}

\vfill \end{slide} %-----------------------------------------------------------

%==============================================================================
%==============================================================================
\begin{slide}{}
\slideheading{GNU \texttt{info}}

{\footnotesize
\begin{alltt}
File: info,  Node: Top,  Next: Getting Started,  Up: (dir)

Info: An Introduction
*********************

   Info is a program, which you are using now, for reading
documentation of computer programs.  The GNU Project distributes most
of its on-line manuals in the Info format, so you need a program called
"Info reader" to read the manuals.  One of such programs you are using
now.

   If you are new to Info and want to learn how to use it, type the
command `h' now.  It brings you to a programmed instruction sequence.

   To learn advanced Info commands, type `n' twice.  This brings you to
`Info for Experts', skipping over the `Getting Started' chapter.

* Menu:

* Getting Started::             Getting started using an Info reader.
* Advanced Info::               Advanced commands within Info.
* Creating an Info File         How to make your own Info file.
--zz-Info: (info.gz)Top, 24 lines --Top----*** Tags out of Date ***-----------
Welcome to Info version 4.2. Type C-h for help, m for menu item.
 
\end{alltt}
}

\vfill \end{slide} %-----------------------------------------------------------

%==============================================================================
%==============================================================================
\begin{slide}{}
\slideheading{GNU \texttt{info} Navigation}
\begin{description}
\item[Tab] Move among hyperlinks
\item[Enter] Follow hyperlinks
\item[d] Return to the top
\item[?] List these info commands
\item[n] Move to the "next" node of this node.

\item[p] Move to the "previous" node of this node.
\item[u] Move "up" from this node.
\item[q] Quit Info altogether.
\item[h] Show a primer for first time users.
\item[/string] Search for string.
\end{description}

\vfill \end{slide} %-----------------------------------------------------------

%==============================================================================
%==============================================================================
\begin{slide}{}
\slideheading{\texttt{/usr/share/doc/}}

General information about packages and programs.
\begin{alltt}
\cmd{ls /usr/share/doc/}
4Suite-0.11.1                   libtabe-0.2.6
a2ps-4.13b                      libtiff-3.5.7
abiword-1.0.4                   libtiff-devel-3.5.7
ac-archive-0.5.39               libtool-1.4.3
acl                             libungif-4.1.0
adjtimex-1.13                   libungif-devel-4.1.0
alchemist-1.0.26                libunicode-0.4  
\end{alltt}
\vfill \end{slide} %-----------------------------------------------------------

%==============================================================================
%==============================================================================
\begin{slide}{}
\slideheading{\texttt{/usr/share/doc/}}
\begin{alltt}
\cmd{ls /usr/share/doc/acl}
CHANGES.gz  LICENSE  PORTING  README
\end{alltt}
\vfill \end{slide} %-----------------------------------------------------------

%==============================================================================
%==============================================================================
\begin{slide}{}
\slideheading{\texttt{/usr/share/doc/}}
\begin{alltt}
\cmd{head /usr/share/doc/acl/README}
Access control list package README
__________________________________

See the file doc/INSTALL for build, installation and post-
install configuration steps.

Refer to the acl(5) manual page for general access control list
information and references to other related manual pages.

The extended attributes and access control list project for the
ext2 and ext3 filesystems is located at:
        http://acl.bestbits.at/

For more information and details on how to contribute to the
XFS project see the web pages at: http://oss.sgi.com/projects/xfs/
\end{alltt}
\vfill \end{slide} %-----------------------------------------------------------

%==============================================================================
%==============================================================================
\begin{slide}{}
\slideheading{\texttt{/usr/share/doc/}}

\cmd{mozilla /usr/share/doc/xfig/html/index.html}

\vfill \end{slide} %-----------------------------------------------------------

%==============================================================================
\begin{slide}{} %ghr
\heading{The End}
 \Slidecontents
\vfill \end{slide} %-----------------------------------------------------------


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\end{document} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

%==============================================================================
%==============================================================================
\begin{slide}{}
\slideheading{}


\vfill \end{slide} %-----------------------------------------------------------

=============================================================================
\begin{slide}{}

\end{slide} %------------------------------------------------------------------


%==============================================================================
\begin{slide}{} %ghr
\Slidecontents
\vfill \end{slide} %-----------------------------------------------------------

