On 2013/03/25 16:19, Christian Weisgerber wrote:
> James Turner <[email protected]> wrote:
> 
> > Description:
> > se is a screen oriented version of the classic UNIX text editor ed. se
> > has a long history dating back to the early 1980s. Beginning in 2013,
> > Thomas Cort undertook the task of modernizing the early code and build
> > system to get the software working on recent POSIX operating systems.
> > 
> > The code base was straight forward and only used facilities available 25
> > years prior, and as a result, with a few modifications, it runs on many
> > modern operating systems. Thomas' primary motivation is to preserve this
> > bit of computing history. His goals are to squash any remaining bugs and
> > make se as portable as possible. No major new features will be added.
> 
> I know we all just copy and paste this stuff, but try to see it
> from the user's perspective.  What do I want to know?  What is this
> package, what can it be used for.  I do not care about the history,
> other operating systems, or the author's love for kittens.  All but
> the first line of that description is useless fluff and can be
> removed.

A short description of what "a screen oriented version of(...)ed"
actually does might be handy. Isn't that what vi is? How does this differ?

My usual method for DESCR is to copy/paste, then read through, remove
junk, rewrite sections where they don't make sense or aren't written in
fluent language, and re-flow so they look nice (usually starting with
fmt and par, picking the nicest, then tweaking where it looks raggedy)..

Reply via email to