Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fix many package descriptions #3771

Merged
merged 1 commit into from
Aug 25, 2014

Conversation

bjornfor
Copy link
Contributor

(My OCD kicked in today...)

Remove repeated package names, capitalize first word, remove trailing
periods and move overlong descriptions to longDescription.

I also simplified some descriptions as well, when they were particularly
long or technical, often based on Arch Linux' package descriptions.

I've tried to stay away from generated expressions (and I think I
succeeded).

Some specifics worth mentioning:

  • cron, has "Vixie Cron" in its description. The "Vixie" part is not
    mentioned anywhere else. I kept it in a parenthesis at the end of the
    description.
  • ctags description started with "Exuberant Ctags ...", and the
    "exuberant" part is not mentioned elsewhere. Kept it in a parenthesis
    at the end of description.
  • nix has the description "The Nix Deployment System". Since that
    doesn't really say much what it is/does (especially after removing
    the package name!), I changed that to "Powerful package manager that
    makes package management reliable and reproducible" (borrowed from
    nixos.org).
  • Tons of "GNU Foo, Foo is a [the important bits]" descriptions
    is changed to just [the important bits]. If the package name doesn't
    contain GNU I don't think it's needed to say it in the description
    either.

(My OCD kicked in today...)

Remove repeated package names, capitalize first word, remove trailing
periods and move overlong descriptions to longDescription.

I also simplified some descriptions as well, when they were particularly
long or technical, often based on Arch Linux' package descriptions.

I've tried to stay away from generated expressions (and I think I
succeeded).

Some specifics worth mentioning:
 * cron, has "Vixie Cron" in its description. The "Vixie" part is not
   mentioned anywhere else. I kept it in a parenthesis at the end of the
   description.

 * ctags description started with "Exuberant Ctags ...", and the
   "exuberant" part is not mentioned elsewhere. Kept it in a parenthesis
   at the end of description.

 * nix has the description "The Nix Deployment System". Since that
   doesn't really say much what it is/does (especially after removing
   the package name!), I changed that to "Powerful package manager that
   makes package management reliable and reproducible" (borrowed from
   nixos.org).

 * Tons of "GNU Foo, Foo is a [the important bits]" descriptions
   is changed to just [the important bits]. If the package name doesn't
   contain GNU I don't think it's needed to say it in the description
   either.
domenkozar added a commit that referenced this pull request Aug 25, 2014
@domenkozar domenkozar merged commit ed463b3 into NixOS:master Aug 25, 2014
@bjornfor bjornfor deleted the fix-package-descriptions branch September 1, 2014 20:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants