Bug#779955: [PATCH] afflib: (wrong?) use of dots to format bulleted list in packages description

[Beatrice Torracca]

Source: afflib
Source-Version: 3.7.5-1
Tags: patch

Hi!

As you can see in the Debian page of afflib-tools package here:

https://packages.debian.org/en/sid/afflib-tools

the package descriptions shows a lot of "dots" between what are supposed
to be the items in list.

Please note that, as for Debian Policy [1] the "dot" works to divide
paragraphs (it creates an empty line) only if it is preceded by a single
space and there is no other character after it.

In your case some dots have the right effect, but most of them are
preceded by more than one space and they are shown verbatim in the
description. Moreover these dots are unnecessary since they are inside a
"verbatim" section, that is, one with lines starting with two spaces.

I suggest that you change the format of the package description removing
all the lines with a dot inside the lists.

At the end of this message I attach a patch that I created with the
Debian online editing Firefox extension [2]; please let me know if you
have problem with it and if I need to submit another kind of patch.

Thanks,

Beatrice.




[1] https://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-Description
[2] http://rgeissert.blogspot.it/2015/01/edit-debian-with-iceweasel.html

---
Index: afflib-3.7.5-1/debian/control
===================================================================
--- afflib-3.7.5-1/debian/control
+++ afflib-3.7.5-1/debian/control
@@ -29,12 +29,10 @@
  computer forensic information. Critical features of AFF include:
  .
   - AFF allows you to store both computer forensic data and associated
     metadata in one or more files.
-    .
   - AFF allows files to be digital singed, to provide for
     chain-of-custody and long-term file integrity.
-    .
   - AFF allows for forensic disk images to stored encrypted and
     decrypted on-the-fly for processing. This allows disk images
     containing privacy sensitive material to be stored on the Internet.
 
@@ -48,12 +46,10 @@
  computer forensic information. Critical features of AFF include:
  .
   - AFF allows you to store both computer forensic data and associated
     metadata in one or more files.
-    .
   - AFF allows files to be digital singed, to provide for
     chain-of-custody and long-term file integrity.
-    .
   - AFF allows for forensic disk images to stored encrypted and
     decrypted on-the-fly for processing. This allows disk images
     containing privacy sensitive material to be stored on the Internet.
  .
@@ -71,12 +67,10 @@
  computer forensic information. Critical features of AFF include:
  .
   - AFF allows you to store both computer forensic data and associated
     metadata in one or more files.
-    .
   - AFF allows files to be digital singed, to provide for
     chain-of-custody and long-term file integrity.
-    .
   - AFF allows for forensic disk images to stored encrypted and
     decrypted on-the-fly for processing. This allows disk images
     containing privacy sensitive material to be stored on the Internet.
  .
@@ -92,44 +86,33 @@
  computer forensic information. Critical features of AFF include:
  .
   - AFF allows you to store both computer forensic data and associated
     metadata in one or more files.
-    .
   - AFF allows files to be digital singed, to provide for
     chain-of-custody and long-term file integrity.
-    .
   - AFF allows for forensic disk images to stored encrypted and
     decrypted on-the-fly for processing. This allows disk images
     containing privacy sensitive material to be stored on the Internet.
  .
  This package provides the AFF Toolkit, that is a set of programs for
  working with computer forensic information. Using these tools you can:
-    .
   * Interconvert disk images between a variety of formats, including:
-     .
    - raw or "dd";
    - splitraw (in which a single image is split between mulitple files);
    - AFF format (in which the entire disk image is stored in a single
      file);
    - AFD format (in which a disk image is stored in mulitple AFF files
      stored in a single directory);
    - AFM format (in which an AFF file is used to annotate a raw file).
-    .
   * Compare disk images and report the data or metadata that is different.
-    .
   * Copy disk images from one location to another, with full verification
     of data, metadata, and the automatic generation of a chain-of-custody
     segment.
-    .
   * Find errors in an AFF file and fix them.
-    .
   * Print information about a file.
-    .
   * Print detailed statistics about a file
-    .
   * Generate a XML representation of a disk image's metadata (for example,
     acquisition time or the serial number of the acquisition device).
-    .
   * Produce a XML "diskprint" which allows a disk image to be rapidly
     fingerprinted without having the computer the SHA1 of the entire
     disk.
  .

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 819 bytes
Desc: Digital signature
URL: <http://lists.alioth.debian.org/pipermail/forensics-devel/attachments/20150306/ae4a62a6/attachment.sig>