The cdrtools ebuilds do not copy all README files from the source directory. However, the man pages refer directly to these README files for extended descriptions of options, algorithms, etc. They should all be placed under /usr/share/doc/cdrtools-${PV}/ An example: work/cdrtools-2.01.01/mkisofs/README.sort For cdrtools-2.01.01_alpha10.ebuild, README.sort is referenced by the man page. But it is not included by emerging. It should be. If you disagree, please create a 'doc' USE flag. Thanks.
# equery f cdrtools | grep /doc /usr/share/doc /usr/share/doc/cdrtools-2.01.01_alpha20 /usr/share/doc/cdrtools-2.01.01_alpha20/ABOUT.gz /usr/share/doc/cdrtools-2.01.01_alpha20/Changelog.gz /usr/share/doc/cdrtools-2.01.01_alpha20/README.ATAPI.gz /usr/share/doc/cdrtools-2.01.01_alpha20/README.DiskT@2.gz /usr/share/doc/cdrtools-2.01.01_alpha20/README.audio.gz /usr/share/doc/cdrtools-2.01.01_alpha20/README.cdplus.gz /usr/share/doc/cdrtools-2.01.01_alpha20/README.cdrw.gz /usr/share/doc/cdrtools-2.01.01_alpha20/README.cdtext.gz /usr/share/doc/cdrtools-2.01.01_alpha20/README.clone.gz /usr/share/doc/cdrtools-2.01.01_alpha20/README.copy.gz /usr/share/doc/cdrtools-2.01.01_alpha20/README.gz /usr/share/doc/cdrtools-2.01.01_alpha20/README.linux-shm.gz /usr/share/doc/cdrtools-2.01.01_alpha20/README.linux.gz /usr/share/doc/cdrtools-2.01.01_alpha20/README.mkisofs.gz /usr/share/doc/cdrtools-2.01.01_alpha20/README.multi.gz /usr/share/doc/cdrtools-2.01.01_alpha20/README.parallel.gz /usr/share/doc/cdrtools-2.01.01_alpha20/README.raw.gz /usr/share/doc/cdrtools-2.01.01_alpha20/README.rscsi.gz /usr/share/doc/cdrtools-2.01.01_alpha20/README.sony.gz /usr/share/doc/cdrtools-2.01.01_alpha20/README.verify.gz /usr/share/doc/cdrtools-2.01.01_alpha20/START.gz /usr/share/doc/cdrtools-2.01.01_alpha20/cdda2wav /usr/share/doc/cdrtools-2.01.01_alpha20/cdda2wav/FAQ.gz /usr/share/doc/cdrtools-2.01.01_alpha20/cdda2wav/Frontends.gz /usr/share/doc/cdrtools-2.01.01_alpha20/cdda2wav/HOWTOUSE.gz /usr/share/doc/cdrtools-2.01.01_alpha20/cdda2wav/README.gz /usr/share/doc/cdrtools-2.01.01_alpha20/cdda2wav/TODO.gz /usr/share/doc/cdrtools-2.01.01_alpha20/mkisofs /usr/share/doc/cdrtools-2.01.01_alpha20/mkisofs/README.compression.gz /usr/share/doc/cdrtools-2.01.01_alpha20/mkisofs/README.eltorito.gz /usr/share/doc/cdrtools-2.01.01_alpha20/mkisofs/README.graft_dirs.gz /usr/share/doc/cdrtools-2.01.01_alpha20/mkisofs/README.gz /usr/share/doc/cdrtools-2.01.01_alpha20/mkisofs/README.hfs_boot.gz /usr/share/doc/cdrtools-2.01.01_alpha20/mkisofs/README.hfs_magic.gz /usr/share/doc/cdrtools-2.01.01_alpha20/mkisofs/README.hide.gz /usr/share/doc/cdrtools-2.01.01_alpha20/mkisofs/README.joliet.gz /usr/share/doc/cdrtools-2.01.01_alpha20/mkisofs/README.macosx.gz /usr/share/doc/cdrtools-2.01.01_alpha20/mkisofs/README.mkhybrid.gz /usr/share/doc/cdrtools-2.01.01_alpha20/mkisofs/README.prep_boot.gz /usr/share/doc/cdrtools-2.01.01_alpha20/mkisofs/README.rootinfo.gz /usr/share/doc/cdrtools-2.01.01_alpha20/mkisofs/README.session.gz /usr/share/doc/cdrtools-2.01.01_alpha20/mkisofs/README.sort.gz /usr/share/doc/cdrtools-2.01.01_alpha20/mkisofs/README.sparcboot.gz /usr/share/doc/cdrtools-2.01.01_alpha20/mkisofs/README.sunx86boot.gz /usr/share/doc/cdrtools-2.01.01_alpha20/print /usr/share/doc/cdrtools-2.01.01_alpha20/print/cdda2wav.ps.gz /usr/share/doc/cdrtools-2.01.01_alpha20/print/cdrecord.ps.gz /usr/share/doc/cdrtools-2.01.01_alpha20/print/isoinfo.ps.gz /usr/share/doc/cdrtools-2.01.01_alpha20/print/mkisofs.ps.gz /usr/share/doc/cdrtools-2.01.01_alpha20/print/readcd.ps.gz /usr/share/doc/cdrtools-2.01.01_alpha20/print/scgcheck.ps.gz