[LinuxFocus-icon]
<--  | �����  | �����  | ������  | �����

������� | ������ | ������ | ��� LF
��� �������� �������� �� ��������� ������: English  Castellano  Deutsch  Francais  Italiano  Nederlands  Russian  Turkce  

[Photo of the Author]
����� Guido Socher (homepage)

�� ������:

Guido �������� Linux �� �� �������� � �����������, ������� ���������� ��������� �� � ����� ������ ��.



������� �� �������:
Pukhlyakov Kirill <kirill(at)linuxfocus.org>

����������:

 

�������� man-�������

man

������:

������ ������ ��������� ����������� �� UNIX shell'� ������� � man-��������. � ������� �� ���������� ������� �������� ���� �������.

_________________ _________________ _________________

 

��������

������������ � ������������ ����������� �������� ����� �����, ��� ���� ����������� �����������, ������� ���� ��� �� ������������ ������ �������. ���� ���� � ���� ���������, ������� ��������� ������������ ������ ���, � ��� ����� ���� ������������, ������, ��� ����� ��������� ������� ����� ������ ��� ������������ ����������, � ������ ���������� ������������ ������� ��� �� ��������� ������ ��������� ���.

������������ ������� Linux ������ ������ ���������������. ���� �� ������ ������ ��� �������� ��������� - ��� ���������� ������� man commandname

������������ man-������� ����� ������� ������� ������������ ������� � ���������

  1. ��� �������� �� ����� ��������� Linux � ����� ������ �������
  2. �� ����� ������������� � ����� ������ ������: HTML, PDF, Postscript, Text,...
  3. Man �������� ����� �������� �� ������ � ������������ ������, �� � � �����������, �������� � konqueror (������ ��������: man:commandname)
 

�������

Man-�������� ������� �� ��������, �������� ����� ��� ����� - �� ������. �������� ���� ��� man-�������� ��� ������� printf. ���� ��� ������������ ������� ����� 'C' ( ������ 3 ), � ������ - ��� ������� shell'� ( ������ 1 ).
> whichman -0 printf
/usr/share/man/man1/printf.1.bz2
/usr/share/man/man3/printf.3.bz2
���������� �������:
������
   1    ���������������� �������.
   2    ��������� ������, �.�. ��, ������� ������������� ����.
   3    ������������ ( ������������ ������� ).
   4    ���������� ( ����� � �������� /dev ).
   5    �������� �������� ������ ( �������� /etc/passwd ).
   6    ����.
   7    ������.
   8    ����������� ��� ���������� ����������������� (��������� ������ root'� ).
   9    ������.
   n    ����� ������������.
   l    ��������� ������������ ( ��������� � ������ ������� ).
����, �� ��������� "man 1 printf" � ������� ������������ ��� ������� shell'�, ��������� "man 3 printf" � ������ ������������ ������������ ������� ����� 'C'. ������ ������ "man printf" �� ������� ������ ��������� �������� ( ������ ��� "printf" �� ������� 1 ).

��������� ���������� ��������, � ������� ��������� ������������ ��� ������������ ����� ��������� ��������� whichman ( �� ������ ��������� �� � ���� �������� �������� ) ��� ������ "man:printf" � konqueror.

 

MANPATH

��������� man ���� ������������ ����������� �� �������� ���������� MANPATH. � ��������� ������ ������������ Linux ����������� �������������� ��� ����������. ������ ������� /usr/lib/perl5/man, � ������� ��������� �������� ��������� ������� ����� 'perl' �� ������ � ���� ����������. �� ������ �������� ���� ������� ��������� �������:
Bash:
  MANPATH="/usr/local/man:/usr/man:/usr/share/man:/usr/X11R6/man:/usr/lib/perl5/man"
  export MANPATH

Tcsh:
  setenv MANPATH "/usr/local/man:/usr/man:/usr/share/man:/usr/X11R6/man:/usr/lib/perl5/man"
����� ����� �������� "man Pod::Man" � ���������� �������� �� ������ ���� �������.  

��������������

�������� man-�������� ��������� �������. ���������� ����������� ���� � ������� ������� �������������� ���������� � ".". ���������� �������� ������:
.TH -> ��������� man-��������
.SH -> ��������� �������
.PP -> ����� ��������
."  -> �����������
.TP -> ����� ����� - ���������� ����� �������� ���� ����� �������


��������� ������� .TH:
.TH [name of program] [section number] [center footer] [left footer] [center header]

��������� ������� .SH:
.SH ����� ��� ���������


������ .PP ������������ ��� �������� ������.

������ ������� �������� �������� ����. ��� �������� ��������� �������:
.nf
_���_�������_�����������������_
_�����_�������������_�����_____
.fi
�������� ��������, ��� ��� ������� groff/nroff. ������ ����������� �������� �� ������ Unix ��������.

��� ������� �������������� man-������� ������ ��������������� �� man'� groff_man(7) ( ����� �� ������ ���������� html ������ ���� ������� ). � ���� ������� � �� ���� ��������� ��� �������, ������� ��� �������������� ������� ������������, ��� ���������� ��������� � �������� ��� ����������� ��� ����������.

 

�����

����� ��� ��� ������� ���� ������ man-�������� ���������� ����� �� ������� ��� �������:
NAME           ������ Name, �������� �������� ������� ��� �������.
SYNOPSIS       �������������.
DESCRIPTION    ��������.
OPTIONS        ���������.
RETURN VALUES  ������������ ��������.
ENVIRONMENT    �������� ���������� ���������.
FILES          ��������������� �����.
EXAMPLES       �������.
DIAGNOSTICS    ������������ ��� ������� 4 ( ���������� ).
ERRORS         ������ � ��������� ��������.
SEE ALSO       ������.
STANDARDS      ���������.
BUGS           ��������������.
SECURITY CONSIDERATIONS
               ������� ������������, ������� ���� �����.
other          ������.
 

������� man-��������

�������� ������� man-��������. �������� ��� ��� � ����� ��������� ��������� � ��������� ��� cdspeed.1.
.TH cdspeed 1  "September 10, 2003" "version 0.3" "USER COMMANDS"
.SH NAME
cdspeed \- decrease the speed of you cdrom to get faster access time
.SH SYNOPSIS
.B cdspeed
[\-h] [\-d device] \-s speed
.SH DESCRIPTION
Modern cdrom drives are too fast. It can take several seconds
on a 60x speed cdrom drive to spin it up and read data from
the drive.  The result is that these drives are just a lot slower
than a 8x or 24x drive.  This is especially true if you are only
occasionally (e.g every 5 seconds) reading a small file. This
utility limits the speed and makes the drive more responsive
when accessing small files.
.PP
cdspeed makes the drive also less noisy and is very useful if
you want to listen to music on your computer.
.SH OPTIONS
.TP
\-h
display a short help text
.TP
\-d
use the given device instead of /dev/cdrom
.TP
\-s
set the speed. The argument is a integer. Zero means restore maximum
speed.
.SH EXAMPLES
.TP
Set the maximum speed to 8 speed cdrom:
.B cdspeed
\-s 8
.PP
.TP
Restore maximum speed:
.B cdspeed
\-s 0
.PP
.SH EXIT STATUS
cdspeed returns a zero exist status if it succeeds to change to set the
maximum speed of the cdrom drive. Non zero is returned in case of failure.
.SH AUTHOR
Guido Socher (guido (at) linuxfocus.org)
.SH SEE ALSO
eject(1)
����� �� ������ ���������� ��� ��������.  

�������� � �������������� man-��������

�������� man-�������� �� ������ ����� �� ������� ������������� ��� ��� ��������:
nroff -man your_manpagefile.1 | less
���
groff -man -Tascii your_manpagefile.1 | less
��� �������������� man-�������� � ������ �������� ������ ����������� ��������� �����������:
nroff -man your_manpagefile.1 | col -b > xxxx.txt
��� �������������� � ������ Postscript ( ��� ������ ��� ����������� �������������� � ������ pdf ):
groff -man -Tps your_manpagefile.1 > your_manpagefile.ps
��� �������������� � ������ html:
man2html your_manpagefile.1
 

������������� perl POD ��� �������� man-�������

� ���� �����, ������� ������� �������� ������� �������������� man-������� � ��������� ���������. ��� ������������ ������������ ��. � ���� ������ ������� ������� �������� ������ perl POD. �� ������ �������� ��������, ��������� ��������� POD, � ����� ��������� ��������� �������:
pod2man your_manpagefile.pod > your_manpagefile.1
��������� ����� ��� �������� ���������� ������� perl pod ������ � man-�������� perlpod. ��������� ���� man-�������� ����� ��������� � ������� pod ��������� �������, ��� �������� ����. �������� �������� �� ������� � ������ ������ ����� ������ ��������� ������������ � ������� POD.
=head1 NAME

cdspeed -  decrease  the speed of you cdrom to get faster access time

=head1 SYNOPSIS

cdspeed [-h] [-d device] -s speed

=head1 DESCRIPTION

Modern cdrom drives are too fast. It can take several seconds  on a  60x
speed cdrom drive to spin it up and read data from the drive.  The result
is that these drives  are just  a lot slower than a 8x or 24x drive.
This is especially true if you are only occasionally (e.g every 5 seconds)
reading a small file. This utility limits the speed and makes the  drive
more  responsive  when  accessing  small files.

cdspeed makes the drive also less noisy and is very useful
if you want to listen to music on your computer.

=head1 OPTIONS

B<-h> display a short help text

B<-d> use the given device instead of /dev/cdrom

B<-s> set the speed. The  argument  is a  integer.  Zero
means restore maximum speed.

=head1 EXAMPLES

Set the maximum speed to 8 speed cdrom:

          cdspeed -s 8

Restore maximum speed:

          cdspeed -s 0


=head1 EXIT STATUS

cdspeed returns  a  zero  exist  status  if it succeeds to
change to set the maximum speed of the  cdrom  drive.  Non
zero is returned in case of failure.

=head1 AUTHOR

Guido Socher

=head1 SEE ALSO

eject(1)
 

������

 

�������� �������

� ������ ������� ���� �������� �������. �� ���� �������� �� ������ �������� ���� ����������� ��� ����������� ����������� ������ ���������
 talkback page 

<--, ������� � ��������� �������� �������

Webpages maintained by the LinuxFocus Editor team
© Guido Socher, FDL
LinuxFocus.org
Translation information:
en --> -- : Guido Socher (homepage)
en --> ru: Pukhlyakov Kirill <kirill(at)linuxfocus.org>

2003-11-03, generated by lfparser version 2.43