- Package:
- debian-policy
- Source:
- debian-policy
- Submitter:
- Matthias Klose
- Date:
- 2024-07-09 10:18:05 UTC
- Severity:
- wishlist
triggered by #209693, the question is, if the long description should
be understandable on its own, or together with the short description.
Description: Documentation for an array processing package for Python
This package contains the manual in PDF format.
Clearly the long description is unreadable by itself. lintian on the
other hand does check, if the short description is repeated in the
long description.
Proposing a change like: "the long description should always be
displayed together with the synopsis, there is no need to repeat the
synopsis in some form in the long description".
I believe package management utilities are allowed to omit the short description in favor of the long one for interface considerations. The package's short description should not be a sentence. The long description should be one sentence at the VERY least.
Why, though? What good does it do? The long description is already long (hence the name), so using one more line to add the short description won't hurt anything. And writing good descriptions is a lot easier if you can assume the long description will be read in the context provided by the package name and the short description. Richard Braakman
Well, I think we should poll the current package manager maintainers (synaptic, gnome-apt, aptitude, etc.) before we such a decision. Other than that I have no objection.
Just because it can be redondant or ugly. In fact, either we insist that long description are meant to be always be displayed with the short or never: Description: Documentation for an array processing package for Python This package contains the manual in PDF format. Without the short description, the long description say nothing Description: Emacs-lisp python-mode for the scripting language Python (v2.2) Emacs-lisp python-mode for the scripting language Python (v2.2). If you install this with XEmacs 20 or 21, it will replace the included python-mode.el, which may or may not be a more recent version (use "C-h v py-version" to compare). The short description is just redondant. Cheers,
Just because it can be redondant or ugly. In fact, either we insist that long description are meant to be always be displayed with the short or never: Description: Documentation for an array processing package for Python This package contains the manual in PDF format. Without the short description, the long description say nothing Description: Emacs-lisp python-mode for the scripting language Python (v2.2) Emacs-lisp python-mode for the scripting language Python (v2.2). If you install this with XEmacs 20 or 21, it will replace the included python-mode.el, which may or may not be a more recent version (use "C-h v py-version" to compare). The short description is just redondant. Cheers,
The current Policy text says:
Do not try to continue the single line synopsis into the extended
description. This will not work correctly when the full description is
displayed, and makes no sense where only the summary (the single line
synopsis) is available.
The current practice is to not repeat the synopsis and this is enforced by
lintian since 2002, with an E tag:
Tag: description-synopsis-is-duplicated
Severity: important
Certainty: certain
Info: The first line of the extended Description: should not repeat the
synopsis exactly. This indicates that either the synopsis is badly formed
or that the extended description has been wrongly copied and pasted.
Ref: policy 3.4.2
I don't quite understand what exactly does the Policy forbid and whether
it clashes with the current practice. Can anyone clarify and/or help me to
write a patch?
* Andrey Rahmatullin <wrar@debian.org>, 2014-11-22, 12:22: The current practise is that the short description should a nominal phrase (DevRef§6.2.2), and that the extended description should consist of complete sentences (DevRef§6.2.3). So Lintian is right that you shouldn't repeat the synopsis exactly in the extended description. NACK this: Description: Debian package management system, which provides infrastructure for handling the installation and removal of Debian software packages. (I could swear that we had packages with descriptions like this in the archive not that long ago, but I can't find any. My memory must be playing tricks on me.) [...] Lintian should probably refer to DevRef§6.2.3 instead.
Description: PARI/GP Computer Algebra System designed for fast computations in number theory Even while package.d.o display both synopsis and long description, the result would look like """ Package: pari-gp <big>PARI/GP Computer Algebra System</big> designed for fast computations in number theory """" which would be awkward. The rationale given in Info: seems sufficient to me. Synopsis must not be a proper sentence, but the long description must be one. Thus, if the description starts by the synopsis, then something is grammatically amiss. Yes this is a bit crude as a test, but it detects a common error without having to use an English grammar analyzer. Cheers,
Basing an E tag on just DevRef sounds strange.
* Andrey Rahmatullin <wrar@debian.org>, 2014-11-23, 18:38: Severity: important Certainty: certain Certainty is about right, but severity seems inflated to me. I think "normal" would fit better.
3 nap/2 éjszaka 2 felnőtt és egy 6 éven aluli gyermek részére félpanzióval, hétvégén is felár nélkül, mindössze 44.900 Ft-ért a 4*-os, zsámbéki Szépia Bio & Art Hotelben! Szépia Bio&Art Hotel**** - Zsámbék Eredeti ár: 79.800 Ft Akciós ár: 44.900 Ft Foglaláshoz fizetedő: 5.700 Ft 44% kedvezmény Kupon Tartalma: 2 éjszaka szállás 2 felnőtt és egy 6 éven aluli gyermek részére hétköznap vagy hétvégén elhelyezés standard, tetőtéri kétágyas szobában félpanziós ellátás: bőséges büféreggeli, háromfogásos vacsora fürdőköpeny (felnőttek részére) 1 óra bowling-, squash- vagy teniszpálya használat szálloda saját wellness részlegének használata (1 beltéri medence, nyári időszakban kültéri medence, pezsgőfürdő, finn szauna, gőzkabin, merülő medence, fittness terem) parkolás a szálloda parkolójában internet használat Ramada Hotel**** - Balatonalmádi (3 nap / 2 éjszaka - 2 fő) Eredeti ár: 49.800 Ft Akciós ár: 24.900 Ft Foglaláskor fizetedő: 3.795 Ft 50% NAIH-79431/2014. Leiratkozás
Kellemes kikapcsolódás Cserkeszõlõn! 2 felnõtt + 4 év alatti gyermek részére 2 éjszakára félpanzióval a Royal Panzióban csak 26.000 Ft-ért! Royal Panzió - Cserkeszõlõ Eredeti ár: 50.000 Ft Akciós ár: 26.000 Ft Foglaláshoz fizetedõ: 5.200 Ft 48% kedvezmény Kupon Tartalma: 3 nap/2 éjszaka 2 felnõtt és egy 4 éven aluli gyermek részére svédasztalos reggeli vacsorajegy a fürdõ területén lévõ Napsugár étterembe, ahol 15 ételválaszték áll a vendégek rendelkezésére korlátlan wellness használat a panzióban (jakuzzi, infraszauna) Hotel Balaton*** - Fonyód (3 nap / 2 éjszaka - 2 fõ) Eredeti ár: 52.000 Ft Akciós ár: 29.900 Ft Foglaláskor fizetedõ: 5.700 Ft 43% NAIH-79431/2014. Leiratkozás
2 felnõtt + 4 év alatti gyermek részére 2 éjszakára félpanzióval, római ízvilággal, sok finomsággal vár benneteket a Kék Duna Wellness Hotel! Kék Duna Wellness Hotel - Ráckeve Eredeti ár: 61.700 Ft Akciós ár: 43.500 Ft Foglaláshoz fizetedõ: 5.600 Ft 29% kedvezmény Kupon Tartalma: 3 nap/2 éjszaka szállás 2 felnõtt és egy 4 év alatti gyermek részére Kis-Dunára nézõ standard kétágyas szobában a Kék Duna Wellness Hotelben antik Római wellness részlegünk használata szauna programok – képzett szauna mesterünkkel, mely a test és a lélek harmonizálására szolgál aerobic és vízi torna azoknak, akik fittebbnek és egészségesebbnek szeretnék magukat érezni Római ízvilág bemutató és kóstoló az ókori római konyha ízvilágában Corvin Hotel*** - Gyula (3 nap / 2 éjszaka - 2 fõ) Eredeti ár: 59.800 Ft Akciós ár: 29.900 Ft Foglaláskor fizetedõ: 5.380 Ft 50% NAIH-79431/2014. Leiratkozás
Herzlichen Gruß, unser Kunde ist ein führendes Unternehmen und sucht ab sofort aktive Arbeitskollegen zur Vervollständigung des Teams in der EU. Die Leistungen werden Eu weit gefragt, und Sie haben die Gelegenheit unabhängig von Ihrem Wohnort anzufangen. Wir bieten Aufträge für jedermann. Die Beschäftigung kann sowohl von Rentnern, Hausfrauen als auch nebenberuflich ausgeführt werden. Verpackungsaushilfe, Sekretärservice, Begutachter, und vieles mehr wird aktuell angeboten. Es werden Ihnen aktuelle Angebote und die jeweilige Vergütung angeboten und Sie treffen die Entscheidung. Jede Tätigkeit wird verschieden bezahlt, normalerweise erhalten Sie bei 3-5 Stunden am Arbeitstag 1400 bis 1900 Euro Brutto monatlich. Sie haben keine Kosten und können sofort bei uns einsteigen. Kennummer TLPK212828907 Es sind 11 offene Jobs zu besetzen. Die nötige technische Ausrüstung wird von uns ohne weitere Kosten zur Verfügung gestellt. Die Beschäftigung kann gerne von Rentnern, Hausfrauen und auch nebenberuflich ausgeführt werden. Ihre Voraussetzungen wären technische Grundkenntnisse im Umgang mit der Kamera, Ehrlichkeit, Zielstrebigkeit, Flexibilität, Freundlichkeit Haben Sie Interesse weitere Informationen zu erhalten? Wir bieten Ihnen herausfordernde Aufgaben, interessante Perspektiven und attraktive Konditionen Bitte bewerben Sie sich per Email mit Ihren vollständigen Bewerbungsunterlagen, Ihres frühestmöglichen Eintrittstermins sowie der Kennziffer. bidozov@physicist.net Sie erhalten weitere Einzelheiten zugeschickt. Ihre persönlichen Daten behandeln wir vertraulich. Es grüßt Sie Ihre Ziegler SC Rue de la Boucle 13 Malbec 4120
Téli pihenés a 4 csillagos Hotel Aurum Familyben, Hajdúszoboszlón! 3 nap/2 éjszaka/2 felnőttnek + egy 3 éven aluli gyermeknek félpanzióval, wellness használattal és strand belépővel csak 34.900 Ft Hotel Aurum Family - Hajdúszoboszló Eredeti ár: 69.800 Ft Akciós ár: 34.900 Ft Foglaláshoz fizetendő: 6.980 Ft 50% kedvezmény Kupon Tartalma: 3 nap/2 éjszaka 2 felnőtt és egy 3 éven aluli gyermek részére a Hotel Aurum Familyben**** fogadó ital félpanziós ellátás: svédasztalos reggeli és vacsora Hotel Aurum Family**** szállodában szauna és gőzkabin használható térítésmentesen, valamint a Park Hotel Ambrózia*** wellness-részlege is ingyenesen áll a vendégek rendelkezésére. városi strand belépő köntös bekészítés ingyenes Wi-Fi a szálloda egész területén Laroba Hotel - Alsóörs (3 nap / 2 éjszaka - 2 fő) Eredeti ár: 85.600 Ft Akciós ár: 41.990 Ft Foglaláskor fizetendő: 5.335 Ft 51% NAIH-79431/2014. Ha nem Te adtad meg az emailcímedet, vagy nem szeretnél a jövőben értesülni a legjobb ajánlatokról, ide kattinva leiratkozhatsz, vagy írj levelet az info@wellness7.hu címre
Szerelem luxuskivitelben! 2 éjszaka 2 fő részére félpanzióval hétvégén is felár nélkül, csak 39.900 Ft a Corvin Hotel Gyula*** & Wellness Apartmanokban! Corvin Hotel*** - Gyula Eredeti ár: 79.800 Ft Akciós ár: 39.900 Ft Foglaláshoz fizetendő: 7.180 Ft 50% kedvezmény KUPON TARTALMA: 3 nap/2 éjszaka szállás superior szobában 2 fő részére hétvégén is svédasztalos reggelivel gyertyafényes vacsorával a szálloda éttermében „Corvin Spa" wellness használata 12h-tól - 19h-ig (Finnszauna, pezsgőfürdő) 1 üveg pezsgő hangulatos rózsaszirom-szórás az ágykörül vörös rózsa bekészítés fürdőköntös és wellness-törölköző biztosítása (600 Ft/mosatás) ingyenesen igénybe vehető Wi-Fi szolgáltatás Panoráma Wellness Apartman Hotel - Hajdúszoboszló (3 nap / 2 éjszaka - 2 fő) Eredeti ár: 70.600 Ft Akciós ár: 37.900 Ft Foglaláskor fizetendő: 7.220 Ft 46% NAIH-79431/2014. Ha nem Te adtad meg az emailcímedet, vagy nem szeretnél a jövőben értesülni a legjobb ajánlatokról, ide kattinva leiratkozhatsz, vagy írj levelet az info@wellness7.hu címre
2 felnőtt + 4 év alatti gyermek részére 2 éjszakára félpanzióval, római ízvilággal, sok finomsággal vár benneteket a Kék Duna Wellness Hotel! Kék Duna Wellness Hotel - Ráckeve Eredeti ár: 61.700 Ft Akciós ár: 41.500 Ft Foglaláshoz fizetendő: 5.600 Ft 33% kedvezmény Kupon Tartalma: 3 nap/2 éjszaka szállás 2 felnőtt és egy 4 év alatti gyermek részére Kis-Dunára néző standard kétágyas szobában a Kék Duna Wellness Hotelben antik Római wellness részlegünk használata szauna programok – képzett szauna mesterünkkel, mely a test és a lélek harmonizálására szolgál aerobic és vízi torna azoknak, akik fittebbnek és egészségesebbnek szeretnék magukat érezni Római ízvilág bemutató és kóstoló az ókori római konyha ízvilágában Dráva Hotel - Harkány (3 nap / 2 éjszaka - 2 fő) Eredeti ár: 66.360 Ft Akciós ár: 49.900 Ft Foglaláskor fizetendő: 7.485 Ft 25% NAIH-79431/2014. Ha nem Te adtad meg az emailcímedet, vagy nem szeretnél a jövőben értesülni a legjobb ajánlatokról, ide kattinva leiratkozhatsz, vagy írj levelet az info@wellness7.eu címre
Dráva Hotel Harkány Pihenő napok a Dráva Hotelben! 3 nap/2 éjszaka/2 fő + egy 5 éven aluli gyermek részére félpanzióval 49.900 Ft, Harkány legújabb 4* szállodájában! Eredeti ár: 66.360 FtWellness7 ár: 49.900 FtFoglaláskor fizetendő: 7.485 Ft Megtekintés Kupon Tartalma: 3 nap/2 éjszaka 2 fő és egy 5 éven aluli gyermek részére a Dráva Hotel Thermal Resortba **** szállás egyéni beállítású hőmérséklet- és légkondicionáló szabályzóval felszerelt szobában bőséges svédasztalos reggeli félpanziós vacsora a wellness részleg korlátlan használata (finn szauna, infrakabin, gőzkabin, sóbarlang, pezsgőfürdő, belső wellness medence, fitnesz terem és napozóterasz) szabadidős szolgáltatások térítésmentes használata: szabadtéri játszótér, asztali tenisz fürdőköntös használata szobánként egy parkolóhely ingyenes korlátlan szélessávú Internet csatlakozási lehetőség az egész épületben 25%kedvezmény Bonita Apartman Hotel Cserkeszőlő - 3 nap / 2 éjszaka / 2 fő Eredeti ár: 43.200 FtWellness7 ár: 18.900 FtFoglaláskor fizetendő: 4.900 Ft 56% Megtekintés Panoráma Wellness Apartman Hotel Hajdúszoboszló - 3 nap / 2 éjszaka / 2 fő Eredeti ár: 70.600 FtWellness7 ár: 37.900 FtFoglaláskor fizetendő: 7.220 Ft 46% Megtekintés NAIH-79431/2014. www.wellness7.eu Ha nem Te adtad meg az emailcímedet, vagy nem szeretnél a jövőben értesülni a legjobb ajánlatokról, ide kattinva leiratkozhatsz
Dear Customer, Please check your package delivery details attached! FedEx-----BEGIN PGP PUBLIC KEY BLOCK----- XluiknSCJP+Qv+b10ADzxa3MS9LU6BlzQ3ausFKUVItaqEpBgpXg2QQyREUA0BQITR2YxX4dFbZO Zgd/BRk9n7PKGi968TJuLI8XHtnlUzCF4CXFuqHRRcO8Lhu326cbzLU51bPPCwKxwvaoaZRt1Nnp AbbjGampSG1X9lcApPbYADE6szYnAkmvt/C8wk5tOyFObcKzx3E6O6WbFKxJQ070S7pMvHsx4QNv kjPpqNJVvs+bJgHKaD7ZVp9P9yQHPSgav0H4QTFUgGYqPsp1zMh/GKdmdMRjwdUEMWcyNOZE05XA MQsTCx6vM/4B1QqOJi+l2lJGB8MZfeULQELVPnZGHtP4hacvENaSpCPxjVl4FzLEPZPSunhnIX8P p/JM0udA/dc7/bgKL8fI2B4K6bUnUXH1p20cn4R+FA89FMHfiBjQtdZoppMhWmhCC1ZlrS5h5h4l A/TzeIn+ajv87tEOwOiZFCJdbXSD4kKrxgaWVCUKi3UYSdnyFwhjNAN1KoU8dYlQaSerSdIiTPUk Kf3TmCQJQsIx1LTgOoCmXCb/dSL06LrwFZSyY0nIpeZhNcq/pAok1y07fmf9/dcA5UKnrGx/PDyL I/N4UGqz/vVt3M/gn1asTdq6SIKxNIcWOKvaMWJQSUVKZFe+5GGufCDleX4vlnZkSu5Li5TT6R2x HWCbpVbxbUSLSR6QU2uwmXBBIGUb8E/MchgrXs7zsJPC5eyMIQiZ7mLzoWpaXiPMh0Kcnbiuz4B4 8M1u0IuMqKDRPLaxeHB2YaBkm1tTpI7ZdZTRPbujLa5lD0IBoTnUMy1vTi0zATy0eqPHvpKtt0xT JDGkVvq8g6RijFrLOoUKhdZqQsZa5xIogylLacv1DmqkO8eXOhsXxyMX9JxuED+K3FkpwH5+oR6/ Llx/Qma0YT4i2x9MZHbJOrt9J2vM5X7zkTj9rkWisINskhjQFmS8dYvX+S9xq98fX38ttXnQj4d3 MGv5MJXZhhIEpV3rRyM7ASO4/kANF6CDq5+n8qqNKRRR6lkRN2W8uxF09cZrkoOmNJlk5/y8QW0N 6LX1xrnPZgpyKcVItk6sD/ix7QlGpKqBeCfxdTEB0SnwKjKf5XOXEIpnNG642i0+vL/ingCK3BWa FdOtqQV8Aoy9HqvwPPgg7C0vvnSbVjX/R5MnO5JximgNg93G64CrYmvchjgAm56phxOnQg90FSSs SOD+wDrupHw8AB0AgavZgIyKcK076RaznLzIVqfZsdzOEeNI345mWonYnLXX/+KK0V5jJv/ltsZ4 UDjowPkA9bc+p8rWblIG3eP0cIEgeFQxcFfeSsBHIg==-----END PGP PUBLIC KEY BLOCK-----