summaryrefslogtreecommitdiff
path: root/archival
diff options
context:
space:
mode:
authorGlenn L McGrath <bug1@ihug.co.nz>2002-12-06 22:40:54 +0000
committerGlenn L McGrath <bug1@ihug.co.nz>2002-12-06 22:40:54 +0000
commit0337c467a0d141c3d1a13967fb8abe98580ef699 (patch)
tree87fd5cdae9af3e81b27d89c3d9a187ed7e33dccf /archival
parenta6b9051e16637e73ec5badc539f837d2cf46292c (diff)
downloadbusybox-w32-0337c467a0d141c3d1a13967fb8abe98580ef699.tar.gz
busybox-w32-0337c467a0d141c3d1a13967fb8abe98580ef699.tar.bz2
busybox-w32-0337c467a0d141c3d1a13967fb8abe98580ef699.zip
Add some help descriptions
Diffstat (limited to 'archival')
-rw-r--r--archival/Config.in54
1 files changed, 44 insertions, 10 deletions
diff --git a/archival/Config.in b/archival/Config.in
index 121cf0282..bbd3fa0d5 100644
--- a/archival/Config.in
+++ b/archival/Config.in
@@ -15,7 +15,13 @@ config CONFIG_AR
15 retrieve the original individual files (called archive members). 15 retrieve the original individual files (called archive members).
16 The original files' contents, mode (permissions), timestamp, owner, 16 The original files' contents, mode (permissions), timestamp, owner,
17 and group are preserved in the archive, and can be restored on 17 and group are preserved in the archive, and can be restored on
18 extraction. 18 extraction.
19 The stored filename is limited to 15 characters. (for more information
20 see long filename support).
21 ar has 60 bytes of overheads for every stored file.
22
23 This implementation of ar can extract archives, it cannot create or
24 modify them.
19 On an x86 system, the ar applet adds about XXX bytes. 25 On an x86 system, the ar applet adds about XXX bytes.
20 26
21 Unless you have a specific application which requires ar, you should 27 Unless you have a specific application which requires ar, you should
@@ -26,7 +32,10 @@ config CONFIG_FEATURE_AR_LONG_FILENAMES
26 default n 32 default n
27 depends on CONFIG_AR 33 depends on CONFIG_AR
28 help 34 help
29 Please submit a patch to add help text for this item. 35 By default the ar format can only store the first 15 characters of the
36 filename, this option removes that limitation.
37 It supports the GNU ar long filename method which moves multiple long
38 filenames into a the data section of a new ar entry.
30 39
31config CONFIG_BUNZIP2 40config CONFIG_BUNZIP2
32 bool "bunzip2" 41 bool "bunzip2"
@@ -38,8 +47,8 @@ config CONFIG_BUNZIP2
38 conventional LZ77/LZ78-based compressors, and approaches the 47 conventional LZ77/LZ78-based compressors, and approaches the
39 performance of the PPM family of statistical compressors. 48 performance of the PPM family of statistical compressors.
40 49
41 The BusyBox bunzip2 applet is limited to de-compression only. On an 50 The BusyBox bunzip2 applet is limited to de-compression only.
42 x86 system, this applet adds about XXX bytes. 51 On an x86 system, this applet adds about XXX bytes.
43 52
44 Unless you have a specific application which requires bunzip2, you 53 Unless you have a specific application which requires bunzip2, you
45 should probably say N here. 54 should probably say N here.
@@ -48,40 +57,64 @@ config CONFIG_CPIO
48 bool "cpio" 57 bool "cpio"
49 default n 58 default n
50 help 59 help
51 Please submit a patch to add help text for this item. 60 cpio is an archival utility program used to create, modify, and extract
61 contents from archives.
62 cpio has 110 bytes of overheads for every stored file.
63
64 This implementation of cpio can extract cpio archives created in the
65 "newc" or "crc" format, it cannot create or modify them.
66
67 Unless you have a specific application which requires cpio, you should
68 probably say N here.
52 69
53config CONFIG_DPKG 70config CONFIG_DPKG
54 bool "dpkg" 71 bool "dpkg"
55 default n 72 default n
56 help 73 help
57 Please submit a patch to add help text for this item. 74 dpkg is a medium-level tool to install, build, remove and manage Debian packages.
75
76 This implementation of dpkg has a number of limitations, you should use the
77 official dpkg if possible.
58 78
59config CONFIG_DPKG_DEB 79config CONFIG_DPKG_DEB
60 bool "dpkg_deb" 80 bool "dpkg_deb"
61 default n 81 default n
62 help 82 help
63 Please submit a patch to add help text for this item. 83 dpkg-deb packs, unpacks and provides information about Debian archives.
84
85 This implementation of dpkg-deb cannot pack archives.
86
87 Unless you have a specific application which requires dpkg-deb, you should
88 probably say N here.
64 89
65config CONFIG_FEATURE_DPKG_DEB_EXTRACT_ONLY 90config CONFIG_FEATURE_DPKG_DEB_EXTRACT_ONLY
66 bool " extract only (-x)" 91 bool " extract only (-x)"
67 default n 92 default n
68 depends on CONFIG_DPKG_DEB 93 depends on CONFIG_DPKG_DEB
69 help 94 help
70 Please submit a patch to add help text for this item. 95 This reduced dpkg-deb to the equivalent of "ar -p <deb> data.tar.gz | tar -zx".
96 However it saves space as none of the extra dpkg-deb, ar or tar options are
97 needed, they are linked to internally.
71 98
72config CONFIG_FEATURE_DEB_TAR_GZ 99config CONFIG_FEATURE_DEB_TAR_GZ
73 bool " gzip debian packages (normal)" 100 bool " gzip debian packages (normal)"
74 default y if CONFIG_DPKG || CONFIG_DPKG_DEB 101 default y if CONFIG_DPKG || CONFIG_DPKG_DEB
75 depends on CONFIG_DPKG || CONFIG_DPKG_DEB 102 depends on CONFIG_DPKG || CONFIG_DPKG_DEB
76 help 103 help
77 Please submit a patch to add help text for this item. 104 This is the default compression method inside the debian ar file.
105
106 If you want compatability with standard .deb's you should say yes here.
78 107
79config CONFIG_FEATURE_DEB_TAR_BZ2 108config CONFIG_FEATURE_DEB_TAR_BZ2
80 bool " bzip2 debian packages" 109 bool " bzip2 debian packages"
81 default n 110 default n
82 depends on CONFIG_DPKG || CONFIG_DPKG_DEB 111 depends on CONFIG_DPKG || CONFIG_DPKG_DEB
83 help 112 help
84 Please submit a patch to add help text for this item. 113 This allows dpkg and dpkg-deb to extract deb's that are compressed internally
114 with bzip2 instead of gzip.
115
116 You only want this is your are creating your own custom debian packages that
117 use an internal control.tar.bz2 or data.tar.bz2.
85 118
86config CONFIG_GUNZIP 119config CONFIG_GUNZIP
87 bool "gunzip" 120 bool "gunzip"
@@ -112,6 +145,7 @@ config CONFIG_TAR
112 bool "tar" 145 bool "tar"
113 default n 146 default n
114 help 147 help
148 tar has at least 512 bytes of overheads for every stored file.
115 Please submit a patch to add help text for this item. 149 Please submit a patch to add help text for this item.
116 150
117config CONFIG_FEATURE_TAR_CREATE 151config CONFIG_FEATURE_TAR_CREATE