#! /usr/bin/perl
# 
# $Id$
# perlpod(1) source for captive-install-fstab(1) man page
# Copyright (C) 2003 Jan Kratochvil <project-captive@jankratochvil.net>
# 
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; exactly version 2 of June 1991 is required
# 
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
# 
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA


use vars qw($VERSION);
$VERSION=do { my @r=(q$Revision$=~/\d+/g); sprintf "%d.".("%03d"x$#r),@r; };
use strict;
use warnings;


print <<'POD_EOF';
=head1 NAME

@PACKAGE@-install-fstab - Manage B<@PACKAGE@-ntfs> B</etc/fstab> entries


=head1 SYNOPSIS

=for man
\fB@PACKAGE@-install-fstab\fP [\fB-v\fP|\fB--verbose\fP] [\fB-n\fP|\fB--dry\fP]
{\fB--add\fP|\fB--remove\fP}


=head1 DESCRIPTION

Program will scan your local disk drive partitions (from B</proc/partitions>)
and it will add/remove appropriate file-system type B<captive-ntfs> entries
in B</etc/fstab>.

Destination directory is chosen automatically as B</mnt/@PACKAGE@->LABEL_NAME
where B<LABEL_NAME> is the label used for the B<NTFS> partition. Directory
B</mnt/@PACKAGE@-> may be used if no volume label is set. Different (numbered)
directory name is used if multiple disks have the same volume label set.


=head1 OPTIONS

=over

=item B<-v>|B<--verbose>

Display additional information during disks scanning.


=item B<-n>|B<--dry>

Perform all the operations but do not modify anything (file B</etc/fstab>).
You will probably use this option together with [B<-v>|B<--verbose>].


=item B<--add>

Add all the found B<NTFS> disk drive partitions to B</etc/fstab>.
Previous B<captive-ntfs> entries for the same device will be kept
if B<--replace> is not used.


=item B<--remove>

Remove all lines of filesystem type B<@PACKAGE@-ntfs> and device name in
B</dev> directory.


=item B<--replace>

Replace existing entries by new ones on B<--add>. By default the existing
B<captive-ntfs> entries are kept untouched.


=back


=head1 SEE ALSO

B<@PACKAGE@-install-acquire>(1), B<@PACKAGE@>(7), B<mount.@PACKAGE@>(8)


=head1 AUTHOR

Jan Kratochvil <B<project-@PACKAGE@@jankratochvil.net>>,
		I<http://www.jankratochvil.net/>
POD_EOF
1;