[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#967428: marked as done (debian-policy: Abstract of Debian Manifesto (doc ID debian-manifesto) should not use verbatim)



Your message dated Mon, 17 Aug 2020 00:32:54 +1000
with message-id <3278678.AD7qlikOqo@simurgh>
and subject line Re: Bug#967428: debian-policy: Abstract of Debian Manifesto (doc ID debian-manifesto) should not use verbatim
has caused the Debian Bug report #967428,
regarding debian-policy: Abstract of Debian Manifesto (doc ID debian-manifesto) should not use verbatim
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact owner@bugs.debian.org
immediately.)


-- 
967428: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=967428
Debian Bug Tracking System
Contact owner@bugs.debian.org with problems
--- Begin Message ---
Package: debian-policy
Version: 4.3.0.3
Severity: minor
Tags: patch

Dear Maintainer,

the abstract of the Debian Manifest (document ID debian-manifesto, installed as
file /usr/share/doc-base/debian-manifesto) is written in all verbatim format
(except for the initial line), which to me, judging from its content, appears
to have happened by mistake. I hence modestly suggest to change the
continuation lines its value consists of from verbatim into regular format, by
merely reducing the number of leading spaces from two to only a single one per
line.

For my amusement, I applied this change to my live system (with version 4.3.0.3
of debian-policy installed), deleted and rebuilt the online documentation
(install-docs invoked with the -R, and subsequently -I option), and got quite
satisfied with the result shown by dwww afterwards. The rest of this message
records the change I applied to file /usr/share/doc-base/debian-manifesto.


*** debian-manifesto.diff
5,8c5,8
<   outlines his view for a brand new Linux distribution which would be
developed
<   openly, describes why the world needed this distribution and which problems
<   would the distribution solved. This document is provided in order to
document
<   Debian's history.
---
>  outlines his view for a brand new Linux distribution which would be
developed
>  openly, describes why the world needed this distribution and which problems
>  would the distribution solved. This document is provided in order to
document
>  Debian's history.



-- System Information:
Debian Release: 10.4
  APT prefers stable-updates
  APT policy: (500, 'stable-updates'), (500, 'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 4.19.0-9-amd64 (SMP w/4 CPU cores)
Locale: LANG=de_DE.UTF-8, LC_CTYPE=de_DE.UTF-8 (charmap=UTF-8), LANGUAGE=de_DE.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

debian-policy depends on no packages.

Versions of packages debian-policy recommends:
ii  libjs-sphinxdoc  1.8.4-1

Versions of packages debian-policy suggests:
ii  doc-base  0.10.8

-- no debconf information
5,8c5,8
<   outlines his view for a brand new Linux distribution which would be developed
<   openly, describes why the world needed this distribution and which problems
<   would the distribution solved. This document is provided in order to document
<   Debian's history.
---
>  outlines his view for a brand new Linux distribution which would be developed
>  openly, describes why the world needed this distribution and which problems
>  would the distribution solved. This document is provided in order to document
>  Debian's history.

--- End Message ---
--- Begin Message ---
Hi Peter

The file format used by the doc-base index is not markdown and a single space 
indent is not a verbatim formatting mark. The file format used is the same as 
many packaging-related files in Debian and is known as "Deb822"; it is a Debian 
variant of the format described in RFC822 for email headers.

The Abstract entry you are looking at is a 'folded' field as described by 
deb822(5):

https://manpages.debian.org/buster/dpkg-dev/deb822.5.en.html

regards
Stuart

-- 
Stuart Prescott    http://www.nanonanonano.net/   stuart@nanonanonano.net
Debian Developer   http://www.debian.org/         stuart@debian.org
GPG fingerprint    90E2 D2C1 AD14 6A1B 7EBB 891D BBC1 7EBB 1396 F2F7

--- End Message ---

Reply to: