Gentoo Archives: gentoo-dev

From: Dan Douglas <ormaaj@×××××.com>
To: gentoo-dev@l.g.o
Subject: Re: [gentoo-dev] readme.gentoo.eclass: Add a DISABLE_AUTOFORMATTING variable
Date: Thu, 31 Jan 2013 15:22:26
Message-Id: 2397459.bCZm6DZF3s@smorgbox
In Reply to: [gentoo-dev] readme.gentoo.eclass: Add a DISABLE_AUTOFORMATTING variable by Pacho Ramos
1 On Sunday, January 27, 2013 03:00:21 PM Pacho Ramos wrote:
2 > Currently, when people uses DOC_CONTENTS variable to place their desired
3 > messages, they are automatically reformatted by "fmt" to get proper
4 > messages (for example, splitting long lines).
5 >
6 > But, in some cases, may be useful to disable this behavior and respect
7 > strictly how DOC_CONTENTS was formatted, for example in that kind of
8 > messages telling people to run a command and, then, requiring a new line
9 > to be used. This can also be useful to append extra information to
10 > DOC_CONTENTS when, for example, additional info is needed when enabling
11 > a USE flag.
12 >
13
14 Why does this eclass even exist? Everything that it does can be done directly
15 in an ebuild in a couple lines of code, except in a much less ugly manner. It
16 doesn't help to generalize anything. If you want to copy a file and call dodoc
17 then just do it, don't write a pointless wrapper that people then have to go
18 and look up what it does in order to read your ebuilds. The only thing I see
19 that's maybe useful is saving on the logic for checking REPLACING_VERSIONS.
20
21 You can get rid of all that UUOC / UUOE. The set -f and eshopts stuff is
22 unnecessary. You should localize the variables that can be localized like
23 ELINE.
24
25 Funnily, looking at the implementation of elog, it appears to already mangle
26 its input by a pass of `echo -e', pointlessly reading lines and joining them
27 back together again repeatedly. This is just horrible! I don't even...
28 --
29 Dan Douglas

Attachments

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

Replies