Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 21 Jun 2014 17:13:45 -0400
From:      Adam Weinberger <adamw@adamw.org>
To:        Stephen Hurd <shurd@sasktel.net>
Cc:        svn-ports-head@freebsd.org, Adam Weinberger <adamw@freebsd.org>, svn-ports-all@freebsd.org, Eitan Adler <eadler@freebsd.org>, ports-committers@freebsd.org
Subject:   Re: svn commit: r358704 - head/Mk
Message-ID:  <B0D893EA-0345-4470-89A3-66E371F1B29D@adamw.org>
In-Reply-To: <53A5EF35.3020702@sasktel.net>
References:  <201406211423.s5LENFt4010937@svn.freebsd.org> <CAF6rxgmCpgvW7w20Y7sfL5%2B2hDWU=C4OpidV0_AjzndYcBvaTA@mail.gmail.com> <3AC42E34-C633-4797-9539-D57676A19E62@adamw.org> <53A5EF35.3020702@sasktel.net>

next in thread | previous in thread | raw e-mail | index | archive | help
On 21 Jun, 2014, at 16:46, Stephen Hurd <shurd@sasktel.net> wrote:
> While it supports a great deal of output formats, it supports a very
> small number of input formats.  Of course, "PS" isn't universally
> understood anymore, some maybe "PostScript and PDF handing via
> Ghostscript" would be better... or "Use Ghostscript for PDF and =
Postscript=94.

I really like =93PostScript and PDF handling via Ghostscript.=94 It=92s =
clear, clean, and more-or-less accurate... I wouldn=92t suspect there =
are too many ports that rely on GS for its bitmap rasterization. =
(Right?)

> I'm not even sure that Ghostscript needs to be repeated in the
> description since the option name is shown.  Possibly even "for
> PostScript and PDF rasterization" would be best.
>=20
> Quite often the word following the option name on the line is the =
option
> name with different casing.

I agree with everything you just said, except I think that consistency =
is vitally important for clarity so GHOSTSCRIPT should match the way =
other descriptions are formatted.

Ideally though, descriptions should say what the OPTION will accomplish, =
as you and Eitan have pointed out. =93PS and PDF rasterization=94 tells =
me what enabling it will accomplish, and I can be confident that I can =
deselect it if I don=92t want PS and PDF rasterization support. And =
while we=92re at it, there should be a pop-up box that tells me which =
dependencies will be added by selecting this OPTION.

# Adam


--=20
Adam Weinberger
adamw@adamw.org
http://www.adamw.org





Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?B0D893EA-0345-4470-89A3-66E371F1B29D>