[haiku] Re: Documenting your package

  • From: Ingo Weinhold <ingo_weinhold@xxxxxx>
  • To: haiku@xxxxxxxxxxxxx
  • Date: Mon, 04 Apr 2016 10:04:44 +0200

On 04/04/2016 01:25 AM, pete.goodeve@xxxxxxxxxxxx wrote:

On Sun, Apr 03, 2016 at 12:20:51PM +0200, Ingo Weinhold wrote:
On 04/03/2016 12:13 AM, Pete Goodeve wrote:

The 'packages' subfolder holds the most, but this seems redundant,
as by definition anything in system/documentation must have come
>from a package!

The name of the directory is inherited from the Unix (or Linux) world,
where it's usually .../share/doc/packages. It would be named the same in
a non-packaged installation location.

Eh??  Not on any Linux installation I've ever seen.  I've just checked my 
Ubuntu,
Raspbian, and my Web site ISP.  They all have the package-named directories
directly under /usr/share/doc.

Yeah, seems mostly an openSUSE thing. Anyway, that's where the name came from.

$ ssh vmrepo.haiku-os.org
bonefish@vmrepo:~> ll /usr/share/doc/packages/
total 1856
drwxr-xr-x 2 root root  4096 Apr 10  2014 a2ps
drwxr-xr-x 2 root root  4096 Nov 15 15:14 aaa_base
drwxr-xr-x 2 root root  4096 Feb  2  2014 acl
[...]

Still seems redundant (and less clear) to have an extra 'packages layer.

The point is to avoid burying type-like directories (info, man) and system documentation under a heap of packages documentation. FWIW the man package's documentation (if we provided it) would also clash with the man pages directory.

CU, Ingo


Other related posts:

  1. Home
  2. haiku
  3. Archive
  4. 04-2016