doc-base errors, documentation installation
Hi all!
A small question on how to configure a Debian package with proper
installation of user documentation.
The package I'm looking at is netCDF [1] which – apart from the
library and headers – installs the file
```
$ cat /usr/share/doc-base/netCDF
Document: netCDF
Title: NetCDF Manual
Author: Russ Rew, Glenn Davis, Steve Emmerson, Harvey Davies, Ed
Hartnett, Dennis Heimbigner, Ward Fisher
Abstract: This manual describes what netCDF is, and how it can be used.
Section: File Management
Format: HTML
Index: /usr/share/doc/netCDF/index.html
Files: /usr/share/doc/netCDF/*.html
```
and of course a bunch of files in
```
$ ls /usr/share/doc/netCDF/*
[...]
```
Up until now, I've always put all files of `/usr/share/doc/netCDF/*`
into libnetcdf-doc, and the file `/usr/share/doc-base/netCDF` into the
libnetcdf-dev package. With this, however, I'm getting
```
$ install-docs --verbose --check /usr/share/doc-base/netCDF
Warning in `/usr/share/doc-base/netCDF', line 1: invalid value of
`Document' field.
Warning in `/usr/share/doc-base/netCDF', line 9: file
`/usr/share/doc/netCDF/index.html' does not exist.
Error in `/usr/share/doc-base/netCDF', line 9: all `Format' sections
are invalid.
```
The second warning I understand, but I'm not sure how to best fix it.
Move `/usr/share/doc-base/netCDF` into the doc package?
The first warning and the error I don't understand.
Ideas, anyone?
Cheers,
Nico
[1] https://launchpadlibrarian.net/193981161/buildlog_ubuntu-utopic-amd64.netcdf_1%3A4.3.3~20150104-utopic1_UPLOADING.txt.gz
Reply to: