source:
patches/tar-1.22-man_page-1.patch@
369d5d6
Last change on this file since 369d5d6 was 4588a6c, checked in by , 16 years ago | |
---|---|
|
|
File size: 16.7 KB |
-
doc/Makefile.am
Submitted By: Jim Gifford (jim at cross-lfs dot org) Date: 2009-03-06 Initial Package Version: 1.22 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.22.orig/doc/Makefile.am tar-1.22/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.22.orig/doc/Makefile.in tar-1.22/doc/Makefile.in
old new 146 146 MAKEINFOHTML = $(MAKEINFO) --html 147 147 AM_MAKEINFOHTMLFLAGS = $(AM_MAKEINFOFLAGS) 148 148 DVIPS = dvips 149 am__installdirs = "$(DESTDIR)$(infodir)" 149 am__installdirs = "$(DESTDIR)$(infodir)" "$(DESTDIR)$(man1dir)" 150 150 am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; 151 151 am__vpath_adj = case $$p in \ 152 152 $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \ 153 153 *) f=$$p;; \ 154 154 esac; 155 155 am__strip_dir = `echo $$p | sed -e 's|^.*/||'`; 156 man1dir = $(mandir)/man1 157 NROFF = nroff 158 MANS = $(man_MANS) 156 159 DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) 157 160 ACLOCAL = @ACLOCAL@ 158 161 ALLOCA = @ALLOCA@ … … 645 648 target_alias = @target_alias@ 646 649 top_builddir = @top_builddir@ 647 650 top_srcdir = @top_srcdir@ 651 man_MANS = tar.1 648 652 info_TEXINFOS = tar.texi 649 653 tar_TEXINFOS = \ 650 654 dumpdir.texi\ … … 858 862 echo " rm -f $$i $$i-[0-9] $$i-[0-9][0-9] $$i_i[0-9] $$i_i[0-9][0-9]"; \ 859 863 rm -f $$i $$i-[0-9] $$i-[0-9][0-9] $$i_i[0-9] $$i_i[0-9][0-9]; \ 860 864 done 865 install-man1: $(man1_MANS) $(man_MANS) 866 @$(NORMAL_INSTALL) 867 test -z "$(man1dir)" || $(MKDIR_P) "$(DESTDIR)$(man1dir)" 868 @list='$(man1_MANS) $(dist_man1_MANS) $(nodist_man1_MANS)'; \ 869 l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \ 870 for i in $$l2; do \ 871 case "$$i" in \ 872 *.1*) list="$$list $$i" ;; \ 873 esac; \ 874 done; \ 875 for i in $$list; do \ 876 if test -f $(srcdir)/$$i; then file=$(srcdir)/$$i; \ 877 else file=$$i; fi; \ 878 ext=`echo $$i | sed -e 's/^.*\\.//'`; \ 879 case "$$ext" in \ 880 1*) ;; \ 881 *) ext='1' ;; \ 882 esac; \ 883 inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \ 884 inst=`echo $$inst | sed -e 's/^.*\///'`; \ 885 inst=`echo $$inst | sed '$(transform)'`.$$ext; \ 886 echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man1dir)/$$inst'"; \ 887 $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man1dir)/$$inst"; \ 888 done 889 uninstall-man1: 890 @$(NORMAL_UNINSTALL) 891 @list='$(man1_MANS) $(dist_man1_MANS) $(nodist_man1_MANS)'; \ 892 l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \ 893 for i in $$l2; do \ 894 case "$$i" in \ 895 *.1*) list="$$list $$i" ;; \ 896 esac; \ 897 done; \ 898 for i in $$list; do \ 899 ext=`echo $$i | sed -e 's/^.*\\.//'`; \ 900 case "$$ext" in \ 901 1*) ;; \ 902 *) ext='1' ;; \ 903 esac; \ 904 inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \ 905 inst=`echo $$inst | sed -e 's/^.*\///'`; \ 906 inst=`echo $$inst | sed '$(transform)'`.$$ext; \ 907 echo " rm -f '$(DESTDIR)$(man1dir)/$$inst'"; \ 908 rm -f "$(DESTDIR)$(man1dir)/$$inst"; \ 909 done 861 910 tags: TAGS 862 911 TAGS: 863 912 … … 896 945 dist-info 897 946 check-am: all-am 898 947 check: check-am 899 all-am: Makefile $(INFO_DEPS) 948 all-am: Makefile $(INFO_DEPS) $(MANS) 900 949 installdirs: 901 for dir in "$(DESTDIR)$(infodir)" ; do \950 for dir in "$(DESTDIR)$(infodir)" "$(DESTDIR)$(man1dir)"; do \ 902 951 test -z "$$dir" || $(MKDIR_P) "$$dir"; \ 903 952 done 904 953 install: install-am … … 945 994 946 995 info-am: $(INFO_DEPS) 947 996 948 install-data-am: install-info-am 997 install-data-am: install-info-am install-man 949 998 950 999 install-dvi: install-dvi-am 951 1000 … … 1010 1059 install-info --info-dir="$(DESTDIR)$(infodir)" "$(DESTDIR)$(infodir)/$$relfile" || :;\ 1011 1060 done; \ 1012 1061 else : ; fi 1013 install-man: 1062 install-man: install-man1 1014 1063 1015 1064 install-pdf: install-pdf-am 1016 1065 … … 1054 1103 ps-am: $(PSS) 1055 1104 1056 1105 uninstall-am: uninstall-dvi-am uninstall-html-am uninstall-info-am \ 1057 uninstall-pdf-am uninstall-ps-am 1106 uninstall-man uninstall-pdf-am uninstall-ps-am 1107 1108 uninstall-man: uninstall-man1 1058 1109 1059 1110 .MAKE: install-am install-strip 1060 1111 … … 1063 1114 html-am info info-am install install-am install-data \ 1064 1115 install-data-am install-dvi install-dvi-am install-exec \ 1065 1116 install-exec-am install-html install-html-am install-info \ 1066 install-info-am install-man install- pdf install-pdf-am\1067 install-p s install-ps-am install-strip installcheck\1068 installcheck -am installdirs maintainer-clean \1117 install-info-am install-man install-man1 install-pdf \ 1118 install-pdf-am install-ps install-ps-am install-strip \ 1119 installcheck installcheck-am installdirs maintainer-clean \ 1069 1120 maintainer-clean-aminfo maintainer-clean-generic \ 1070 1121 maintainer-clean-vti mostlyclean mostlyclean-aminfo \ 1071 1122 mostlyclean-generic mostlyclean-vti pdf pdf-am ps ps-am \ 1072 1123 uninstall uninstall-am uninstall-dvi-am uninstall-html-am \ 1073 uninstall-info-am uninstall-pdf-am uninstall-ps-am 1124 uninstall-info-am uninstall-man uninstall-man1 \ 1125 uninstall-pdf-am uninstall-ps-am 1074 1126 1075 1127 1076 1128 header.texi: $(top_srcdir)/src/tar.h -
doc/tar.1
diff -Naur tar-1.22.orig/doc/tar.1 tar-1.22/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 \-J, \-\-xz 167 selects XZ compression algorithm 168 .TP 169 .B \-k, \-\-keep\-old\-files 170 keep existing files; don't overwrite them from archive 171 .TP 172 .B \-K, \-\-starting\-file F 173 begin at file F in the archive 174 .TP 175 .B \-\-lzip 176 selects Lzip compression algorithm 177 .TP 178 .B \-\-lzma 179 selects LZMA compression algorithm 180 .TP 181 .B \-l, \-\-check\-links 182 print a message if not all links are dumped 183 .TP 184 .B \-L, \-\-tape\-length N 185 change tapes after writing N*1024 bytes 186 .TP 187 .B \-m, \-\-touch 188 don't extract file modified time 189 .TP 190 .BI \-\-transform " expr" 191 applies filename transformations. 192 The argument to this option can be a list of replace expressions, separated 193 by semicolon (as in `sed'). 194 Filename transformations are applied to symbolic link targets during both 195 creation and extraction. 196 This option may be specified any number of 197 times, the specified transofrmations will be applied in turn. 198 .TP 199 .B \-M, \-\-multi\-volume 200 create/list/extract multi-volume archive 201 .TP 202 .B \-\-mode M 203 set permissions to M while adding files 204 .TP 205 .B \-N, \-\-after\-date DATE, \-\-newer DATE 206 only store files newer than DATE 207 .TP 208 .B \-\-newer\-mtime DATE 209 only store files whose contents have changed after DATE 210 .TP 211 .B \-\-no\-anchored 212 allow exclusion patterns to match any substring (the default) 213 .TP 214 .B \-\-no\-ignore\-case 215 match patterns case sensitively (the default) 216 .TP 217 .B \-\-no\-recursion 218 do not recurse into subdirectories 219 .TP 220 .B \-o, \-\-no\-same\-owner 221 extract files with owner set to current user (the default for non-root 222 users) 223 .TP 224 .B \-\-no\-same\-permissions 225 apply umask to extracted files (the default for non-root users) 226 .TP 227 .B \-\-no\-wildcards 228 do not use wildcards when excluding files 229 .TP 230 .B \-\-no\-wildcards\-match\-slash 231 don't let wildcards match "/" when excluding files 232 .TP 233 .B \-\-null 234 for \-T, use "NUL" instead of newline as filename terminator 235 .TP 236 .B \-\-numeric\-owner 237 always use numbers for user/group names 238 .TP 239 .B \-\-old\-archive, \-\-portability 240 write a V7 format archive, rather than ANSI format. These options are 241 deprecated, please use 242 .B \-\-format\=v7 243 instead. 244 .TP 245 .B \-\-one\-file\-system 246 stay in local file system when creating an archive 247 .TP 248 .B \-\-owner O 249 set owner to O while adding files 250 .TP 251 .B \-O, \-\-to\-stdout 252 extract files to standard output 253 .TP 254 .B \-p, \-\-same\-permissions, \-\-preserve\-permissions 255 ignore umask when extracting files (the default for root) 256 .TP 257 .B \-P, \-\-absolute\-names 258 don't strip leading `/'s from file names 259 .TP 260 .B \-\-posix 261 create POSIX compliant archive. This option is deprecated, 262 please use 263 .B \-\-format\=posix 264 instead. 265 .TP 266 .B \-\-preserve 267 like \-p \-s 268 .TP 269 .B \-R, \-\-block\-number 270 show block number within archive with each message 271 .TP 272 .B \-\-record\-size SIZE 273 use SIZE bytes per record 274 .TP 275 .B \-\-recursion 276 recurse into directories (the default) 277 .TP 278 .B \-\-recursive\-unlink 279 remove existing directories before extracting directories of the same 280 name 281 .TP 282 .B \-\-remove\-files 283 remove files after adding them to the archive 284 .TP 285 .B \-\-rsh\-command=CMD 286 Use remote COMMAND instead of `rsh'. This option exists so that 287 people who use something other than the standard `rsh' (e.g., a 288 Kerberized `rsh') can access a remote device. 289 .TP 290 .B \-S, \-\-sparse 291 handle sparse files efficiently 292 .TP 293 .B \-s, \-\-same\-order, \-\-preserve\-order 294 list of names to extract is sorted to match archive 295 .TP 296 .B \-\-same\-owner 297 extract files with owner as specified in archive (the default for 298 root) 299 .TP 300 .B \-\-show\-omitted\-dirs 301 mention directories that are being skipped over 302 .TP 303 .BI \-\-strip\-components " n" 304 Strip the given number of leading directory components 305 .TP 306 .B \-\-strip, \-\-strip\-components N 307 Strips the first N components from archive members' pathnames when 308 unpacking. 309 .TP 310 .B \-\-suffix SUFFIX 311 append SUFFIX to make backup files (default ~) 312 .TP 313 .B \-T, \-\-files\-from F 314 get names to extract or archive from file F 315 .TP 316 .B \-\-totals 317 display total bytes written after creating an archive 318 .TP 319 .B \-U, \-\-unlink\-first 320 unlink & recreate files instead of overwriting 321 .TP 322 .B \-\-use\-compress\-program PROG 323 filter the archive through PROG (which must accept \-d) 324 .TP 325 .B \-v, \-\-verbose 326 verbosely list files processed 327 .TP 328 .B \-V, \-\-label NAME 329 create archive with volume name NAME 330 .TP 331 .B \-\-version 332 print tar program version number 333 .TP 334 .B \-\-volno\-file F 335 keep track of current volume (of a multi-volume archive) in F 336 .TP 337 .B \-w, \-\-interactive, \-\-confirmation 338 ask for confirmation for every action 339 .TP 340 .B \-W, \-\-verify 341 attempt to verify the archive after writing it 342 .TP 343 .B \-\-wildcards 344 use wildcards when excluding files (the default) 345 .TP 346 .B \-\-wildcards\-match\-slash 347 allow wildcards to match "/" (the default) 348 .TP 349 .B \-X, \-\-exclude\-from=FILE 350 exclude files matching patterns listed in FILE 351 .TP 352 .B \-Z, \-\-compress, \-\-uncompress 353 filter the archive through compress 354 .TP 355 .B \-z, \-\-gzip, \-\-gunzip, \-\-ungzip 356 filter the archive through gzip 357 .TP 358 .B \-[0\-7][lmh] 359 specify drive and density 360 .SH ENVIRONMENT 361 The behavior of tar is controlled by the following environment variables, 362 among others: 363 .TP 364 .B TAPE 365 Device or file to use for the archive if \fB--file\fR is not specified. 366 If this environment variable is unset, use stdin or stdout instead. 367 .TP 368 .B TAR_OPTIONS 369 Options to prepend to those specified on the command line, separated by 370 whitespace. Embedded backslashes may be used to escape whitespace or 371 backslashes within an option. 372 .LP 373 In addition, the value of the blocking factor is made available to info 374 and checkpoint scripts via environment variable 375 .B TAR_BLOCKING_FACTOR. 376 .SH BUGS 377 .LP 378 The GNU folks, in general, abhor man pages and create info documents instead. 379 The maintainer of \fBtar\fR falls into this category. Thus, this man page may 380 not be complete nor current, and it is included in the Cross-LFS Build 381 because man is a great tool :). This man page was taken from Debian 382 Linux and has since been lovingly updated here. 383 384 If you want to read the complete documentation for GNU tar, please refer to 385 the online version at 386 .PP 387 .ce 1 388 <http://www.gnu.org/software/tar/manual/index.html> 389 .PP 390 This man page was created for the Cross LFS Build. It does not describe 391 all of the functionality of tar, and it is often out of date. Patches to 392 improve the coverage and/or accuracy of this man page are appreciated, and 393 should be filed as tickets in bug reporting system for Cross-LFS and 394 not submitted to the GNU tar maintainers. The URL for the Cross-LFS bug 395 reporting system is at 396 .PP 397 .ce 1 398 <http://trac.cross-lfs.org> 399 .PP 400
Note:
See TracBrowser
for help on using the repository browser.