Package: brandy
Version: 1.20~pre5-3
Severity: normal
Tags: patch

There are some mistakes in the man page brandy(1) (which is from
Debian, not upstream):

1. You talk about “BASIC V” as distinct from “BBC BASIC”, but “BASIC
   V” is simply version 5 of BBC BASIC.

I suggest you rewrite the first two paragraphs as follows:

       Brandy is an interpreter for BBC BASIC V, the dialect of BASIC
       that Acorn Computers supplied with their ranges of ARM-based
       desktop computers such as the Archimedes and Risc PC, and is
       still in use on these and compatibles.

       BASIC V is a much-extended compared to versions I-IV, which
       were used on Acorn's 6502-based BBC Micro family.

I have improved the general accuracy of the paragraphs as well (for
example, the reference to the “early 1980s” was wrong: new BBC Micro
models were introduced in the mid-late 80s, and the machines were on
sale until the 90s).

Brandy’s home page these days appears to be

http://jaguar.orpheusweb.co.uk/branpage.html

though you should also list the SourceForge URL

http://sourceforge.net/projects/brandy/

as that is the only source of later versions. (But equally, it does
not link to the home page.)

The section on reporting bugs should probably suggest reporting bugs
to SourceForge (or c.s.a.programmer), as I don’t know if Dave’s email
address is still correct, or even if he’s still maintaining Brandy.

The Copyright section should update the copyright years to 2000-2009
(the date of release of 1.20pre5).

In SEE ALSO, remove “(use zless to view it)”, as there are many ways
to read system documentation on Debian, and an individual man page is
not the place to try to tell users how. (Users with doc-central, for
example, may use a web browser; Emacs users may simply view it in
Emacs; users who don’t know can find out from the Debian
documentation, and are unlikely to be reading the brandy man page in
the first place!).

-- System Information:
Debian Release: squeeze/sid
  APT prefers maverick-updates
  APT policy: (500, 'maverick-updates'), (500, 'maverick-security'), (500, 
'maverick-backports'), (500, 'maverick')
Architecture: i386 (i686)

Kernel: Linux 2.6.35-25-generic (SMP w/2 CPU cores)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages brandy depends on:
ii  libc6                 2.12.1-0ubuntu10.2 Embedded GNU C Library: Shared lib
ii  libsdl1.2debian       1.2.14-6ubuntu3    Simple DirectMedia Layer

brandy recommends no packages.

brandy suggests no packages.

-- no debconf information



-- 
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org

Reply via email to