Re: Bug#428195: krb5: [debconf_rewrite] Debconf templates review
On (11/06/07 09:11), Russ Allbery wrote:
> Reading them all over instead of reading the diff turned up one more
> clarification. My apologies for not catching this the first time.
>
> (Was the conclusion to use single quotes? I should probably join
> debian-l10n-english in my copious free time.)
There was no conclusion. If someone wanted to make a statement that only
one should be used and pick one then we could follow it, but maybe we
should stick with a more organic approach, where we just use whatever
comes out at the end of the maintainer->reviewers->maintainer interaction.
You would be very welcome to join in with the list. Now we have got
going it seems to be clear that English as a first language is far from
necessary. Christian does large parts of the rewrites himself, and
Justin and MJ do a good job of picking up on the language issues.
> > Template: krb5-admin-server/newrealm
> > Type: note
> Oh, and while we're reviewing this -- is this note debconf note abuse? I
> didn't remove it the last time I changed the templates, but I wasn't
> sure.
Well, Christian is the one to ask, but I believe it might be.
> krb524d is a daemon that converts Kerberos V5 tickets into Kerberos V4
> tickets for the krb524init program and other programs that obtain
> Kerberos V4 tickets for compatibility with old applications.
>
> I don't want to give the impression that krb524d is only used if you're
> running krb524init, since the latter is not one of the more common ways of
> getting Kerberos V4 tickets. Most users actually use krb524d because of
> old versions of aklog, although the version in Debian hasn't required this
> for quite some time. The Red Hat Kerberos PAM module is another likely
> use.
>
Your new wording is fine. However can I suggest
krb524d is a daemon that converts Kerberos V5 tickets into Kerberos V4
tickets for programs, such as krb524init, that obtain Kerberos V4 tickets
for compatibility with old applications.
I hope this reads a little better, while not suggesting that krb524init
is the only user.
> Also, I'm not sure what standard you've been following for this with other
> templates, but I've always been taught it's conventional to keep Unix
> program names in lowercase at the start of a sentence, since the case
> difference implies a different program.
That seems like a good convention to me, and one that I use. However it
does push technical writing conventions up against those of more
traditional writing. Much like the "V5" vs. "v5" issue, which I did not
speak up on before, but I would like to put a vote in for the latter if
it is not too late.
Thanks,
James
--
James Westby -- GPG Key ID: B577FE13 -- http://jameswestby.net/
seccure key - (3+)k7|M*edCX/.A:n*N!>|&7U.L#9E)Tu)T0>AM - secp256r1/nistp256
Reply to: