diff options
author | Glenn L McGrath <bug1@ihug.co.nz> | 2002-12-06 22:40:54 +0000 |
---|---|---|
committer | Glenn L McGrath <bug1@ihug.co.nz> | 2002-12-06 22:40:54 +0000 |
commit | 0337c467a0d141c3d1a13967fb8abe98580ef699 (patch) | |
tree | 87fd5cdae9af3e81b27d89c3d9a187ed7e33dccf /archival | |
parent | a6b9051e16637e73ec5badc539f837d2cf46292c (diff) | |
download | busybox-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.in | 54 |
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 | ||
31 | config CONFIG_BUNZIP2 | 40 | config 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 | ||
53 | config CONFIG_DPKG | 70 | config 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 | ||
59 | config CONFIG_DPKG_DEB | 79 | config 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 | ||
65 | config CONFIG_FEATURE_DPKG_DEB_EXTRACT_ONLY | 90 | config 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 | ||
72 | config CONFIG_FEATURE_DEB_TAR_GZ | 99 | config 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 | ||
79 | config CONFIG_FEATURE_DEB_TAR_BZ2 | 108 | config 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 | ||
86 | config CONFIG_GUNZIP | 119 | config 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 | ||
117 | config CONFIG_FEATURE_TAR_CREATE | 151 | config CONFIG_FEATURE_TAR_CREATE |