From: Jakub Bogusz <qboosh@pld-linux.org>
Date: Mon, 6 Jan 2014 12:23:30 +0000 (+0100)
Subject: - longer instructions wrt. man pages renaming
X-Git-Tag: auto/th/tcllib-1.18-1~1
X-Git-Url: http://git.pld-linux.org/gitweb.cgi?a=commitdiff_plain;h=2e4dc2f9379806023c6ec74b4d8748bbe60a0447;p=packages%2Ftcllib.git

- longer instructions wrt. man pages renaming
---

diff --git a/tcllib.spec b/tcllib.spec
index 13f2282..567d5c3 100644
--- a/tcllib.spec
+++ b/tcllib.spec
@@ -29,8 +29,16 @@ użyteczne dla wielu programistów Tcl-a.
 %setup -q
 %patch0 -p1
 
-# move manuals to proper namespaces, consistent with where they are exported,
-# also avoiding conflicts with the same names in other namespaces
+# Move manuals to proper namespaces, consistent with where they are exported,
+# also avoiding conflicts with the same names in other namespaces.
+# Upstream names are most commonly based on the last element, or have
+# "namespace_" prefix.
+# Unify man pages regarding [sub]namespace or function to the form
+# namespace[::subnamespace] or namespace::[subnamespace::]function;
+# for other man pages, like introductions, namespace::thing or
+# namespace_thing forms might be used.
+# Note: some man pages have "tcllib_" prefix because of conflict with
+# core tcl man pages (e.g. when namespace is identical to tcl keyword).
 %{__mv} modules/base32/base32{,::}core.man
 %{__mv} modules/base32/base32{,::}hex.man
 %{__mv} modules/bench/bench{_read,::in}.man