on fedora, "man gitweb" exists but actual gitweb command is missing

on fedora, "man gitweb" exists but actual gitweb command is missing

[Robert P. J. Day]

  not so much a git issue as what looks like a fedora packaging issue.
on my updated fedora 29 system, "man gitweb" works:

  GITWEB(1)                    Git Manual                    GITWEB(1)

  NAME
       gitweb - Git web interface (web frontend to Git repositories)

  SYNOPSIS
       To get started with gitweb, run git-instaweb(1) from a Git
       repository. This would configure and start your web server, and
       run web browser pointing to gitweb.
       ... snip ...

and the corresponding man page source file clearly belongs to the
"git" package:

  $ rpm -qf /usr/share/man/man1/gitweb.1.gz
  git-2.20.1-1.fc29.x86_64
  $

but there is no "git instaweb" command:

  $ git instaweb
  git: 'instaweb' is not a git command. See 'git --help'.
  $

it took only a few seconds to determine that fedora bundles that
functionality in two separate packages which are not dependencies of
"git": "gitweb" and "git-instaweb" (output abbreviated):

  $ sudo dnf install git-instaweb
  ...
  Installing:
   git-instaweb
  Installing dependencies:
   gitweb
   perl-CGI

and now "git-instaweb" works fine.

  the question is, is it not inconsistent for fedora's basic "git"
package to include the man page for gitweb, without including the
corresponding functionality? is this something i should submit a
fedora bugzilla report for? or am i misunderstanding something?

rday

-- 

========================================================================
Robert P. J. Day                                 Ottawa, Ontario, CANADA
                  http://crashcourse.ca/dokuwiki

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================

Re: on fedora, "man gitweb" exists but actual gitweb command is missing

[Todd Zullinger]

Hi,

Robert P. J. Day wrote:
> 
>   not so much a git issue as what looks like a fedora packaging issue.

Yeah, it's just a minor packaging issue.  The gitweb
manpages are included in the main git package rather than in
the gitweb package with the rest of the gitweb files.  I'll
fix that for future releases and when f29 is updated to 2.21
it will pick that up¹.

Since gitweb requires git, you'd be sure to have the
documentation after installing gitweb.  If we made it
possible to install gitweb without getting the
documentation, that would be more annoying. :)

¹ https://src.fedoraproject.org/fork/tmz/rpms/git/c/0d9ad786

> it took only a few seconds to determine that fedora bundles that
> functionality in two separate packages which are not dependencies of
> "git": "gitweb" and "git-instaweb" (output abbreviated):
> 
>   $ sudo dnf install git-instaweb
>   ...
>   Installing:
>    git-instaweb
>   Installing dependencies:
>    gitweb
>    perl-CGI
> 
> and now "git-instaweb" works fine.
> 
>   the question is, is it not inconsistent for fedora's basic "git"
> package to include the man page for gitweb, without including the
> corresponding functionality? is this something i should submit a
> fedora bugzilla report for? or am i misunderstanding something?

If I hadn't seen this thread, then a report in the fedora
bugzilla would be the way to go to ensure one of the fedora
git maintainers noticed it.

Thanks,

-- 
Todd

Re: on fedora, "man gitweb" exists but actual gitweb command is missing

[Robert P. J. Day]

[-- Attachment #1: Type: text/plain, Size: 940 bytes --]

On Sat, 23 Feb 2019, Todd Zullinger wrote:

> Hi,
>
> Robert P. J. Day wrote:
> >
> >   not so much a git issue as what looks like a fedora packaging
> >   issue.
>
> Yeah, it's just a minor packaging issue.  The gitweb manpages are
> included in the main git package rather than in the gitweb package
> with the rest of the gitweb files.  I'll fix that for future
> releases and when f29 is updated to 2.21 it will pick that up¹.

  ... snip ...

  ah, eggcellent, so i can remove this from my TODO list, thanks.

rday

-- 

========================================================================
Robert P. J. Day                                 Ottawa, Ontario, CANADA
                  http://crashcourse.ca/dokuwiki

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================