Bug 24517

Summary:	Inconsistencies in a documentation layout
Product:	[Retired] Red Hat Linux	Reporter:	Michal Jaegermann <michal>
Component:	samba	Assignee:	Trond Eivind Glomsrxd <teg>
Status:	CLOSED WONTFIX	QA Contact:	David Lawrence <dkl>
Severity:	low	Docs Contact:
Priority:	medium
Version:	7.1
Target Milestone:	---
Target Release:	---
Hardware:	i386
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2001-01-21 21:00:10 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Michal Jaegermann 2001-01-21 21:00:07 UTC

A content of directories /usr/share/doc/samba-2.0.7/docs/htmldocs
and /usr/share/swat/help is nearly identical but not quite.  One would
think that at least identical documents should be replaced in one
place by links to ensure consistency.

Also /usr/share/swat/using_samba/ smells to me like a documentation
but it is not in /usr/share/doc tree.  It is probably where it is because
swat will serve its content on line when swat is used.  At least a link to
it should be provided somewhere in /usr/share/doc/samba*/ or somebody
not running swat may easily miss it.  Note that by default swat is off.

  Michal
  michal

Comment 1 Bill Nottingham 2001-01-31 22:22:39 UTC

This is not exactly feasible.

- the docs in /usr/share/doc/samba-2.0.7 are in the samba package
- swat is a separate subpackage

You can't have the files in swat be symlinks, because the packages might have
been installed with --excludedocs. And you can't have the docs be symlinks,
because swat might not be installed at all.