Gentoo Archives: gentoo-dev

From: Pacho Ramos <pacho@g.o>
To: gentoo-dev@l.g.o
Subject: Re: [gentoo-dev] About DESCRIPTION in ebuilds needing to end with a dot "."
Date: Sat, 20 Oct 2012 06:10:16
Message-Id: 1350713353.12879.57.camel@belkin4
In Reply to: Re: [gentoo-dev] About DESCRIPTION in ebuilds needing to end with a dot "." by "Michał Górny"
1 El vie, 19-10-2012 a las 22:37 +0200, Michał Górny escribió:
2 > On Fri, 19 Oct 2012 21:01:57 +0200
3 > Pacho Ramos <pacho@g.o> wrote:
4 >
5 > > At least in spanish, it's mandatory to end phrases with a dot ".", would
6 > > you agree with trying to enforce this trivial change with a repoman
7 > > warning?
8 >
9 > In my opinion, descriptions should not be sentences. Sentences
10 > in English not only need to end with a dot but also require a subject
11 > and a predicate. That makes them unnecessarily long, filled with
12 > useless information like repeated package name and obvious 'is',
13 > at least.
14 >
15 > So, rephrasing the example Alexandre pasted, consider:
16 >
17 > x11-libs/qt-core - The Qt toolkit is a comprehensive C++ application
18 > development framework.
19 >
20 > vs.
21 >
22 > x11-libs/qt-core - A comprehensive C++ application development framework
23 >
24 > Which one is better, in your opinion?
25 >
26
27 Well, I my case I would prefer second sentence... but it would still end
28 with a dot. But if it sounds rare for you, no problem.

Attachments

File name MIME type
signature.asc application/pgp-signature

Replies

Subject Author
Re: [gentoo-dev] About DESCRIPTION in ebuilds needing to end with a dot "." Peter Stuge <peter@×××××.se>