ossp-pkg/shtool/sh.fixperm 1.17 -> 1.18
--- sh.fixperm 2004/01/01 16:54:20 1.17
+++ sh.fixperm 2004/02/12 16:06:26 1.18
@@ -1,7 +1,6 @@
##
## fixperm -- Fix file permissions inside a source tree
## Copyright (c) 1996-2004 Ralf S. Engelschall <rse@engelschall.com>
-## Originally written for ePerl
##
## This file is part of shtool and free software; you can redistribute
## it and/or modify it under the terms of the GNU General Public
@@ -77,3 +76,67 @@
done
done
+shtool_exit 0
+
+##
+## manual page
+##
+
+=pod
+
+=head1 NAME
+
+B<shtool fixperm> - B<GNU shtool> file permission fixing command
+
+=head1 SYNOPSIS
+
+B<shtool fixperm>
+[B<-v>|B<--verbose>]
+[B<-t>|B<--trace>]
+I<path>
+[I<path> ...]
+
+=head1 DESCRIPTION
+
+B<shtool fixperm> fixes file permissions inside a source tree under
+I<path> by cleaning up the permission bits. It determines the cleaned up
+permission from the already set bits. It is intended to be run before
+a tarball is rolled (usually with B<shtool tarball>) out of a source
+tree. The trick is that this is more convenient than having to set the
+permissions manually or by using a large file list.
+
+=head1 OPTIONS
+
+The following command line options are available.
+
+=over 4
+
+=item B<-v>, B<--verbose>
+
+Display some processing information.
+
+=item B<-t>, B<--trace>
+
+Enable the output of the essential shell commands which are executed.
+
+=back
+
+=head1 EXAMPLE
+
+ # Makefile.in
+ dist:
+ shtool fixperm -v *
+ ...
+
+=head1 HISTORY
+
+The B<GNU shtool> B<fixperm> command was originally written by Ralf S.
+Engelschall E<lt>rse@engelschall.comE<gt> in 1996 for I<OSSP eperl>.
+It was later taken over into B<GNU shtool>.
+
+=head1 SEE ALSO
+
+shtool(1), chmod(1).
+
+=cut
+
|
|
