Browse Source

man: Change debian-split member internal description to a list

This makes it easier to see what each line contains.
Guillem Jover 15 years ago
parent
commit
8bc7ba68ff
2 changed files with 20 additions and 8 deletions
  1. 2 0
      debian/changelog
  2. 18 8
      man/deb-split.5

+ 2 - 0
debian/changelog

@@ -16,6 +16,8 @@ dpkg (1.16.1) UNRELEASED; urgency=low
     fallback to use the system shell in case of error, such as with empty
     fallback to use the system shell in case of error, such as with empty
     maintainer scripts. Thanks to Jonathan Nieder <jrnieder@gmail.com>.
     maintainer scripts. Thanks to Jonathan Nieder <jrnieder@gmail.com>.
     Closes: #622094
     Closes: #622094
+  * Improve deb-split(5) format description by splitting debian-split
+    member contents into a list.
 
 
   [ Updated man page translations ]
   [ Updated man page translations ]
   * German (Helge Kreutzmann).
   * German (Helge Kreutzmann).

+ 18 - 8
man/deb-split.5

@@ -1,4 +1,4 @@
-.TH deb\-split 5 "2010-01-28" "Debian Project" "Debian"
+.TH deb\-split 5 "2011-04-15" "Debian Project" "Debian"
 .SH NAME
 .SH NAME
 deb\-split \- Debian multi-part binary package format
 deb\-split \- Debian multi-part binary package format
 .SH SYNOPSIS
 .SH SYNOPSIS
@@ -11,13 +11,23 @@ The file is an \fBar\fP archive with a magic value of \fB!<arch>\fP.
 The file names might contain a trailing slash (since dpkg 1.15.6).
 The file names might contain a trailing slash (since dpkg 1.15.6).
 .PP
 .PP
 The first member is named \fBdebian\-split\fP and contains a series
 The first member is named \fBdebian\-split\fP and contains a series
-of lines, separated by newlines. Currently seven lines are present.
-The first is the format version number, \fB2.1\fP at the time this
-manual page was written. The second is the package name. The third
-is the package version. The fourth is the md5sum of the package.
-The fifth is the total size of the package. The sixth is the maximum
-part size. The seventh is the current part number, followed by a slash
-and the total amount of parts (as in \(oq1/10\(cq).
+of lines, separated by newlines. Currently seven lines are present:
+.IP \(bu 4
+The format version number, \fB2.1\fP at the time this manual page was
+written.
+.IP \(bu
+The package name.
+.IP \(bu
+The package version.
+.IP \(bu
+The md5sum of the package.
+.IP \(bu
+The total size of the package.
+.IP \(bu
+The maximum part size.
+.IP \(bu
+The current part number, followed by a slash and the total amount of
+parts (as in \(oq1/10\(cq).
 .PP
 .PP
 Programs which read multi-part archives should be prepared for additional
 Programs which read multi-part archives should be prepared for additional
 lines to be present, and should ignore these if this is the case.
 lines to be present, and should ignore these if this is the case.