Control: severity -1 minor
Control: retitle -1 Files in git-doc may not be findable by apt-file search

On Mon, 2018-08-13 at 19:27 -0700, Jonathan Nieder wrote:
> tags 905938 + moreinfo
> quit
> 
> Hi Ben,
> 
> Ben Hutchings wrote:
> 
> > git-rebase(1) refers to
> > /usr/share/doc/git/html/howto/revert-a-faulty-merge.html, but this
> > filename does not exist in any package.  git-doc contains
> > /usr/share/doc/git-doc/howto/revert-a-faulty-merge.html which is
> > presumably the right file to refer to.
> 
> $ ls -ld /usr/share/doc/git/html
> lrwxrwxrwx 1 root root 10 May 30  2017 /usr/share/doc/git/html -> ../git-doc
> 
> Is it configured differently on your machine?

No, it's not.  Now that I have git-doc installed, the symlink is there
and I can access the document through both filenames.

Initially I did not have git-doc installed, and "apt-file search"
couldn't find the file by the name given in git-rebase(1) because it
doesn't take symlinks into account.

[...]
> Arguably it would be better to install directly into
> /usr/share/doc/git/html, but that would have broken links (e.g.
> kernel-handbook links to [1]).  Perhaps the package should install
> docs directly to /usr/share/doc/git/html and put some symlinks in
> /usr/share/doc/git-doc --- what do you think?

I don't know.  Do whichever you think is likely to cause least
confusion.

Ben.

-- 
Ben Hutchings
The Peter principle: In a hierarchy, every employee tends to rise to
their level of incompetence.

Attachment: signature.asc
Description: This is a digitally signed message part

Reply via email to