On 08-May-2016, Niklas Sombert wrote:
> Then I would change the description to:
> 
> Description: displays an aquarium with ASCII art

That synopsis you've written still is not a noun phrase :-)

The synopsis should be a noun phrase saying what the package *is*. A
package does not *do* anything; you're not describing a program,
you're describing a package. See the Developer's Reference §6.2.2.

Consider: The synopsis for ‘asciiquarium’ should be a good answer to
the question “What does the package ‘asciiquarium’ install?”.

The synopsis text should work correctly in a sentence of the form “The
package ‘asciiquarium’ installs {a,an,the} foo bar baz.”

>  This program simulates an aquarium with fish and various other things
>  and displays it using ASCII art on a terminal.

That looks fine as a long description.

-- 
 \      “We tend to scoff at the beliefs of the ancients. But we can't |
  `\        scoff at them personally, to their faces, and this is what |
_o__)                                         annoys me.” —Jack Handey |
Ben Finney <b...@benfinney.id.au>

Attachment: signature.asc
Description: PGP signature

Reply via email to