Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 4 Sep 2012 15:03:33 +0200
From:      Carlo Strub <cs@FreeBSD.org>
To:        danfe@FreeBSD.org,
Cc:        svn-ports-head@freebsd.org, knu@iDaemons.org, svn-ports-all@freebsd.org, ports-committers@freebsd.org
Subject:   Re: svn commit: r303589 - head/devel/rubygem-locale  [ID#2012090409000358]
Message-ID:  <1346763813.599803.71313393.51072.2@c-st.net>
In-Reply-To: <20120904072156.GA67866@FreeBSD.org>
References:  <20120904072156.GA67866@FreeBSD.org><201209030527.q835RI0O025589@svn.freebsd.org> <20120903055925.GA38769@FreeBSD.org> <86txvfvbgt.knu@iDaemons.org>

next in thread | previous in thread | raw e-mail | index | archive | help
09/04/2012 09:25 - Alexey Dokuchaev wrote:

> On Mon, Sep 03, 2012 at 03:58:58PM +0900, Akinori MUSHA wrote:
> > At Mon, 3 Sep 2012 05:59:25 +0000,
> > Alexey Dokuchaev wrote:
> > > You should have not replaced space after WWW: with tab; also, we do n=
ot
> > > normally list Author(s) unless proper attribution cannot be given in =
any
> > > other way (read: no WWW page).
> >=20
> > Heh, I've created and maintained hundreds of ports this way since the
> > last century without a single moment I'm blamed for that.
>=20
> Well, no one is blaming here, for starters, and formatting is not the most
> important issue, most people would not even care enough to pay attention.
>=20
> > It's OK for me to abandon my way of respecting original authors and
> > stop the use of tabs if need be, but I just wonder what your argument
> > is based on and what the problem is.
>=20
> There had been several attempts to clean up port descriptions in the past
> few years, and lately thanks for cs@ who started to clean up COMMENT shit,
> and other people who started to format WWW: page more consistently, not to
> forget large shaving off old-style attribution few months ago (I forgot w=
ho
> exactly did that).  Basically, in the old days port descriptions were a l=
ot
> more inconsistent and untidy.  I think we need to improve here and, given
> positive momentum, it's about time, hence my email.
>=20
> ./danfe
>=20


Danfe is right, there have been several attempts to clean up ports on the "=
cosmetic" side and we are not yet done with all the plans we have in our mi=
nds. Regarding COMMENTS, most if not all typos have been fixed but there is=
 one big issue left (removing A/An) which I will postpone to the time after=
 the release/freeze. More importantly, I have updated the Porter's Handbook=
 with more precise advise on formatting COMMENTS.

Regarding pkg-descr we are far from anywhere yet. For example, there needs =
to be a discussion on the length of the lines etc. All this will go into th=
e Porter's Handbook as well. Regarding the space after WWW and mentioning t=
he author, I think it is fair to say, however, that there is a broad consen=
sus on how to do that. If it makes you happy, I can clarify these two point=
s in the PHB right now. Otherwise it will flow in later together with all t=
he other formatting requirements.

Carlo



--
Carlo Strub
Ports committer
--=



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?1346763813.599803.71313393.51072.2>