Bug 296611 - missing man pages for symlinked commands
Summary: missing man pages for symlinked commands
Keywords:
Status: CLOSED RAWHIDE
Alias: None
Product: Fedora
Classification: Fedora
Component: cdrkit
Version: rawhide
Hardware: All
OS: Linux
low
low
Target Milestone: ---
Assignee: Harald Hoyer
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2007-09-19 17:22 UTC by Todd Zullinger
Modified: 2007-11-30 22:12 UTC (History)
0 users

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2007-09-20 15:36:29 UTC
Type: ---
Embargoed:


Attachments (Terms of Use)
patch to add manpage symlink creation to F-& and devel branch spec files (3.56 KB, patch)
2007-09-19 17:22 UTC, Todd Zullinger
no flags Details | Diff

Description Todd Zullinger 2007-09-19 17:22:35 UTC
Hola Harald,

cdrkit creates symlinks to various binaries from the older cdrtools package that
it replaces.  The package should also provide symlinks (or stub man pages or .so
man pages, etc.) to the man pages so users who only know the commands by their
previous (and far more obvious) names can find help a little easier.

The attached patch adds symlinks for the cdda2wav, cdrecord, dvdrecord, and
readcd man pages to the F-7 and devel branch spec files.  Hopefully I've not
missed any needed links.

Comment 1 Todd Zullinger 2007-09-19 17:22:35 UTC
Created attachment 199821 [details]
patch to add manpage symlink creation to F-& and devel branch spec files

Comment 2 Harald Hoyer 2007-09-20 15:36:29 UTC
switched to alternatives :)

Comment 3 Aaron Konstam 2007-09-25 13:56:54 UTC
This seems to be taking the wrong slant on the problem. The general solution is
to have man detect the symbolic link and follow it to the right man page.
By the way:  /usr/bin/mkisofs -> genisoimage 
is another candidate.

As far as I can figure it out Ubuntu handles it that way. I am sorry but what
you suggest seems like a kludge.

Comment 4 Harald Hoyer 2007-09-25 14:24:12 UTC
These are the symlinks set up by "alternatives" in the new rpm packages:

/etc/alternatives/cdda2wav->/usr/bin/icedax
/etc/alternatives/cdda2wav-cdda2wavman->/usr/share/man/man1/icedax.1.gz
/etc/alternatives/cdrecord->/usr/bin/wodim
/etc/alternatives/cdrecord-cdrecordman->/usr/share/man/man1/wodim.1.gz
/etc/alternatives/cdrecord-dvdrecord->/usr/bin/wodim
/etc/alternatives/cdrecord-dvdrecordman->/usr/share/man/man1/wodim.1.gz
/etc/alternatives/cdrecord-readcd->/usr/bin/readom
/etc/alternatives/cdrecord-readcdman->/usr/share/man/man1/readcd.1.gz
/etc/alternatives/mkisofs->/usr/bin/genisoimage
/etc/alternatives/mkisofs-mkhybrid->/usr/bin/genisoimage
/etc/alternatives/mkisofs-mkisofsman->/usr/share/man/man1/genisoimage.1.gz
/usr/bin/cdda2wav->/etc/alternatives/cdda2wav
/usr/bin/cdrecord->wodim
/usr/bin/dvdrecord->/etc/alternatives/cdrecord-dvdrecord
/usr/bin/mkhybrid->genisoimage
/usr/bin/mkisofs->/etc/alternatives/mkisofs
/usr/share/man/man1/cdda2wav.1.gz->/etc/alternatives/cdda2wav-cdda2wavman
/usr/share/man/man1/cdrecord.1.gz->/etc/alternatives/cdrecord-cdrecordman
/usr/share/man/man1/dvdrecord.1.gz->/etc/alternatives/cdrecord-dvdrecordman
/usr/share/man/man1/mkisofs.1.gz->/etc/alternatives/mkisofs-mkisofsman


Comment 5 Harald Hoyer 2007-09-25 14:25:22 UTC
what is a kludge here?


Note You need to log in before you can comment on or make changes to this bug.