[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: doc-base errors, documentation installation



Hi Nico,

First of all thanks for your work on NetCDF!

> 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

Interestingly there is no doc-base file in the souce package. Do you have
local changes not yet available in the git repository?

http://anonscm.debian.org/cgit/pkg-grass/netcdf.git

> 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

The doc-base file should be in the same package as the documention it
references, moving the doc-base file to libnetcdf-doc should be the right
way forward.

> ```
> $ 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?

I wanted to reproduce your problem, but was unable because the source
package in git is different from the source you're working with.

Kind Regards,

Bas


Reply to: