source:
patches/tar-1.21-man_page-1.patch@
649028b
Last change on this file since 649028b was ce3a096, checked in by , 16 years ago | |
---|---|
|
|
File size: 16.6 KB |
-
doc/Makefile.am
Submitted By: Jim Gifford (jim at cross-lfs dot org) Date: 2009-01-04 Initial Package Version: 1.21 Origin: Debian Upstream Status: N/A Description: This Patch adds and man-page to TAR. This has been added as per numerous requests. diff -Naur tar-1.21.orig/doc/Makefile.am tar-1.21/doc/Makefile.am
old new 17 17 ## along with this program; if not, write to the Free Software Foundation, 18 18 ## Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. 19 19 20 man_MANS = tar.1 21 20 22 info_TEXINFOS = tar.texi 21 23 tar_TEXINFOS = \ 22 24 dumpdir.texi\ -
doc/Makefile.in
diff -Naur tar-1.21.orig/doc/Makefile.in tar-1.21/doc/Makefile.in
old new 143 143 MAKEINFOHTML = $(MAKEINFO) --html 144 144 AM_MAKEINFOHTMLFLAGS = $(AM_MAKEINFOFLAGS) 145 145 DVIPS = dvips 146 am__installdirs = "$(DESTDIR)$(infodir)" 146 am__installdirs = "$(DESTDIR)$(infodir)" "$(DESTDIR)$(man1dir)" 147 147 am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; 148 148 am__vpath_adj = case $$p in \ 149 149 $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \ 150 150 *) f=$$p;; \ 151 151 esac; 152 152 am__strip_dir = `echo $$p | sed -e 's|^.*/||'`; 153 man1dir = $(mandir)/man1 154 NROFF = nroff 155 MANS = $(man_MANS) 153 156 DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) 154 157 ACLOCAL = @ACLOCAL@ 155 158 ALLOCA = @ALLOCA@ … … 592 595 target_alias = @target_alias@ 593 596 top_builddir = @top_builddir@ 594 597 top_srcdir = @top_srcdir@ 598 man_MANS = tar.1 595 599 info_TEXINFOS = tar.texi 596 600 tar_TEXINFOS = \ 597 601 dumpdir.texi\ … … 805 809 echo " rm -f $$i $$i-[0-9] $$i-[0-9][0-9] $$i_i[0-9] $$i_i[0-9][0-9]"; \ 806 810 rm -f $$i $$i-[0-9] $$i-[0-9][0-9] $$i_i[0-9] $$i_i[0-9][0-9]; \ 807 811 done 812 install-man1: $(man1_MANS) $(man_MANS) 813 @$(NORMAL_INSTALL) 814 test -z "$(man1dir)" || $(MKDIR_P) "$(DESTDIR)$(man1dir)" 815 @list='$(man1_MANS) $(dist_man1_MANS) $(nodist_man1_MANS)'; \ 816 l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \ 817 for i in $$l2; do \ 818 case "$$i" in \ 819 *.1*) list="$$list $$i" ;; \ 820 esac; \ 821 done; \ 822 for i in $$list; do \ 823 if test -f $(srcdir)/$$i; then file=$(srcdir)/$$i; \ 824 else file=$$i; fi; \ 825 ext=`echo $$i | sed -e 's/^.*\\.//'`; \ 826 case "$$ext" in \ 827 1*) ;; \ 828 *) ext='1' ;; \ 829 esac; \ 830 inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \ 831 inst=`echo $$inst | sed -e 's/^.*\///'`; \ 832 inst=`echo $$inst | sed '$(transform)'`.$$ext; \ 833 echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man1dir)/$$inst'"; \ 834 $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man1dir)/$$inst"; \ 835 done 836 uninstall-man1: 837 @$(NORMAL_UNINSTALL) 838 @list='$(man1_MANS) $(dist_man1_MANS) $(nodist_man1_MANS)'; \ 839 l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \ 840 for i in $$l2; do \ 841 case "$$i" in \ 842 *.1*) list="$$list $$i" ;; \ 843 esac; \ 844 done; \ 845 for i in $$list; do \ 846 ext=`echo $$i | sed -e 's/^.*\\.//'`; \ 847 case "$$ext" in \ 848 1*) ;; \ 849 *) ext='1' ;; \ 850 esac; \ 851 inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \ 852 inst=`echo $$inst | sed -e 's/^.*\///'`; \ 853 inst=`echo $$inst | sed '$(transform)'`.$$ext; \ 854 echo " rm -f '$(DESTDIR)$(man1dir)/$$inst'"; \ 855 rm -f "$(DESTDIR)$(man1dir)/$$inst"; \ 856 done 808 857 tags: TAGS 809 858 TAGS: 810 859 … … 843 892 dist-info 844 893 check-am: all-am 845 894 check: check-am 846 all-am: Makefile $(INFO_DEPS) 895 all-am: Makefile $(INFO_DEPS) $(MANS) 847 896 installdirs: 848 for dir in "$(DESTDIR)$(infodir)" ; do \897 for dir in "$(DESTDIR)$(infodir)" "$(DESTDIR)$(man1dir)"; do \ 849 898 test -z "$$dir" || $(MKDIR_P) "$$dir"; \ 850 899 done 851 900 install: install-am … … 892 941 893 942 info-am: $(INFO_DEPS) 894 943 895 install-data-am: install-info-am 944 install-data-am: install-info-am install-man 896 945 897 946 install-dvi: install-dvi-am 898 947 … … 957 1006 install-info --info-dir="$(DESTDIR)$(infodir)" "$(DESTDIR)$(infodir)/$$relfile" || :;\ 958 1007 done; \ 959 1008 else : ; fi 960 install-man: 1009 install-man: install-man1 961 1010 962 1011 install-pdf: install-pdf-am 963 1012 … … 1001 1050 ps-am: $(PSS) 1002 1051 1003 1052 uninstall-am: uninstall-dvi-am uninstall-html-am uninstall-info-am \ 1004 uninstall-pdf-am uninstall-ps-am 1053 uninstall-man uninstall-pdf-am uninstall-ps-am 1054 1055 uninstall-man: uninstall-man1 1005 1056 1006 1057 .MAKE: install-am install-strip 1007 1058 … … 1010 1061 html-am info info-am install install-am install-data \ 1011 1062 install-data-am install-dvi install-dvi-am install-exec \ 1012 1063 install-exec-am install-html install-html-am install-info \ 1013 install-info-am install-man install- pdf install-pdf-am\1014 install-p s install-ps-am install-strip installcheck\1015 installcheck -am installdirs maintainer-clean \1064 install-info-am install-man install-man1 install-pdf \ 1065 install-pdf-am install-ps install-ps-am install-strip \ 1066 installcheck installcheck-am installdirs maintainer-clean \ 1016 1067 maintainer-clean-aminfo maintainer-clean-generic \ 1017 1068 maintainer-clean-vti mostlyclean mostlyclean-aminfo \ 1018 1069 mostlyclean-generic mostlyclean-vti pdf pdf-am ps ps-am \ 1019 1070 uninstall uninstall-am uninstall-dvi-am uninstall-html-am \ 1020 uninstall-info-am uninstall-pdf-am uninstall-ps-am 1071 uninstall-info-am uninstall-man uninstall-man1 \ 1072 uninstall-pdf-am uninstall-ps-am 1021 1073 1022 1074 1023 1075 header.texi: $(top_srcdir)/src/tar.h -
doc/tar.1
diff -Naur tar-1.21.orig/doc/tar.1 tar-1.21/doc/tar.1
old new 1 .\" @(#)tar.1 1.11.1 93/19/22 PJV; 2 .TH TAR 1 "29 Aug 2007" 3 .SH NAME 4 tar \- The GNU version of the tar archiving utility 5 .SH SYNOPSIS 6 .B tar 7 [ 8 .B \- 9 ] 10 .B A \-\-catenate \-\-concatenate \||\| c \-\-create \||\| d \-\-diff \-\-compare \||\| \-\-delete \||\| r \-\-append \||\| t \-\-list \||\| u \-\-update \||\| x \-\-extract \-\-get 11 .I [ options ] 12 .I pathname [ pathname ... ] 13 .SH DESCRIPTION 14 .LP 15 This manual page documents the GNU version of 16 .B tar 17 , an archiving program designed to store and extract files from 18 an archive file known as a 19 .IR tarfile. 20 A 21 .IR tarfile 22 may be made on a tape drive, however, it is also common 23 to write a 24 .IR tarfile 25 to a normal file. 26 The first argument to 27 .B tar 28 must be one of the options: 29 .BR Acdrtux , 30 followed by any optional functions. 31 The final arguments to 32 .B tar 33 are the names of the files or directories which should be archived. The use 34 of a directory name always implies that the subdirectories below should be 35 included in the archive. 36 .SH EXAMPLES 37 .TP 38 .B tar \-xvvf foo.tar 39 extract foo.tar 40 .TP 41 .B tar \-xvvzf foo.tar.gz 42 extract gzipped foo.tar.gz 43 .TP 44 .B tar \-cvvf foo.tar foo/ 45 tar contents of folder foo in foo.tar 46 .SH "FUNCTION LETTERS" 47 .TP 48 .B One of the following options must be used: 49 .TP 50 .B \-A, \-\-catenate, \-\-concatenate 51 append tar files to an archive 52 .TP 53 .B \-c, \-\-create 54 create a new archive 55 .TP 56 .B \-d, \-\-diff, \-\-compare 57 find differences between archive and file system 58 .TP 59 .B \-\-delete 60 delete from the archive (not for use on mag tapes!) 61 .TP 62 .B \-r, \-\-append 63 append files to the end of an archive 64 .TP 65 .B \-t, \-\-list 66 list the contents of an archive 67 .TP 68 .B \-u, \-\-update 69 only append files that are newer than copy in archive 70 .TP 71 .B \-x, \-\-extract, \-\-get 72 extract files from an archive 73 .SH "OTHER OPTIONS" 74 .TP 75 .B \-\-allow\-name\-mangling 76 re-enable handling of GNUTYPE_NAMES which is now disabled by default 77 .TP 78 .B \-\-anchored 79 force exclusion patterns to match initial subsequences 80 .TP 81 .B \-\-atime\-preserve 82 don't change access times on dumped files 83 .TP 84 .B \-a, \-\-auto\-compress 85 with \-\-create, selects compression algorithm basing on the suffix 86 of the archive file name 87 .TP 88 .B \-b, \-\-blocking\-factor N 89 use record size of Nx512 bytes (default N=20) 90 .TP 91 .B \-B, \-\-read\-full\-records 92 reblock as we read (for reading 4.2BSD pipes) 93 .TP 94 .B \-\-backup[\=TYPE] 95 back up files instead of overwriting (TYPE=numbered, existing, simple) 96 .TP 97 .B \-C, \-\-directory DIR 98 change to directory DIR 99 .TP 100 .B \-\-checkpoint 101 print periodic checkpoints 102 .TP 103 .B \-\-checkpoint\-action 104 this action allows to specify an action to be executed upon hitting a 105 checkpoint. Recognized actions are: dot, echo (the default), 106 echo\=string, ttyout\=string, exec\=cmdline, and sleep\=value. Any number 107 of `\-\-checkpoint\-action' options can be specified, the actions will be 108 executed in order of their appearance in the command line. 109 .TP 110 .B \-\-check\-device 111 enables comparing device numbers. This is the default. 112 .TP 113 .B \-\-no\-check\-device 114 disables comparing device numbers during preparatory stage of an 115 incremental dump. 116 This allows to avoid creating full dumps if the device numbers change 117 (e.g. when using an LVM snapshot) 118 .TP 119 .B \-\-exclude=PATTERN 120 exclude files matching PATTERN 121 .TP 122 .B \-f, \-\-file [HOSTNAME:]F 123 use archive file or device F (otherwise value of TAPE environment variable; if unset, "\-", meaning stdin/stdout) 124 .TP 125 .B \-F, \-\-info\-script F, \-\-new\-volume\-script F 126 run script at end of each tape (implies \-M) 127 .TP 128 .B \-\-force\-local 129 archive file is local even if it has a colon 130 .TP 131 .B \-G, \-\-incremental 132 create/list/extract old GNU-format incremental backup 133 .TP 134 .B \-g, \-\-listed\-incremental F 135 create/list/extract new GNU-format incremental backup 136 .TP 137 .B \-\-group G 138 set group to G while adding files 139 .TP 140 .B \-h, \-\-dereference 141 don't dump symlinks; dump the files they point to 142 .TP 143 .B \-\-hard\-dereference 144 during archive creation, dereferences hard links and stores the files 145 they refer to, instead of creating usual hard link members (type '1') 146 .TP 147 .B \-\-help 148 print help message 149 .TP 150 .B \-i, \-\-ignore\-zeros 151 ignore blocks of zeros in archive (normally mean EOF) 152 .TP 153 .B \-\-ignore\-case 154 ignore case when excluding files 155 .TP 156 .B \-\-ignore\-failed\-read 157 don't exit with non-zero status on unreadable files 158 .TP 159 .B \-j, \-\-bzip2 160 filter archive through bzip2, use to decompress .bz2 files. 161 WARNING: some previous versions of tar used option \-I to 162 filter through bzip2. When writing scripts, use \-\-bzip2 163 instead of \-j so that both older and newer tar versions 164 will work. 165 .TP 166 .B \-k, \-\-keep\-old\-files 167 keep existing files; don't overwrite them from archive 168 .TP 169 .B \-K, \-\-starting\-file F 170 begin at file F in the archive 171 .TP 172 .B \-\-lzma 173 selects LZMA compression algorithm 174 .TP 175 .B \-l, \-\-check\-links 176 print a message if not all links are dumped 177 .TP 178 .B \-L, \-\-tape\-length N 179 change tapes after writing N*1024 bytes 180 .TP 181 .B \-m, \-\-touch 182 don't extract file modified time 183 .TP 184 .BI \-\-transform " expr" 185 applies filename transformations. 186 The argument to this option can be a list of replace expressions, separated 187 by semicolon (as in `sed'). 188 Filename transformations are applied to symbolic link targets during both 189 creation and extraction. 190 This option may be specified any number of 191 times, the specified transofrmations will be applied in turn. 192 .TP 193 .B \-M, \-\-multi\-volume 194 create/list/extract multi-volume archive 195 .TP 196 .B \-\-mode M 197 set permissions to M while adding files 198 .TP 199 .B \-N, \-\-after\-date DATE, \-\-newer DATE 200 only store files newer than DATE 201 .TP 202 .B \-\-newer\-mtime DATE 203 only store files whose contents have changed after DATE 204 .TP 205 .B \-\-no\-anchored 206 allow exclusion patterns to match any substring (the default) 207 .TP 208 .B \-\-no\-ignore\-case 209 match patterns case sensitively (the default) 210 .TP 211 .B \-\-no\-recursion 212 do not recurse into subdirectories 213 .TP 214 .B \-o, \-\-no\-same\-owner 215 extract files with owner set to current user (the default for non-root 216 users) 217 .TP 218 .B \-\-no\-same\-permissions 219 apply umask to extracted files (the default for non-root users) 220 .TP 221 .B \-\-no\-wildcards 222 do not use wildcards when excluding files 223 .TP 224 .B \-\-no\-wildcards\-match\-slash 225 don't let wildcards match "/" when excluding files 226 .TP 227 .B \-\-null 228 for \-T, use "NUL" instead of newline as filename terminator 229 .TP 230 .B \-\-numeric\-owner 231 always use numbers for user/group names 232 .TP 233 .B \-\-old\-archive, \-\-portability 234 write a V7 format archive, rather than ANSI format. These options are 235 deprecated, please use 236 .B \-\-format\=v7 237 instead. 238 .TP 239 .B \-\-one\-file\-system 240 stay in local file system when creating an archive 241 .TP 242 .B \-\-owner O 243 set owner to O while adding files 244 .TP 245 .B \-O, \-\-to\-stdout 246 extract files to standard output 247 .TP 248 .B \-p, \-\-same\-permissions, \-\-preserve\-permissions 249 ignore umask when extracting files (the default for root) 250 .TP 251 .B \-P, \-\-absolute\-names 252 don't strip leading `/'s from file names 253 .TP 254 .B \-\-posix 255 create POSIX compliant archive. This option is deprecated, 256 please use 257 .B \-\-format\=posix 258 instead. 259 .TP 260 .B \-\-preserve 261 like \-p \-s 262 .TP 263 .B \-R, \-\-block\-number 264 show block number within archive with each message 265 .TP 266 .B \-\-record\-size SIZE 267 use SIZE bytes per record 268 .TP 269 .B \-\-recursion 270 recurse into directories (the default) 271 .TP 272 .B \-\-recursive\-unlink 273 remove existing directories before extracting directories of the same 274 name 275 .TP 276 .B \-\-remove\-files 277 remove files after adding them to the archive 278 .TP 279 .B \-\-rsh\-command=CMD 280 Use remote COMMAND instead of `rsh'. This option exists so that 281 people who use something other than the standard `rsh' (e.g., a 282 Kerberized `rsh') can access a remote device. 283 .TP 284 .B \-S, \-\-sparse 285 handle sparse files efficiently 286 .TP 287 .B \-s, \-\-same\-order, \-\-preserve\-order 288 list of names to extract is sorted to match archive 289 .TP 290 .B \-\-same\-owner 291 extract files with owner as specified in archive (the default for 292 root) 293 .TP 294 .B \-\-show\-omitted\-dirs 295 mention directories that are being skipped over 296 .TP 297 .BI \-\-strip\-components " n" 298 Strip the given number of leading directory components 299 .TP 300 .B \-\-strip, \-\-strip\-components N 301 Strips the first N components from archive members' pathnames when 302 unpacking. 303 .TP 304 .B \-\-suffix SUFFIX 305 append SUFFIX to make backup files (default ~) 306 .TP 307 .B \-T, \-\-files\-from F 308 get names to extract or archive from file F 309 .TP 310 .B \-\-totals 311 display total bytes written after creating an archive 312 .TP 313 .B \-U, \-\-unlink\-first 314 unlink & recreate files instead of overwriting 315 .TP 316 .B \-\-use\-compress\-program PROG 317 filter the archive through PROG (which must accept \-d) 318 .TP 319 .B \-v, \-\-verbose 320 verbosely list files processed 321 .TP 322 .B \-V, \-\-label NAME 323 create archive with volume name NAME 324 .TP 325 .B \-\-version 326 print tar program version number 327 .TP 328 .B \-\-volno\-file F 329 keep track of current volume (of a multi-volume archive) in F 330 .TP 331 .B \-w, \-\-interactive, \-\-confirmation 332 ask for confirmation for every action 333 .TP 334 .B \-W, \-\-verify 335 attempt to verify the archive after writing it 336 .TP 337 .B \-\-wildcards 338 use wildcards when excluding files (the default) 339 .TP 340 .B \-\-wildcards\-match\-slash 341 allow wildcards to match "/" (the default) 342 .TP 343 .B \-X, \-\-exclude\-from=FILE 344 exclude files matching patterns listed in FILE 345 .TP 346 .B \-Z, \-\-compress, \-\-uncompress 347 filter the archive through compress 348 .TP 349 .B \-z, \-\-gzip, \-\-gunzip, \-\-ungzip 350 filter the archive through gzip 351 .TP 352 .B \-[0\-7][lmh] 353 specify drive and density 354 .SH ENVIRONMENT 355 The behavior of tar is controlled by the following environment variables, 356 among others: 357 .TP 358 .B TAPE 359 Device or file to use for the archive if \fB--file\fR is not specified. 360 If this environment variable is unset, use stdin or stdout instead. 361 .TP 362 .B TAR_OPTIONS 363 Options to prepend to those specified on the command line, separated by 364 whitespace. Embedded backslashes may be used to escape whitespace or 365 backslashes within an option. 366 .LP 367 In addition, the value of the blocking factor is made available to info 368 and checkpoint scripts via environment variable 369 .B TAR_BLOCKING_FACTOR. 370 .SH BUGS 371 .LP 372 The GNU folks, in general, abhor man pages and create info documents instead. 373 The maintainer of \fBtar\fR falls into this category. Thus, this man page may 374 not be complete nor current, and it is included in the Cross-LFS Build 375 because man is a great tool :). This man page was taken from Debian 376 Linux and has since been lovingly updated here. 377 378 If you want to read the complete documentation for GNU tar, please refer to 379 the online version at 380 .PP 381 .ce 1 382 <http://www.gnu.org/software/tar/manual/index.html> 383 .PP 384 This man page was created for the Cross LFS Build. It does not describe 385 all of the functionality of tar, and it is often out of date. Patches to 386 improve the coverage and/or accuracy of this man page are appreciated, and 387 should be filed as tickets in bug reporting system for Cross-LFS and 388 not submitted to the GNU tar maintainers. The URL for the Cross-LFS bug 389 reporting system is at 390 .PP 391 .ce 1 392 <http://trac.cross-lfs.org> 393 .PP 394
Note:
See TracBrowser
for help on using the repository browser.